NIRISS Generic Recommended Strategies

Generic recommendations for crafting a NIRISS observing program are presented that are applicable to multiple NIRISS observing modes.

On this page

See also: JWST Near Infrared Imager and Slitless SpectrographNIRISS Observing Modes

JWST's Near Infrared Imager and Slitless Spectrograph (NIRISS) has observing modes for imaging, low-resolution wide field grism spectroscopy, single object grism spectroscopy, and high spatial resolution imaging using aperture masking interferometry.

NIRISS has 4 observing modes with unique capabilities for imaging and spectroscopy that correspond to templates in the Astronomer's Proposal Tool (APT):

  • Wide field slitless spectroscopy (0.8–2.2μm) over a 2.2' × 2.2' field of view using 2 identical orthogonal grisms with R = λ/Δλ = 150;
  • Single object slitless spectroscopy (0.6–2.8μm) for bright targets in 2 cross-dispersed orders using the R = λ/Δλ = 700 grism, optimized for time-series observations (TSOs);
  • Aperture masking interferometry which offers the highest spatial resolution imaging on JWST, using a non-redundant mask (NRM), reaching a contrast of 10-4  for separations of 70–400 mas;
  • Imaging (0.8–5.0μm) over a 2.2' × 2.2' field of view with pixel scale ~0.066"/pixel.

Advice is offered below to guide the user in choosing observing parameters for a NIRISS program.

Choosing between NIS and NISRAPID readout patterns

See also: NIRISS Detector Readout Patterns

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

NIRISS offers two readout patterns: NISRAPID, where each frame is read out, and NIS, where 4 frames are averaged together. The use of NIS readout is recommended if the individual exposures are longer than about 300 s. Note that when using the NISRAPID readout mode, there is a limit of 30 groups in an integration.

While the Astronomer's Proposal Tool (APT) allows up to 200 groups for the NIS readout pattern, it is recommended to limit the number of NIS groups to 25 to mitigate cosmic ray hits on the detector. Note that the dark calibration reference files are only available up to 30 NIS groups in an integration ramp, so any observing programs with data exceeding 30 groups per integration will not have a dark signal correction applied in the pipeline reduction.

When using NIRISS in a coordinated parallel mode with another instrument as the primary mode, the NISRAPID readout pattern is recommended  when the exposures of the primary instrument are relatively short to ensure that the best frame sampling is obtained in the parallel observations. In particular, if the NIRISS observations are in parallel to NIRCam BRIGHT1 or BRIGHT2 observations, the best choice is to use a NISRAPID readout for NIRISS and match the integration time to the primary NIRCam integrations.

Dithering recommendations

See also: NIRISS DithersNIRISS Ghosts

Dithering is required for the NIRISS Wide Field Slitless Spectroscopy (WFSS) mode and imaging mode, is discouraged for the Aperture Masking Interferometry (AMI) mode, and is not allowed for the Single Object Slitless Spectroscopy (SOSS) mode. For the WFSS and imaging observing modes, the choice of dither step size and number of steps can improve removal of artifacts from ghosts and cosmic rays. 

If the target field is expected to have a large number of bright sources, ghosts from the sources could potentially impact data quality. In this case, a LARGE dither step size may be preferable to help remove ghosts in the final combined spectral product. Four is the minimum number of recommended dither steps to mitigate detector artifacts, cosmic ray hits, and improve PSF sampling, though fewer steps should be considered if 4 dithers increases the exposure time too much or results in integration ramps with NGroups ≤ 3. 

Additional information for consideration when choosing a dither pattern for WFSS observations is provided in the NIRISS WFSS Recommended Strategies article. More detailed advice and metrics for selecting the most appropriate dither pattern for a particular science goal is given in the report NIRISS Dither Patterns for the WFSS and Imaging Observing modes.

Beware the imprint of occulting spots 

The NIRISS pick-off mirror has 4 coronagraphic occulters engraved on its surface which projects circular spots with diameters of 0.58", 0.75", 1.5", and 2.0" (approximately 9, 11, 23, and 31 pixels, respectively) located about 11" from the top of the detector. The projection of the detector on the observing field, and thus the exact location of the spots, depends on the PA_V3 orientation of the spacecraft at the time of observation. The MEDIUM and LARGE dither step sizes are sufficient to move a source over the smaller 2 spots but not enough to fully cover the larger 2 spots. There will be a very small region that is not covered by the LARGE 4-point dither pattern.

Though the risk of a source overlapping one of these spots is relatively small, if there is a particular target of interest in the field-of-view when using full frame readout, it may be desirable to position the field center so that the target(s) do not fall within ~11" of the detector edges.

Minimizing the effect of snowballs on image quality

See also: Snowballs and Shower Artifacts

Snowballs are cosmic ray impacts that can affect up to hundreds of pixels on a near-infrared detector. Though these features are generally removed by the JWST data reduction pipeline during the calwebb_detector1 stage, they can be imprinted in the "_*rate.fits" or "_*rateints.fits" images when using the NIS readout pattern, but not when using the NISRAPID readout pattern. The snowballs are removed in the files processed through the calwebb_image2 or calwebb_spec2d stages of the pipeline when 4 or more dithers are used.

To mitigate the impact of snowballs on data quality, it is recommended to use at least 4 dither positions when using the imaging or WFSS observing modes with the NIS readout pattern. For modes where dithering is not allowed (SOSS) or discouraged (AMI), the NISRAPID readout pattern is recommended to minimize the effect of snowballs, though there is a limit of 30 groups in an integration when using NISRAPID. Longer exposures can be achieved by increasing the number of integrations.

Designing an efficient science program with multiple filters 

See also: NIRISS Pupil and Filter Wheels

When designing a program that uses multiple filters, users should be aware that overheads are associated with each mechanism move. To design an efficient observing program, it is recommended to select filters in sequential order in the pupil wheel or filter wheel, as illustrated in Figure 2.

Figure 1. Layout of optical elements in the pupil filter and filter wheel

Layout of the NIRISS Pupil Wheel and Filter Wheel

Schematic diagram showing the layout of optical elements in the pupil wheel (left) and filter wheel (right). To design an efficient  observing program, it is recommended to choose filters in sequential order when multiple  filters are used.


Goudfrooij, P., 2015, JWST-STScI-004466
NIRISS Dither Patterns for the WFSS and Imaging Observing modes

Latest updates
    Added information on mitigating snowball artifacts
Originally published