NIRCam Apertures

A JWST aperture consists of a unique targetable fiducial point and its associated region, used in support of JWST science operations. Aperture definitions are stored in the Science Instrument Aperture File (SIAF, see Cox & Lallo, 2017).

Each aperture has a reference position which will generally coincide with the observed target at the first dither position, and coordinates defining the field of view (FoV) for the given instrument configuration.  While in some cases apertures coincide with physical entities in the field of view (e.g. a detector and its center, or a slit and its location), this is not always the case. Apertures can sometimes be defined to represent convenience regions. Detector-specific apertures define the reference position and subarray field of view for each detector. Compound apertures represent, in a simplified way, the overall field of view when multiple detectors are collecting data. For example, the NIRCam ALL aperture encompasses the entire NIRCam FoV, and its reference position is at the nominal center of the FoV, in the intra-modules gap, where no data are collected. In addition to their positions and extents, the SIAF appropriately defines several systems of coordinates for each aperture. These coordinates describe the FoV geometry for the given instrument configuration (see Cox & Lallo, 2017). Some types of apertures may not have all available coordinates systems defined. E.g. compound apertures, not physically bound to a single detector, do not have "det" or "sci" (detector or science) coordinates attached.

For NIRCam—for all observations and for target acquisition—the apertures in use depend on the APT observing template, Module (e.g. A, B, or ALL), and/or Subarray selected (e.g. SUB320, SUB400P), and in some cases, other APT template parameters (e.g. filter). Apertures for the Time Series and Grism Time Series templates are described in the linked articles. APT uses the relevant apertures to support visualization of observations in the Aladin tool.

SIAF uses two coordinate systems. V1, V2, V3 system is is common to all instruments and is referenced to the telescope boresight (V1) and anti-sunshield (V3) vectors. Apertures have a reference position defined in V2, V3 that is used to point at targets. Each detector and each subarray have reference positions in this system. The compound apertures also have V2, V3 reference positions. The ideal coordinate system is defined with axes parallel to detector rows (XIdl) and columns (YIdl) at the reference position on the detectors. For NIRCam, the V2 and V3 axes are nearly aligned (to ~1° of rotation) with both the ideal coordinate system at all locations in the focal plane. The ideal system is used to calculate offsets of the pointing within an observation (e.g., dither positions, mosaic tile positions, Offset special requirements). Ideal frame coordinates can be treated as a location in a tangent plane projection, with the origin defined as the given aperture's fiducial/reference position.

Representative entries are given below for the NIRCam apertures corresponding the the FULL subarrays on all 10 detectors and some subarrays. Separate tables are used for the imaging and coronagraphic imaging entries (on modules B and A, respectively). The coronagraphic field of view is in fact different from, e.g., the imaging one, and it is projected onto the detectors only when the coronagraphic pupil elements are in use.

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

The ALL aperture is used for full frame observations with both modules. It defines the full extent displayed in APT Aladin as well as for each detector and tile in a mosaic. Full frame observations with module B alone use another compound aperture, the "Bs" aperture (a.k.a BSHORT). "Bs" spans the full extent of the short wavelength detectors in module B.

The aperture coordinates have changed slightly as astrometric calibration observations have been analyzed, but are extremely accurate and expected to be quite stable. Values here are low precision and informational only. Users interested in the most up-to-date and precise data should use the PySiaf package, as outlined in the article JWST Field of View.

Figure 1. Prominent NIRCam apertures

Target reference positions ("X") and and aperture vertices (outlines) for the NIRCam detectors as well as for the subarrays assigned to the coronagraphic masks in JWST (V2, V3) coordinates. Each detector is labeled (A1–B5). Blue and red correspond to the short and long wavelength channels, respectively. The smaller squares at the top are coronagraphic apertures with mask names labeled accordingly. Note that from Cycle 2, NIRCam coronagraphic imaging is offered simultaneously on the SW and LW channels; but for simplicity, only the aperture on the channel naturally associated with each mask is displayed. For example, for the MASK 210R, optimized for 2.1 μm, the natural aperture is on the SW channel. The larger As and Bs apertures are drawn as gray dotted lines, and the ALL aperture is drawn in black dashed lines. Coordinates for all of these apertures are given in the tables below.

