C.2 WFC3 Patterns

A number of different types of patterns are available to support dithered and mosaicked WFC3 observations. The pre-defined patterns that have been implemented in APT are described in the Phase II Proposal Instructions, which are updated when the selection of a new cycle of proposals is announced. The pre-defined WFC3 patterns in effect in APT at the time of publication of this handbook are summarized here. Patterns not predefined in APT can still be executed by specifying POS TARGs on exposures in the Phase II proposal. WFC3 ISR 2016-14 and WFC3 ISR 2020-07 tabulate the necessary POS TARGs for compact patterns with up to 9 steps for WFC3/IR and WFC3/UVIS, respectively. WFC3 ISR 2023-05 tabulates the necessary POS TARGs for optimal patterns when using WFC3 and ACS simultaneously (i.e. one instrument as prime and the other in parallel). Those patterns are designed to preserve sub-pixel sampling as much as possible over the face of the detector, given the scale changes introduced by geometric distortion. Alternatively, observers can also develop custom Patterns within APT by starting with a Generic pattern and setting the required parameters as desired or by adjusting specific parameters within a pre-defined pattern. 

Pre-defined WFC3 dither patterns designed to subsample pixels can optionally be selected as secondary patterns when WFC3 patterns with larger steps are selected as primary patterns. WFC3 patterns can also be added as secondary patterns to any of the generic pattern types (BOX, LINE, SPIRAL). When combining patterns, the smaller dither pattern should be the secondary pattern to minimize the time spent moving the telescope. Due to geometric distortion (Appendix B), a large mosaic step shifts some objects by an integer number of rows (or columns), and others by an integer plus some fraction of a pixel. The PSF is thus not evenly sampled in the overlap region of the two exposures, so a PSF-sampling dither should be added if spatial resolution is important.

Sets of exposures with offsets executed using patterns or POS TARGs are associated and combined automatically during pipeline processing, as long as the same guide stars have been used for all exposures. Pointings must be contained within a diameter ~130 arcsec or less (depending on the availability of guide stars in the region) to use the same guide stars. Note that the rms pointing repeatability is significantly less accurate if the same guide stars are not used for all exposures (Appendix B of the DrizzlePac Handbook).

The names and purposes of the patterns in effect in APT at the time of publication are given in Table C.1. Note that the initially-adopted names of patterns have been preserved for continuity, although they do not always correspond to the distinction between dither steps and mosaic steps outlined above. The small BOX dither patterns are designed to optimally sample the PSF when 4 steps are used. Since time constraints do not always permit visits to be broken into multiples of 4 steps, LINE dither patterns that optimally sample the PSF in 2 or 3 steps are also given. The BOX and LINE dither patterns are illustrated in WFC3 ISR 2010-09. A full discussion and illustrations of patterns that optimally sample the PSF for different numbers of steps are available in Section C.2 of the DrizzlePac Handbook. Note that PSF sampling generally produces a more significant improvement for IR images than for UVIS images (Section 6.6.1 and Section 7.6.1). The remainder of the patterns in Table C.1 are special-purpose mosaic patterns that are expected to be commonly needed. There are no pre-defined patterns to deal with specific features in flats—notably, the circular dead spot on the IR detector (WFC3 ISR 2008-08) and the UVIS “droplets” (WFC3 ISR 2008-10); however, patterns that can be used to mitigate the effects of these artifacts are discussed in WFC3 ISR 2010-09.

Table C.1: Dithering and Mosaicking Patterns in APT for WFC3.

Pattern Name

Description

WFC3 IR Patterns

WFC3-IR-DITHER-BLOB

Dithers over “blobs” (Section 7.9.6)

WFC3-IR-DITHER-BOX-MIN

Provides optimal 4-step sampling of the PSF.

WFC3-IR-DITHER-BOX-UVIS

Produces an IR mosaic (despite the name) covering approximately the same area as the UVIS-CENTER aperture.

WFC3-IR-DITHER-LINE

