Engineering Requirements

Engineering-related requirements are only available if the ALLOW RESTRICTED checkbox is selected in Program Information






Engineering

ENGINEERING = ENGINEERING MODE VISIT DURATION

This special requirement specifies the type of engineering observation and duration.

  • Options for ENGINEERING MODE are MOMENTUM UNLOAD , STATION KEEPING , and  GENERAL ENGINEERING . Only one option is allowed.
  • VISIT DURATION is the duration of the visit in seconds. The range is 1 TO 172800 seconds.

When ENGINEERING is used:

  • MOSAIC DITHER , and SUBPIXEL DITHER are set to  NONE and are not editable.
  • OPTICAL ELEMENT , EXPOSURES/DITHER , MA TABLE , RESULTANT , and OBSERVATION REPEAT are not editable and any values are removed.
  • CALIBRATION and ENGINEERING special requirements are not allowed on the same observation.
  • Science observations (observations without CALIBRATION or ENGINEERING ) are allowed together with engineering observations in the same observation sequence.

Focus Type Override

FOCUS TYPE OVERRIDE = FOCUS TYPE OVERRIDE SM Z-Position Change   WFI ACM Z-Position Change

The FOCUS TYPE OVERRIDE requirement specifies an override of the Focus Type for all exposure pointings in the observation. Three values must be specified: FOCUS TYPE OVERRIDE WFI ACM Z-Position Change , and SM Z-Position Change .

Focus Type Override

Select the size of the Focus Type Override (required). Options are SMALL, MODERATE, and LARGE

WFI ACM Z-Position Change

Enter the WFI Alignment Compensation Mechanism (ACM) Z-Position Change expressed in millimeters (mm). Entry is required. Allowed range is -6.0 to 6.0 .

SM Z-Position Change

Enter the Secondary Mirror (SM) Z-Position Change expressed in microns. Entry is required. Allowed range is -250.0 to 250.0 .

Real Time

REAL TIME

This requirement specifies that the current (engineering) observation should have real time access (i.e. be executed during a contact) to Roman. The  REAL TIME special requirement has no parameters. 

Required

REQUIRED

This requirement indicates that Visits derived from the observation cannot be skipped. The REQUIRED special requirement has no parameters. 

Wavefront Control File

WAVEFRONT CONTROL FILE FILE NAME

This requirement provides the initial formatted filename of the Wavefront Control File for the selected observation. The portion of the file name being provided here must be of the form vuuuuu.aux. The v is 'W' if for WFI ACM moves or 'S' if for secondary mirror offset moves.  The u is only ASCII uppercase letters or numbers. The file will always end with .aux. Note that ROPGS will prepend the Visit ID to create a fully formed auxiliary file name for use in the Visit File.




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




Latest Update

 

Updated for APT 2026.4
Publication

 

Initial publication of the article.