! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! SDDL Name: QBOVERRIDES.SDDL ! ! Purpose: This SDDL file defines the qboverrides relation. ! ! Modification History: ! ! Date PR Who Reason ! -------- ------- --- ------------------------------------------------- ! INCORPORATES SOGS-300-83-016 "ST-ScI Response to Jan 17-19 Action Items" ! dated 23 Feb 1984 by J. Isaacs ! ! SOGS-700-84-109 "Windows for Scheduling" dated 3 July 1984 ! by J. Isaacs ! ! 11/16/94 27329 RJS Original implementation ! 01/19/99 36102 MRB Rename SU_ID to SUNIT_ID ! 03/26/99 38755 sfs Corrected related fields for fhst_bright/dark. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! LANGUAGE C, FORTRAN, SQL INCLUDE ZSPSS_USER_TYPES.SDDL RECORD QBOVER_TYPE !------------------------------------------------------------------------------ ! ! RECORD INFORMATION ! !------------------------------------------------------------------------------ DESCRIPTION "There may be times when it will be beneficial to override certain observation set level constraint checks. These checks or data values are used by multiple processes in SPSS such as PMDB/UPDATE/TYPE=OBSET or calendar scheduling. The overridable features in this relation are non-PCS dependent constraints. Each field in this table will map to some other field in some constraint constants relation (such as widcr_parms). The mapping will be revealed for each field so you know what is being overridden. The field description will be override oriented - to see the true purpose of the field you will need to navigate to the mapped constraint constants relation field. The fields described in this relation can be modified through the BCR form." !------------------------------------------------------------------------------ ! ! FIELD INFORMATION ! !------------------------------------------------------------------------------ FIELD proposal_id TYPE PROPOSAL_ID_TYPE DESCRIPTION "This field can be blank. See sunit_id field below." RELATED_FIELDS "qboverrides.sunit_id" FORM NAME "BCR" LABEL "PROPOSAL ID" END_FORM END_FIELD FIELD obset_id TYPE OBSET_ID_TYPE DESCRIPTION "This field can be blank. See sunit_id field below." RELATED_FIELDS "qboverrides.sunit_id" FORM NAME "BCR" LABEL "OBSET ID" END_FORM END_FIELD FIELD version_num TYPE VERSION_NUM_TYPE FORM NAME "BCR" LABEL "VERSION NUM" END_FORM END_FIELD FIELD sunit_id TYPE SUNIT_ID_TYPE DESCRIPTION "This field contains the scheduling unit to which the overrides in this relation apply. If the proposal and obset ids are blank, the overrides will apply to *all* obsets in the specified SU." FORM NAME "BCR" LABEL "SCHEDULING UNIT ID" END_FORM END_FIELD FIELD sun_avoid TYPE R4 UNITS "DEGREES" DESCRIPTION "This field allows you to override the sun avoidance angle used to compute the slew to this observation set. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.sun_avoi_ang" FORM NAME "BCR" LABEL "SUN AVOIDANCE ANGLE (deg)" END_FORM END_FIELD FIELD moon_avoid TYPE R4 UNITS "DEGREES" DESCRIPTION "This field allows you to override the moon avoidance angle used to compute the slew to this observation set. This override is used during PMDB/UPDATE window calculations. 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 "widcr_parms.mon_avoi_ang" FORM NAME "BCR" LABEL "MOON AVOIDANCE ANGLE (deg)" END_FORM END_FIELD FIELD max_deviat TYPE R4 UNITS "DEGREES" DESCRIPTION "This field allows you to override the maximum allowed deviation (+/-) from nominal roll in sunlight for this observation set. This override is used during PMDB/UPDATE window calculations. RELATED_FIELDS "widcr_parms.max_dev" FORM NAME "BCR" LABEL "MAXIMUM ALLOWED DEVIATION FROM NOMINAL ROLL (deg)" END_FORM END_FIELD FIELD fgs_bright TYPE R4 UNITS "DEGREES" DESCRIPTION "The FGS line-of-sight must not be smaller than this angle from the bright earth limb. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fgs_brit" FORM NAME "BCR" LABEL "FGS BRIGHT EARTH LIMB ANGLE (deg)" END_FORM END_FIELD FIELD fgs_dark TYPE R4 UNITS "DEGREES" DESCRIPTION "The FGS line-of-sight must not be smaller than this angle from the dark earth limb. This override is used during calendar scheduling. " RELATED_FIELDS "widcr_parms.fgs_dark" FORM NAME "BCR" LABEL "FGS DARK EARTH LIMB ANGLE (deg)" END_FORM END_FIELD FIELD fhst_bright TYPE R4 UNITS "DEGREES" DESCRIPTION "The FHST line-of-sight must not be smaller than this angle from the bright earth limb. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhst_brit" FORM NAME "BCR" LABEL "FHST BRIGHT EARTH LIMB ANGLE (deg)" END_FORM END_FIELD FIELD fhst_dark TYPE R4 UNITS "DEGREES" DESCRIPTION "The FHST line-of-sight must not be smaller than this angle from the dark earth limb. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhst_dark" FORM NAME "BCR" LABEL "FHST DARK EARTH LIMB ANGLE (deg)" END_FORM END_FIELD FIELD sh_dev TYPE R4 UNITS "DEGREES" DESCRIPTION "This field allows you to override the maximum allowed deviation (+/-) from nominal roll when the ST line of sight is within the shadow restriction angle of the sun. This override is used during during PMDB/UPDATE window calculations." RELATED_FIELDS "widcr_parms.shad_dev" FORM NAME "BCR" LABEL "SHADOW DEVIATION FROM NOMINAL ROLL (deg)" END_FORM END_FIELD FIELD sh_restrict TYPE R4 UNITS "DEGREES" DESCRIPTION "The aperture door shadow constraint is imposed when the ST line of sight is within the shadow restriction angle of the sun. This override is used during PMDB/UPDATE window calculations." RELATED_FIELDS "widcr_parms.sh_restrict" FORM NAME "BCR" LABEL "SHADOW RESTRICTION ANGLE (deg)" END_FORM END_FIELD FIELD anti_sun TYPE R4 UNITS "DEGREES" DESCRIPTION "This override field allows you to change the anti-sun angle for this observation set. When the ST line of sight is within the anti-sun angle of the anti-solar point, all roll restrictions are ignored. This override is used during PMDB/UPDATE window calculations." RELATED_FIELDS "widcr_parms.anti_sun_ang" FORM NAME "BCR" LABEL "UNRESTRICTED ROLL, ANTI-SUN CONE ANGLE (deg)" END_FORM END_FIELD FIELD fhstthr1 TYPE R4 DESCRIPTION "This field allows you to override the slew angle threshold for FHST updates as it relates to the scheduling of slews to this observation set. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstthr1" FORM NAME "BCR" LABEL "FHST UPDATE SLEW ANGLE THRESHOLD (deg)" END_FORM END_FIELD FIELD fhstthr2 TYPE R4 DESCRIPTION "This field allows you to override the position uncertainty threshold for FHST updates as it relates to the scheduling of slews to this observation set. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstthr2" FORM NAME "BCR" LABEL "FHST UPDATE POSITION UNCERTAINTY THRESHOLD (arcsec)" END_FORM END_FIELD FIELD fhstthr3 TYPE R4 DESCRIPTION "This field allows you to override the MAXIMUM position uncertainty threshold for FHST updates as it relates to the scheduling of slews to this observation set. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstthr3" FORM NAME "BCR" LABEL "MAXIMUM POSITION UNCERTAINTY THRESHOLD (arcsec)" END_FORM END_FIELD FIELD fhstdur1 TYPE I4 UNITS "SECONDS" DESCRIPTION "This field allows you to override the duration of of an FHST roll update. It requires visibility by one or two FHSTs. If two FHSTs are used simultaneously, the duration of the FHST update is the same. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstdur1" FORM NAME "BCR" LABEL "DURATION OF FHST ROLL UPDATE" END_FORM END_FIELD FIELD fhstdur2 TYPE I4 UNITS "SECONDS" DESCRIPTION "This field allows you to override the duration of an FHST full update. It requires visibility by two FHSTs. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstdur2" FORM NAME "BCR" LABEL "DURATION OF FHST FULL UPDATE" END_FORM END_FIELD FIELD fhstdurm TYPE I4 UNITS "SECONDS" DESCRIPTION "This field allows you to override the duration of the maneuver following a maneuver mode FHST. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstdurm" FORM NAME "BCR" LABEL "DURATION OF MANEUVER FOLLOWING A MANEUVER MODE FHST" END_FORM END_FIELD FIELD fhstdel1 TYPE I4 UNITS "SECONDS" DESCRIPTION "This field allows you to override the delta time threshold between start of FHST update and start of slew. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstdel1" FORM NAME "BCR" LABEL "DELTA TIME THRESHOLD BETWEEN START OF FHST AND SLEW" END_FORM END_FIELD FIELD fhstdel2 TYPE I4 UNITS "SECONDS" DESCRIPTION "This field allows you to override the delta time threshold between start of an FHST update after the slew and start of a PCS acquisition activity. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstdel2" FORM NAME "BCR" LABEL "DELTA TIME THRESHOLD BETWEEN START OF FHST AND PCS" END_FORM END_FIELD FIELD fhstdel3 TYPE I4 UNITS "SECONDS" DESCRIPTION "This field allows you to override the delta time threshold for FHST update scheduling used to evaluate FHST update scenarios for scheduling efficiency. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.fhstdel3" FORM NAME "BCR" LABEL "DELTA TIME THRESHOLD FOR SCHEDULING OF FHST UPDATE" END_FORM END_FIELD FIELD max_inc TYPE R4 UNITS "DEGREES" DESCRIPTION "This field allows you to override the maximum allowable solar array incidence angle for off-normal roll windows. This was required due to the anti-sun avoidance cone required for magnetometer heating and cooling problems before the first servicing mission. This override is used during calendar scheduling." RELATED_FIELDS "widcr_parms.max_inc" FORM NAME "BCR" LABEL "MAXIMUM ALLOWED SOLAR ARRAY INCIDENCE ANGLE (deg)" END_FORM END_FIELD FIELD asun_avoid TYPE R4 UNITS "DEGREES" DESCRIPTION "This field allows you to override the anti-sun avoidance angle (measured from vector to the anti-sun). The ST line-of-sight will not be pointed within the cone defined by this angle about the anti-sun vector. This override is used during PMDB/UPDATE window calculations." RELATED_FIELDS "widcr_parms.asun_avdang" FORM NAME "BCR" LABEL "ANTI-SUN AVOIDANCE ANGLE (deg)" END_FORM END_FIELD END_RECORD !------------------------------------------------------------------------------ ! ! RELATION DECLARATION ! !------------------------------------------------------------------------------ RELATION qboverrides TYPE QBOVER_TYPE DESCRIPTION "Observation Set Overrides Relation" SUBSYSTEM_USING "SPSS", "CCLIST" RELATED_FIELDS "widcr_parms.*" FORM NAME "BCR" END_FORM INDEX qboverrides_1 TYPE unique, clustered FIELDS sunit_id, proposal_id, obset_id, version_num END_INDEX END_RELATION !------------------------------------------------------------------------------ ! ! INSTANCE DECLARATION ! !------------------------------------------------------------------------------ INSTANCE qboverrides GLOBAL TYPE QBOVER_TYPE END_INSTANCE