Page tree

James Webb Space Telescope User Documentation

 

 

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
id277319515
Content Column
id277319517
classpdf-full
Content Block
overflowauto
nameSummary
id277319516

JWST APT includes a capability to ingest a file containing fixed target information directly into the APT target section.

Content Block
overflowauto
nameContent
id277805920

Introduction

Main article: JWST APT Targets

For programs involving a large number of targets, APT supports the ingest of catalogs or lists of targets and target information in various formats.

File Formats for Importing

The are 4 supported file formats:

  • Whitespace Separated 
  • Comma Separated Values (CSV) 
  • Tab separated Values (TSV)
  • Virtual Observatory Table (VOT) 

Here is an example of a CSV file for fixed targets. (Solar sytem targets are not supported for bulk entry.)

# Name, RA, DEC, RA Uncertainty, Dec Uncertainty, RA PM,    
    RA PM units, DEC PM, DEC PM units, Epoch, Annual Parallax, "Comments" 

SDSS2346-0016,23 46 25.6700,-00 16 0.05,0.1,0.1,3.4,
    MAS/YR,1.0,MAS/YR,1989.9,,"From the Sloan Survey" 

V-V1343-AQL,19 11 50,4 58 58,,,,,,,,,"This object is from SIMBAD"

HD76932,08 58 43.9300,-16 07 57.90,,,,,,,,,

RW-AUR-A,76.95629,+30.40153,,,,,,,,0.1, 

 

There are several items to note about the format:

  • Lines starting with a "#" are comment lines.
  • The first line in the file (there can be other comment lines between this line and the data) contains the names of the columns; the column names in the file must be unique, and they are not case sensitive. The names above are the names that APT uses, but you can use other names for some columns and APT may properly interpret them (e.g. RA can be RA, Right Ascension, or R.A.) If you do not supply a column identification line, or if your column names cannot be interpretted by APT, you can manually assign the columns.
  • You do not need to supply values for all of the APT fields (e.g. you can skip the RA Uncertainty field and populate it in APT after ingest).
  • Each line must contain the exact same number of entries. For CSV format, you can use extra commas to represent missing data (e.g. for SDSS2346-0016, there is 1 comma between the Epoch and Comment to indicate that the Annual Parallax field is not populated. Note that for Whitespace and Tab separated, this method will not work (i.e. you cannot have extra whitespace or tabs to indicate blank fields).
  • The coordinate fields can support multiple formats, as shown above. For RA, you can use 19 09 53.0 (no units), 16h 22m 31s (units), or 118.77170 (decimal degrees). For Dec, you can use 4 53 16 (no units), -17d 52m 44.0s (units), or 22.00137 (decimal degrees); note that you cannot use ' (minutes) or " (seconds) for the units.
  • Note that text fields need to use double quotes (") and not single quotes (').
  • To specify quotes within a text field, use double double quotes (e.g. "This will preserve the ""quote"" mark.")
  • For some text field data, you will need to use quotes around the text. In Whitespace separated files, quotes are needed around all text fields that contain white space (e.g. "19 09 53.0"). In CSV files, quotes are needed if the text field contains a comma (e.g. "This object, from my list, is interesting").

 


Accessing the Importer

To ingest a target list into APT: 

a) go to the File Menu, Import, Import Targets, or

b) select the Targets folder in the Tree Editor and click on the Import Targets in the APT window (or right click on the Targets folder and select Import Targets from the menu), or

c) select the Fixed Targets folder in the Tree Editor and click on the Import Targets in the APT window (or right click on the Fixed Targets folder and select Import Targets from the menu).

These options are shown in Figure 1.

Figure container
Figure title

Figure 1. Options for Accessing the Target list importer in APT

Figure caption

The target importer can be accessed in several different ways, as shown in the three panels above.

 


Assigning Column Names

After selecting the Importer, you need to select the file format, the file name, and the coordinate type (only equatorial is supported). See Figure 2. Once you select the file format, you will see the file format displayed.  See Figure 2.

 

Figure container
Figure title

Figure 2. The Target list import interface GUI

Figure caption

This GUI permits the file type and file name to be selected for import.

 

Once you enter a file name, the Importer will attempt to match the column names in your file (if you provided any) with the APT field names. 

Figure container
Figure title

Figure 3. Import GUI Attempts to Identify Columns in the Input File

Figure caption

These panels show several outcomes from the tool's attempt to identify columns in the input file.

In the examples shown in Figure 3, the field names for Right Ascension, RA Uncertainty, and Dec Uncertainty were not understood by APT, so these will need to be manually selected. Note that the Importer requires the Target Name, RA, and Dec fields to be identified before it will accept the file for import. You can view all the objects in the file by scrolling down.

Also, the entry in the Annual Parallax column has an incorrect format. You may import a file with this type of error, although the object with the error will NOT be imported (but all the other targets will be). However, if all the entries in a given column are improperly formatted, the Importer will not accept the file for import.

With all the columns identified, click on the Import button to load the targets into APT.

Besides the Target Name, RA, and Dec, two other fields are required for a minimal, complete target specification and Category and Description. These fields will need to be entered manually as the importer will not populate these fields from the file.

 


 

Content Block
overflowauto
nameRelated links
id280628021
classpdf-hide

Related links

Astronomer's Proposal Tool

JWST APT Targets
JWST Astronomers Proposal Tool Overview

General

JWST Acronyms and Abbreviations
JWST User Documentation Home

Content Block
overflowauto
nameReferences
id281944791
classpdf-hide

References

JWST technical documents

 

Restrict Content
groupsconfluence-authors
Panel

Block has been set to pdf-hide. Contact Shireen if you enter references

Content Column
id277319512
classpdf-hide
Content Block
overflowauto
nameIcon
id278719485

Multiexcerpt include
MultiExcerptNameAPT icon and name
PageWithExcerptMR:APT icon and name

Content Block
overflowauto
nameUpdates
id1066359141
HTML Wrap
padding0
margin0
idupdatesbox
HTML Wrap
tagspan
classupdatesbox-heading

Last updated

Published November 20, 2017


 

Comment

The format for 'Last updated' is shown below. Enter updates above this internal"Comment" box. Only enter major updates (not typos or formatting changes).


Updated April 5, 2017

  • Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aliquam fermentum vestibulum est. Cras rhoncus. 
  • Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed quis tortor. 

Published March 2, 2017


Restrict Content
groupsconfluence-authors

Tables are only visible to JDox content providers

"Updated" refers to the updated or publish dates for the public pages.

Page properties
idcomments
UpdatedNovember 20, 2017
Open comments-
Team-
Author-
Page properties
idlayout
UpdatedNovember 20, 2017
Fix pageYes
Typepattern
Teameditors