Go to the bottom.
!
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! SDDL Name:	WSISTATE_TRA.SDDL
!
! Purpose:      This SDDL file defines the WSISTATE_TRA relation.
!
! Modification History:
!
!   Date       OPR      Who                       Reason
! --------   -------    ---   -------------------------------------------------
! 10/ 4/94    27329     NSS   Original implementation
! 11/29/95    30445     NLC   Duplicate type SI_STATE_TYPE; rename to      
!			      SI_CONFIG_STATE_TYPE
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
!

LANGUAGE	FORTRAN, SQL

INCLUDE		ZSPSS_USER_TYPES.SDDL

RECORD  SITRAN_TYPE

!------------------------------------------------------------------------------
!
!   RECORD INFORMATION
!
!------------------------------------------------------------------------------

    DESCRIPTION       "This relation is used to define Science Instrument (SI)
                       and SI Detector state transitions. A transition is a
                       method in which an SI or Detector can change its mode or 
                       configuration.

		       For example, suppose that there is an SI on board 
                       the HST. There are 3 modes for this instrument: HOLD, 
                       WARM, and CAPTURE. A typical user will want to operate 
                       the SI in the CAPTURE mode while observing a target.
                       At a minimum, the SI must transition thru the WARM
                       mode prior to transitioning up to the CAPTURE mode.

		       Entries within this relation will have to be defined 
                       that describe the attributes of:

                         o  changing from the HOLD state to the WARM state
                            (and vice versa)

                         o  changing from the WARM state to the CAPTURE state
		            (and vice versa)                       

		       There are many attributes that describe a transition, 
                       including:

                         o  the power needed to transition into the next state
 
                         o  how long the transition takes

                         o  is there a warmup or cooldown duration associated 
                            with the transition?
	
		         o  are there external constraints (SAA, occultation)
                            that can interfere with the transition
  
                         o  the previous and next states of the transition

                         o  etc..."