Tables 1–3 provide the target reference positions ("_ref") and aperture vertices (_1–4) for the NIRCam detectors (SCAs), the subarrays used for imaging, and those used for coronagraphy in JWST (V2, V3) coordinates. Tables 4 and 5 give the FULL detector aperture information in NIRCam ideal reference systems (XIdl, YIdl). 


Table 1. NIRCam apertures (reference position and four corners) for all 10 detectors, and the All, A- and B-module compound apertures, in the JWST (V2, V3) coordinate system

SCA* or
Compound
Aperture

V2_ref

V3_ref

V2_1

V2_2

V2_3

V2_4

V3_1

V3_2

V3_3

V3_4

A1

120.58

-527.50

153.05

88.80

88.62

151.99

-559.36

-560.00

-495.73

-495.26

A2

119.74

-459.78

151.55

88.23

88.35

150.98

-491.18

-491.55

-428.30

-428.07

A3

51.95

-527.93

84.00

19.45

20.22

83.88

-560.18

-560.32

-495.68

-495.89

A4

52.36

-459.90

84.05

20.45

20.90

83.82

-491.56

-491.67

-428.05

-428.29

A5

85.93

-493.50

151.24

20.71

22.11

149.56

-558.01

-558.84

-428.75

-428.88

B1

-122.43

-457.71

-91.03

-154.29

-153.57

-90.99

-489.52

-488.98

-425.95

-426.34

B2

-122.68

-525.42

-91.10

-155.29

-153.91

-90.60

-558.04

-557.09

-493.05

-493.85

B3

-54.61

-457.70

-22.54

-86.07

-86.23

-23.39

-489.23

-489.52

-426.33

-425.70

B4

-54.39

-525.63

-21.90

-86.38

-86.31

-22.73

-557.95

-557.88

-493.66

-493.40

B5

-89.40

-491.36

-24.03

-154.79

-153.19

-25.54

-556.76

-556.04

-426.72

-426.46

ALL

-1.96

-492.90

Mind the gap! Target placement is in the gap between the two modules.

AS

81.27

-498.07









BS

-83.63

-495.98









* Sensor chip assembly = individual detector, of which NIRCam has 10. ALL, AS and BS refer to apertures encompassing all 10, all 4 SW detectors on module A, or all 4 SW detectors on module B, respectively.

For Table 1, ALL, AS (a.k.a ASHORT), and BS (BSHORT) apertures are compound apertures; ALL corresponds to all 10 detectors on both modules, while AS and BS correspond to all 5 detectors on one module. These three compound apertures are provided as options for Target Placement, defining the telescope pointing, when observing with all detectors on both modules (MODULE = ALL), or module B (MODULE = B in which case the BS aperture is used). Note that the compound apertures do not have vertices defined in the (V2,V3) focal plane system. Also note that the AS and BS apertures have reference points located within the footprints of the A3 and B4 SCAs, respectively (see also Figure 1). Values are in arcseconds.


Table 2. NIRCam imaging subarray apertures (reference position and four corners) for Module B detectors in the JWST (V2, V3) coordinate system


Subarray

SCA

V2_ref

V3_ref

V2_1

V2_2

V2_3

V2_4

V3_1

V3_2

V3_3

V3_4

SUB160 *

B1

-93.50-487.03-90.63-95.58-95.54-90.60-498.82-498.78-493.81-493.85


B2

-93.09-496.31-90.63-95.58-95.54-90.60-498.82-498.78-493.81-493.85


B3

-83.60-487.04-81.13-86.07-86.08-81.14-489.52-489.52-484.56-484.56


B4

-83.83-496.15-81.35-86.31-86.31-81.36-498.64-498.63-493.66-493.66


B5

-88.66-491.59-83.62-93.68-93.67-83.62-496.68-496.66-486.56-486.57

SUB64P

B1

-148.67-432.15-147.57-149.53-149.51-147.55-433.14-433.11-431.15-431.17

 

B5