Provides optimal 2-step sampling of the PSF.

WFC3-IR-DITHER-LINE-3PT

Provides optimal 3-step sampling of the PSF.

WFC3 UVIS Patterns

WFC3-UVIS-DITHER-BOX

Provides optimal 4-step sampling of the PSF; produces spacings of >1 column for removal of hot columns.

WFC3-UVIS-DITHER-LINE

Provides optimal 2-step sampling of the PSF; produces spacings of >1 column for removal of hot columns.

WFC3-UVIS-DITHER-LINE-3PT

Provides optimal 3-step sampling of the PSF; produces spacings of >1 column for removal of hot columns.

WFC3-UVIS-GAP-LINE

Dithers over the interchip gap.

WFC3-UVIS-MOS-BOX-LRG

Produces a mosaic that can generally be executed with a single set of guide stars.

WFC3-UVIS-MOS-DITH-LINE

Combines a primary gap-stepping pattern with an optional dither at each primary position.

WFC3-UVIS-MOSAIC-LINE

For full-frame UVIS with ACS/WFC in parallel; steps the gap on both detectors.


The default specifications of the patterns are summarized in Table C.2. The equivalent POS TARG moves are summarized in Table C.3, along with the approximate number of pixels corresponding to these moves. The number of pixels was computed using only the linear distortion terms with coefficients measured at the center of each detector. This is an excellent approximation for small moves and for objects that remain in the central region of the detector (Figure B.1 and B.3 in Appendix B).

Note that you can easily scale up the patterns in APT to make them largere.g., multiply the Point Spacing and Line Spacing of patterns with half-pixel sampling (WFC3-IR-DITHER-BOX-MIN, WFC3-IR-DITHER-LINE, WFC3-UVIS-DITHER-BOX, WFC3-UVIS-DITHER-LINE) by an odd number to preserve the half-pixel sampling (this is equivalent to multiplying the POS TARGs and steps in pixels by that number). You may want to do this in the IR, for example, to achieve the recommended spacing of at least 10 pixels between positions for photometric repeatability (WFC3 ISR 2019-07) or to move a saturated persistence-generating core of a target by a greater distance than the minimal default distance.

As an example, for the WFC3-IR-DITHER-LINE, one would scale the 0.636" spacing x3 to preserve half-pixel sampling, making this ~15 pixels along the diagonal instead of the standard ~5 pixels.  This will help minimize the effect of self-persistence from bright stars taken in prior exposures from the same visit.

Be aware, however, that larger steps result in larger variations in sub-pixel sampling of the PSF over the face of the detector due to non-linear geometric distortion (WFC3 ISR 2016-14).

Table C.2: Default values of the parameters that define the WFC3 APT convenience patterns

Pattern

No. of Points

Point Spacing (arcsec)

Line Spacing (arcsec)

Pattern Orient (degrees)

Angle between Sides (degrees)

Center Pattern

WFC3-IR-DITHER-BLOB

2

5.183


 

41.859


 

yes

WFC3-IR-DITHER-BOX-MIN

4

0.572

0.365

18.528

74.653

no

WFC3-IR-DITHER-BOX-UVIS

4

23.020

35.212

0.713

89.287

yes

WFC3-IR-DITHER-LINE

2

0.636


 

41.788


 

no

WFC3-IR-DITHER-LINE-3PT

3

0.605


 

41.788


 

no








WFC3-UVIS-DITHER-BOX

4

0.173

0.112

23.884

81.785

no

WFC3-UVIS-DITHER-LINE

2

0.145


 

46.840


 

no

WFC3-UVIS-DITHER-LINE-3PT

3

0.135


 

46.840


 

no

WFC3-UVIS-GAP-LINE

2

2.414


 

85.759


 

yes

WFC3-UVIS-MOS-BOX-LRG

4

79.400

77.500

5.550

95.300

yes

WFC3-UVIS-MOS-DITH-LINE


 

 

 

 

 

 

