NIRISS Target Acquisition

An onboard target acquisition (TAs) positions a source with subpixel accuracy on a specific location on the detector. 

On this page

TAs are supported for 2 NIRISS observing modes: single object slitless spectroscopy (SOSS) and aperture masking interferometry (AMI). While a TA is only required for those observing modes when a subarray is used, it is also strongly recommended for the full frame detector readout to ensure that the target is always placed on the same detector pixel.

Target acquisition procedure

Steps in the NIRISS TA procedure are described below:

  1. The target is located: 
    1. Three 64 × 64 pixel subarray exposures are taken; images are offset from each other (dithered) by a small integer pixel in X and Y to allow for removal of bad pixels. 
    2. Onboard TA software processes the images (aligns the images, flags bad pixels, removes cosmic rays, and subtracts the background level) and applies a centroiding algorithm to determine the target coordinates (see Target location algorithm below). 
  2. The spacecraft is moved to place the target at the nominal center of the TA subarray being used, which is listed in onboard tables. 
  3. The target is re-imaged with a single (undithered) exposure. This is the so-called "TA verification" exposure.
  4. If the observing mode is AMI, the spacecraft is moved to the science aperture which is located on a separate (but nearby) subarray. This is done to avoid any persistence from the TA images. (This step is not performed for the SOSS observing mode, for which the spectra are projected onto a different location on the detector, so that the telescope does not have to be moved.)

A TA exposure sequence produces scientific data—images of the target produced in steps 1 and 3. These data will be returned to the observer along with the other science data.

Target location algorithm

To locate the target, the onboard software first passes a square checkbox of 3 × 3 pixels (0.196 × 0.196 arcsec2) over the TA subarray image and determines the intensity contained within the checkbox at each pixel in the subarray. The software then selects the checkbox with the maximum intensity and determines the flux-weighted centroid of the target using a 5 × 5 pixel window centered on that checkbox (see Figure 1 below).  

Figure 1. Illustration of target location algorithm

Illustration of Target Location procedure

Generally, the TA will be performed on the science target of the observation, though it is allowed to perform the TA on an object within 30"–80" of the science target (where the exact maximum distance depends on Galactic latitude).

Target acquisition modes

See also: NIRISS Non-Redundant Mask, NIRISS Pupil and Filter Wheels

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

TAs are performed with either the CLEARP or non-redundant mask (NRM) element in the pupil wheel and the F480M filter in the filter wheel. In general, the CLEARP element is used for faint TA targets while the NRM element, which limits throughput to 15% of the CLEARP element, is used for bright targets. Another important difference between the CLEARP and NRM elements is that they sample the telescope pupil differently. Table 1 lists the target magnitude ranges recommended for the various TA observing modes, accounting for both target brightness and pupil sampling.

Table 1. Recommended magnitude ranges for NIRISS TA Modes

TA modePW element

Target magnitude
(Vega mag)


2.9 ≤ M ≤ 6.0


6.0 ≤ M ≤ 14.4


2.9 ≤ M ≤ 9.2


9.2 ≤ M ≤ 14.4

A TA exposure time, one that achieves a signal-to-noise ratio (SNR) of at least 30, is best determined using the Exposure Time Calculator (ETC). This enables a centroid accuracy of ≤0.15 pixel. However, increasing the TA exposure time to get a higher SNR should be considered while planning observations for which accurate centroiding is deemed crucial. For example, the centroiding accuracy improves to about ≤0.10 pixel at SNR = 50 and to about ≤0.05 pixel at SNR = 100. More information on the use of the NIRISS TA ETC is given in the JWST ETC NIRISS Target Acquisition article.

The WISE W2 magnitude should be used as the M magnitude in Table 1 above. If there is no WISE W2 magnitude available for the target acquisition source, then other M-band magnitudes (e.g., Spitzer 4.5 µm photometry) can be used. If that is unavailable, then the WISE W1 magnitude can be used. If the source is not detected by WISE in either the W1 or W2 band and there is no Spitzer 4.5 µm data, then the M band magnitude can be estimated via K band photometry, using Table 2 or Figure 2 for lower mass, cooler stars.

Table 2. K-M colors to estimate M magnitude from K band photometry

Spectral Type



K-W1K-W2Spectral Type




Figure 2. Ks-W2 vs Ks-W1 color plots to estimate M band magnitudes from K band photometry

Density of points plot for the observed 2MASS/WISE colours of stars at galactic latitude > 20°  with good quality WISE photometry (<0.03 magnitude uncertainties). The red points are predicted colors from the Phoenix NextGen models of France Allard from 10,000 K down to 2,000 K with log(g) = 5.5 and solar metallicity, and are the values given in Table 2. This metallicity gives the best match to the observed colours for the cooler stars in these models. 


Allard, F. & Freytag, B., 2011, ASPC, 448, 91
Model Atmospheres From Very Low Mass Stars to Brown Dwarfs

Goudfrooij, P., 2017, JWST-STScI-005934
NIRISS Target Acquisition: the sensitivity of centroid accuracy to the presence of saturated pixels

Notable updates
    Updated TA magnitude limits to reflect in-flight performance

    Added details about how to estimate M band magnitude for TA SNR calculations.

    Table 1 updated
Originally published