This article describes how to use the Target Name Search and Upload List area.
On this page...
Overview
The Target Name Search and Upload List components are used for exact target name matches, or are based on an uploaded list of target information such as target names or dataset IDs. An exact target name search is performed when the "Resolve" toggle button 
is unchecked:
If a Cone Search is preferred, please refer to the Cone Search documentation.
Features and Functionality
A description of the Target Name Search and Upload List Component capabilities: Search By Target Name and Upload A List.
- Any target name entries (see below) can be entered using this component, it will not attempt to resolve them into coordinates.
- Enabling a search does not require specifying a target name. Use the search form to conduct a search based only on other search parameters, or even no parameters at all! Searching with nothing entered in the form retrieves all available entries from a given data collections.
Search By Exact Match on Target Name
One or more target names can be entered into the 'Target Name' box. Press 'tab', 'return', or 'comma' on your keyboard to finish entering the target name (clicking off the text box will also work). The video below shows how to enter target names.
Note:
- Upon a successful entry, the target name will be surrounded by a light-blue color and a check mark is added in front of the name.
- Target names that include one or more asterisks (*) correspond to a wildcard, where zero or more additional characters can exist between the non-wildcard characters. Asterisks can be placed anywhere in each target name.
- The 'X' mark right next to each entry can used to remove an object.
Upload a list of target names or Dataset IDs
A file can be uploaded into the form that contains a list of target names or Dataset IDs. The video below shows how to do that.
The file must be in comma-separated value (CSV) format, and the top row must contain a header of column names. The header row need not begin with a special character: the first row is always treated as the header row, and is case-insensitive.
The uploaded file must contain at least one of two search parameters:
- target name (using the header "Target"), or
- dataset ID (using the header "Dataset_ID")
- If the file contains target names and dataset IDs, the search will use the dataset IDs and return those exact matches in the search results.
- If the file contains only target names, the search will attempt to perform an exact match on the target name.
The number of target names that were successfully (and unsuccessfully) identified is reported, and clicking the number of unsuccessful name resolves will display an overlay with more information and line numbers. 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'.
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.
Some datasets do not have a dataset_id available. In those cases, the value in the dataset_id column will be treated as a target name.
Example target lists
Since there are a wide variety of ways to upload lists of targets, some sample files are provided or linked below.
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 target names. | |
| One column, only dataset IDs. | |
| Three columns, target names and coordinates. | example_idandcoords.csv |
| Four columns, target names, coordinates, and dataset IDs. | example_idandcoordsanddatasets.csv |
| Five columns, target names, coordinates, and two user-defined columns. | example_idandcoordsandnotes.csv |