Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DraftMASTDOCS and version 1.3

Component Overview

A description of This page describes the Cone Search and Upload List area.  These components are used for searches that are based on coordinates (positions) on the sky (also known as cone searches), or based on an uploaded list of target information, such as resolvable object names, coordinates, or dataset IDs.


Component Features and Functionality

Below you can find a A description of the features Cone Search and capabilities of this component.Upload List Component capabilities: Search By Object Names To Resolve Into Coordinates, Search By Coordinates, Upload A List, and Specify The Cone Search Radius.

You do not need to specify to resolve into coordinates. You can use
Info
  • Any combination of object names and/or coordinates (see below) can be entered using this component, it can resolve either one as they are entered!
  • Enabling a search does not require specifying
Info
title
  • a coordinate or object name
  • . Use the search form to conduct a search based only on other search parameters, or even no parameters at all!
<200px image or animated gif>
  • Searching with nothing entered in the form retrieves all available entries from a given data collections.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Widget Connector
width100%
urlhttps://www.youtube.com/watch?v=4jGcq51T574

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
Anchor
single_target
single_target
Search By
A Single
Object
Name
Names To Resolve Into Coordinates

One

option is to enter an object name into the Target Search box.  The form will then attempt to resolve this

or more object names can be entered into the 'Object Search' box. Press 'tab', 'return', or 'comma' on your keyboard to finish entering the object name (clicking off the text box will also work). The form will attempt to resolve the object name into a coordinate

using the

using the MAST name

resolver  The resolver

This service looks up the object's name using

a number of interfaces, including

Simbad, NED, and several databases

at MAST.  These are the central coordinates used to include a spatial cone search, along with any other query constraints you include in the rest of the search form.

internal to MAST.

  • Upon a successful resolve, the object name will be surrounded by a green color, a check mark is added in front of the name, and the resolved coordinate will appear to the right of the object name in parenthesis. The coordinate shown will be used as the center of the cone search for that object.
         Image Added
  • If the object name can not be resolved, the target will be surrounded by a yellow color and an exclamation point is added in front of the name.

         Image Added 

  • The 'X' mark right next to each entry can used to remove an object.
Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image AddedImage AddedImage Added


Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Widget Connector
width100%
urlhttps://www.youtube.com/watch?v=EbH7YP634S0

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>

Anchor
single_coord
single_coord
Search By

A Single Object's

Coordinates

Another option is to enter the coordinates of the desired cone search into the Target Search box.  The form will then attempt to parse the coordinates, which can be specified in decimal degrees or sexagesimal format

One or more coordinates can be entered into the 'Object Search' box. Coordinates can be entered in sexagesimal notation (Right Ascension in hours; HH MM SS.ss or HH:MM:SS.ss, Declination in degrees; DD MM SS.ss or DD:MM:SS

).  Right

.ss) or in decimal notation (Right Ascension and Declination both in degrees; DDD.dd). Press 'tab', 'return', or 'comma' on your keyboard to finish entering the coordinate (clicking off the text box will also work).

Note
titleValues outside the bounds

Right Ascension values outside the bounds of 0.0 <= R.A. <= 360.0 degrees will be wrapped to fit

within

with these bounds.

 Declination

Image Added

Declination values outside the bounds of -90.0 <= Dec. <= 90.0

are defined as invalid.

will be parsed as invalid.

Image Added

For positive values, you may optionally decide to include a '+' sign.


Warning

When entering a coordinate, do not include a comma or semicolon between R.A. and Dec. Separate them with only a space. 

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Widget Connector
width100%
urlhttps://www.youtube.com/watch?v=hLaloMVMT9g

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Since there are a wide variety of ways to upload lists of objects, a number of sample files is provided in the table below.

Divbox
stylebackground-color:white;margin:0px;border:0px;
Panel
borderColorblack
titleCSV File Format Example

target,ra,dec,dataset_id
M101, 14:03:12.545, +54:20:56.22, J8OB02011
51 Peg, 22 57 27.960, +20 46 07.75, O4ZE04020
TRAPPIST-1,23h06m29.368s,-05h02m29.03s, ID4301QPQ
helix nebula, 22:29:38.545, -20:50:13.75, W1KA2T01T

DescriptionSample Upload File
One column, only object names.
One column, only coordinates.
One column, only dataset IDs.
Three columns, object names and coordinates.example_idandcoords.csv
Four columns, object names, coordinates, and dataset IDs.example_idandcoordsanddatasets.csv
Five columns, object names, coordinates, and two user-defined columns.example_idandcoordsandnotes.csv
Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>
Anchor
upload_list
upload_list
Upload A List Of Object Names To Resolve Into Coordinates, Cone Search Coordinates, or Dataset IDs

Another option is to upload a list of object names to resolve, coordinates, or dataset IDs.  NEED TO GO THROUGH A LOT MORE HERE.

A file can be uploaded into the form that contains a list of object names to resolve into coordinates, coordinate pairs of Right Ascension and Declination, or Dataset IDs. The file must be in comma-separated value (CSV) format, and the top row must contain a header with column names. The header row does not need any special character in the front: the first row is always read in as the header row. The header row is case-insensitive.

Warning

The uploaded file must contain at least one of three search parameters: object name (using the header "Target"), coordinate (using the headers "RA" and "Dec"), and/or dataset ID (using the header "Dataset_ID"). Remember that the headers are case-insensitive.


  • If the file contains object names, coordinates, and dataset IDs, the search form will use the dataset IDs and return those exact matches in the search results.  
  • If the file contains object names and coordinates, the search form will use the coordinates to perform cone searches, and it will not attempt to resolve any object names.  
  • If the file contains only object names, the search form will attempt to resolve them into coordinates.

The number of object names that were successfully and unsuccessfully resolved is reported, and clicking on the number of unsuccessful name resolves will display an overlay with more information and line numbers to provide further information.

The columns in the uploaded file are included in the search results table on the far right, with labels of 'User File <col>'.  For example, if the uploaded file contained rows labeled 'target', 'ra', 'dec', 'dataset_id' they are included in the search results table as 'User File target', 'User File ra', 'User File dec', and 'User File dataset_id'.

Info

If there are additional columns in the uploaded CSV file, they will be included in the search result table in the far right as well. This allows additional columns to be cross-matched to the search results and thus included when exporting the search result table.

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2

Image Added

Panel
borderColor#00617E
bgColor#E3EEF1
borderWidth2
<200px image or animated gif>
Anchor
cone_size
cone_size
Specifying The
Size Of Your
Cone Search Radius

Regardless of how

you request

a position on the sky is specified (through

a single, resolvable

an object name

, a single, parsable coordinate, an uploaded list of resolvable object names, or an uploaded list of coordinates) you can control

resolved into coordinates, or directly using Right Ascension and Declination) the size of the

cone search by specifying a radius in either arc seconds or arcminutes.  A maximum

search radius is defined using the 'Search Radius' component. The radius may be defined in either arcseconds or arcminutes.  The default size is 3 arcminutes in the form and a maximum radius of 30 arcminutes is allowed.

 Note that if you upload

If a list is uploaded to the search form, this cone search radius is applied to every object name or coordinate in that list.

Note

If a list of Dataset IDs

, this component

is

not used

specified,

because

a cone search is not conducted

.  When supplying a list of Dataset IDs

; thus this component is not used. Instead, a direct match on the dataset IDs is performed

instead

.


For Further Reading...