!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! SDDL Name: ZQSLINK_ORIENT.SDDL ! ! Purpose: This SDDL file defines the qslink_orient relation. It is ! modeled after the relation qslink_spec. The relation ! qslink_spec will be renamed to qslink_timing in a future ! release. ! ! Modification History: ! ! Date PR Who Reason ! -------- ------- --- ------------------------------------------------- ! 09/05/96 32570 rjs Created. ! 02/07/97 33001 sxt Rename QSLINK_SPEC to QSLINK_TIMING ! 08/12/97 33001.6 rjs Updated documentation. ! 05/08/98 36870 MRB Add C output ! 11/05/99 36836 rjs Allow more than 1 record between two SUs ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! LANGUAGE C, FORTRAN, SQL INCLUDE ZSPSS_USER_TYPES.SDDL RECORD LKORIENT_TYPE !------------------------------------------------------------------------------ ! ! RECORD INFORMATION ! !------------------------------------------------------------------------------ DESCRIPTION "This table defines an orientation linked set specification. Orientation linked sets are identified in the table qslink_info as having a link_type value of ORIENT. A linked set specification record in qslink_orient defines a unique orientation relationship between a pair of scheduling units. For example, suppose you have two SUs: SU00001 and SU00002 that you want to link together. You can define a link specification between these scheduling units by populating this relation with a record that defines that timing relationship. It might say: 'Scheduling unit SU00002 must be scheduled 30 degrees in the clockwise direction from the orientation of scheduling unit SU00001 with a tolerance of 5 degrees.' A given linked set will have 1 or more of these records to comprise the full link set specifcation. There is an N to 1 relationship between the link specification records and the housekeeping information stored in qslink_info." !------------------------------------------------------------------------------ ! ! FIELD INFORMATION ! !------------------------------------------------------------------------------ FIELD link_set_id TYPE LINK_SET_ID_TYPE RELATED_FIELDS "qslink_info.link_set_id" END_FIELD FIELD sunit_id_1 TYPE SUNIT_ID_TYPE DESCRIPTION "This is the *first* SU in the link set specification pair. It will have an orientation relationship between sunit_id_2 in this same relation as defined by the link_delta and link_tolerance fields." END_FIELD FIELD vrs_num_1 TYPE VERSION_NUM_TYPE END_FIELD FIELD sunit_id_2 TYPE SUNIT_ID_TYPE DESCRIPTION "This is the *second* SU in the link set specifcation pair. It will have an orientation relationship between sunit_id_1 in this same relation as defined by the link_delta and link_tolerance fields." END_FIELD FIELD vrs_num_2 TYPE VERSION_NUM_TYPE END_FIELD FIELD link_delta TYPE R8 UNITS "DEGREES" DESCRIPTION "This is the minimum V3 position angle separation between the first and second scheduling units above. It is a positive value that is applied to the V3 position angle (at the target) of the first targeted science activity of the first scheduling unit and defines the starting point of the V3 position angle range that will restrict the position angle of the first science activity of the second scheduling unit. The range is specified from the starting point to an end point defined by link_tol in a clockwise direction. Positive values of link_delta are applied in a clockwise manner to the V3 angle of the first scheduling unit. Examples follow. The link_delta field is limited to the range 0 to 360. Example 1: --------- SU A schedules at a V3 position angle of 20.0 degrees, and is linked to SU B by the following relationship: sunit_id_1 = SU A sunit_id_2 = SU B link_delta = -21.0 link_tol = 2.5 Then the start of the range that constrains SU B is 359.0 degrees. The end of the range (again-defined in a clockwise direction from the range start) is 1.5 degrees. The range spans a total of 2.5 degrees. Example 2: --------- SU A schedules at a V3 position angle of 20.0 degrees, and is linked to SU B by the following relationship: sunit_id_1 = SU A sunit_id_2 = SU B link_delta = 21.0 link_tol = 2.5 Then the start of the range that constrains SU B is 41.0 degrees. The end of the range (again-defined in a clockwise direction from the range start) is 43.5 degrees. The range spans a total of 2.5 degrees." RELATED_FIELDS "qslink_orient.link_tol" END_FIELD FIELD link_tol TYPE R8 UNITS "DEGREES" DESCRIPTION "This is the separation tolerance that is applied to the link_delta orientation value. It has a positive value which, when added to link_delta, specifies the size of the valid range of angles at which to schedule an SU. The link_tol field is limited to the range 0 to 360. Since link_delta is the the minimum signed separation between the pair, the maximum signed separation is link_delta + link_tol. See description of link_tol for sample usage of this field." RELATED_FIELDS "qslink_orient.link_delta" END_FIELD END_RECORD !------------------------------------------------------------------------------ ! ! RELATION DECLARATION ! !------------------------------------------------------------------------------ RELATION qslink_orient TYPE LKORIENT_TYPE DESCRIPTION "Orient Link Set Specification Description Relation" SUBSYSTEM_USING "SPSS", "SPIKE" RELATED_FIELDS "qslink_info.*", "qslink_timing.*" INDEX qslink_orient_1 TYPE unique, clustered FIELDS link_set_id, sunit_id_1, vrs_num_1, sunit_id_2, vrs_num_2, link_delta END_INDEX INDEX qslink_orient_2 TYPE nonclustered FIELDS sunit_id_1, vrs_num_1 END_INDEX INDEX qslink_orient_3 TYPE nonclustered FIELDS sunit_id_2, vrs_num_2 END_INDEX END_RELATION !------------------------------------------------------------------------------ ! ! INSTANCE DECLARATION ! !------------------------------------------------------------------------------ INSTANCE qslink_orient GLOBAL TYPE LKORIENT_TYPE END_INSTANCE