-146.68-150.67-150.65-146.66-434.17-434.13-430.13-430.17

SUB160P

B1

-146.11-151.01-150.97-146.07-434.62-434.57-429.66-429.72

 

B5

-143.27-153.24-153.19-143.22-436.83-436.72-426.72-426.83

SUB400P

B1

-141.43-153.68-153.57-141.34-438.36-438.22-425.95-426.09

 

B5

-128.37-153.35-153.19-128.29-451.97-451.74-426.72-426.95

* In the interest of brevity, only the values for the SUB160 extended source subarrays are shown (SUB320 and SUB640 being omitted). Values for all subarray apertures are available in the pySIAF package.

In reference to Table 2, these systems are used, e.g., by APT to specify the (X,Y) offset special requirement when Module = B, and Subarray = 160/320/640. or 64P/160P/400P. When using Module = B and Subarray = 160/320/640, the target is placed within the short wavelength detector gap, so dithers, a mosaic or an Offset special requirement will be required to provide coverage at the target position. These subarrays are primarily intended to provide imaging of bright, extended sources. For imaging of bright, confined or point sources, use the "point source subarrays" (Subarray = SUB64P/SUB160P/SUB400P) which are located in the upper right corner of the B module as pictured in Figure 1 (see NIRCam Detector Subarrays).  Values are in arcseconds.


Table 3. NIRCam subarray apertures for coronagraphy (reference position and four corners) in the JWST V2-V3 coordinate system

MASK

SCA

V2_ref

V3_ref

V2_1

V2_2

V2_3

V2_4

V3_1

V3_2

V3_3

V3_4

210R

A2

127.37

-405.01

137.21

117.64

117.67

137.20

-415.13

-415.27

-395.54

-395.39


A5

127.37

-405.04

147.20

107.40

107.44

147.13

-424.97

-425.36

-385.14

-384.76

335R

A2

107.37

-405.09

112.23

102.45

102.48

112.25

-409.93

-409.95

-400.08

-400.06


A5

107.37

-405.07

116.65

96.78

96.83

116.66

-415.96

-416.03

-395.92

-395.85

430R

A2

87.33

-405.07

96.34

86.56

86.61

96.38

-409.94

-409.92

-400.04

-400.07


A5

87.33

-405.05

96.66

76.78

76.86

96.70

-416.03

-416.00

-395.86

-395.92

SWB

A4

67.32

-404.94

77.07

57.44

57.47

77.06

-415.30

-415.25

-395.44

-395.52


A5

67.32

-404.97

87.03

47.16

47.36

87.12

-425.18

-424.93

-384.56

-384.94

LWB

A4

43.40

-404.78

49.58

37.28

37.31

49.60

-408.73

-408.62

-400.68

-400.81


A5

43.40

-404.75

55.41

30.43

30.56

55.51

-414.06

-413.71

-397.54

-397.93

SCA used for Target Acquisition with this mask

Starting in Cycle 2, NIRCam coronagraphic imaging is offered simultaneously on the SW and LW channel. Note that the SW and LW apertures have the same pixels size, but have angular sizes in a 1:2 ratio. When the natural channel for a mask is the SW channel, the apertures correspond to a 640 × 640 pixels subarray, with angular sizes of ~20" and ~40" on the SW and LW channel respectively. When the natural channel for a mask is the LW channel, the apertures correspond to a 320 × 320 pixels subarray, with angular sizes of ~10" and ~20" on the SW and LW channel respectively. The natural channel is the channel corresponding to the wavelength for which the mask is optimized, for example SW for the 210R mask, optimized at 2.1 μm, or LW for the 430R mask, optimized at 4.3 μm.

Table 3 gives the nominal target reference positions for the coronagraphic occulting masks ("Ref") and subarray aperture vertices (1–4)  in JWST (V2, V3) coordinates in arcseconds. Bar occulters (with names ending in "B") have multiple reference positions (not shown here), one for each allowed filter. Note that only module A is used for coronagraphy.


Table 4. NIRCam apertures, center and 4 corners for all 10 NIRCam detectors in the NIRCam ideal coordinate system tied to the NRCALL aperture