!------------------------------------------------------------------------------
!
!   FIELD INFORMATION
!
!------------------------------------------------------------------------------



    FIELD  si_name
        TYPE SI_ID_TYPE
    END_FIELD



    FIELD  si_det_name
        TYPE SI_DETECTOR_TYPE
        DESCRIPTION     "This field is blank for SI states. By being blank,
                         it actually designates that this transition is for
                         an SI."

    END_FIELD



    FIELD  prev_state
        TYPE SI_CONFIG_STATE_TYPE
        DESCRIPTION     "This field is the name of the state at the start of 
                         the transition."
    END_FIELD



    FIELD  next_state
        TYPE SI_CONFIG_STATE_TYPE
        DESCRIPTION     "This field is the name of the state at the end of the 
                         transition."
    END_FIELD



    FIELD  trans_type
        TYPE            C1
        DESCRIPTION     "This field is a flag indicating whether this 
                         transition is an upward or downward transition."
        DISCRETE        "U", "D"
    END_FIELD



    FIELD  command_time
        TYPE            I4
        DESCRIPTION     "This field is the amount of time used to command to
                         the configuration."

        UNITS           "SECONDS"
    END_FIELD



    FIELD  min_warmup
        TYPE            I4
        DESCRIPTION     "This field is the minimum warmup period duration for 
                         upward transitions. This field is not applicable for 
                         downward transitions.

                         See System Engineering SI User's Guide for more 
                         information concerning this field."

        UNITS           "SECONDS"
    END_FIELD



    FIELD  min_time_req
        TYPE            I4
        DESCRIPTION     "This field is the time required in the previous lower 
                         state for minimum warmup duration for an upward 
                         transition. This field is not applicable for downward 
                         transitions."
        UNITS           "SECONDS"
    END_FIELD



    FIELD  max_warmup
        TYPE            I4
        DESCRIPTION     "This field is the maximum warmup period duration for 
                         upward transitions. The value must not be less than 
                         the minimum warmup duration. This field is not 
                         applicable for downward transitions."
        UNITS           "SECONDS"
    END_FIELD



    FIELD  max_time_req
        TYPE            I4
        DESCRIPTION     "This field is the time required in the previous lower 
                         state for maximum warmup duration for upward 
                         transitions. The value must not be less than the time 
                         required for minimum warmup duration. This field is 
                         not applicable for downward transitions."
        UNITS           "SECONDS"
    END_FIELD



    FIELD  cooldwn_time
        TYPE            I4
        DESCRIPTION     "This field is the cooldown time required for downward
                         transitions. This field is not applicable for upward 
                         transitions."
        UNITS           "SECONDS"
    END_FIELD



    FIELD  parallel
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field specifies whether a transition activity 
                         may be scheduled in parallel with the warmup or 
                         cooldown period of this transition. 

                         If specified for an SI transition, then the transition 
                         activities for its SI detectors may be scheduled in 
                         parallel with the warmup or cooldown period following 
                         this SI transition. 

                         If specified for an SI detector transition, then the 
                         next SI transition activity for the SI may be scheduled
                         in parallel with the warmup or cooldown period 
                         following this SI detector transition.

                         Note that this field only applies to a SI GROUP (an SI
                         and its Detectors)."

    END_FIELD



    FIELD  power
        TYPE            I2
        DESCRIPTION     "This field is the power required for the transition. 
                         SI transitions and states must schedule according to 
                         HST power availability/constraints."
        UNITS           "WATTS"
    END_FIELD



    FIELD  power_delay
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "If this field is set to 'Y', the power required 
                         during the warmup or cooldown period is the power 
                         required during the SI reconfiguration activity. 
                         Otherwise, the power required is the power for the 
                         next SI or Detector state."
    END_FIELD



    FIELD  saa_flag
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field is a flag indicating whether the transition 
                         is allowed during the SAA."
    END_FIELD



    FIELD  saa_model
        TYPE SAA_MODEL_TYPE
        DESCRIPTION     "This field is the SAA model id for the transition. This
                         field is set only if the transition is not allowed in 
                         SAA, as determined by the saa_flag field."
        RELATED_FIELDS  "wsistate_tra.saa_flag"
    END_FIELD



    FIELD  saa_recovery
        TYPE            I4
        DESCRIPTION     "This field specifies the recovery time after SAA exit 
                         before the transition is allowed. This field is set 
                         only if the transition is not allowed in the SAA, as
                         determined by the saa_flag field."
        UNITS           "SECONDS"
        RELATED_FIELDS  "wsistate_tra.saa_flag" "wsistate_tra.saa_model"

    END_FIELD



    FIELD  motion
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field specifies whether the mechanism motion 
                         flag is set during the transition. Transitions setting 
                         this flag cannot be scheduled within an observation 
                         set that disallows the flag to be set."
    END_FIELD



    FIELD  nssc1_used
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field is a flag specifiying if the NSSC-1 scratch 
                         pad is used anywhere during this transition."
    END_FIELD



    FIELD  command_code
        TYPE            C8
        DESCRIPTION     "This field is a reference to the change code used to 
                         identify the instruction which is expanded to 
                         generate commands for the transition."

        RELATED_FIELDS  "qgreconfig.change_code"
    END_FIELD



    FIELD  penalty
        TYPE            I2
        DESCRIPTION     "This field specifies the component of the penalty 
                         which results when the transition must be scheduled.
                         This penalty is used by CALENDAR/AUTO."
    END_FIELD



    FIELD  trans_prio
        TYPE            I2
        DESCRIPTION     "This field specifies the priority of this transition 
                         when the scheduling software selects the next SI 
                         activity to process and several choices exist.

                         See System Engineering SI User's Guide for more 
                         information concerning this field."
    END_FIELD



    FIELD  trans_order
        TYPE            I2
        DESCRIPTION     "This field specifies the order of this transition when 
                         the scheduling software selects the next SI activity 
                         to process and several choices exist with the same 
                         priority."
    END_FIELD



    FIELD  pdb_record
        TYPE            I4
        DESCRIPTION     "This field is the PDB record number. This field is 
                         currently unused, and set to 0."
    END_FIELD



    FIELD  comments
        TYPE            C80
        DESCRIPTION     "This field is descriptive text describing this state 
                         transition."
    END_FIELD


END_RECORD


!------------------------------------------------------------------------------
!
!   RELATION DECLARATION
!
!------------------------------------------------------------------------------


RELATION  wsistate_tra

    TYPE             SITRAN_TYPE

    DESCRIPTION      "SI State Transition Definition Relation"

    SUBSYSTEM_USING  "SPSS", "IM", "SCIOPSDB", "CCLIST"

    RELATED_FIELDS  "wsidata_def.*" "wsistate_def.*" "wsistate_seq.*"


    INDEX  wsistate_tra_1
        TYPE         unique, clustered
        FIELDS       si_name, si_det_name, prev_state, next_state
    END_INDEX

END_RELATION

!------------------------------------------------------------------------------
!
!   INSTANCE DECLARATION
!
!------------------------------------------------------------------------------


INSTANCE  wsistate_tra

    GLOBAL

    TYPE        SITRAN_TYPE

END_INSTANCE

Go to the top.