NIRCam Imaging APT Template

Instructions for designing JWST NIRCam imaging observations using APT, the Astronomer's Proposal Tool, are provided in this article.

On this page

See also: NIRCam ImagingImaging RoadmapNIRCam Imaging Recommended StrategiesNIRCam Deep Field Imaging with MIRI Imaging ParallelsNIRCam Parallel Imaging and NIRISS WFSS of Galaxies in Lensing Clusters

Imaging is one of the 5 NIRCam observing modes. Each mode has a corresponding template in the Astronomers Proposal Tool, APT, for users to design their observing programs. Step-by-step APT instructions for NIRCam imaging are given below. Complete listings of allowed values are documented in the NIRCam Imaging Template parameters page.



Generic parameters

Words in bold are GUI menus/
panels or data software packages; 
bold italics are buttons in GUI
tools or package parameters.

The following parameters are generic to all templates, and are not discussed in this article: observation Number, observation Labelobservations CommentsTarget name, ETC Wkbk. Calc ID (in the Filters dialog box), Mosaic Properties, and Special Requirements.


After selecting Template: NIRCam Imaging, the Coordinated Parallel checkbox appears on the form.

Coordinated Parallel checkbox

See also: JWST Parallel Observations

NIRCam imaging supports coordinated parallel observations with MIRI or NIRISS. When the Coordinated Parallel checkbox is checked, one of these 3 parameter values can be selected:

  1. NIRCam-MIRI Imaging
  2. NIRCam-NIRISS Imaging
  3. NIRCam Imaging-NIRISS WFSS

Note that the default option is None Selected.


The lower part of the form, following the diagnostic boxes about Visit Splitting, Duration, and Data Volume, presents 4 tabs for detailed observation parameters. They are described below. 



NIRCam Imaging tab

Module

See also: NIRCam Modules

Under the NIRCam Imaging tab, set Module to ALL to observe with both NIRCam modules, returning data from the full field of view using all 10 detectors. To obtain data from only a single module or smaller detector subarrays, select Module B.

Subarray

See also: NIRCam Detector Subarrays

When using module ALL, all 10 detectors are completely read out and Subarray is set to FULL by default. 

When using module B, users may opt to either read out all 5 detectors completely (FULL) or one of the 7 smaller detector subarrays. Subarrays are read out more quickly than the full detector, providing brighter saturation limits for a given number of reads and smaller data volume (see below). The locations of the subarrays cannot be changed; they are shown in Figure 1 and listed in Table 1.

The 3 central subarrays, SUB160, SUB320 and SUB640, are designed for bright extended sources (e.g., Jupiter or large star-formation regions). They return data from the 4 short wavelength detectors and the long wavelength detector of module B, with similar combined areas on the sky. Note that there are gaps in field coverage for the short wavelength channel; these gaps can be filled with dithering or mosaics (see below).

The 3 corner subarrays, SUB64P, SUB160P and SUB400P,  are designed for small objects (subarray names are postfixed with "P" for point source) and return data from just 2 detectors, B1 for the short wavelength and B5 for the long wavelength channel. 

A 7th subarray, FULLP, covers the full area of B1 and B5, with the target placed in the upper right region where image quality and detector response are expected to be optimal. 

Figure 1. NIRCam detectors and imaging subarrays

Layout in the NIRCam field of view of the 10 detectors and module B subarrays. The short and long wavelength channels are shown in blue and red, respectively. Note each long wavelength subarray covers 4 times the area as the corresponding short wavelength subarray with the same number of pixels, because the short wavelength pixels deliver twice the spatial resolution along each axis.

Note that the short and long wavelength SUB64P subarrays and the short wavelength SUB160P subarrays have been moved slightly downwards on the detector. See NIRCam Subarray Primary Dithers.


Table 1. Imaging subarrays

Imaging
subarray
Size in pixels
Nrows × Ncolumns

Short wavelength FOV

Long wavelength FOV

Frame time

