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
meta-propertiestrue
nameSummary
id277319516

Instructions for designing JWST NIRCam grism time series observations using APT, the Astronomer's Proposal Tool.

Content Block
overflowauto
nameContent
id277805920

Introduction

Grism time series is one of the 5 NIRCam observing modes and one of two 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

Multiexcerpt include
MultiExcerptNamegeneric
PageWithExcerptMIRI Imaging Template APT Guide

Target acquisition parameters

Anchor
Target ACQ
Target ACQ
Target ACQ

Users can opt to do target acquisition on any nearby object, including the science target. Target acquisition occurs with a 32 × 32 pixel subarray on the long-wavelength channel of Module A located near the grism field positions, and uses the F335M filter. Target acquisition objects other than the science target can be defined in Targets. Choose SAME TARGET AS OBSERVATION to use the science target. 

Figure container
Figure title

Figure 1. Target acquisition location

Multiexcerpt
MultiExcerptNameNIRCam_GrTS_TA

Figure caption

Target acquisition is performed with a 32 × 32 pixel subarray (yellow square) near the bottom of the long wavelength detector A5. The grism subarrays are shown in black for long-wavelength channel. The corresponding short wavelength subarrays are not shown; they span the short wavelength detectors horizontally and are centered vertically within the long-wavelength subarrays. The target acquisition pointing is centered on the TA subarray. If any of the 3 grism subarrays is chosen, a slew places the target on one of the lower 2 yellow stars, depending on the science filter. If full-array exposures are selected, the target is positioned at one of the upper 2 yellow stars, depending on the selected filter.

Anchor
Acq Exposure Time
Acq Exposure Time
Acq exposure time

Multiexcerpt include
MultiExcerptNameTA SNR
PageWithExcerptNIRCam Coronagraphic Imaging Template APT Guide

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 (less of a concern for subarrays).

ACQ GROUPS/INT: 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.

Anchor
Time Series Parameters
Time Series Parameters
Time-series parameters

Note: Module A is used for this observing mode.

Anchor
Subarray
Subarray
Subarray

Users may opt to either read out three detectors completely or more quickly read out three 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 as the long wavelength subarray. When a subset of rows are selected, subarrays are defined in two 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 132 pixels across, respectively. Therefore, WLP8 images would be significantly truncated by the smallest subarray SUBGRISM64.

Grism
subarray
Size in pixels
Nrows × Ncolumns 
Short-wavelength
FOV
Long-wavelength 
FOV
Frame 
time (s)
No. of output channels
FULL2048 × 2048

132" (with 4"–5" gaps) × 132" (with 4"–5" gaps)

129" × 129"42.20940
10.73676
1
SUBGRISM256256 × 20488.1" × 132" (with gaps)16.6" × 129"

5.29420
1.34668

1
SUBGRISM128128 × 20484.1" × 132" (with gaps)8.3" × 129"2.65740
0.67596
1
SUBGRISM6464 × 20482.0" × 132" (with gaps)4.2" × 129"1.33900
0.34060
1

Anchor
NumberofOutputChannels
NumberofOutputChannels
Number of output channels

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

Anchor
NumberofExposures
NumberofExposures
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.

Info

In APT 25.1, this section is named "Exposures/Dith" (Exposures per Dither) for consistency with other observing modes, even though no dithering is allowed in this mode.

Anchor
ShortPupil+Filter
ShortPupil+Filter
Short pupil + filter

Two weak lenses are available in this mode for short wavelength observations, and 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 + F212N2 is located in the filter wheel and is used in combination with the CLEAR filter.

Short-wavelength pupil wheelLong-wavelength filter wheel
WLP8F182M, F187N, F210M, or F212N
CLEAR

WLP4 + F212N2

Anchor
LongPupil+Filter
LongPupil+Filter
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.

Anchor
ExposureTime
ExposureTime
Exposure time

Each exposure is defined as a readout pattern, number of groups, and number of integrations. 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 sufficient signal-to-noise for their science without saturating during each integration. Approximate saturation limits may be found at NIRCam Grism Time Series.

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 may introduce jitter and affect data quality.

 



Content Block
overflowauto
nameRelated links
id280628021
classpdf-hide

Related links

JWST User Documentation Home
NIRCam Grism Time Series
NIRCam Time-Series Observations
JWST Astronomers Proposal Tool, APT
NIRCam Grism Time Series Imaging Template Parameters
JWST Exposure Time Calculator - ETC

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
nameInstrument icon
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

Updated September 28, 2017

  • Updated the TA figure to include the FULL array field points.


Published June 1, 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
UpdatedJune 1, 2017
Open commentsNo
TeamAPT NIRCam
AuthorCoe 

Note from SG: need to review all template patterns and styles.

Page properties
idlayout
UpdatedJune 1, 2017
Fix pageYes
TypeStyle
Teameditors