Component Overview

This page describes the Target Name Search and Upload List area.  These components are used for exact target name matches, or 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 (deselected):


If a Cone Search is preferred, please refer to the Cone Search documentation.

Component 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). 

  • 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.

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

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

DescriptionSample 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
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 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.

The uploaded file must contain at least one of two search parameters: target name (using the header "Target") and/or dataset ID (using the header "Dataset_ID"). Remember that the headers are case-insensitive ("dataset_id" works as well as "Dataset_ID").


  • If the file contains target names and dataset IDs, the search form will use the dataset IDs and return those exact matches in the search results.  
  • If the file contains only target names, the search form 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 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'.

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.


  • No labels

Data Use | Acknowledgements | DOI | Privacy

Send comments & corrections on this MAST document to: archive@stsci.edu