! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! SDDL Name: QALIGNMENT.SDDL ! ! Purpose: This SDDL file defines the qalignment relation. ! ! Modification History: ! ! Date PR Who Reason ! -------- ------- --- ------------------------------------------------- ! 11/18/94 27329 RJS Original implementation ! 03/17/95 27408 RJS Update CALC_SAM description ! 07/20/95 28642 SXT Add new fields: low_sky & moon_avd_ang ! 11/10/95 28062 SBA overlaps ! 01/31/96 28642 MRB Expand information on fields low_sky & moon_avd_ang ! 03/12/96 20893 MRB Remove TDRS contact fields, IM now using QReadout ! 05/10/96 31409 NLC Added field: si_intrlv !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! LANGUAGE FORTRAN, SQL INCLUDE ZSPSS_USER_TYPES.SDDL RECORD QALIGN_TYPE !------------------------------------------------------------------------------ ! ! RECORD INFORMATION ! !------------------------------------------------------------------------------ DESCRIPTION "This is the master relation for alignment data in the PMDB. An alignment is a collection of exposures that are grouped together based upon changes in the target/aperture combinations and the length of a visibility period. That is, a separate alignment is generated if the target or aperture changes between eposures or the sum of the exposure times is greater than a visibility period. In general, alignments that are grouped into an observation set all share the same pointing. Alignments are the lowest level entity that the SPSS calendar scheduling software deals with. The calendar is not concernerd with exposures. The commands PMDB/UPDATE, CCLIST/CREATE, and CALENDAR/*, and others access most of the fields in this relation. Data contained here ranges from alignment SAA information, to timing information, alignment target usage, PCS restrictions, and much more." !------------------------------------------------------------------------------ ! ! FIELD INFORMATION ! !------------------------------------------------------------------------------ FIELD proposal_id TYPE PROPOSAL_ID_TYPE FORM NAME "AGD" LABEL "PROPOSAL ID" END_FORM END_FIELD FIELD obset_id TYPE OBSET_ID_TYPE FORM NAME "AGD" LABEL "OBSET ID" END_FORM END_FIELD FIELD alignment_id TYPE ALIGN_ID_TYPE FORM NAME "AGD" LABEL "ALIGN ID" END_FORM END_FIELD FIELD version_num TYPE VERSION_NUM_TYPE FORM NAME "AGD" LABEL "VERSION NUM" END_FORM END_FIELD FIELD align_type TYPE C2 DESCRIPTION "This field specifies the type of alignment, where 'TA' = target acquisition 'DC' = data collection 'CA' = calibration 'RC' = si reconfiguration 'NL' = null. type indicates the predominant type of exposures associated with the alignment." FORM NAME "AGD" LABEL "ALIGN. TYPE (CA/DC/RC/TA/NL)" END_FORM DISCRETE "CA", "DC", "NL", "RC", "TA" END_FIELD FIELD low_priority TYPE YES_NO_FLAG_TYPE DESCRIPTION "When this field is 'Y' it indicates this alignment is for a low priority target." FORM NAME "AGD" LABEL "LOW PRIORITY TARGET/ALGN (Y/N)" END_FORM END_FIELD FIELD astrometry TYPE YES_NO_FLAG_TYPE DESCRIPTION "When this field is 'Y' it indicates this is an astrometry alignment." FORM NAME "AGD" LABEL "ASTROMETRY ALIGN. FLAG (Y/N)" END_FORM END_FIELD FIELD sequence TYPE I2 DESCRIPTION "This field specifies the sequence number (order) of this alignment in the observation set. The software sorts alignments based on two sort fields: sequence and alignment id; therefore if all sequence fields are zero (by default), the alignments will be sequenced by alignment_id." FORM NAME "AGD" LABEL "SEQUENCE NUMBER" END_FORM END_FIELD FIELD excute_slew TYPE YES_NO_FLAG_TYPE DESCRIPTION "When this field is 'Y' it indicates this alignment can be executed during a maneuver. It is illegal to attach a parallel to this alignment. When this flag is 'Y', then there is a POSSIBILITY that a maneuver would overlap the alignment. In this overlap situation, the parallel place (maneuver to maneuver) is undefined. To avoid having to deal with this undefined state, SPSS will not allow a parallel SU that is attached to any primary alignment whose excute_slew ='Y' to be added to the C&Clist via CCLIST/CREATE or CANDLIST/ADDSUS." FORM NAME "AGD" LABEL "EXECUTE DURING SLEW" END_FORM END_FIELD FIELD oss_overload TYPE I4 UNITS "SECONDS" DESCRIPTION "This field specifies the OSS overload time. This is the amount of time to allow after this alignment if it is followed by real time activity. This gives OSS enough time to catch up with their processing so that they can process the real time data." FORM NAME "AGD" LABEL "OSS OVERLOAD TIME" END_FORM END_FIELD FIELD shadow TYPE C1 DESCRIPTION "This field indicates how this alignment must be scheduled relative to the earth's shadow. 'Y' = must be scheduled in shadow. 'A' = must be scheduled to avoid shadow. 'C' = must avoid shadow crossing. 'N' = no constraint at all." FORM NAME "AGD" LABEL "SCHED. IN EARTH SHAD (Y/N/A/C)" END_FORM DISCRETE "A", "C", "N", "Y" END_FIELD FIELD interrupt TYPE YES_NO_FLAG_TYPE DESCRIPTION "When this field is 'Y' it indicates this alignment can be interrupted for occultations and other reasons. 'N' means it must be scheduled as a whole entity." RELATED_FIELDS "qalignment.int_overhead", "qalignment.min_interrup", "qbs_obset.interrupt" FORM NAME "AGD" LABEL "INTERRUPTION ALLOWED (Y/N)" END_FORM END_FIELD FIELD min_interrup TYPE I4 DESCRIPTION "This field specifies the minimum duration for each interrupted alignment segment. This is set only if the QALIGNMENT.interrupt field='Y'. For each non-interruptable alignment, this field is set to QALIGNMENT.time_require less any start and end overheads. This is set during PMDB/UPDATE." RELATED_FIELDS "qalignment.interrupt" UNITS "SECONDS" FORM NAME "AGD" LABEL "MIN. SCIENCE DURATION" END_FORM END_FIELD FIELD interleaver TYPE YES_NO_FLAG_TYPE DESCRIPTION "When this field is 'Y' it indicates that a same SI interleaver is allowed." FORM NAME "AGD" LABEL "SAME SI INTERLEAVERS (Y/N)" END_FORM END_FIELD FIELD int_aftr_ths TYPE C1 DESCRIPTION "This field indicates whether or not an interrupt is permitted between this alignment and the next. The setting of this flag determines the method used to get the values for min and max separation between this alignment and the one following: QALIGNMENT.min_sep_dur and QALIGNMENT.max_sep_dur. 'D' means take the default values for qalmnp and qalmxp, 'Y' means do not recompute these values, 'N' causes values to be computed for these variables which eliminate in scheduling the chance for an interrupt occuring. For more details see the requirements written by J. Isaacs in the comment section of opr 18592." FORM NAME "AGD" LABEL "INTERRUPT PERMITTED BETWEEN THIS ALIGN. AND THE NEXT (Y/N/D)" END_FORM DISCRETE "D", "N", "Y" END_FIELD FIELD calc_sam TYPE YES_NO_FLAG_TYPE DESCRIPTION "When this field is 'Y' it indicates a SAM calculation is to be performed by PMDB/UPDATE for this alignment (target acquisition or science). The result is stored in SAM_TIME. When set to 'N', and the alignment requires a SAM, then the user specified SAM_TIME via PFORM AGD will be used in scheduling. Note that scheduling will also compute a SAM duration. The maximum of the scheduling and PMDB/UPDATE/TYPE=SU computed SAM durations will be used to schedule a SAM activity." FORM NAME "AGD" LABEL "CALC. SMALL ANGLE MANEUVER" END_FORM END_FIELD FIELD sam_time TYPE I4 UNITS "SECONDS" DESCRIPTION "This field specifies the small angle maneuver time required to be scheduled before this alignment (target acquisition or science) begins." FORM NAME "AGD" LABEL "SMALL ANGLE MANUEVER TIME" END_FORM END_FIELD FIELD acq_time TYPE I4 DESCRIPTION "This field specifies the target acquisition time required for this pointing. This is the time to be scheduled for the initial target acquisition for this alignment. This time will be scheduled uninterrupted." UNITS "SECONDS" FORM NAME "AGD" LABEL "TARGET ACQUISITION" END_FORM END_FIELD FIELD time_require TYPE I4 DESCRIPTION "This field specifies the total science time associated with this alignment. This should include the sum of exposure times including SI configuration change time, readout time, SI calibration time, etc. It excludes the initial target acquisition time." UNITS "SECONDS" FORM NAME "AGD" LABEL "TOTAL ALIGN. SCI. TIME" END_FORM END_FIELD FIELD time_calc TYPE I4 UNITS "SECONDS" DESCRIPTION "This field specifies the total calculated alignment time. It specifies the total time associated with pointing for this alignment. This includes the sum of exposure times including SI configuration change time, readout time, target (re)acquisition times, and the SI calibration time." FORM NAME "AGD" LABEL "CALC. ALIGN. TIME" END_FORM END_FIELD FIELD backgr_lite TYPE R4 DESCRIPTION "This field specifies background light requirements. It is the signal to noise ratio used in the exposure time tool (SOGS ii) to calculate exposure time based on when the alignment is scheduled. This is set in PMDB/UPDATE as the most restrictive (maximum) of all associated exposure values." FORM NAME "AGD" LABEL "BACKGROUND LIGHT LEVEL" END_FORM END_FIELD FIELD data_volume TYPE R*4 DESCRIPTION "This field specifies the expected data volume for this alignment in kilobits. This is calculated by as the sum of all exposure data volume estimates." UNITS "KILOBITS" FORM NAME "AGD" LABEL "SCIENCE DATA" END_FORM RANGE END_FIELD FIELD calib_volume TYPE R*4 DESCRIPTION "This field specifies the expected calibration data volume for this alignment. This is calculated as the sum of all calibration exposure (exposure type = 'CA') data volume estimates." UNITS "KILOBITS" FORM NAME "AGD" LABEL "CALIBRATION DATA" END_FORM END_FIELD FIELD tape_recordr TYPE C1 DESCRIPTION "This field indicates the usage of the tape recorder for this alignment, where 'Y' = use tape recorder, 'N' = not use tape recorder, 'B' = use tape recorder as backup." RELATED_FIELDS "qreadout.tape_mode" FORM NAME "AGD" LABEL "TAPE RECORDER USAGE (Y/N/B)" END_FORM DISCRETE "B", "N", "Y" END_FIELD FIELD prim_target TYPE TARGET_ID_TYPE DESCRIPTION "This field specifies the primary target to which this alignment is pointed." FORM NAME "AGD" LABEL "PRIMARY TARGET ID" END_FORM END_FIELD FIELD ref_target TYPE TARGET_ID_TYPE DESCRIPTION "This field specifies the reference target which is used in target acquisition of the primary target. By default this field is blank." FORM NAME "AGD" LABEL "REFERENCE TARGET ID" END_FORM END_FIELD FIELD target_type TYPE C1 DESCRIPTION "This field specifies the target type for this alignment, where 'P' = Point, 'A' = Area, 'M' = Moving, 'E' = Earth, 'G' = Generic, 'N' = No target." FORM NAME "AGD" LABEL "TARGET TYPE (A/E/G/M/P/N)" END_FORM DISCRETE "A", "E", "G", "M", "N", "P" END_FIELD FIELD calibr_type TYPE C1 DESCRIPTION "This field specifies the calibration type for alignments with QALIGNMENT.align_type = 'CA', where 'I' = Internal, 'E' = External, 'N' = Not applicable." UNITS FORM NAME "AGD" LABEL "CALIBRATION TYPE (I/E/N)" END_FORM DISCRETE "E", "I", "N" END_FIELD FIELD inner_radius TYPE R4 DESCRIPTION "This field specifies the angle from the center of the earth to the inner edge of the annulus around the earth where the calibration is to be performed. set if QALIGNMENT.target_type = 'E' (earth). Used with QALIGNMENT.outer_radius for flat field or aperture calibration exposures." FORM NAME "AGD" LABEL "INNER RADIUS" END_FORM UNITS "DEGREES" END_FIELD FIELD outer_radius TYPE R4 DESCRIPTION "This field specifies the angle from the center of the earth to the outer edge of the annulus around the earth where the calibration is to be performed. Set if QALIGNMENT.target_type = 'E' (earth). Used with QALIGNMENT.inner_radius for flat field or aperture calibration exposures." FORM NAME "AGD" LABEL "OUTER RADIUS" END_FORM UNITS "DEGREES" END_FIELD FIELD min_brit_lmt TYPE R4 DESCRIPTION "This field specifies the minimum earth limb brightness. Set if QALIGNMENT.target_type = 'E'." FORM NAME "AGD" LABEL "MIN. BRIGHTNESS" END_FORM UNITS END_FIELD FIELD max_brit_lmt TYPE R4 DESCRIPTION "This field specifies the maximum earth limb brightness. set if QALIGNMENT.target_type = 'E'." FORM NAME "AGD" LABEL "MAX. BRIGHTNESS" END_FORM UNITS END_FIELD FIELD ephemeris_fl TYPE C9 DESCRIPTION "This field is obsolete." END_FIELD FIELD jpl_fl TYPE C2 DESCRIPTION "This field is obsolete. It held the name of the moving target in the jpl file where: me = mercury; ve = venus; ma = mars; ju = jupiter; sa = saturn; ur = uranus; ne = neptune; pl = pluto; mo = moon " END_FIELD FIELD ephem_fl_typ TYPE C1 DESCRIPTION "This field is obsolete." END_FIELD FIELD saa_avoid TYPE SAA_MODEL_TYPE DESCRIPTION "This field defaults to the avoidance model id of the SI specified in QAPOSITION.si_used, where QAPOSITION.initial_pos = 'I' or 'B'. It is only used and set if the SAA avoidance flag QALIGNMENT.saa_flag = 'Y' or 'I'." FORM NAME "AGD" LABEL "MODEL ID (02-99)" END_FORM END_FIELD FIELD saa_ovr TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field is the SI SAA avoidance model ID override FLAG. A value of 'Y' in indicates that the QALIGNMENT.saa_avoid model should be used as the SI SAA avoidance model ID for the alignment. A value of 'N' specifies that the SI SAA avoidance model ID used will be the avoidance model ID of the SI specified in QAPOSITION.si_used, where QAPOSITION.initial_pos = 'I' or 'B'. This field is ignored if QALIGNMENT.saa_flag = 'N'." RELATED_FIELDS "qalignment.saa_flag", "qalignment.saa_avoid", "qbs_obset.saa_ovr" FORM NAME "AGD" LABEL "MODEL OVERRIDE FLAG (Y/N)" END_FORM END_FIELD FIELD recovery_tm TYPE I4 DESCRIPTION "This field specifies the SI SAA exit recovery time. It defaults to the recovery time of the SI specified in QAPOSITION.si_used, where QAPOSITION.initial_pos = 'I' or 'B'. This field is ignored when QALIGNMENT.saa_flag = 'N'." UNITS "SECONDS" FORM NAME "AGD" LABEL "RECOVERY TIME" END_FORM END_FIELD FIELD recovery_ovr TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field is the SI SAA recovery time override flag, where 'N' = default to the ST PDB recovery time of the SI specified in QAPOSITION.si_used, where QAPOSITION.initial_pos = 'I' or 'B'; 'Y' = user override value is input; Ignored when QALIGNMENT.saa_flag = 'N'." FORM NAME "AGD" LABEL "RECOVERY OVER. FLAG (Y/N)" END_FORM END_FIELD FIELD target_acqsi TYPE C2 DESCRIPTION "This field indicates the target acquisition mode for this pointing where 01 = mode I (ground assisted target acquisition requiring realtime tdrs contact), 02 = mode II (onboard computer assisted correction to target position), 03 = mode III (fixed simple pointing requiring no special target acquisition activity), 00 = null implies there is no target" FORM NAME "AGD" LABEL "TARGET ACQUISITION MODE (00-99)" END_FORM RANGE "00..99" END_FIELD FIELD camera_ast TYPE C4 DESCRIPTION "This field is used to indicate if the target acquisition is camera assisted for SI assist modes 1, 2 target acquisition along with scanning techniques where 'NONE' = no camera assist, 'FOC' = FOC camera assist, 'WFC' = WF camera assist, 'PC' = PC camera assist." FORM NAME "AGD" LABEL "CAMERA ASSIST (FOC/WFC/PC/NONE)" END_FORM DISCRETE "FOC", "NONE", "PC", "WFC" END_FIELD FIELD pointing_mde TYPE C1 DESCRIPTION "This field specifies the specifies the ST pointing mode. If the pointing mode is track, the target must be a moving target, and optimal GS hand-off sequences will be generated in the response for tracking the target. Values are 'F' for fixed, 'T' for track, 'S' for ????." UNITS FORM NAME "AGD" LABEL "POINTING MODE (F/T/S)" END_FORM DISCRETE " ", "F", "S", "T" END_FIELD FIELD track_source TYPE C1 DESCRIPTION "This field is used to indicate the source of tracking parameters. Values are 'D' = derived from target ephemeris, 'S' = specified." FORM NAME "AGD" LABEL "TRACKING SOURCE FLAG (D/S)" END_FORM DISCRETE " ", "D", "S" END_FIELD FIELD scan_type TYPE C1 DESCRIPTION "This field specifies the spatial scan mode types. Possible values are 'C' = continuous 'D' = dwell 'N' = not applicable The 'C' type is a series of linear scans alternating in direction and offset from one another by a small angle separation (a linear scan is a slew of the ST optical axis from point a to b on the celestial sphere at a constant commanded rate); The 'D' type is like a continuous scan with a specified number of dwell points per line and time to wait at each dwell point. Type 'N' signifies that this field is applicable, i.e. no scan is required." FORM NAME "AGD" LABEL "SCAN TYPE (C/D/N)" END_FORM DISCRETE " ", "C", "D", "N" END_FIELD FIELD scan_coord TYPE C1 DESCRIPTION "This field is used to indicate the scan coordinate frame of reference. Possible values are 'C' = celestial frame (ra-dec), 'V' = vehicle (v1v2v3)." FORM NAME "AGD" LABEL "SCAN COORDINATE FRAME (C/V)" END_FORM DISCRETE " ", "C", "V" END_FIELD FIELD dwells_line TYPE I2 DESCRIPTION "This field specifies the number (1-99) of dwell points per line for scan pointing mode. It is set if this is a dwell scan" FORM NAME "AGD" LABEL "POINTS PER LINE" END_FORM END_FIELD FIELD time_dwell TYPE R4 DESCRIPTION "This field specifies the wait time (duration) at each dwell point in seconds (1 x 10e-1 precision). It is set only if this is a dwell scan alignment." UNITS "SECONDS" FORM NAME "AGD" LABEL "WAIT TIME PER POINT (secs)" END_FORM END_FIELD FIELD df224_pit TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field is used to indicate the setting of a bit in the process interface table (pit) by the NSSC1 to indicate to the DF224 upon activation to start the scan." FORM NAME "AGD" LABEL "DF224 PIT FLAG (Y/N)" END_FORM END_FIELD FIELD scan_angle TYPE R4 DESCRIPTION "This field specifies the position angle (0 to 360) of scan line when QALIGNMENT.scan_coord is equal to 'C', this is the counterclockwise angle, about the beginning of the first scan, from north at the target to the direction of the first scan. When scan_coord is equal to v, this is the counterclockwise angle from the positive v3-axis to the direction of the first scan. (1 x 10e-4 precision)" UNITS "DEGREES" FORM NAME "AGD" LABEL "POS. ANGLE of SCAN LINE (deg)" END_FORM END_FIELD FIELD scan_rate TYPE R4 UNITS "ARCSECONDS/SECOND" DESCRIPTION "This field specifies the commanded constant rate of the line scan (slew of the st optical axis from point a to b on the celestial sphere)." FORM NAME "AGD" LABEL "SCAN RATE (arcsec/sec)" END_FORM END_FIELD FIELD number_lines TYPE I2 DESCRIPTION "This field specifies the number of lines per scan." FORM NAME "AGD" LABEL "NUMBER OF LINES PER SCAN" END_FORM RANGE "1..99" END_FIELD FIELD scan_width TYPE R4 DESCRIPTION "This field specifies the scan width (0.,3600.)." UNITS "ARCSECONDS" FORM NAME "AGD" LABEL "SCAN WIDTH (arcsec)" END_FORM RANGE "0..360" END_FIELD FIELD scan_length TYPE R4 DESCRIPTION "This field specifies the scan length ( 0.,3600.)." UNITS "ARCSECONDS" FORM NAME "AGD" LABEL "SCAN LENGTH (arcsec)" END_FORM RANGE "0..360" END_FIELD FIELD angle_sides TYPE R4 DESCRIPTION "This field specifies the angle (0-360) between sides of scan parallelogram clockwise angle, about the beginning of the first scan, from the direction of the first scan to the side of the scan parallogram. (1X10E-04 precision)." UNITS "DEGREES" FORM NAME "AGD" LABEL "PARALLELOGRAM (arcsec/sec)" END_FORM RANGE "0..360" END_FIELD FIELD duration TYPE I4 DESCRIPTION "This field specifies the duration of the scan." UNITS "SECONDS" FORM NAME "AGD" LABEL "TOTAL DURATION" END_FORM END_FIELD FIELD sis_used TYPE I2 DESCRIPTION "See description in qscheduling.sis_used" RELATED_FIELDS "qscheduling.sis_used" END_FIELD FIELD fhstpar TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field indicates whether an FHST update can be scheduled in parallel with this alignment." FORM NAME "AGD" LABEL "FHST/ALIGNMENT PARALLEL (Y/N)" END_FORM END_FIELD FIELD dark_er_occ TYPE R4 DESCRIPTION "This field specifies the dark earth avoidance angle for computing target visibility. A target will be considered occulted by the dark earth if the line of sight vector to the target is within this angle of the dark earth limb." UNITS "DEGREES" FORM NAME "AGD" LABEL "OBDARK LIMB OCC." END_FORM RELATED_FIELDS "widcr_parms.dark_er_angl" END_FIELD FIELD brit_er_occ TYPE R4 DESCRIPTION "This field specifies the bright earth avoidance angle for computing target visibility. A target will be considered occulted by the bright earth if the line of sight vector to the target is within this angle of the bright earth limb." UNITS "DEGREES" FORM NAME "AGD" LABEL "BRIT LIMB OCC." END_FORM RELATED_FIELDS "widcr_parms.brit_er_angl" END_FIELD FIELD si_parallel TYPE YES_NO_FLAG_TYPE DESCRIPTION "This flag specifies whether an SI activity can be scheduled in parallel with the alignment." FORM NAME "AGD" LABEL "SI PARALLEL (Y/N)" END_FORM END_FIELD FIELD occ_ovr TYPE YES_NO_FLAG_TYPE DESCRIPTION "This flag specifies whether target earth avoidance is a constraint for this alignment. 'Y' means override target earth avoidance." FORM NAME "AGD" LABEL "OVERRIDE FLAG (Y/N)" END_FORM END_FIELD FIELD gsss_request TYPE YES_NO_FLAG_TYPE DESCRIPTION "This flag indicates if the qalignment data should be sent in a GSSS request. If 'N', data will not be extracted from the corresponding record. If 'Y', data will be extracted from the corresponding record. The purpose of this field is to avoid replicating data in the GSSS request (e.g. for duplicate alignments), and also to avoid sending data in the GSSS request which should not be considered when selecting guide stars (e.g. for certain exposures of astrometry reference stars) " FORM NAME "AGD" LABEL "OBSS REQUEST (Y/N)" END_FORM END_FIELD FIELD max_int_dur TYPE I4 DESCRIPTION "This field specifies the maximum time the alignment may be interrupted, as measured from the end of the last science activity before the interruption to the start of the first science activity after the interruption." RELATED_FIELDS "qalignment.interrupt", "qbs_obset.max_int_dur" UNITS "SECONDS" FORM NAME "AGD" LABEL "MAX INTERRUPT DURATION" END_FORM END_FIELD FIELD min_sep_dur TYPE I4 DESCRIPTION "This field specifies the minimum separation time between this alignment and the next alignment. Separation is measured from the start of the first science activity of this alignment to the start of the first science activity of the next alignment." UNITS "SECONDS" FORM NAME "AGD" LABEL "MIN SEPARATION DURATION" END_FORM END_FIELD FIELD max_sep_dur TYPE I4 DESCRIPTION "This field specifies the maximum separation time between this alignment and the next alignment. Separation is measured from the start of the first science activity of this alignment to the start of the first science activity of the next alignment." UNITS "SECONDS" FORM NAME "AGD" LABEL "MAX SEPARATION DURATION" END_FORM END_FIELD FIELD int_overhead TYPE I4 DESCRIPTION "This field specifies the overhead time added to each interrupted alignment segment other than the first." RELATED_FIELDS "qalignment.interrupt" UNITS "SECONDS" FORM NAME "AGD" LABEL "INTERRUPT OVERHEAD" END_FORM END_FIELD FIELD saa_flag TYPE C1 DESCRIPTION "This field specifies whether an SAA avoidance check is to be performed for this alignment. Possible values are 'Y' = consider saa avoidance 'N' = do not consider SAA avoidance 'I' = do alignment in SAA region." FORM NAME "AGD" LABEL "SAA CHECK FLAG (Y/N)" END_FORM DISCRETE "I", "N", "Y" END_FIELD FIELD beg_tim_delt TYPE I4 UNITS "SECONDS" DESCRIPTION "This field specifies the earth shadow time delta for shadow/avoid-shadow entry. It specifies the time delta in seconds to be added to shadow/avoid shadow entry time. This field is used in conjunction with QALIGNMENT.shadow as follows: if QALIGNMENT.shadow = 'Y', added to shadow entry time, if QALIGNMENT.shadow = 'A', added to avoid-shadow start time." FORM NAME "AGD" LABEL "BEGIN DELTA" END_FORM END_FIELD FIELD end_tim_delt TYPE I4 DESCRIPTION "This field specifies the earth shadow time delta for shadow/avoid-shadow exit. It specifies the time delta in seconds to be added to shadow/avoid-shadow exit time. This field is used in conjunction with QALIGNMENT.shadow as follows: if QALIGNMENT.shadow = 'Y', added to shadow exit time, if QALIGNMENT.shadow = 'A', added to avoid-shadow end time." UNITS "SECONDS" FORM NAME "AGD" LABEL "END DELTA" END_FORM END_FIELD FIELD par_readout TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field specifies whether science data readouts can be scheduled in parallel with the alignment." RELATED_FIELDS "qreadout.par_readout" FORM NAME "AGD" LABEL "PARALLEL DATA READOUT (Y/N)" END_FORM END_FIELD FIELD set_mech_mot TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field specifies whether the set mechanism motion flag can be set during the alignment. This alignment may not be scheduled in parallel with an obset which does not permit the mechanism motion flag to be set." END_FIELD FIELD par_allowed TYPE PAR_ALLOWED_TYPE FORM NAME "AGD" LABEL "PARALLELS ALLOWED TYPE (Y/N/I/A)" END_FORM END_FIELD FIELD nssc1_used TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field specifies whether the NSSC-1 scratch pad used anywhere during this alignment. This will always be 'Y' if there is at least one QREADOUT record with NSSC interval_typ for this alignment. But, it could be 'Y' even if there are no QREADOUT records." FORM NAME "AGD" LABEL "NSSC-1 SCRATCH PAD MEMORY (Y/N)" END_FORM END_FIELD FIELD ea_duration TYPE I4 DESCRIPTION "THIS FIELD IS OBSOLETE." END_FIELD FIELD saa_duration TYPE I4 DESCRIPTION "THIS FIELD IS OBSOLETE." END_FIELD FIELD coor_par_exp TYPE YES_NO_FLAG_TYPE DESCRIPTION "This field specifies whether this alignment contains any coordinated parallel exposures. It is used for CALENDAR/DISPLAY purposes only." FORM NAME "AGD" LABEL "COORDINATED PARALLEL EXPOSURE (Y/N)" END_FORM END_FIELD FIELD max_al_dur TYPE I4 DESCRIPTION "This fields specifies the maximum elapsed time from the start of the alignment to the end of the alignment including any interruptions which may occur. " UNITS "SECONDS" RELATED_FIELDS "qbs_obset.max_ob_dur", "qscheduling.max_su_dur" FORM NAME "AGD" LABEL "MAXIMUM ALIGN. DURATION" END_FORM END_FIELD FIELD ovratalstart TYPE I4 DESCRIPTION "This field specifies the duration of the overhead at the start of an alignment which may be scheduled outside target/FGS visibility windows due to SAA, occultation, and shadow restrictions." UNITS "SECONDS" FORM NAME "AGD" LABEL "OVERHEAD AT ALIGNMENT START" END_FORM END_FIELD FIELD ovratalend TYPE I4 DESCRIPTION "This field specifies the duration of the overhead at the start of an alignment which may be scheduled outside target/FGS visibility windows due to SAA, occultation, and shadow restrictions." UNITS "SECONDS" FORM NAME "AGD" LABEL "OVERHEAD AT ALIGNMENT END" END_FORM END_FIELD FIELD mustusegyro TYPE YES_NO_FLAG_TYPE DESCRIPTION "This flag specifies whether this alignment must be executed under gyro control. FORM NAME "AGD" LABEL "MUST USE GYRO (Y/N)" END_FORM END_FIELD FIELD guide_tolera TYPE R4 DESCRIPTION "This field specifies the maximum accumulated position uncertainty from the end of FGS control to the end of the non-overhead portion of the alignment. This can be set in a way so that the alignment can extend past fgs visibility." UNITS "ARCSECONDS" FORM NAME "AGD" LABEL "GUIDING TOL." END_FORM END_FIELD FIELD low_sky TYPE YES_NO_FLAG_TYPE DESCRIPTION "The low_sky flag indicates whether an alignment has an exposure that uses the LOW-SKY special requirement." END_FIELD FIELD moon_avd_ang TYPE R4 DESCRIPTION "This field contains the avoidance angle from the center of the moon. SPSS needs to know the moon avoidance angle for an obset so it can compute its moon avoidance windows during obset-level PMDB/UPDATE. SPSS uses QBOverrides data if it exists. If not, take the maximum QAlignment moon_avd_ang value (in degrees) over all alignments in the obset, assuming it is a positive number (0 is equivalent to `unspecified'). If there is no alignment for which moon_avd_ang was populated with a nonzero value, then fall back on the WIDCR_Parms default. Note that this is suboptimal in the case where an obset contains some LOW-SKY and some non-LOW-SKY alignments, since the LOW-SKY moon avoidance angle will be applied to the entire obset even though it is only needed for part of it. A more accurate approach would move the moon avoidance window processing down to the alignment level, but this would be a major project in SPSS and is not warranted just to optimize LOW-SKY. However, the moon avoidance field is still being defined at the alignment level to preserve the option of doing thisat some later time. There was some discussion on whether Trans should populate moon_avd_ang for all alignments or just the LOW-SKY alignments. Doing the latter would preserve our freedom to change WIDCR_Parms without also changing Trans, but the former approach is more consistent with the way earth avoidance angles are handled and makes for a cleaner interface in my opinion (the data is always coming from Trans, not from Trans some of the time and SPSS defaults at other times)." RELATED_FIELDS "qboverrides.moon_avoid", "widcr_parms.mon_avoi_ang" UNITS "DEGREES" END_FIELD FIELD si_intrlv TYPE I2 DESCRIPTION "This field is used as a Bit mask indicate which SIs cannot be interleaved after this alignment. If the bit is 1, the corresponding SI cannot be used. If the bit is 0, the SI can be used. Interleaving needs to be prohibited by SI because some of the SIs have buffer-management schemes which would break if another SU used the buffer between alignments. The bit pattern is the same as in QAlignment sis_used. (OPR 30833). See the include file ZSIBITS.INC for field definitions." RELATED_FIELDS "qalignment.sis_used" END_FIELD END_RECORD !------------------------------------------------------------------------------ ! ! RELATION DECLARATION ! !------------------------------------------------------------------------------ RELATION qalignment TYPE QALIGN_TYPE DESCRIPTION "Alignment Relation" SUBSYSTEM_USING "SPSS", "TRANS", "PODPS" RELATED_FIELDS "qaapertures.*", "qreadout.*", "qexposures.*" FORM NAME "AGD" END_FORM INDEX qalignment_1 TYPE unique, clustered FIELDS proposal_id, obset_id, version_num, alignment_id END_INDEX INDEX qalignment_2 TYPE nonclustered FIELDS prim_target, ref_target END_INDEX END_RELATION !------------------------------------------------------------------------------ ! ! INSTANCE DECLARATION ! !------------------------------------------------------------------------------ INSTANCE qalignment GLOBAL TYPE QALIGN_TYPE END_INSTANCE