!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! SDDL Name:	STIS_MSM.SDDL
!
! Purpose:      This SDDL file defines the STIS_MSM relation.
!
! Modification History:
!
!   Date       OPR      Who                       Reason
! --------   -------    ---   -------------------------------------------------
! 06/14/96    29753     Baum   Original implementation
! 01/03/97    32946     Baum   Redefine pixels as offsets
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
!
 
LANGUAGE	SQL

RECORD  STIS_MSM_TYPE
 
!------------------------------------------------------------------------------
!
!   RECORD INFORMATION
!
!------------------------------------------------------------------------------
 
 
DESCRIPTION       "This relation is used to define the values OPUS needs for
                   WCS calculations for observations using dispersive elements.
                   There must be a record in this table for every STIS spectral
                   element (except MIRROR and PRISM) and valid central
                   wavelength (as listed in the proposal instructions). If
                   significant MSM changes are made during the mission that
                   requires different data for different observation times,
                   the valid_date is used by OPUS to fetch the right record. "

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

    FIELD  detector
        TYPE            C8
        DESCRIPTION     "STIS/CCD, STIS/MA1, STIS/MA2 are the values of
                         OPUS DGX keyword SS_DTCTR found in qelogsheet.config. "
    END_FIELD
	
    FIELD  grating 
        TYPE            C8
        DESCRIPTION     "G140L,G140M,E140M,E140H,X140M,X140H,G230L,G230M,E230M,
                         E230H,X230M,X230H,G230LB,G230MB,G430M,G750L,or G750M.
                         The mirror and prism values are also allowed:
                         MIRVIS,MIRCUV,MIRFUV,MIRNUV or PRISM.

                         These are the values from OPUS DGX keyword SS_GRTNG
                         that come from qelogsheet.ap_1. "
    END_FIELD
	
    FIELD  cen_wave 
        TYPE            I4
        DESCRIPTION     "The central wavelength supplied in the proposal and
                         found in OPUS DGX keyword SS_CWAVE that comes from
                         qelogsheet.min_wave. The allow values are in the
                         proposal instructions. For mirror elements the value
                         can be zero. "
    END_FIELD
	
    FIELD  dith_id
        TYPE            I2
        DESCRIPTION     "This number indicates which set of MAMA dither offsets
                         are being used. The value 0 is the baseline MSM
                         positions (not dithered). "
    END_FIELD
 
    FIELD  valid_date 
        TYPE            C17
        DESCRIPTION     "YYYY.DDD:HH:MM:SS, the date-time of either the SMS
                         which loads a new dither table or a time preceding
                         the first STIS observation that uses a new dither
                         table. "
    END_FIELD
	
    FIELD  msm_step1
        TYPE            I2
        DESCRIPTION     "This number indicates the motor step position for
                         cylinder 1 used for this dither position. "
    END_FIELD
 
    FIELD  msm_step2
        TYPE            I2
        DESCRIPTION     "This number indicates the MSM motor step position for
                         cylinder 3 used for this dither position. "
    END_FIELD
 
    FIELD  msm_step3
        TYPE            I2
        DESCRIPTION     "This number indicates the MSM motor step position for
                         cylinder 4 used for this dither position. "
    END_FIELD
 
    FIELD axis1_pix
	TYPE		R4
        DESCRIPTION	"Axis 1 pixel offset for this MSM position. "

    END_FIELD

    FIELD axis2_pix
	TYPE		R4
        DESCRIPTION	"Axis 2 pixel offset for this MSM position. "

    END_FIELD

END_RECORD
 
 
!------------------------------------------------------------------------------
!
!   RELATION DECLARATION
!
!------------------------------------------------------------------------------
 
 
RELATION  stis_msm
 
    TYPE             STIS_MSM_TYPE
 
    DESCRIPTION      "STIS Mode Select Mechanism Relation"
 
    SUBSYSTEM_USING  "OPUS"

    INDEX  stis_msm_1
        TYPE         unique, clustered
        FIELDS       detector,grating,cen_wave,dith_id,valid_date
    END_INDEX

END_RELATION
 
!------------------------------------------------------------------------------
!
!   INSTANCE DECLARATION
!
!------------------------------------------------------------------------------
 
 
INSTANCE  stis_msm
 
    GLOBAL
 
    TYPE        STIS_MSM_TYPE
 
END_INSTANCE