SCA

XIdl_ref

YIdl_ref

XIdl_1

XIdl_2

XIdl_3

XIdl_4

YIdl_1

YIdl_2

YIdl_3

YIdl_4

A1

-122.49

-34.77

-154.92

-90.67

-90.57

-153.94

-66.67

-67.22

-2.95

-2.56

A2

-121.74

32.95

-153.51

-90.19

-90.39

-153.02

1.52

1.22

64.48

64.63

A3

-53.86

-35.10

-85.87

-21.32

-22.17

-85.83

-67.39

-67.45

-2.82

-3.10

A4

-54.36

32.92

-86.01

-22.41

-22.94

-85.86

1.22

1.20

64.81

64.50

A5

-87.88

-0.72

-153.11

-22.58

-24.15

-151.60

-65.32

-65.97

64.12

63.81

B1

120.42

35.35

89.07

152.32

151.52

88.95

3.49

4.11

67.14

66.67

B2

120.76

-32.37

89.23

153.42

151.95

88.64

-65.03

-64.00

0.04

-0.84

B3

52.61

35.26

20.58

84.11

84.18

21.34

3.70

3.48

66.68

67.22

B4

52.47

-32.67

20.03

84.50

84.36

20.78

-65.03

-64.87

-0.66

-0.47

B5

87.44

1.65

22.15

152.91

151.14

23.50

-63.83

-62.95

66.37

66.47

ALL

0.00

0.00

-154.93

153.42

151.52

-153.03

-66.67

-64.00

67.14

64.63

Values are in arcseconds.


Table 5. NIRCam apertures, center and 4 corners for the 5 module B detectors in the NIRCam ideal coordinate systems referenced to the NRCBS and the NRCB5 apertures

Values are in arcseconds.

SCA

XIdl_ref

YIdl_ref

XIdl_1

XIdl_2

XIdl_3

XIdl_4

YIdl_1

YIdl_2

YIdl_3

YIdl_4

B1

38.83

38.23

7.40

70.66

70.00

7.42

6.45

6.93

69.96

69.63

B2

39.02

-29.48

7.41

71.60

70.28

6.97

-62.07

-61.18

2.86

2.12

B3

-28.99

38.30

-61.08

2.45

2.66

-60.18

6.81

6.45

69.65

70.33

B4

-29.27

-29.63

-61.79

2.69

2.68

-60.90

-61.91

-61.90

2.31

2.64

B5

5.77

4.61

-59.66

71.10

69.62

-58.03

-60.73

-60.13

69.19

69.57

BS *

0.00

0.00

-61.79

71.60

70.00

-60.18

-61.91

-61.18

69.96

70.33

B1

33.04

33.64

1.63

64.89

64.19

1.62

1.84

2.35

65.38

65.02

B2

33.26

-34.07

1.67

65.86

64.50

1.19

-66.68

-65.76

-1.72

-2.49

B3

-34.78

33.67

-66.86

-3.33

-3.15

-65.99

2.16

1.84

65.04

65.68

B4

-35.03

-34.26

-67.53

-3.05

-3.09

-66.67

-66.56

-66.52

-2.30

-2.01

B5 *

0.00

0.00

-65.40

65.36

63.81

-63.83

-65.37

-64.71

64.61

64.93



References

Cox C. & Lallo M., 2017, JWST-STScI-001550
Description and Use of the JWST Science Instrument Aperture File




Notable updates
  •  
    Added Table 2 with V2/V3 data for the imaging subarrays, re-ordered the tables. Corrected what is now Table 5 by removing references to subarrays. Updated text to reflect improved accuracy of SIAF data, improved organization and correct several statements.

  •  
    All values updated to reflect current distortion and relative alignment knowledge based on all Cycle 1 calibration data.

  •  
    Added aperture "As" to Figure 1 and Table 1. This is a new option for Target Placement.

  • Added coronagraphic apertures for Cycle 2. Several clarifications in the text. Added tables in Idl coordinates.

  •  
    corrected aperture B3 vertex coordinates V2_1, V2_2, V2_3, V2_4
Originally published