Purple text indicates the parameter is Limited Access.
Boldface italics type indicates the name of an APT parameter or a value for a parameter.
Red text indicates restrictions on a parameter.
Black text indicates an important note.
Brown text indicates notes for the developers.
Green text indicates the name of the parameter used by Commanding.
Items in brackets - <value> - are required values.
Items in square brackets - [<value>] - are optional.
The Targets list tells us where you wish to point JWST and so must be filled out with care, precision, and accuracy. For proposals with a large number of fixed targets, please note that there is a capability to ingest a comma-separated text file with the appropriate target information.
The following information is required to identify and classify each target.
Each target in your proposal will be assigned its own unique number, ranging from 1 to 999, by APT; note that these can be changed by the user.. A different target must be defined whenever different coordinates are required. Separate targets should be defined and listed if you plan to take observations at several points within an extended object. For example, if you were to take images at three different locations in the Crab Nebula, each point must have its own target number, name, and coordinates, such as CRAB1, CRAB2, and CRAB3.
Name in the Proposal
NAME IN THE PROPOSAL provides a unique designation for a target for use throughout the proposal.
The following restrictions should be noted for the target name in the proposal:
- The length of a target name can be anywhere from 2 to 31 characters.
- Only upper and lower-case letters, numerals, '.', '+', '_' and '-' are allowed. Spaces are not allowed.
- Two targets may not have the same name with different cases.
Name for the Archive
Using a common name for the NAME IN THE PROPOSAL (e.g. CRABNEBULA instead of NGC1952) can make a proposal more readable. Annotating the name (e.g. CRAB1, CRAB2) may be useful when sampling parts of an extended object. But these names are not as helpful for people searching the Archive. So, there is an optional second target name – the NAME FOR THE ARCHIVE. Proposers and archival researchers use these names to determine whether JWST has observed a particular object. This facility will be most useful if the names supplied are resolvable with standard name resolvers such as NED or SIMBAD. This name is not required, but if used must be 2 to 31 characters in length.
One to five Target Descriptions must be selected for each target. The Target Descriptions will be one of the fields used by archival researchers in searching through the JWST data archive; thus it is extremely important that the information be supplied by the observer who knows the intention for each target.
Each target must be assigned a single primary category from Table 1 , and at least one descriptive keyword, chosen from the appropriate tables (see Table 1 for which table is appropriate for each category).
Table 1. Target Categories
|Cluster of Galaxies||Clusters of Galaxies table|
|Stellar Cluster||Stellar Cluster table|
The following information is required to allow for JWST to be properly pointed at the target.
Required Accuracies of Target Positions
JWST uses one guide star to stabilize the pointing of the telescope and to place the target in the desired aperture. The fundamental problem, then, is to determine the position of the target relative to the guide star in the surrounding area with sufficient accuracy to place the target in the aperture. The specific guide star to be used cannot be determined in advance of the observation; several possible stars will often be available for each target. The guide stars are chosen from the Guide Star Catalog 2 (GSC2). The anticipated pointing accuracy of the telescope after acquisition of the guide star is required to be 1" (1σ, 1 axis), but actual performance achieved should be about 0.25" (1σ, 1 axis), as will be determined from inflight data. Errors in the proposer specified ICRS coordinates of the science target will contribute additional pointing errors. For targets that need to be placed within small apertures (coronagraphs, spectroscopic slits, etc) will require onboard target acquisition.
Inaccurate target coordinates can result in failed target acquisitions and can therefore waste valuable JWST observing time. Please contact the JWST Help Desk at jwsthelp.stsci.edu if you need additional information.
|The Principal Investigator of a proposal is responsible for ensuring that target coordinates are accurate.|
|Targets near the Celestial Poles: Be very careful if your target lies near a celestial pole. Many precession routines break down in this regime, and uncertainties in position are exacerbated in this region. Also, patterns that you may execute with an instrument could cross the pole, leading to confusion in position. All these issues can be resolved, but careful attention is needed.|
J2000 Coordinates and Uncertainty
The right ascension and declination <values> must be provided; the uncertainties are optional.
|RA: <value>||Dec: <value>|
Uncertainty RA: +/– <value>
|Uncertainty Dec: +/– <value>|
- The year of the equator and equinox to which the coordinates are referred must be J2000 (Julian). It is not necessary to apply precession corrections to coordinates from positional catalogs. The Guide Star Catalog and the Hipparcos Input Catalogue both use the J2000 equinox. (Note, however, that the Hipparcos Output Catalogue is epoch 1991.25, which means proper motions can have significant effects if you are not careful.)
- The uncertainties should represent the accuracy (1 sigma) of the target coordinates, not the region within which a target could be observed (e.g., for a sky measurement).
- The right ascension value must be expressed in hours (H), minutes (M), and seconds of time (S). Note that you can enter the right ascension in decimal degrees (e.g. 15.0), and APT will automatically converted it to HMS format (01H 00M 00.0S). Note that it is not possible to input RA in decimal hours.
- The declination value must be expressed in degrees (D), minutes ('), and seconds (") of arc. Note that you can enter the declination in decimal degrees (e.g. -20.5), and APT will automatically converted it to DMS format (e.g. -20D 30’ 00.0”).
- The units for the uncertainty must be selected from the following values:
|Quantity and units specified||Acceptable units for uncertainty|
|RA: H-M-S||timemin, timesec, arcmin, arcsec|
|Dec: D-M-S||degrees, arcmin, arcsec|
|If the sign of the declination is not indicated, a positive declination is assumed, but we urge you to always include the sign as a way of reducing errors.|
Determining Coordinates in the Reference Frame Appropriate for JWST Observations
The JWST reference frame is effectively defined by the positions of the Guide Star used for each pointing. We are using the Guide Star Catalog (GSC2), which is an all-sky catalog of stars calibrated to be on the International Celestial Reference System (ICRS), which has been adopted by the IAU as the new fundamental reference frame.
|For observations it is vital that you provide positions derived in the ICRS reference frame.|
- If your target has a position that is in a catalog using the ICRS you may use the coordinates directly. These include GSC2, Hipparcos, Tycho, SDSS, 2MASS and FIRST.
- If your target is an extended object where the observation position does not correspond to the catalog coordinates, we recommend that you obtain an image of the field and measure your target coordinates in the ICRS reference frame. If your target has a relevant proper motion, you must provide the epoch of the coordinate as well as the proper motion values.
Access to the GSC2, the Digitized Sky Survey (DSS) and other catalogs/surveys is built into the Aladin interface in APT (Note: for the DSS use the POSS2UKSTU-Red plates that were used to build GSC2).
Getting Coordinates from the GSC2 or DSS
- If your target is a star brighter than m(V)~20 then it typically will be visible on the DSS images and present in the GSC2 catalog. Using the GSC2 position will ensure that the target is in the same reference frame as the guide star.
- For extended sources visible on the photographic survey plates, we strongly recommend that you examine the DSS image and check your coordinates. Depending on the brightness, morphology and structure of the galaxy the GSC2 coordinate may not correspond to the aperture location you require for your observation. The DSS headers downloaded from STScI contain ICRS-based FITS WCS information to allow you to measure the image using various image analysis tools.
- Please note that the GSC2 coordinates for bright stars come from the Tycho2 catalog as these are more accurate than positions measured from the Schmidt plates.
As part of preparing your fixed targets, you must create Confirmation Charts which show the target coordinates (as entered in the proposal) overlaid on the field from the DSS.
|You are responsible for verifying that the coordinates are correct.|
EXTENDED = UNKNOWN (default), YES, NO
This parameter is used to indicate if the target is extended to support data pipeline processing, and is recommended for spectroscopic observations. When left as UNKNOWN, the pipeline will use default values based on the instrument configuration (e.g. template, wavelength, etc.).
Note for developer: Add the line "Recommended for spectroscopy (for advice to data reduction pipeline)" after the parameter.
If it is impossible to obtain adequate plate material to measure coordinates to the required accuracy (for example, a very crowded field which cannot be resolved using ground-based observations, NIRSpec MSA observations), it may be necessary to obtain an early acquisition image with JWST. In that case, enter coordinates as accurate as possible on the Target List.
See also: Specifying APT Background Targets; Special fixed target cases: Mosaics, multi-object spectroscopic targets, and background targets
A target may be designated as requiring one or more background observations. Background observations may be linked to other observations so that background may be subtracted during pipeline processing.
Observations of this target require companion background observation(s)
Selecting this option indicates that observations of this target require one or more companion background observations.
Target(s) to be used as background observation(s)
This option is only available when "Observations of this target require companion background observation(s)" is selected.
Select one or more targets to be used in background observations linked to observations of this target. Only targets from the current proposal are available to be selected.
A background observation:
- Observes a target selected to be used in a background observation, and
- Must have an exposure specification similar to the science observation. A similar exposure specification has the same instrument, template, grating, filter, subarray, and aperture, but not necessarily the same exposure time parameters.
Note that targets selected to be used in background observations cannot also be targets of science observations. If your proposal has targets that serve as both science targets and background targets, you will need to create the target twice with slightly different names. Otherwise, the data processing pipeline will not be able to automatically apply the correct processing.
Observations of targets designated as requiring background observations
For science observations of targets designated as requiring background observations, the science observation may be linked to its background observation with a SEQUENCE OBSERVATIONS NON -INTERRUPTIBLE special requirement. Both observations must have similar exposure specifications.
- This link is required for science observations with the MIRI LRS, MIRI MRS, MIRI Coronagraphic Imaging, NIRSpec Fixed Slit, and NIRSpec IFU templates (APT provides an error)
- For all other templates this link is optional (APT provides a warning).
Is Proper Motion of Parallax Relevant?
If a small aperture or occulter is to be used, even a relatively small proper motion or parallax may cause difficulties in acquiring the target. In such cases, the Proper Motion/Parallax data must be provided.
The observer must determine whether or not proper motion or parallax is relevant. In general, this will depend on the size of the acquisition aperture of the SI that will be used and the epoch of the coordinates that have been provided. For example, the NIRISS SOSS mode uses a target acquisition area of 4.2 arcsec square. For a star whose coordinates are given for the epoch 1995.0, and that will be observed in 2020.0, a proper motion of 0.05”/year yields a total motion of 1.25", which is greater than half the minimum center-to-edge distance (1.1”) of the aperture, and therefore relevant.
Proper Motion and Annual Parallax Data
The following information is required for targets where proper motion and parallax are “relevant”; note that uncertainties for Proper Motion and Annual Parallax are not required.
|If a sign is not given for Proper Motion, a positive value will be assumed, but it is better to be explicit.|
- RA: For Proper Motion in RA, the value can be in units of mas/year, arcsec/year, or seconds of time/year. The selection of units is especially critical for RA, as there is a large difference between 15 seconds of time/year and 15 arscec/year, so the observation will fail if improper units are provided.
- DEC: For Proper Motion in Declination, the value can be in units of mas/year or arcsec/year.
- EPOCH: The “Epoch of position” is the date of the the data from which the position of a star with proper motion was measured, or to which it has been corrected. Any epoch may be given but it must be correctly specified. SIMBAD coordinates are usually corrected to epoch 2000 regardless of the original source epoch.
- The “Epoch of position” may or may not be the same as the date of “Equinox for Coordinates” (J2000). Remember that the “Epoch of position” is the date the target position is referred to, whereas the “Equinox of Coordinates” is the date of the coordinate frame, which changes because of the precession of the Earth's axis. For example, a star with a large proper motion may have its coordinates given in the J2000 system, but the numbers themselves are for epoch 1984, meaning that the star was at the specified position on January 1, 1984. Epoch should be of the form 20yy.y or 19yy.y. (Note: An epoch is purely a time, and one of the form "J1991.25" is nonsensical.)
- Ordinarily the epoch of position is earlier than the present date. In the Guide Star Catalog2 (GSC2), the equinox is J2000 while the epoch depends on the individual plate. It is not necessary to adjust your coordinates to be those that would be measured if the plate were taken in the year 2000. However, some catalogs contain coordinates already adjusted to an epoch of 2000: the Hipparcos Input Catalogue (in cases where the star was known to have a proper motion at the time the catalog was generated; often used in the GSC2 for stars brighter than m(V) ~= 9) and the PPM Star Catalog. When these catalogs are being used, it is appropriate to specify an epoch of J2000. (These remarks do not apply to the Hipparcos Output Catalog.)
- ANNUAL PARALLAX: The unit for parallax is arcsec/year.
The example below is for the object DM–9D697 (Epsilon Eridani), where the proper motion data are taken from the SAO Catalog.
Proper Motion in RA
PROPER MOTION DEC
Proper Motion in Dec
Epoch of Position
20yy.y or 19yy.y
Developer note: The units for RA PM and Dec PM should be arcseconds/year in the fixed target table of the database.
Any additional information that you wish to enter can be entered in COMMENTS area. Comments are not interpreted by the software, but are maintained in the data base and do appear in the PDF output.
February 28, 2023
- PROPINSTJWST-91555 Updated text entry constraints in the NAME IN THE PROPOSAL section.
December 21, 2022
- PROPINSTJWST-91559 Rewrote Background Targets section to document removal of constraints, and generally improve wording.
Version 8 (April 27, 2021)
- PROPINSTJWST-89165 Removed Solar System category from Table 1..
- PROPINSTJWST-89165 Removed Table 4 (Solar System keywords) in the Target Descriptions article.
- PROPINSTJWST-91464 Added MIRI Coronagraphic template to Background Targets section.
Version 7 (April 16, 2019)
- Editorial change (moved change log to main article)
Version 6 (April 3, 2018)
- Editorial change (fixed bad links)
Version 5 (December 28, 2017)
- PR 82799 and PR 83416 - added description of background targets
Version 4 (October 9, 2017)
- PR 83610 - added Extended parameter
Version 3 (May 11, 2017)
- Updated Target Description to only support 5 values.
Version 2 (October 6, 2016)
- PR 85913 and PR 63771 - rewrote the Target Description section
- PR 85608 - remove text on target flux and ETC Run number
Version 1 (June 16, 2016)
This is the converted Word File from Chapter 3.