Warning |
---|
|
This page is under construction. |
Panel |
---|
borderColor | #00617E |
---|
borderWidth | 2px |
---|
borderStyle | solid |
---|
|
On this page... |
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.
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 | You do not need to specify - a coordinate or object name
| to resolve into coordinates. You can use - . 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 |
---|
borderWidth | 2 |
---|
|
Widget Connector |
---|
width | 100% |
---|
url | https://www.youtube.com/watch?v=4jGcq51T574 |
---|
|
|
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
Anchor |
---|
| single_target |
---|
| single_target |
---|
| Search By |
A Single 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 resolver The resolver This service looks up the object's name using |
a number of interfaces, including 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 |
---|
borderWidth | 2 |
---|
|
Widget Connector |
---|
width | 100% |
---|
url | https://www.youtube.com/watch?v=EbH7YP634S0 |
---|
|
|
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
<200px image or animated gif> A Single Object's 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 |
---|
title | Values outside the bounds |
---|
| Right Ascension values outside the bounds of 0.0 <= R.A. <= 360.0 degrees will be wrapped to fit |
|
within 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 |
---|
borderWidth | 2 |
---|
|
Widget Connector |
---|
width | 100% |
---|
url | https://www.youtube.com/watch?v=hLaloMVMT9g |
---|
|
|
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
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 |
---|
style | background-color:white;margin:0px;border:0px; |
---|
| Panel |
---|
borderColor | black |
---|
title | CSV 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 |
|
Description | Sample 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 |
---|
borderWidth | 2 |
---|
|
<200px image or animated gif> |
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 |
---|
borderWidth | 2 |
---|
|
Image Added
|
Panel |
---|
borderColor | #00617E |
---|
bgColor | #E3EEF1 |
---|
borderWidth | 2 |
---|
|
<200px image or animated gif> Size Of Your Cone Search Radius Regardless of how |
you request a position on the sky is specified (through |
a single, resolvable , 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 not used 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