NIRCam Grism Time-Series APT Template
Instructions for designing JWST NIRCam grism time-series observations using APT, the Astronomer's Proposal Tool, are provided in this article.
On this page
See also: NIRCam Grism Time Series, JWST Time-Series Observations Roadmap, NIRCam Time-Series Observation Recommended Strategies, NIRCam Grism Time-Series Observations of GJ 436b
Grism time series is one of the 5 NIRCam observing modes and one of 2 NIRCam time-series observing modes. Each mode has a corresponding template in APT for users to design their observing programs.
This mode uses the NIRCam grisms for long wavelength observations (2.4–5.0 µm) and weak lenses for short wavelength observations (0.6–2.3 µm) obtained simultaneously.
No telescope moves (dithering nor mosaics) are allowed during NIRCam time-series observations.
Lists of allowed values for each input parameter are documented and maintained in the NIRCam Grism Time-Series Imaging Template Parameters article.
Step-by-step APT instructions are provided below.
Generic parameters
Words in bold are GUI menus/
panels or data software packages;
bold italics are buttons in GUI
tools or package parameters.
NIRCam Grism Time Series tab
Target Acquisition Parameters
Target ACQ
See also: NIRCam Grism Time-Series Target Acquisition, JWST ETC NIRCam Target Acquisition
Users can opt to do target acquisition on the science target or a nearby object. Target acquisition occurs with a 32 × 32 pixel subarray on the long wavelength channel of module A located near the grism field positions.
A target acquisition object other than the science target should be defined in the Targets form in order for it to appear in the Target Acq pulldown menu. If the science target is used for target acquisition, set the Target Acq field to Same Target as Observation.
Available filters for target acquisition are F335M and F405N. The F405N filter is used to perform target acquisition on bright science targets that would saturate if observed with the F335M filter.
Acq Exposure Time
Acq Readout Pattern: The NIRCam detectors are read out continuously using readout patterns. Patterns with longer exposure times typically average more frames to reduce data volume (which is less of a concern for subarrays).
Acq Groups/Int: This value is the number of groups to include during an integration. Each group results in a saved image, which may be averaged from multiple frames (reads), depending on the readout pattern.
Only one integration per exposure is permitted.
Thus the exposure time and integration time are equal.
Grism Time Series Parameters
See also: NIRCam Modules
Note: module A is used for this observing mode.
Subarray
See also: NIRCam Detector Subarrays
Users may opt to either read out 3 detectors completely or more quickly read out 3 smaller detector subarrays. Smaller subarrays allow for brighter saturation limits in each integration.
The grism time-series subarrays span all detector columns and either some or all rows. The same numbers of pixels are read out from all subarrays, so each short wavelength subarray covers a quarter the area on the sky compared to the long wavelength subarray. When a subset of rows are selected, subarrays are defined in 2 short wavelength detectors to overlap and be centered vertically within the long wavelength subarray's footprint on the sky.
Note the weak lenses WLP4 and WLP8 produce defocused images roughly 66 and 140 pixels across, respectively. Therefore, WLP8 images would be significantly truncated by the smallest subarray SUBGRISM64.
Table 1. Subarray characteristics for NIRCam grism time series
Grism subarray | Size in pixels (each detector) Nrows × Ncolumns | Short-wavelength FOV | Long-wavelength FOV | Frame time (s) | No. of output channels |
---|---|---|---|---|---|
FULL | 2048 × 2048 | 64" × (2 x 64" with 4"–5" gaps) | 129" × 129" | 42.23000 10.73677 | 1 4 |
SUBGRISM256 | 256 × 2048 | 8.1" × (2 x 64" with 4"–5" gaps) | 16.6" × 129" | 5.31480 | 1 4 |
SUBGRISM128 | 128 × 2048 | 4.1" × (2 x 64" with 4"–5" gaps) | 8.1" × 129" | 2.67800 0.67597 | 1 4 |
SUBGRISM64 | 64 × 2048 | 2.0" × (2 x 64" with 4"–5" gaps) | 4.0" × 129" | 1.35960 0.34061 | 1 4 |
Number of output channels
See also: NIRCam Detector Readout, JWST Data Volume and Data Excess
The detectors may be read out through a single output channel or more quickly through 4 output channels simultaneously. The latter produces roughly 4 times as much data for a given exposure time. (Put another way, for a given set of exposure parameters which produces a given data volume, the exposure time is roughly 4 times higher when using a single output channel instead of 4.) Data rates and data volumes are limited somewhat by APT; tighter limitations may be required to facilitate scheduling (see Data Volume Limitations).
Number of exposures
Multiple exposures may be performed in sequence to increase the total exposure time. Each exposure is executed as defined in the remaining sections below.
In APT, this section is named Exposures/Dith (exposures per dither) for consistency with other observing modes, even though no dithering is allowed in this mode.
Short pupil + filter
Two weak lenses are available in this mode for short wavelength observations—one or the other must be used:
- WLP8 (8 waves of defocus at 2.12 µm)
- WLP4 + F212N2 (4 waves of defocus at 2.12 µm; coupled to a 2.12 µm narrowband filter with a 2.3% bandpass)
The weak lenses defocus incoming light, mitigating uncertainties (jitter and flat fields) and allowing for observations of brighter objects before saturation in a given integration time.
WLP8 is located in the pupil wheel and must be used in combination with a medium- or narrowband filter.
WLP4 is joined with a narrowband filter F212N2 in the filter wheel. F212N2 has a 2.3% bandpass, wider than the 1% bandpass F212N filter. WLP4 + F212N2 is used in combination with the CLEAR filter in the pupil wheel.
Short wavelength pupil wheel | Short wavelength filter wheel |
---|---|
WLP8 | F070W, F0140, F182M, F187N, F210M, or F212N |
CLEAR | WLP4 + F212N2 |
Long pupil + filter
The row dispersion grism GRISMR (in the pupil wheel) is used in combination with a wide long wavelength filter (in the filter wheel): F277W, F322W2, F356W, or F444W. See NIRCam Grism Time Series for more details.
Exposure time
See also: Understanding JWST Exposure Times
Each exposure is defined as a Readout Pattern, number of groups (Groups/Int), and number of integrations (Integrations/Exp). The resulting Total Exposure Time is reported. This readout configuration applies to both wavelength channels (short and long); the observations are obtained simultaneously using a dichroic.
Users should consult the Exposure Time Calculator (ETC) to achieve a sufficient signal-to-noise ratio for their science without saturating during each integration. Approximate saturation limits may be found in the NIRCam Grism Time Series article.
Each group yields saved data. Each integration accumulates charge for its duration, preceded and followed by detector resets. Shorter integrations may prevent saturation. Saturated sources may be recovered (unsaturated) in earlier groups during the integration.
Each exposure is performed without moving the telescope nor any mechanisms, with one exception; exposures of more than 10,000 s are permitted in this observing mode, but users are warned that the high gain antenna may need to move during a longer exposure. That movement has an impact on pointing stability lasting approximately 60 s during which light curve scatter can be increased. An analysis of commissioning data indicates that the target location on the detector is restored to 1 mas following an HGA move Schlawin et al. (2022).
Other tabs
Special Requirements
A variety of observatory level Special Requirements may be chosen under the Special Requirements tab.
When NIRCam is used in the time-series mode, two special requirements are automatically included and required: Time Series Observation and No Parallel. Users are encouraged to determine Phase limits by making use of the ExoCTK's Phase Constraint Calculator.
Mosaics are not available for NIRCam time-series imaging.
Comments
The Comments field (under the Comments tab) should be used for observing notes.