(s)

Noutputs

Reset rows

FULL

4 × 2048 × 2048 (SW)
 2048 × 2048 (LW)

4 × 64" × 64" + 4" to 5" gap128" × 128"10.736774
SUB640

4 ×  640 × 640 (SW)
640 × 640 (LW)

4 × 20" × 20" + 4" to 5" gap40" × 40"4.1858412048
SUB320

4 ×  320 × 320 (SW)
320 × 320 (LW)

4 × 10" ×  10" + 4" to 5" gap20" × 20"1.0690412048
SUB160

4 ×  160 × 160 (SW)
160 × 160 (LW)

4 × 5" × 5" + 4" to 5" gap10" × 10"0.278641512
FULLP2048 × 204864" × 64"128" × 128"10.736774
SUB400P400 × 40012.5" × 12.5"25" × 25"1.6562412048
SUB160P160 × 1605" × 5"10" × 10"0.278641512
SUB64P64 × 642" × 2"4" × 4"0.050161256

Subarrays ending in "P" are intended for point source imaging. They use only a single detector B1 in the short wavelength channel, in addition to the long wavelength detector B5. FULLP, added in APT 2021.2, exploits the full area of a single SW detector (B1) and the whole LW detector (B5), with the target placed in the upper right region where image quality and detector response are expected to be optimal.

The other non-"P" subarrays are intended for extended sources and use all 4 short wavelength detectors; the resulting images include 4"–5" gaps along the center of both axes.

Target Placement

See also: NIRCam Apertures, NIRCam Imaging Recommended Strategies

When observing with both NIRCam modules (Module = ALL), the science target may be centered at the following locations defined by Target Placement:

  • Module Gap (default) – centered in the ~44” gap between the modules in the field of view
  • A Short (on A3) – near the center of module A and the corner of the A3 detector
  • B Short (on B4) – near the center of module B and the corner of the B4 detector

These locations are shown on NIRCam Apertures and designated ALL, As, and Bs, respectively. The pointing may be tweaked by combining with a special requirement Offset.

Dither Parameters

Dithering (taking multiple exposures with shifted overlapping pointings) is required for NIRCam imaging. Dithering mitigates bad detector pixels, and it improves flat fielding and PSF sampling by imaging each portion of sky with different regions of the detector. Larger primary dithers and smaller subpixel dithers serve different purposes, as described below.

Primary dithers

See also: NIRCam Primary DithersNIRCam Subarray Primary DithersNIRCam Imaging Recommended Strategies: Dither pattern

