Page tree

Versions Compared


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


Content Block


The JWST Exposure Time Calculator (ETC) calculation is performed from the Calculations page where the user chooses the input parameters which include: (1) instrument and mode, (2) a scene containing one or more sources, (3) background model parameters, (4) instrument configuration, (5) detector setup, and (6) the strategy for calculation of the signal-to-noise. The location of the tabs where the input parameters can be provided on the Calculations page is shown in Figure 1 by the numbers in red.

Figure container
Figure title

Figure 1. Calculation page layout

titleVideo Tutorial

The video tutorial 

Multiexcerpt include
PageWithExcerptVideo Tutorials
 provides a walk-through of setting up a calculation in ETC.

Create a new ETC calculation

A new calculation may be created by two methods: selecting an instrument and mode, or copying and modifying an existing calculation. The Calculation page has instrument buttons for the JWST instruments, and each instrument button has a drop-down menu with all the modes offered for that instrument. Selecting an instrument and the mode immediately initiates a calculation using the default scene with default source. The new calculation can then be edited for the desired input parameters as described in the following sections. If the user wants to copy and modify an existing calculation that is provided in a sample workbook, this is accomplished by using the Copy Calculation option from the drop-down menu under Edit button at the topmost left corner. This creates an exact copy of the calculation and the user can modify the calculation by changing the input parameters as described below.

Editing an ETC calculation

To edit a calculation, select it by clicking on the row corresponding to that calculation so it is highlighted. The configuration pane is activated and the input parameters can now be modified to change the scene, backgrounds, instrument setup, detector setup, and strategy.


On the Configuration pane, click on the Scene tab. This offers a drop-down menu of all the scenes available in the scene library, which is used to specify which scene should be used for the existing calculation. Often, this is the only thing users need to manipulate on the scene tab. 

Choosing a scene automatically populates the Source tab with all the sources present in that scene. The Configuration pane provides all the same input parameters offered under the source editor of the Scenes and Sources page and can be directly modified on this pane in the Calculation page.


Remember that when a change is made to the source properties from the Configuration pane, it modifies the source in the source library on the Scenes and Sources page and affects all the calculations that use that particular source. If you are not sure you want to change the property of a given source and affect all the calculations involving that source, then go to the Scenes and Sources page, copy and modify the source and use it in the desired scene before performing the calculation.


The ETC calculations can include Background from the expected in-field zodiacal light (within the FOV) and stray light (scattered from the outside into the FOV), which is the total input sky background for a given set of celestial coordinates and optionally a specified date. The thermal self-emission of JWST will be characterized on-orbit, and currently the ETC assumes that the thermal self-emission is constant with time and pointing. The ETC can use and report a dated sky background or a non-dated sky background. When a date is specified, the ETC will use the background model generator to generate the background for the specified sky position (RA, Dec) for that date. The non-dated background offers a choice of low, medium, or high which corresponds to the 10th, 50th, or 90th percentile of the sky background over the period of visibility for that sky position. 

Instrument setup

The Instrument Setup offers the choice of filters, grisms, dispersers, and slits for the different JWST instruments. For imaging modes, the Instrument Setup has a drop-down menu with the choice of filters that can be used for the imaging calculation. For wide-field slitless spectroscopy mode available with NIRISS and NIRCam there are two drop-down menus, one for the grisms and the other for the blocking filters that are used in combination with the grism. The MIRI MRS  mode has options for choosing the channel and disperser. The NIRSpec IFU calculations require the grating/filter pair to be selected. The NIRSpec MSA setup is specified by choosing the grating/filter pair, slitlet shape, and MSA location.  The NIRSpec fixed slit requires the grating/filter pair and slit to be selected. For spectroscopy modes that do not require a blocking filter, only a menu for the disperser is provided (eg; NIRISS SOSS, MIRI LRS).

Detector setup

The Detector Setup allows the user to specify the following parameters: subarray configuration, readout pattern, number of groups, number of integrations, and number of exposures. All of these parameters control the exposure time and photon-collecting duration.

titleHelpful Tips

All JWST detectors integrate using MULTIACCUM readout, which consists of "up-the-ramp" sampling.

  • Groups per integration = number of groups in an integration (each group can have a number of frames that may be averaged, depending on readout pattern)

    A group consists of one or more consecutively read frames with no intervening resets. Frame is the result of sequentially clocking and digitizing all pixels in a rectangular area of a sensor chip assembly (SCA). 

  • Integrations per exposure = number of integrations in a single exposure

    An Integration is the end result of resetting the detector and then non-destructively sampling it one or more times over a finite period of time before resetting the detector again. This is a unit of data for which signal is proportional to intensity, and it consists of one or more GROUPS.

  • Exposures per specification = number of exposures

    The end result of one or more INTEGRATIONS over a finite period of time. EXPOSURE defines the contents of a single FITS file.

Multiexcerpt include
PageWithExcerptJWST ETC to APT Interface Support Information

For subtle interface differences, please visit the JWST ETC to APT Interface Support article.


As mentioned above, the ETC does not support single-group (Ngroups = 1) readout modes.


The Strategy tab is where the user defines the extraction parameters for the source flux and for the background to be used for background subtraction. There are different strategies implemented depending on the mode, for example, imaging, slit spectroscopy, slitless spectroscopy, and coronagraphy.

In general terms, the strategy defines the location of the aperture for extracting the source flux, and the size of the aperture. There is also an option to define a region for extracting the background flux if background subtraction is required. The background in the region defined for background flux extraction will include the sky background as well as any other flux from nearby overlapping sources that contribute to the defined background region. For the IFU modes the background is estimated by using the IFU Nod off scene option.

If a background region is not specified, then a noiseless sky background is subtracted from the source aperture. The total sky background includes the contribution to the FOV from the in-field zodiacal light and the stray light from outside that is scattered into the FOV. 

Running the edited ETC calculation

After all the above mentioned parameters have been set, the calculation is performed by clicking on the Calculate button. If the sources used in the newly created calculation are included in other existing calculations, then all of those calculations will be run simultaneously. If the user wants to delete a calculation, there is a Delete Calculation option available in the drop-down menu under Edit button at the topmost left corner. There is also an option to delete multiple calculations at once by choosing Delete Marked Calculations. Once the calculation is completed the results may be viewed in the Images pane, Plots pane, and the Reports pane.