Visit Timing
Visit timing is part of the total time estimated by JWST's Astronomer’s Proposal Tool (APT). This page describes the components of visit timing.
General visit overhead
Visit overhead is described in Table 1.
Table 1. Visit overhead time
Activity | Time (seconds) | Comment |
---|---|---|
OPE constraint scripts | 20 | |
Disable fine guide | 30 | if visit has fine guiding |
The following templates have additions to visit overheads:
- NIRCam aditions to visit overhead
- NIRSpec additions to visit overhead
- NIRISS additions to visit overhead
- MIRI additions to visit overhead
- WFSC additions to visit overhead
Note that mechanism moves performed at the start or end of the visit are included in visit overheads but are not identified as mechanism overheads in the APT times report.
Visit timing model
Several intermediate values for visit timing need to be reported in order to support other systems and user interest. These include:
Science duration
Science duration is defined as the sum of the Photon Collecting Time of the exposures in the visit. This value is based on the instrument mode, subarray, readout pattern, number of integrations, and number of groups, as defined in the Proposal Instructions, Appendix D. It does not include the internal exposure overheads of the Frame Synchronization, Frame Resets, and Exposure Setup and Clean up. Those values are considered Exposure Overhead (see Exposure Timing).
SCIENCE_DURATION = SUM(CEILING(PHOTON_COLLECT_TIME for each exposure in the Visit))
Initial overhead
The Initial Overhead is the time between the end of the visit slew activity and the start of the first Science Activity. It includes the Guide Star Acquisition, Target Acquisition, and the initial movement of any filters, pupils, or other mechanisms. This time is used when setting scheduling windows to allow timing requirements to specify a time when science activities will start.
INITIAL_OVERHEAD = GS_ACQ_TIME + TARGET_ACQ_TIME + [FILTER_MOVE_TIME, if first science filter is not = TA filter]
Table 2. Initial overhead
Activity | Time (seconds) | Comment |
---|---|---|
OPE constraint scripts | 20 | |
GS Acquisition | 284 | if visit has fine quiding |
Target Acq[1] | 300 | if visit has TA |
Certain templates have additions to initial overheads (see Instrument Specific Overheads).
Overhead duration
(also see Overhead Duration Components)
Overhead duration is meant to account for all of the direct, non-science activities that occur in the visit to support the exposures. As such, it includes the initial overhead, plus all the additional overheads for mechanism movements, pointing changes (SAMs), and exposure overhead from setup, cleanup, and frame resets noted above.
OVERHEAD_DURATION = INITIAL_OVERHEAD + VISIT_START_OVERHEADS + SUM(SAM_TIMEs) + (#MECHANISMS-1 * FILTER_MOVE_TIME) + EXPOSURE_OVERHEAD + INSTRUMENT_SPECIFIC_OVERHEADS + VISIT_CLEANUP
Table 3. Overhead duration
Activity | Time (seconds) | Comment |
---|---|---|
Disable fine guide | 30 | if visit has fine guiding |
Notes:
- This is also called Instrument Overheads in the APT GUI and Timing report.
- #Pointings may be 1 more than the number of Dithers if the Template has a Target Acquisition and the final pointing of the TA is not the same as the first science pointing.
- If two pointings in succession are equal then there will be no SAM for that pointing change.
- Some templates have multiple filters or filter/grating combinations and will get 2*FILTER_MOVE_TIME. This includes NIRCAM, where it is possible for the wheels to move simultaneously, and therefore not actually require that time.
Guide star acquisition time
GS_ACQ_TIME
= 0s if an Internal template is used
=475s if target is in a Bright Crowded Field
otherwise:
= 151s (small slew)
=294s (standard slew)
Slew duration
(also see Slew times)
APT uses a conservative model for the slew duration of a visit when it cannot determine how far it is likely a given visit will need to slew to start. This comes from the PRD, timing_model_overheads table. However, additional visits within an observation, and some observations which can be scheduled in near proximity can have their expected slew times calculated more accurately based on the known position of other visits. APT performs an analysis of an entire program to determine the expected slew time of the visits within it. This process is called Smart Accounting. Smart Accounting seeks to identify the likelihood that any particular observations in a program can be scheduled together. APT will then assign either the default initial slew time for an independent visit, or will calculate the slew time by looking up values from the PRD visit_slew_table.
SLEW_DURATION
= 0 for unpointed visits
= initial slew duration from PRD for initial visit in a scheduling set
= derived from PRD visit_slew table otherwise