Format definitions

Boldface type indicates the name of an APT parameter or a value for a parameter.

Black text indicates an important note.

Magenta text indicates available but unsupported parameters (requires prior approval from STScI).

Red text indicates restricted parameters (for STScI use only).

Brown text indicates text file parameters.

Items in brackets - <value> - are required values.

Items in square brackets - [<value>] - are optional.

See more about Special Requirements:

Limited Resources

Some special requirements that affect scheduling must be indicated in the Phase 1 proposal. These are noted in the tables below as well as in the text explanations of the requirements.

Use the tables below to go directly to information for a particular special requirement.

The following Special Requirements are applicable at the visit level, and they will affect all the exposures within that particular visit.

Supported Formats for Visit-level Special Requirements

FORMAT	EXAMPLE
Guiding Requirements
PCS MODE Fine	PCS MODE Fine
PCS MODE Gyro	PCS MODE Gyro	Not possible under Reduced Gyro Mode
GUIDing TOLernace <angle> (arcsec)	GUID TOL 0.020"	Not possible under Reduced Gyro Mode
DROP TO GYRO [NO REACQuisition]	DROP TO GYRO	Not possible under Reduced Gyro Mode
Special Observation Requirements
CVZ	CVZ	*Must be indicated in Phase 1 proposal*
SCHEDulability <percentage>	SCHED 100%	Default has changed to 70% due to Reduced Gyro Mode
NOTRACK	NOTRACK
TARGET OF OPPORTUNITY RESPONSE TIME <time>	TARGET OF OPPORTUNITY RESPONSE TIME 24.0H	*Must be indicated in Phase 1 proposal*
TARGET OF OPPORTUNITY FLEX DAY (FLEXIBLE THURSDAY)	TARGET OF OPPORTUNITY FLEX DAY (FLEXIBLE THURSDAY)	*Must be indicated in Phase 1 proposal*
Conditional Requirements
ON HOLD FOR [<visit>]	ON HOLD FOR 15	*Must be indicated in Phase 1 proposal*
Target Orientation Requirements
ORIENTation <angle1> TO <angle2>	ORIENT 18° TO 22°	*Must be indicated in Phase 1 proposal*
ORIENTation <angle1> TO <angle2> FROM <visit>	ORIENT 18° TO 22° FROM 5	*Must be indicated in Phase 1 proposal*
SAME ORIENTation AS <visit>	SAME ORIENT AS 5	*Must be indicated in Phase 1 proposal*
Timing Requirements
AFTER <date>	AFTER 12-JUL-2001:12:06	*Must be indicated in Phase 1 proposal*
AFTER <visit> [BY <time1> TO <time2>]	AFTER 6 BY 7D TO 9D	*Must be indicated in Phase 1 proposal*
BEFORE <date>	BEFORE 14-SEP-1999	*Must be indicated in Phase 1 proposal*
BETWEEN <date1> AND <date2>	BETWEEN 21-DEC-1999 AND 31-DEC-1999	*Must be indicated in Phase 1 proposal*
GROUP <visits> WITHIN <time>	GROUP 5-10 WITHIN 60D	*Must be indicated in Phase 1 proposal*
PERIOD <time> ZERO-PHASE (HJD) <date>	PERIOD 1.23H AND ZERO-PHASE (HJD) 2444000	*Must be indicated in Phase 1 proposal*
SEQuence <visits-checked> WITHIN <time>	SEQ Visits 5-7 WITHIN 24H	*Must be indicated in Phase 1 proposal*
VISIBILITY INTERVAL CORON	VISIBILITY INTERVAL CORON	Not possible under Reduced Gyro Mode
VISIBILITY INTERVAL NO GYRO BIAS UPDATE ON MOVING TARGET	VISIBILITY INTERVAL NO GYRO BIAS UPDATE ON MOVING TARGET
Limited-Access Requirements
BRIGHT EARTH AVOIDance <angle in degrees>¹	BRIGHT EARTH AVOID 25
PARallel	PAR
GYRO MODE <value>	GYRO MODE 2G	Default and currently only possible value is 1G due to Reduced Gyro Mode

¹ The <angle in degrees> is currently limited to 25. All other angles from 0º to 90º are Restricted.

The following Special Requirements apply to individual exposures within a visit. All instances of <exposure-list> or <exposure> refer only to exposures in the same visit as the exposure carrying the requirement.

Supported Formats for Exposure-level Special Requirements

