the JWST user documentation is under development; current versions are preliminary and subject to revision.

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content Layer
id277319515
Content Column
id277319517
Content Block
overflowauto
nameSummary
id277319516

This article provides instructions for filling out the JWST NIRISS Wide Field Slitless Spectroscopy APT template.

Content Block
overflowauto
nameContent
id277805920

Introduction

Wide Field Slitless Spectroscopy (WFSS) is one of four observing modes available with the Near Infrared Imager and Slitless Spectrograph (NIRISS). The WFSS mode is used for low-resolution (R ≈ 150) multi-object spectroscopy of sources over the full 2.2' × 2.2' NIRISS field of view. This mode uses a pair of identical grisms (GR150R, GR150C) that are mounted orthogonally to each other in the Filter Wheel and cover the wavelength range from 0.8 to 2.2 μm. The relative dispersion directions are perpendicular to each other, allowing blended spectra to be disentangled in crowded fields. Individual WFSS grism exposures are performed with a filter in the Pupil Wheel (PW) to: (1) select the wavelength range of interest, and (2) reduce blending spectra in different wavelength regions from objects throughout the field. Obtaining spectral coverage across the full 0.8 — 2.2 μm bandpass requires separate exposures in the adjacent filters.

Each WFSS observation will consist of one or more Exposures in APT that include: 1) direct imaging and 2) dithered grism exposures using the same PW filter as the direct image. The direct imaging enables identification of objects in the grism image and calibration of the absolute wavelength zeropoint for grism spectra of each object in the field. One direct image will be taken at the first dither position and a final one at the last dither position. Since the NIRISS point spread function (PSF) is under-sampled over the WFSS wavelength range, dithering will be required for WFSS observations. 

The observer will have control over 3 primary parameters for NIRISS WFSS: 1) filter for direct and grism images, 2) dithering pattern, and 3) detector readout mode and exposure time (via the number of groups and integrations). Allowed values are documented in the NIRISS WFSS Template parameters page.

Step-by-Step APT Instructions

Multiexcerpt include
MultiExcerptNamegeneric
PageWithExcerptMIRI Imaging Template APT Guide

Science Observation

Anchor
NIRISS_WFSS_DITHER
NIRISS_WFSS_DITHER
Dither

        Main Article: NIRISS WFSS Dithers
       
 See Also: NIRISS Dithers 

Choose the NIRISS WFSS dither pattern. The dither offsets are large enough to ensure that a compact source does not fall on the same pixel twice, but not so large as to be affected by distortion across the detector.

Specify:

  • IMAGE DITHERS: number of steps, where the first step corresponds to initial pointing; allowed values are 2, 3, 4, 6, 8, 12, 16
  • PATTERN SIZE: amplitude of dither step; allowed values are SMALL (≈0.3")MEDIUM (≈0.6")and LARGE (≈1.2")

Anchor
NIRISS_WFSS_SEQ
NIRISS_WFSS_SEQ
Sequences

        Main Article: NIRISS Wide Field Slitless Spectroscopy
       
See Also: NIRISS GR150 Grisms, NIRISS Filters, NIRISS Detector Readout Patterns 

Specify:

  • GRISM: GR150RGR150CBOTH
  • FILTERF090WF115WF140MF150WF158MF200W
  • READOUT PATTERN
    • NISRAPID: all frames are read and stored. Generally this can be used if the number of frames per integration is small and the data volume is not an issue. There is a limit of 30 on the number of groups per ramp in NISRAPID read out.
    • NIS: four frames are coadded per group. Used for producing a lower data rate for longer integrations of faint targets.
  • NO. OF GROUPSthe number of groups during an integration, equal to the number of frames read per integration (for NISRAPID), or the number of frames read out divided by 4 (for NIS).
  • NO. OF INTEGRATIONS:  the number of integrations during an exposure, where an integration is the time between detector resets.

The Exposure Time Calculator (ETC) should be used to determine the combination of NO. OF GROUPS and NO. OF INTEGRATIONS necessary to achieve the required signal-to-noise.

To take observations in different filters, Add additional observations and specify the appropriate filter. This option will by default add a corresponding direct image for the new grism observation in the Direct Image Exposure Parameters dialog box.

Direct Image Exposure Parameters

A direct image will be taken before and after each set of dithered grism observations. In the case where both grisms are used with the same filter, two direct images are taken when switching between grisms, one at the dither position of the last exposure from the first set and another at the dither position of the first exposure from the second set.

Anchor
NIRISS_WFSS_IMAGE
NIRISS_WFSS_IMAGE
Direct Images

        Main Article: NIRISS Imaging
         See Also: NIRISS Detector Readout Patterns  

Specify choice of the following parameters, whose meanings are identical to the descriptions above:

  • READOUT PATTERN: NIS, NISRAPID
  • NO. OF GROUPS
  • NO. OF INTEGRATIONS

The FILTER of the direct image will by default match the FILTER specified for the corresponding grism image in Science Observation

All Exposures Display

Anchor
NIRISS_WFSS_EXP
NIRISS_WFSS_EXP
Exposures

The All Exposures Display dialog box will show the sequence of observations for each science observation specified in the Science Observation dialog box. If BOTH grisms are selected in the Science Observation dialog box, the exposure sequence for that observation will be DIRECT → N × GRISM → 2 × DIRECT → N × GRISM → DIRECT, where all exposures in this sequence will have the same exposure number and N refers to the number of dithered grism exposures as specified in the IMAGE DITHERS parameter. Note: fields can not be edited in the All Exposures Display dialog box, but must be edited in the Science Observation and Direct Image Exposure Parameters dialog boxes. Changes to these parameters will be propagated to All Exposures Display.

 


Other Tabs

Mosaic Properties

The NIRISS WFSS mode can be used to obtain data for a region larger than the field-of-view by creating a mosaic pattern. Visit the Mosaic Parameters page for information on setting up a mosaic.

Special Requirements

A variety of observatory level special requirements may be chosen.

Content Block
overflowauto
nameRelated links
id280628021

Related links

Near Infrared Imager and Slitless Spectrograph, NIRISS

NIRISS Overview

NIRISS Wide Field Slitless Spectroscopy

NIRISS Imaging

NIRISS Pupil and Filter Wheels

NIRISS GR150 Grisms

NIRISS Filters

NIRISS Dithers

NIRISS WFSS Dithers

NIRISS Detector Readout

NIRISS Detector Readout Patterns

NIRISS WFSS Sensitivity

NIRISS Imaging Sensitivity

JWST Astronomers Proposal Tool, APT

NIRISS WFSS Template Parameters

JWST Exposure Time Calculator, ETC

Content Block
overflowauto
nameReferences
id281944791

References

JWST technical documents

Content Column
id277319512
Content Block
overflowauto
nameIcon
id277319513

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

Published May 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
UpdatedMay 1, 2017
Open commentsNo
TeamAPT NIRISS
AuthorLa Massa
Page properties
idlayout
UpdatedMay 1, 2017
Fix pageNo
Type-
Teameditors