Go to the bottom.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! 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

Go to the top.