A Pass Plan contains one Segment Plan, which may be repeated. On the Pass Plan Form, each row in the segment plan contains one Observation Specification, which is used to create one or more Observations.

Pass Plan Parameters

A Pass Plan contains one or more observation specifications as shown in the Figure of the Pass Plan View in APT . Parameters may be entered or edited on the form. 

Number

NUMBER

An identification (ID) number that designates the Pass Plan. Required (incremental numbers are added by default but may be changed by the user). Non-number characters entered by the user are automatically replaced with the next available ID number. 

Label

LABEL

Enter a name that designates the Pass Plan. Not required. The label identifies the Pass Plan in the hierarchical editor and drop-down menus.

Pass Target

PASS TARGET = FIXED TARGET , REGION TARGET , MULTIPLE FIXED TARGETS , NONE , PARALLEL

Select one or more targets for the pass plan. Options are:

FIXED TARGET Select one target from the list of Fixed Targets previously created for the program. All Observation Specifications defined in the Pass Plan use the selected Fixed Target.

MULTIPLE FIXED TARGETS When selected, one Fixed Target must be selected from  OBSERVATION TARGET for each observation.

REGION TARGET Select one target from the list of Region Targets previously created for the program. All Observation Specifications defined in the Pass Plan use the selected Region Target. The entire Segment Plan will be executed at each location in the specified Region Target, including the entire sequence of specified Observations/Mosaics/Dither/Repeats.

NONE Available when an ENGINEERING special requirement is used.

PARALLEL (see Parallel CGI/WFI Programs).

SEGMENTS PER PASS

Enter the number of times the Segment Plan is repeated (not required). The allowed range is 1-250 . A  SEGMENTS PER PASS of 1 is only 1 total execution of the Segment.

For Region Targets,  SEGMENTS PER PASS is set to the number of pointings for the Region Target and cannot be changed.

Reference Position

All targets in the Survey Plan are observed at the same orient with respect to the  Reference Position . Reference Position  is optional and may be entered manually or automatically.

To add the Reference Position automatically, click the Set Reference Position button. APT calculates the Reference Position  RA/Dec as the center of all coordinates in the Survey Plan.  

Right ascension ( RA ) and declination ( Dec )  must be entered as ICRS coordinates (International Celestial Reference System).

• RA may be entered in HMS format (hh mm ss.ssss), or as decimal degrees (ddd.dddd). Decimal numbers will be converted to HMS. 
• Dec may be entered in DMS format (dd mm ss.ssss) or as decimal degrees (ddd.dddd). Decimal degrees will be converted to DMS.

Observation Sequence 

The Observation Sequence is an ordered list of one or more Observation Specifications. Each Observation Specification associates a target with a Mosaic Pattern, an instrument set up, and a Dither Pattern.

Row Number

A sequential number for the Observation Specification (assigned by APT). When Observation Repeat is used, the Row Number expands to also show the range of assigned observation numbers.

Example: The third row with OBSERVATION REPEAT = 23 might be shown as 3 (25-47)).

Observation Target

OBSERVATION TARGET

Only available when  PASS TARGET = MULTIPLE FIXED TARGETS. Select a target for each observation from the list of Fixed Targets previously created for this program. For certain  CALIBRATION types,  OBSERVATION TARGET is set to NONE and cannot be changed. (For more information see Calibration Requirements).

Optical Element

  OPTICAL ELEMENT = F062 F087 F106 F129 F146 F158 F184 F213 Prism Grism

Select an Optical Element (the WFI Optical Elements are described in the Instrument Handbook).

Prism and Grism  are used for spectroscopic observations. The remaining Optical Elements are for imaging mode.

For certain  CALIBRATION types, Optical Element is set to  DARK and cannot be changed (For more information see Calibration Requirements).

MA Table

MA TABLE = C1_IMG_MICROLENS C2A_IMG_HLWAS C2B_IMG_HLWAS C2C_IMG_HLWAS C2D_IMG_HLWAS C2E_IMG_HLWAS C2F_IMG_HLWAS C2G_IMG_HLWAS C2H_IMG_HLWAS C3A_SPEC_HLSS C3B_SPEC_HLSS C3C_SPEC_HLSS C3D_SPEC_HLSS C3E_SPEC_HLSS C3F_SPEC_HLSS DEFOCUS_MOD DEFOCUS_LRG DIAGNOSTIC

Select the Multi Accumulation Table (required) to be used for this Observation Specification.

Resultant

RESULTANT

Select the resultant at which to stop observing for the selected MA Table (see Multi Accumulation Table). Each MA Table has a defined number of resultants, and the observation is truncated at the selected resultant number.

• The drop-down list displays the Total Accumulated Exposure Time and Total Integration Duration (in seconds) for each resultant option (see Multi Accumulation Table).
• Each MA Table has a recommended minimum number of resultants. If the selected number is less than the recommended minimum, APT provides a warning.

Mosaic

MOSAIC

Select a Mosaic Pattern from those defined by the user for the program, or NONE .

  NONE is a single Tile representing a 1 by 1 pattern.

Dither

  DITHER = NONE (default), LINEGAP2 LINEGAP3 LINEGAP4 BOXGAP4 WIDEGAP4 BOXGAP5 BOXGAP6 WIDEGAP6 BOXGAP7 BOXGAP8 WIDEGAP8 BOXGAP9 WIDEGAP9

Select a Dither Pattern. The resulting dither pointings are shown in the Pointings Report. For more information, see WFI Dithering.

Subpixel Dither

SUBPIXEL DITHER = NONE (default), SUB2 SUB3 SUB4 SUB5 SUB6 SUB7 SUB8 SUB9

Select a subpixel dither.The subpixel dither pattern will be executed at each point in the Dither Pattern. All resulting pointings are shown in the Pointings Report. For more information, see WFI Dithering.

Exposures/Dither

EXPOSURES/DITHER

Enter the number of exposures to be executed at each of the dither and subpixel dither points. (Optional) The range is 1-99

Repeat

OBSERVATION REPEAT

Enter the number of repeats for this Observation Specification (not required).  The allowed range is 1-100 and each Observation is assigned an observation number (see Row Number). A Repeat of 1 is only 1 total execution of the observation.

Visits

Tally of the number of visits for this Observation Specification. The sum is automatically calculated and is not editable.

Special Reqs

Indicates how many Requirements are applied to the Observation Specification. The details of the user-defined Requirements for the selected  Observation Specification are listed in the Special Requirements box. 

Totals for the observation sequence and pass are displayed:

• Observations  Per Segment (maximum allowed is 999, including repeats)
• Visits Per Segment
• Visits Per Pass
• Segment Science Time
• Segment Charged Time

Special Requirements

The Special Requirements tab displays all Requirements for the selected pass plan. Special requirements may be added, removed, or edited here.

Comments

The Comments tab displays comments entered for the Pass Plan. Comments may be added, removed, or edited here. Comments are not required.

For additional questions not answered in this article, please contact the Roman Help Desk at STScI.