Survey Plan

A Survey Plan contains one or more Survey Steps, which are used to create one or more Passes.


Survey Step

A Survey Step references one Pass Plan, and provides additional parameters such as Repeat and Special Requirements.


Figure of the Survey Plan in APT

The Survey Steps presented as an ordered list in the Survey Plan form for demonstration Program 966.

Row Number

Row Number # (Pass#) - A sequential number for the Survey Step (assigned by APT). When REPEAT is used in a given Survey Step, the (Pass#) part expands to show the range of assigned pass numbers. For example, the third row with REPEAT = 5 might be shown as 3 (7-11).

Pass Plan

PASS PLAN - Select a Pass Plan from the program to be included in the Survey Plan (required). 

Repeat

REPEAT - Enter the number of passes to create using this Survey Step (not required). The default is 1 and the range is 1-250 and each Pass is assigned a pass number (see Row Number). A Repeat of 1 is only 1 total execution of the Pass (and a repeat of 2 is 2 total Passes). 

Survey step repeats may not be used with Region Targets. Use separate Survey steps for each desired Pass.

Segments

SEGMENTS

The calculated number of Segments for this Survey Step. Not editable.

Visits

VISITS

The calculated number of Visits for this Survey Step. Not editable.

Planned V3PA

(available only for Survey Steps that observe Region Targets)

PLANNED V3PA

The Planned V3PA Orient for the Region Target. 

Assigned V3PA

(available only for approved programs that observe Region Targets)

ASSIGNED V3PA

The V3PA assigned by STScI. After a program has been approved, STScI will determine an ASSIGNED V3PA for each Survey Step which observes a Region Target.

If the ASSIGNED V3PA is different from the PLANNED V3PA ,  APT provides an error and the Region Target must be re-planned at the Assigned V3PA.


Special Requirements

This field indicates how many Special Requirements have been applied to this Survey Step. The details of the user-defined Requirements for the selected Survey Step are are listed in the Special Requirements tab. 

Total Passes

TOTAL PASSES

The calculated number of passes in the Survey Plan (the sum of the passes over all Survey Steps). Maximum allowed is 999 (including repeats). Not editable.

Total Segments

TOTAL SEGMENTS

The calculated number of segments in the Survey Plan (the sum of the segments over all Survey Steps). Not editable.

Total Visits

TOTAL VISITS

The calculated number of visits in the Survey Plan (the sum of the visits over all Survey Steps). Not editable.

Science Time (hours)

SCIENCE TIME

Total time required to complete all steps in the Survey Plan, excluding required overhead time. Not editable.

Execution Time (hours)

EXECUTION TIME

Total time required to complete all steps in the Survey Plan, excluding statistical external overheads such as certain slews. Not editable.

Charged Time (hours)

CHARGED TIME

Total time required to complete all steps in the Survey Plan, including both deterministic and statistical overhead time. Not editable.

Special Requirements for <selected Survey Step>

The Special Requirements tab lists all user-defined Special Requirements for the selected Survey Step. To add a new requirement, select a survey step, then click Add Requirement.

Linking Requirements

The Linking Requirements tab lists all user-defined Linking Requirements between Survey Steps for the Survey Plan. To add a new requirement, select a survey step, then click Add.




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




Latest Update

Updated for Roman APT version 2025.8 release
Publication

 

Initial publication of the article.