FORMAT	EXAMPLE
Target Acquisition Requirements
INTeractive ACQuisition (obsolete)	No longer available; see text.
Special Observation Requirements
SPATIAL SCAN <Scan_Rate>, <Scan_Ori- ent>, <Scan_Direction>, <Scan_Line_Separation>, <Scan_Number_Lines>		The highest scan rates are no longer possible under Reduced Gyro Mode
PARallel <parallel-exp-list> WITH <primary-exp-list>	See Exposure Containers: Exposure Sequences, Coordinated Parallels and Patterns PAR 4-6 WITH 1-3	*Must be indicated in Phase 1 proposal*
Special Communications Requirements
RT ANALYSIS	RT ANALYSIS
REQuires UPLINK	REQ UPLINK
REQuires EPHEMeris CORRection <id>	REQ EPHEM CORR OFF-13
Target Position Requirements
POSition TARGet <X-value>,<Y-value>	POS TARG +6.3,-8.1
SAME POSition AS <exposure>	SAME POS AS 6
PATTERN <#> [<exposure-list>] (Replaced by Pattern Containers in the APT User Interface))	See Exposure Containers: Exposure Sequences, Coordinated Parallels and Patterns and 7 Pointings and Patterns PATTERN 5 1-4
Timing Requirements
LOW-SKY	LOW-SKY	*Must be indicated in Phase 1 proposal*
PHASE <number1> TO <number2>	PHASE 0.09 TO 0.11	*Must be indicated in Phase 1 proposal*
SEQuence <exposure-list> NON-INTerruptible	See Exposure Containers: Exposure Sequences, Coordinated Parallels and Patterns and 7 Pointings and Patterns SEQ 2-5 NON-INT	*Must be indicated in Phase 1 proposal*
SHADOW	SHADOW	*Must be indicated in Phase 1 proposal*

For engineering parameters

FORMAT	EXAMPLE
Special Communications Requirements
FORMAT [AN or FN or HN or PN]	FORMAT FN
Visit Special Requirements
VISIBILITY INTERVAL <time>	VISIBILITY INTERVAL 5000 S
Exposure Special Requirements
MAXimum DURation (time or %) <value>	MAX DUR 125%
MINimum DURation (time or %) <value>	MIN DUR 1200S
EXPAND (pure parallel exposures only)	EXPAND
NEW OBSET [FULL ACQ]	NEW OBSET
NEW ALIGNMENT	NEW ALIGNMENT
SAME OBSET <exposure-list> (replaced by Exposure Group containers in the APT User Interface)	See Exposure Containers: Exposure Sequences, Coordinated Parallels and Patterns and 7 Pointings and Patterns SAME OBSET 10-20
SAME ALIGNMENT <exposure-list> (in APT replaced by Exposure Group containers in the APT User Interface)	See Exposure Containers: Exposure Sequences, Coordinated Parallels and Patterns and 7 Pointings and Patterns SAME ALIGNMENT 20-30
SAME GUIDE STARS <exposure-list> (in APT replaced by Exposure Group containers in the APT User Interface)	See Exposure Containers: Exposure Sequences, Coordinated Parallels and Patterns and 7 Pointings and Patterns SAME GUIDE STARS 10-20
GSPAIR <pair-id->	GSPAIR 0748300182F10000000000F0
OBSET ID <id>	OBSET ID A2
EXP PCS MODE [FINE \| GYRO]	EXP PCS MODE FINE	EXP PCS MODE=GYRO is not possible under Reduced Gyro Mode
GS ACQ SCENARIO [PAIR \| SINGLE \| GYRO \| <scenario>]	GS ACQ SCENARIO SINGLE	Many Scenarios are not possible under Reduced Gyro Mode (and a few have been added)

For available but unsupported parameters

FORMAT	EXAMPLE
Target Acquisition Requirements
SAVE OFFSET <id>	SAVE OFFSET OFF-1
USE OFFSET <id>	USE OFFSET OFF-1
Special Observation Requirements
SAA CONTOUR <model number> (for WFC3, ACS/WFC and S/C modes; Restricted for ACS/SBC, CAL and ENG proposals)	SAA CONTOUR 02
QASISTATES <si> <detector> <start> <end>	QASISTATES ACS ACS/WFC A1 B2
QESIPARM <parameter> <value>	QESIPARM A1 B1
QELOGSHEET <parameter> <value>	QELOGSHEET AP_1 B1
Timing Requirements
AFTER BY <time> [TO <time2>]	AFTER BY 15M to 16M

For restricted parameters

FORMAT	EXAMPLE
Target Acquisition Requirements
USE OFFSET <id> Use for any CALibration, ENGineering or SMOV program	USE OFFSET 9100-1
Special Observation Requirements
SPECial COMmanding [INSTR <NAME>]	SPEC COM INSTR ESPFORMAT

Expand/Collapse all...

Chapter 6 Special Requirements

HST has special requirements that are used to specify scheduling constraints for both visits and exposures, and this article contains the descriptions of those requirements.

Format definitions

See more about Special Requirements:

Limited Resources

Table of Contents

On this Page