primary pattern

3

2.400


 

85.754


 

yes

secondary pattern

2

0.119


 

33.606


 

no

WFC3-UVIS-MOSAIC-LINE

2

3.264


 

63.697


 

no


Table C.3: Steps in arcsec in the POS TARG frame and in detector pixels for the WFC3 APT convenience patterns.

Pattern Name

POS TARG X (arcsec)

POS TARG Y (arcsec)

x (pixels)

y (pixels)

WFC3-IR-DITHER-BLOB

-1.930
1.930

-1.729
1.729

-14.25
14.25

-14.25
14.25

WFC3-IR-DITHER-BOX-MIN

0.000
0.542
0.339
-0.203

0.000
0.182
0.485
0.303

0.0
4.0
2.5
-1.5

0.0
1.5
4.0
2.5

WFC3-IR-DITHER-BOX-UVIS

-11.071
11.947
11.071
-11.947

-17.744
-17.457
17.744
17.457

-81.7
88.2
81.7
-88.2

-146.5
-144.2
146.5
144.2

WFC3-IR-DITHER-LINE

0.000
0.474

0.000
0.424

0.0
3.5

0.0
3.5

WFC3-IR-DITHER-LINE-3PT

0.000
0.451
0.902

0.000
0.403
0.806

0.00
3.33
6.67

0.00
3.33
6.67

WFC3-UVIS-DITHER-BOX

0.000
0.158
0.099
-0.060

0.000
0.070
0.165
0.095

0.0
4.0
2.5
-1.5

0.0
1.5
4.0
2.5

WFC3-UVIS-DITHER-LINE

0.000
0.099

0.000
0.106

0.0
2.5

0.0
2.5

WFC3-UVIS-DITHER-LINE-3PT

0.000
0.092
0.185

0.000
0.098
0.197

0.00
2.33
4.67

0.00
2.33
4.67

WFC3-UVIS-GAP-LINE

-0.089
0.089

-1.203
1.203

-2.25
2.25

-30.25
30.25

WFC3-UVIS-MOS-BOX-LRG

-39.611
39.611
39.611
-39.611

-42.120
-36.860
42.120
36.860

-1000.0
1000.0
1000.0
-1000.0

-997.0
-1001.0
997.0
1001.0

WFC3-UVIS-MOS-DITH-LINE

-0.178
-0.079
0.000
0.099
0.178
0.277

-2.393
-2.328
0.000
0.066
2.393
2.459

-4.5
-2.0
0.0
2.5
4.5
7.0

-60.2
-58.7
0.0
1.5
60.2
61.7

WFC3-UVIS-MOSAIC-LINE

0.000
1.446

0.000
2.926

0.0
36.5

0.0
71.5


For the IR detector, the linear relation between POS TARGs and pixels is simply

POS TARG X = a11 * x
POS TARG Y = b10 * y

where a11 ~ 0.1355 arcsec/pixel and b10 ~ 0.1211 arcsec/pixel near the center of the detector. For the UVIS detector, there is a cross-term that takes into account the fact that the projected axes are not perpendicular:

POS TARG X = a11 * x
POS TARG Y = b11 * x + b10 * y

where a11 ~ 0.0396 arcsec/pixel, b11 ~ 0.0027 arcsec/pixel, and b10 ~ 0.0395 arcsec/ pixel near the center of the detector. This relationship is illustrated in Figure C.1.

The values of these coefficients were derived using optical models and apply to the centers of the detectors. On-orbit geometric distortion solutions give marginally different coefficients (WFC3 ISR 2010-09). The corresponding changes in pixel steps in small dithers are insignificant. The corresponding changes in pixel steps in large dithers or mosaic steps are inconsequential, since non-linear distortion makes the step size in pixels variable over the detector.

Figure C.1: Transformation between image x,y coordinates (in pixel units) and X,Y coordinates (in arcsec) in the POS TARG frame. See also Figure 6.1.