6.3.1 General Exposure-level Special Requirements
General Special Requirements (e.g., POS TARG, PHASE) are generally used to restrict the scheduling of HST observations by various constraints. The Astronomer's Proposal Tool (APT) is used to enter the requirements into the proposal.
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.
Most general special requirements directly or indirectly Special requirements should not be used unless necessary to accomplish the scientific objectives of the proposal.can be scheduled. hedulers at STScI with enough constraints to ensure that the observations are properly scheduled.
Separate target acquisition exposures must be specified at the beginning of most visits, depending on the target and the science instrument used. Target acquisition exposures are used to remove coordinate uncertainties and to identify targets. Once a target acquisition has been performed, HST can move the target from aperture to aperture or move the aperture around the target (with slew accuracies of about 10 milliarcseconds) as long as the same guide stars can be used. Onboard acquisitions are automatically identified by the software. Acquisition exposures must still be specified, but no Special Requirement is needed or appropriate.
Acquisition of a target using an offset target requires that both be defined in the Target List(s). The first exposure will be an onboard or interactive acquisition of a target from which the offset will be made. This target must be designated as an offset acquisition target by appending -OFFSET to the end of the target name (see Table 3.1: Designations of Special Targets). The appropriate offsets will automatically be made from this position to slew to the target of interest.
INTeractive ACQuisition (obsolete)
INT ACQ is restricted and it should not be used at all.
Interactive acquisitions may no longer be performed with HST. However, the same results can be achieved in other ways, and you should consult your Program Coordinator for more information.
Special Observation Requirements
SPATIAL SCAN <Scan_Rate>, <Scan_Orient>, <Scan_Direction>, <Scan_Line_Separation>, <Scan_Number_Lines>
HST has the capability of performing a single and multi line continuous (boustrophedonic or serpentine) scans relative to the target. Such scans may be useful for observing very bright targets without sacrificing visibility to serial buffer dumps, for example.
Spatial Scans are obtained by moving the spacecraft in a way that moves the target in the instrument aperture along a path in the POS TARG coordinate frame (see POSition TARGet <X-value>,<Y-value>) as designated by the observer. The scan is defined relative to the aperture fiducial point within the SI aperture.
Only one exposure may be executed during a spatial scan, and only one spatial scan may be executed during an exposure. STScI will schedule a spatial scan so that the constant rate portion of the first scan begins at the start of the exposure and the constant rate portion of the last scan ends at the end of the exposure.
Table 6.4: Spatial Scan Parameters1
|Scan_Rate (arcsec/sec)||The constant angular rate at which the target will move with respect to the POS TARG coordinate frame.||0.0 to 0.999999 arcsec/sec for multi-line scans under FGS control.|
0.0 to 4.999999 arcsec/sec for single-line scans under FGS control.
0.0 to 7.84 arcsec/sec under Gyro control.
|Scan_Orient (Degrees)||The orientation of the scan line with respect to the POS TARG coordinate frame. It is measured from the POS TARG +X-axis toward the +Y-axis.||0 to 360°||Yes|
|Scan_Direction||The "direction" of the scan.|
"Forward", "Reverse" and "RoundTrip"2
|Scan_Line_Separation (arcsec)||The separation between the adjacent scan lines in arcseconds. The total width of the scan can be found by Scan_Width = Scan_Line_Separation × (Scan_Number_Lines - 1)|
0.0 arcsec for all single line scans.
For multi-line scans:
|Scan_Number_Lines||The number of scan lines to perform.|
1 to 63 lines
1 See also General Considerations for Spatial Scans. Note that only multi-line "Forward" spatial scans are supported.
2 A "Forward" scan will start at the aperture fiducial point (nominal target position; see point a in Figure 6.8: "Foward" Spatial Scan) and proceed to the end of the scan (point b in Figure 6.8: "Foward" Spatial Scan). A "Reverse" scan will run opposite to the corresponding "Forward" one, with it ending at the aperture fiducial point (i.e., from point b to point a in Figure 6.9: "Reverse" Spatial Scan) and is also subject to consideration 9 below. A "RoundTrip" scan will be performed as two scans: a "Forward" scan followed by a "Reverse" scan with identical setup parameters.
General Considerations for Spatial Scans
- The allowed combinations are ACS/WFC ACCUM, STIS/CCD ACCUM, WFC3/IR MULTIACCUM and WFC3/UVIS ACCUM.
- The maximum Scan_Rate is 4.999999 arcsec/sec under FGS control and 7.84 arcsec/sec under Gyro control. Spatial Scans will be performed under FGS control by default. If you want faster rate than permitted under FGS control, you must use either the visit level special requirement PCS MODE Gyro or exposure level special requirement EXP PCS MODE [FINE | GYRO]. Please contact your PC about the advantages and disadvantages of Gyro control with Spatial Scans, and how to use of these special requirements.
- The SI Optional Parameter CR-SPLIT must be NO via default or an explicit specification.
- The angular length of a scan will be determined from the total exposure time (including some overheads in the case of WFC3/IR), the Scan_Rate, the Scan_Line_Separation and the Scan_Number_Lines. For multi-line scans, the total exposure time encompasses all of the scan lines plus the turn around maneuvers between the lines. It is your responsibility to ensure that the scan does not extend off the detector unless necessary to accomplish the goals of the observation.
- Only Multi-line "Forward" spatial scans are supported.
- The turnaround maneuver time is computed in two parts and then combined
- The time to ramp-up/ramp-down each scan line: Ramp-up_Time = max(sqrt(100 * Scan_Rate), 5) seconds
- The time for the transverse move from one scan line to the next: If Scan_Line_Separation ≤ 10 arcsec then Transverse_Time = max((800 * Scan_Line_Separation)**(1/3), 10) seconds else Transverse_Time = (Scan_Line_Separation + 10) seconds.
- Then we combine the Ramp-up_Time and the Transverse_Time to determine the time for each turnaround maneuver:
Turnaround_Time = max(2 * Ramp-up_Time, Transverse_Time) seconds.
Be sure to round to the next higher integer before using it to determine your exposure time.
- During a scan the telescope moves. Consequently, for a scan under FGS control, the guide stars will move within the fields of view of the FGS being used. It is essential that none of the guide stars moves out of the field of view of its FGS. Therefore, requesting a scan under FGS control imposes additional selection requirements on the available guide stars, which will effectively reduce the number of stars that can be used for the observation. The degree of this reduction will depend on the length of the scan relative to the width of the FGS fields of view (4 arcmin). If the size of the scan precludes finding good guide stars, the observation will not be schedulable unless Gyro Hold (see Table 6.1: Accuracies of Guiding Modes) can be used (see special requirements GUIDing TOLerance <angle>, DROP TO GYRO [NO REACQuisition], PCS MODE Gyro, EXP PCS MODE [FINE | GYRO]. Please contact your PC to discuss the advantages and disadvantages of using these special requirements).
- The entire scan must complete during a single target visibility period. "RoundTrip" scans are expanded into individual "Forward" and "Reverse" scans. As a result, those individual scans may be split between different target visibilities unless the "RoundTrip" exposure is within a SEQ NON-INT container.
- The scan specifications in Spatial Scan Parameters apply to the aperture fiducial point in the SI aperture for the exposure unless you use a POSition TARGet <X-value>,<Y-value> or PATTERN special requirement. When you use POS TARG, the scan is performed relative to the point defined by the POS TARG. When you use PATTERN, the scan will be performed for each exposure of the PATTERN relative to its pattern point.
- Scans are not permitted for exposures with Moving Targets.
- Scans are not permitted for exposures with Internal Targets.
- Special Requirement SAME POSition AS <exposure> is not permitted on and can not refer to a Spatial Scan exposure.
- Spatial Scan exposures are not permitted in Coordinated Parallel Containers (Special Requirement PARallel WITH is not permitted on and can not refer to a Spatial Scan exposure).
- Spatial Scan exposures are not permitted in Pure Parallel visits. Pure Parallel visits may not be in parallel with Spatial Scan exposures.
- The Spatial Scan parameters describe the desired scan in the POSition TARGet <X-value>,<Y-value> coordinate frame. You may need to adjust the Scan_Orient appropriately to account for the geometric distortion of the detector. You may also have to adjust the Scan_Rate, which is arcsec/sec in the POS TARG frame, to account for the geometric distortion of the detector if you need a particular pixel traverse rate.
- Since a multi-line scan is executed as a single exposure, the turnaround part of the scan may be imaged on the detector. This turnaround will not occur at constant velocity or at constant rate. If this is not desired, then a series of single-line scans should be used instead. See Figure 6.10: Multi-line "Forward" Spatial Scan.
We advise observers that neither the CALWF3 pipeline nor generic analysis software is designed to calibrate spatially scanned ACS, STIS or WFC3 data and you should plan accordingly.
PARallel <parallel-exp-list> WITH <primary-exp-list>
|This special requirement has been replaced in the APT User Interface with the use of . See Exposure Containers: Exposure Sequences, Coordinated Parallels and Patterns.|
This special requirement specifies that the exposures in <parallel-exp-list> will execute in parallel with a sequence of exposures in <primary-exp-list>. In the Text Proposal File, both <primary-exp-list> and <parallel-exp-list> must be replaced by either a single exposure number, or a range of exposure numbers separated by a hyphen. See Coordinated Parallel Containers for more details.
SAA CONTOUR <model number>
QASISTATES <si> <detector> <start> <end>
QESIPARM <parameter> <value>
QELOGSHEET <parameter> <value>
Special Communications Requirements
Specifies that the current science exposure must be made available to the observer for analysis in real time. Any science exposures whose execution depends upon a decision based on the real-time analysis should have RT ANALYSIS specified. The REQuires UPLINK Special Requirement may also be used with RT ANALYSIS to establish the ground-to-spacecraft link. The current exposure will be available for analysis at least 16 minutes (for fixed targets) prior to that uplink; for moving targets the time is 24 minutes.
This Special Requirement is a limited resource and should only be used when necessary (please consult with your PC prior to using this mode). Justification for its necessity should be included in the Real_Time_Justification text.
Note that the exposures in the <exposure-list> must be in the same visit as the current exposure, and RT ANALYSIS may not be used if the exposure uses patterns or if Number_of_Iterations > 1.
Indicates that a real-time command uplink is needed to execute this exposure. An uplink will be scheduled prior to the current exposure. This Special Requirement should be used with RT ANALYSIS to replace the capability formerly available with INTeractive ACQuisition (obsolete) and it should specifically identify which exposures need an uplink, assuming that the uplink already provided is not sufficient. This Special Requirement can also be used without RT ANALYSIS if the information which needs to be uplinked is not dependent on real-time analysis of HST data. Usage of this Special Requirement is considered a limited resource and should only be used when necessary. Justification for its necessity should be included in the Real_Time_Justification text.
|Note that for ALIGN mode exposures (with any configuration) that use REQuires UPLINK, no Optional Parameters are allowed.|
REQuires EPHEMeris CORRection <id>
Indicates that a correction for position errors due to moving-target and/or HST ephemeris uncertainty may be needed to execute the exposure. This Special Requirement is only valid for exposures with moving targets. The offset will be uplinked during an available (“generic”) uplink prior to the earliest exposure that uses it. The pointing correction may require a minute or two of orbital visibility time.
An ephemeris correction is needed in two cases:
- When observing an object within about 1 AU of the Earth. In this case, the uncertainty in the position of HST accumulated between the time the schedule is built and the time it is executed can cause the observation to miss the target. (The HST ephemeris is inaccurate by as much as 60 seconds, which translates into a positional error on the moving target). The offset can be easily calculated by STScI personnel in this case.
- When observing an object with an uncertain ephemeris. In this case, updated positions may be used until shortly before the observation actually executes, even though the elements in the program are out of date. Again, STScI personnel can easily determine the proper offset.
With moving targets, the maximum target ephemeris uncertainty must be specified in the solar-system target list (see 3.2 Solar System Targets. STScI will be unable to schedule corrections larger than the maximum offset derived from this uncertainty, so too small an uncertainty may limit the usefulness of the REQ EPHEM CORR procedure. However, offsets larger than about 1 arcminute may make scheduling difficult. If your observation requires a correction this large, contact your Program Coordinator.
The <id> is an alphanumeric string of up to six characters in length. Exposures with the same REQ EPHEM CORR ID (whether in the same visit or in different visits) will use the same offset and must be taken at the same orientation. If exposures in different visits use the same ID, the visits involved are all subject to the same scheduling restrictions as SAME ORIENTation AS <visit>. The SAME ORIENT Special Requirement is implied across such a set of visits, and need not be specified directly.
|Note that REQ EPHEM CORR uses the uncertainties in target coordinates to determine the size of a possible offset maneuver. Therefore those uncertainties must be supplied accurately.|