Primary dithers serve to fill gaps in the field of view between the detectors and to mitigate flat field uncertainties. The primary dither patterns are optimized for different science goals (and the choice is restricted depending on the module selected). The primary dithers are labeled according to the following Primary Dither Type parameters:

  • FULL (only for Module = ALL)
    • for large field targets, large moves allow coverage of all gaps between detectors as well as the ~45" gap between modules
    • optimal for use with mosaics (tiled pointings) of larger areas, but inefficient. Because of the large telescope moves, guide star reacquisition is necessary, causing visit splitting and large overheads (see below)
    • There is a choice between 8 types of FULL primary dithers, depending on the number of telescope moves: 3, 6, 9, 15, 21, 27, 3645.
  • FULLBOX (for Module = ALL) 
    • more efficient than FULL
    • covers a rectangular field of view without gaps when performing 4 or more dithers; recommended for wide area mosaics (see below)
    • There is a choice between 8 types of FULLBOX primary dithers, depending on the number of telescope moves: 2TIGHTGAPS, 3TIGHTGAPS, 4TIGHT, 4, 5TIGHT, 6TIGHT, 6, 8NIRSPEC
  • INTRAMODULE (for Module = ALLor B)
    • for targets smaller than the field of view of a single module (<110" across)
    • covers the 5" gaps between the short wavelength detectors, but not the 44" gap between modules
    • There is a choice between 8 types of INTRAMODULE primary dithers, depending on the number of telescope moves: 3, 4, 6, 8, 12, 16
  • INTRAMODULEBOX (for Module = ALL or B)
    • covers two square regions without gaps when performing 4 dithers
    • more compact than INTRAMODULE or INTRAMODULEX , yielding more area with maximal depth
    • There is a choice between 15 types of INTRAMODULEBOX primary dithers, corresponding to any number of telescope moves between 2 and 16
  • INTRAMODULEX (for Module = ALLor B)
    • similar to INTRAMODULE, but more efficient when performing 4 or more dithers
    • Also in this case there a choice between 15 types of INTRAMODULEX primary dithers, corresponding to any number of telescope moves between 2 and 16
  • INTRASCA (for Module ALLor B)
    • compact targets that can be imaged at the 4 corners of the detector (and in between) to mitigate flat field uncertainties
    • the object size should be smaller than the the field covered by an individual detector (<50" or <100" across for short or long-wavelength observations, respectively)
    • There is a choice between 8 types of INTRASCA primary dithers, depending on the number of telescope moves: 3, 4, 5, 7, 9, 13, 17, 25
  • NONE (for Module = ALLor B) 
    • avoiding  primary dithers is only recommended if used in conjunction with appropriate mosaic or subpixel dithering (see below).

The seven Primary Dithers listed above are available when MODULE = ALL and SUBARRAY = FULL (the only choice with MODULE = ALL) are selected.


When MODULE = B is selected, regardless on the subarray used, the primary dithers FULL and FULLP are not available; however, a new Primary Dither Type is added:

  • SUBARRAY_DITHER (only for Module = B; designed primarily for SUB64P
    • allows to select on of the NIRCam subarray primary dithers, spanning about ±0.6" in each axis (x and y). Designed to ensure that sources are observed in both wavelength channels when using SUB64P
    • There is a choice between 3 types of Subarray Dithers, with Primary Dithers values of 2, 3, and 4.

When module B and subarrays smaller than the full detectors (SUB-type) are used, fewer primary dither options are available:

  • INTRASCA (for SUB640, SUB320, SUB160)—as described above, available for extended-source subarrays only
  • INTRAMODULEBOX—as described above, available for all subarrays
  • SUBARRAY_DITHER (designed primarily for SUB64P)—NIRCam subarray primary dithers, spanning about ±0.6" in each axis (x and y), were designed to ensure that sources are observed in both wavelength channels when using SUB64P
  • NONE—only recommended in conjunction with subpixel dithering (see below)


JWST offers a large range of possibilities; the user can acquire familiarity with the different options using the View in Aladin tool in APT. 

When dithering, besides field coverage, also consider the JWST slew times and overheads. Note in particular that FULL dithers always require visit splitting (new guide star acquisitions), and the associated overheads significantly decrease observing efficiency.

Dithering results in uneven depth (exposure time) across the final combined image. The INTRASCA dither patterns are especially designed to provide uniform depth (full coverage in every exposure) across a small area centered on a compact science target.

Figure 2. Example NIRCam primary dither patterns

Exposure map for dithered observations in the short wavelength channel, as produced by Aladin from APT. The labels indicate values for these parameters: Module/Subarray/Primary Dither Type/Primary Dithers, and for INTRASCA, Dither Size.

Subpixel Dither Type

See also: NIRCam Subpixel Dithers

Smaller subpixel dither patterns include subpixel shifts designed to optimally improve image sampling and resolution. This is especially useful for images with undersampled PSFs below the Nyquist wavelengths, i.e., for filters falling in the 0.6–2 µm region in the short wavelength channel and 2.4–4 µm in the long wavelength channel. Subpixel dithering is not implemented by default but may be added to an observing program by selecting, with Subpixel Dither Type  = STANDARDSubpixel Positions > 1  (up to 64).

In addition to the standard subpixel dither patterns, selecting Subpixel Dither Type = SMALL-GRID-DITHER allows users to choose more compact small grid dither (SGD) patterns. SGD patterns are executed more quickly and precisely using the fine steering mirror (FSM), i.e., without slewing the telescope. They are limited in size to 0.06" or less, and are expected to be 2 times more precise than regular subpixel dithers. The maximum number of FSM moves is 9.

When NIRCam imaging is used as prime mode in a coordinated parallel combination (when the Coordinated Parallel box is checked), additional customized subpixel dither patterns (e.g., Subpixel Dither Type = 3-POINT-WITH-MIRI-F560W) become available which work well for both NIRCam imaging and the parallel instrument mode. Still, a NIRCam-specific subpixel dither patterns can be selected by specifying NIRCam Only, which results in an additional pull-down selector NIRCam Positions that can be used to specify the number of subpixel positions.

Filters and exposures (Filters entry window)

See also: NIRCam FiltersUnderstanding JWST Exposure Times

NIRCam uses a dichroic to observe simultaneously in the short wavelength channel (0.6–2.3 µm) and long wavelength channel (2.4–5.0 µm). For each exposure, users must select 2 NIRCam filters: Short Filter and Long Filter.

The parameters setting the exposure time will be identical for both channels). The first parameter to set is one of the 9 readout patterns. The remaining parameters detail the exposure following this hierarchy:

  • Exposure—with chosen filter pair; all instruments stationary and telescope locked on target. 
    • Integrations—an exposure can contain one or more integrations. An integration starts with a detector reset
      • Groups—integrations are composed of multiple groups. These are the data transmitted to the ground. A group can correspond to one read or result from the average of multiple reads (either 2, 4 or 8).
        • Reads—a single sampling of all pixel data (either full array or subarray), taken in non-destructive mode; after a read the charge continues to accumulate, until a final reset.

These parameters are entered in the Filters window specifying 

  • Groups/int: number of groups per integration
  • Integrations/Exp: number of integrations in an exposure

The fields Total Dithers, Total Integrations, and Total Exposure Time are presented to summarize the configuration of the observation in the selected pair of filters.

Figure 3. NIRCam filters

MultiExcerpt named filter plot was not found -- Please check the page name and MultiExcerpt name used in the MultiExcerpt-Include macro

Preliminary total system throughput for each NIRCam filter. Filters marked "P" are located in the pupil wheel, requiring transmission through a second filter in the filter wheel, either F150W2, F322W2, or F444W. In these cases, the combined transmissions are plotted. Use of F150W2 on its own (with a CLEAR pupil wheel filter) is discouraged. High photometric precision will not be supported in F150W2 due to the transmission dips and the variable PSF across the wide wavelength range.

Readout patterns

See also: NIRCam Detector Readout PatternsNIRCam Imaging Recommended Strategies: Readout pattern

Use the Exposure Time Calculator (ETC) to determine which readout pattern, number of groups, and number of integrations will avoid saturation and/or achieve the signal to noise required for your science.

Multiple integrations may be most useful for brighter sources to avoid saturation. However for fainter sources, multiple dithers are generally preferable, with one integration per exposure per dither position.

Multiple groups enable "up-the-ramp" fitting to observed count rates. This facilitates cosmic ray rejection, reduces the effective read noise for the integration, and increases the dynamic range of the final image (sampling count rates of bright sources before they saturate).

The 9 readout patterns are detailed below, including integration times for full detectors, which are read out in 10.73677 s. Subarray integration times are shorter. Five group sizes are designed for short to long integrations: RAPID, BRIGHT, SHALLOW, MEDIUM, and DEEP. Based on current assumptions, RAPID, BRIGHT2, SHALLOW4, MEDIUM8, and DEEP8 are recommended as yielding higher signal to noise for faint sources  (Robberto 2009, 2010; and more recent tests with the ETC).


Table 2. NIRCam readout patterns and rounded integration times for full detectors

Readout pattern
Reads per group
Frames co-added in each group
Time of first group (s)Time of each subsequent group (s)
Groups per integration
Integration time (s)
RAPID1110.710.71–2 (Module = ALL)
1–10 (Module = B)
10.7–21.5
10.7–107
BRIGHT12110.721.51–1010.7–204
BRIGHT22221.521.52–10 (Module = ALL)
1–10 (Module = B)
42.9–215
21.5–215
SHALLOW25221.553.71–1021.5–505
SHALLOW45442.953.71–1042.9–526
MEDIUM210221.5107.41–1021.5–988
MEDIUM810885.9107.41–1085.9–1052
DEEP220221.5214.71–2021.5–4101
DEEP820885.9214.71–2085.9–4166


The RAPID pattern is limited to 2 groups per integration (to limit the data rate) when reading out the full detectors in both modules. This limit increases to 10 groups when using a single module. DEEP2 and DEEP8 allow up to 20 groups. Scroll right to view full table, if needed.



Other tabs

Mosaic Properties

See also: NIRCam Mosaics
See also:  Specifying Mosaics in APT 

Mosaics are used primarily to cover areas larger than the 5.1' × 2.2' NIRCam field of view (including the ~45" gap between modules). For NIRCam mosaics, the spatial extent of each tile is defined as 5.115033' × 2.221150' in APT. Tile overlaps as well as shifts (pattern rotation angle) may be adjusted for each axis. Primary dithers should be used in conjunction with mosaics to fill the gaps between detectors.

FULLBOX primary dithers are recommended for this purpose. If these patterns would split visits, then INTRAMODULEBOX should be considered as well.

A less efficient option is the original FULL pattern, which was designed specifically to yield roughly even observing depth over large areas with mosaics. Use FULL with mosaic tile spacings of 5.8' × 2.25', input as −13.4% column overlap and −1.3% row overlap in APT. The negative overlap leaves a gap between each tile; these gaps are filled by the FULL dither pattern. This strategy was designed by Anderson (2009) before the observing overheads were known. More efficient mosaics are possible using other dither patterns, though these provide less even depth across the field. Additional background information on principles of dithered observations with JWST are also described in Koekemoer & Lindsay (2005), Anderson (2011)Anderson (2014), and Coe (2017).

Figure 4. NIRCam mosaic examples

Examples of 3 × 3 NIRCam mosaics combined with primary dither patterns. Top: FULLBOX 6TIGHT with 0% overlap in rows and columns. Bottom: FULL 3TIGHT with –1.3% and –13.4% overlap in rows and columns, respectively. This yields relatively uniform depth across the field, at the expense of significantly higher overheads.

Special Requirements

A variety of observatory level Special Requirements may be chosen under the Special Requirements tab.

Comments

The Comments field (under the Comments tab) should be used for observing notes.



References

Anderson, J. 2009, JWST-STScI-001738
Dither Patterns for NIRCam Imaging

Anderson, J. 2011, JWST-STScI-002199
NIRCam Dithering Strategies I: A Least Squares Approach to Image Combination

Anderson, J., 2014, JWST-STScI-002473
NIRCam Dithering Strategies II: Primaries, Secondaries, and Sampling

Coe, D. 2017, JWST-STScI-005798
More Efficient NIRCam Dither Patterns

Koekemoer, A. M. & Lindsay, K. 2005, JWST-STScI-000647
An Investigation of Optimal Dither Strategies for JWST

Robberto, M., 2009, JWST-STScI-001721
NIRCAM Optimal Readout Modes

Robberto, M., 2010, JWST-STScI-002100
NIRCAM Optimal Readout II: General Case (Including Photon Noise)




Latest updates
  •  
    Added Target Placement section to document this new option available in APT 2023.1.1 
  •  
    Updated for APT 2022.7.1

  •   
    Added Subarray Primary Dithers

  •  
    Added new dither patterns available in APT 25.4.

  •  
    Clarified that Primary Dithers NONE may be recommended in some cases.
Originally published