Go to the bottom.
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! SDDL Name:	QAPOSITION.SDDL
!
! Purpose:      This SDDL file defines the qaposition relation.
!
! Modification History:
!
!   Date       PR      Who                       Reason
! --------   -------   ---   -------------------------------------------------
! 11/16/94   27329     RJS   Original implementation.  J. Baum supplied
!                             additional comments.
! 06/04/97   27329     MRB   Added C output
! 04/23/98   36733     MRB   Removed time field
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
!
 
LANGUAGE  C, FORTRAN, SQL

INCLUDE  ZSPSS_USER_TYPES.SDDL
 
RECORD  QAPOSI_TYPE
 
!------------------------------------------------------------------------------
!
!   RECORD INFORMATION
!
!------------------------------------------------------------------------------
 
    DESCRIPTION       "This relation is used to specify the position and
                       orientation requirements of an alignment. It is
                       accessed to specify slew commands in the SMS and for
                       position data sent to GSSS. If the QALIGNMENT record
                       (QALIGNMENT.scan_type) specifies a spatial scan, both
                       the initial and final position of the scans are
                       specified in separate QAPOSITION records. There must
                       be at least one (when QAPOSITION.initial_pos='B') and
                       not more than two (when QAPOSITION.initial_pos='I' and
                       'F') qaposition records for every QALIGNMENT record.  

                       The PMDB/UPDATE/TYPE=obset command calculates various
                       fields in QAPOSITION, such as CALC_RA, CALC_DC,
                       CALC_ALGN_TY and CALC_ORI_TY.  TRANS supplies the
                       value of ALIGN_TYPE and ORIENT_TYPE. When ALIGN_TYPE
                       or ORIE NT_TYPE is 'NL' or 'OF', the calculated values
                       for CALC_ALGN_TY, CALC_ORI_TY, and other pointing or
                       orientation fields are determined by PMDB/UPDATE based
                       on the previous alignment in the obset.

                       The SPSS code modules QUATAP.FOR and QUAORN.FOR are
                       called by PMDB/UPDATE, at which time various flags
                       contained in QAPOSITION are interpreted for the proper
                       calculation of an alignment's position and
                       orientation.

                       GSSS/REQUEST extracts alignment positional data when
                       constructing the guide star request. GSSS/CENTER
                       extracts the target and aperture positions.
                       GSSS/REPORT compares the qaposition angle ranges with
                       the angle ranges for each guide star pair, marking
                       a pair unusable if the ranges do not intersect.

                       The POSANGLE command, which generates a position angle
                       display, selects the target and aperture positions.

                       The LOS command (Line-Of-Sight) extracts RA and Dec,
                       V3 angles, and V2V3 coordinates from qaposition
                       when no calendar is supplied.

                       QAC (Qaposition Aperture Correction) updates aperture
                       reference angle and position fields.

                       CANDLIST/ADDSUS, CANDLIST/DELSU, CANDLIST/UPDATE,
                       CCLIST/CREATE, SGS, FOV, NOM_POS and PLANNINGWINDOWS 
                       select alignment positional data.

                       SMSG/SCHEDULE selects alignment positional data when
                       generating OSS/PODPS observation records.
                       SMSG/GENERATE extracts the target id for the
                       instruction expander."

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

    FIELD  proposal_id
        TYPE PROPOSAL_ID_TYPE
        FORM
            NAME         "APD"
            LABEL        "PROPOSAL ID"
        END_FORM
    END_FIELD
 

    FIELD  obset_id
        TYPE OBSET_ID_TYPE
        FORM
            NAME         "APD"
            LABEL        "OBSET    ID"
        END_FORM
    END_FIELD
 

    FIELD  alignment_id
        TYPE ALIGN_ID_TYPE
        FORM
            NAME         "APD"
            LABEL        "ALIGN    ID"
        END_FORM
    END_FIELD
 

    FIELD  version_num
        TYPE VERSION_NUM_TYPE
        FORM
            NAME         "APD"
            LABEL        "VERSION NUM"
        END_FORM
    END_FIELD
 

    FIELD  initial_pos
        TYPE            C1
        DESCRIPTION     "This field specifies whether the data in this record
                        applies at the initial position ('I') of the alignment,
                        the final position ('F') of the alignment, or at
                        both the initial and final position ('B') of the
                        alignment.  This is needed for spatial scan alignments
                        (QALIGNMENT.scan_type='C' or 'D') and they require that 
			the initial and final positions of the scan be 
			specified."
	RELATED_FIELDS  "qalignment.scan_type"
        FORM
            NAME         "APD"
            LABEL        "ALIGNMENT INITIAL/FINAL SPECIFICATION (I/F/B)"
        END_FORM
        DISCRETE        "B",  "F",  "I"
    END_FIELD
 

    FIELD  align_type
        TYPE            C2
        DESCRIPTION     "This field, which is supplied by TRANS, specifies
                        how the information in this record is to be used
                        to obtain the alignment position. Possible values are:

                        'NL' = null, same as the previous position specified.
                        'AB' = position data contained in this position
                               specification (QAPOSITION record).
                        'OF' = target position and/or aperture specification
                               is described as offsets from the previous
                               position specified.
                        'RT' = position determined in real time.
                        'NO' = no target specified."
        FORM
            NAME         "APD"
            LABEL        "TARGET/APER. SPECIFICATION TYPE (NL/AB/OF/RT/NO)"
        END_FORM
        DISCRETE        " ",  "AB",  "NL",  "NO",  "OF",  "RT"
    END_FIELD
 

    FIELD  calc_algn_ty
        TYPE            C2
        DESCRIPTION     "This field specifies how the alignment position
                        is actually calculated.  

			It can be calculated based solely on the information 
			contained in this record.  

			If the alignment is dependent on the previous 
			alignment's position, it specifies how the previous 
			alignment's positions were calculated.  

			SPSS Developer's Note:

			    The field is set by PMDB/UPDATE in the SPSS 
			    code module QUATAP as follows:

                              - Set to QAPOSITION.calc_algn_ty of the previous
                                alignment if QAPOSITION.align_type= 'NL' or 'OF'

                              - QAPOSITION.calc_algn_ty = QAPOSITION.align_type
                                if QAPOSITION.align_type = 'AB', 'RT', or 'NO' "

        RELATED_FIELDS  "qaposition.align_type" "qapositon.calc_ori_ty"

        FORM
            NAME         "APD"
            LABEL        ""
        END_FORM
        DISCRETE        " ",  "AB",  "NO",  "RT"
    END_FIELD
  

    FIELD  to_pos_angle
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "See to_ang_sep field below for description."
        RELATED_FIELDS  "qaposition.to_ang_sep "qaposition.align_type"

        FORM
            NAME         "APD"
            LABEL        "POSITION ANGLE (deg)"
        END_FORM
    END_FIELD
  

    FIELD  to_ang_sep
        TYPE            R8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is the target offset angle of separation
                        specification, given in arcsec (1 x 10e-3 precision).
                        Together with to_pos_angle field, this field
                        specifies the target position as an offset from the
                        previous calculated target position. The default value
			for this field is 0.0.  It is only relevant when 
			align_type = 'OF'."
        RELATED_FIELDS  "qaposition.align_type" "qaposition.to_pos_angle"

        FORM
            NAME         "APD"
            LABEL        "ANGLE OF SEPARATION (arcsec)"
        END_FORM
    END_FIELD


    FIELD  ao_x_coord
        TYPE            R8
        DESCRIPTION     "This field specifies the aperture offset x coordinate.
                        The units are dependent on the coordinate system.
                        This field is relevant when align_type = 'OF' (offset).
			Together with ao_y_coord field, this field specifies 
			the aperture position as an offset from the previous 
                        position in xoffset_aper field."
        RELATED_FIELDS  "qaposition.align_type" "qaposition.xoffset_aper" "qaposition.ao_y_coord"

        FORM
            NAME         "APD"
            LABEL        "X  COORD."
        END_FORM
    END_FIELD
  

    FIELD  ao_y_coord
        TYPE            R8
        DESCRIPTION     "This field specifies the aperture offset y coordinate.
                        The units are dependent on the coordinate system.
                        This field is relevant when align_type = 'OF' (offset).
			Together with ao_x_coord field, this field specifies 
			the aperture position as an offset from the previous 
                        position in yoffset_aper field."
        RELATED_FIELDS  "qaposition.align_type" "qaposition.yoffset_aper" "qaposition.ao_x_coord"

        FORM
            NAME         "APD"
            LABEL        "Y  COORD."
        END_FORM
    END_FIELD
 

    FIELD  target_ref
        TYPE            C1
        DESCRIPTION     "This field is used to indicate the target referenced
                        by the position offset data in fields position_ang and
			angular_sep, where:
                                     'P' = primary target
                                     'R' = reference target."
        RELATED_FIELDS  "qaposition.position_ang" "qaposition.angular_sep"

        FORM
            NAME         "APD"
            LABEL        "BASED ON PRIMARY/REFERENCE TARGET(P/R)"
        END_FORM
        DISCRETE        "P",  "R"
    END_FIELD
 

    FIELD  target_id
        TYPE TARGET_ID_TYPE
        DESCRIPTION     "This field specifies the target ID of the target
                        referenced.  The field is the same as the field
			QALIGNMENT.prim_target if target_ref field = 'P'.
			Otherwise, this field is the same as the field 
			QALIGNMENT.ref_target when target_ref field = 'R'."
        RELATED_FIELDS  "qalignment.prim_target" "qalignment.ref_target" "qaposition.target_ref"

        FORM
            NAME         "APD"
            LABEL        "TARGET ID"
        END_FORM
    END_FIELD
 

    FIELD  position_ang
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "Together with the angular_sep field, this field 
			specifies offset data from the referenced target 
			position (QTARGETS.ra_j2000,QTARGETS.dec_j2000)
                        in polar coordinates (with 1 x 10e-3 precision).

                        If align_type='NL' the value of this field is set to 
			the value of the field from the previous alignment 
			(or position)."

        RELATED_FIELDS  "qaposition.align_type" "qaposition.to_pos_angle" "qaposition.to_ang_sep" "qaposition.angular_sep" "qaposition.calc_ra" "qaposition.calc_dc" "qtargets.ra_j2000" "qtargets.dec_j2000"

        FORM
            NAME         "APD"
            LABEL        "POSITION ANGLE (deg)"
        END_FORM
    END_FIELD
 

    FIELD  angular_sep
        TYPE            R8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "Together with the position_ang field, this field
                        specifies offset data from the referenced target 
			position (QTARGETS.ra_j2000,QTARGETS.dec_j2000)
                        in polar coordinates (with 1 x 10e-3 precision).

                        If align_type='NL' the value of this field is set to 
			the value of the field from the previous alignment 
			(or position).  

			SPSS Developers can reference code module QUATAP for 
			usage information."

        RELATED_FIELDS  "qaposition.align_type" "qaposition.to_pos_angle" "qaposition.to_ang_sep" "qaposition.position_ang" "qaposition.calc_ra" "qaposition.calc_dc" "qtargets.ra_j2000" "qtargets.dec_j2000"

        FORM
            NAME         "APD"
            LABEL        "ANGLE OF SEPARATION (arcsec)"
        END_FORM
    END_FIELD
 

     FIELD  calc_ra
        TYPE            R8
        UNITS           "DEGREES"
        RANGE          "0.0..360.0"
        DESCRIPTION     "This field is the calculated right ascension of the
                        target.  

			When align_type = 'OF' (offset), the position is 
			calculated from the offset specification in the fields
			to_pos_angle and to_ang_sep and the computed target 
			position from the previous position data in fields 
			calc_ra and calc_dc). 

			When align_type = 'AB/RT' (absolute or real time), the 
			position is calculated from the offset specification 
			in fields position_ang and angular_sep and the 
			reference target position (QTARGETS.ra_j2000,
			QTARGETS.dec_j2000)."
        RELATED_FIELDS  "qaposition.calc_dc" "qaposition.align_type" "qaposition.to_pos_angle" "qaposition.to_ang_sep" "qaposition.position_ang" "qaposition.angular_sep" "qtargets.ra_j2000" "qtargets.dec_j2000"

        FORM
            NAME         "APD"
            LABEL        "RA   (deg)"
        END_FORM
    END_FIELD
 

     FIELD  calc_dc
        TYPE            R8
        UNITS           "DEGREES"
	RANGE           "-90.0..90.0"
        DESCRIPTION     "This field is the calculated declination of the
                        target.

			See calc_ra field above to see rules for how this 
			is calculated."
        RELATED_FIELDS  "qaposition.calc_ra" "qaposition.align_type" "qaposition.to_pos_angle" "qaposition.to_ang_sep" "qaposition.position_ang" "qaposition.angular_sep" "qtargets.ra_j2000" "qtargets.dec_j2000"

        FORM
            NAME         "APD"
            LABEL        "DEC  (deg)"
        END_FORM
    END_FIELD
 

    FIELD  ra_delta
        TYPE            R8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field specifies the delta in right ascension (RA) 
			of the target position RA (from field calc_ra) allowed
                        during real time (1 x 10e-4 precision for fields with 
			align_type = 'RT').

                        The delta in RA shall be measured along the great
                        circle at the target position."
        RELATED_FIELDS  "QAPOSITION.calc_ra" "QAPOSITION.align_type"

        FORM
            NAME         "APD"
            LABEL        "DELTA RA  (arcsec)"
        END_FORM
    END_FIELD
 

    FIELD  dec_delta
        TYPE            R8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field specifies the delta in declination (DEC)
			of the target position DEC (from field calc_dc) allowed
                        during real time (1 x 10e-4 precision for fields with 
			align_type = 'RT').


                        The delta in declination shall be measured along the
                        constant RA great circle connecting the target position
                        and the j2000 north celestial pole (NCP).

                        The delta in RA shall be measured along the great
                        circle at the target position."
        RELATED_FIELDS  "QAPOSITION.calc_dc" "QAPOSITION.align_type"

        FORM
            NAME         "APD"
            LABEL        "DELTA DEC (arcsec)"
        END_FORM
    END_FIELD
 

    FIELD  si_used
        TYPE SI_ID_TYPE
        DESCRIPTION     "This field specifies which science instrument is to
                        be used to determine slit/aperture orientation for
                        pointing."
        FORM
            NAME         "APD"
            LABEL        "SI USED (CSTR/FGS/FOC/FOS/HRS/HSPNIC/STIS/WFII/WFPC)"
        END_FORM
    END_FIELD
 

    FIELD  def_aper_flg
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "When this field is 'Y' it indicates that the software
			should use the previous alignments position record 
			aperture specification data.  'N' means use the data 
			in this record."
        FORM
            NAME         "APD"
            LABEL        "DEFAULT APER.SPEC. FLAG (Y/N)"
        END_FORM
    END_FIELD
 

    FIELD  coord_typ
        TYPE            C4
        DESCRIPTION     "This field specifies the aperture coordinate system
                        type, where

                        'SIDS' = SI detector system, a coordinate system
                                 derived from SI readouts in the science or
                                 engineering data stream.

                        'SIAS' = SI aperture system, a coordinate system based
                                 on the aperture or FOV of the SI.

                        'SICS' = SI corrected system, which in general
                                 differs from the SIAS by removal of
                                 distortions and scale changes."
        RELATED_FIELDS  "qaapertures.*"
        FORM
            NAME         "APD"
            LABEL        "APER. COORD. SYSTEM (SIAS/SICS/SIDS)"
        END_FORM
        DISCRETE        "SIAS",  "SICS",  "SIDS"
    END_FIELD
 

    FIELD  coord_id
        TYPE            C10
        DESCRIPTION     "This field specifies the aperture coordinate system id.
                        The ID of the aperture coordinate system used to
                        specify the location of the target within the
                        aperture. It is the aperture ID concatenated
                        with the aperture coordinate system id,
                        as defined in ST-ICD-26 part III Appendix A."
        RELATED_FIELDS  "qaapertures.coord_id"
        FORM
            NAME         "APD"
            LABEL        "COORD SYSTEM ID"
        END_FORM
    END_FIELD
 

    FIELD  aper_ref_ang
        TYPE            R*8
        UNITS           "DEGREES"
	RANGE           "0.0..360.0"
        DESCRIPTION     "This SI aperture reference angle field is set 
                        based on the ST PDB SI aperture coordinate system used.
                        It is used to compute the V3 position angle."
    END_FIELD
 

    FIELD  xoffset_aper
        TYPE            R8
        DESCRIPTION     "Together with the yoffset_aper field this field
		 	specifies the target location within the aperture of the
                        specified instrument in the specified coordinate system.
			This is for small target acquisition offsets.  

			When the align_type = 'OF', the value is calculated
                        from ao_x_coord and ao_y_coord fields and also from
                        the previous aperture specifications in fields 
                        xoffset_aper and yoffset_aper.

                        The units are dependent on coordinate system used. By
			default this field will be 0.o and it has a 1 x 10e-4 
			precision."
        RELATED_FIELDS  "qaposition.yoffset_aper" "qaposition.align_type" "qaposition.ao_x_coord" "qaposition.ao_y_coord"

        FORM
            NAME         "APD"
            LABEL        "X  COORD."
        END_FORM
    END_FIELD
 

    FIELD  yoffset_aper
        TYPE            R8
        DESCRIPTION     "See xoffset_aper for description of this field."
        RELATED_FIELDS  "qaposition.xoffset_aper" "qaposition.align_type" "qaposition.ao_x_coord" "qaposition.ao_y_coord"

        FORM
            NAME         "APD"
            LABEL        "Y  COORD."
        END_FORM
    END_FIELD
 

    FIELD  v2v3_xcoord
        TYPE            R8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "Together with the v2v3_ycoord field, this field
			holds the computed aperture position in the ST 
			coordinate system.  This is calculated from the input 
			aperture specification data. It has a 1 x 10e-4 
			precision."
        RELATED_FIELDS  "qaposition.v2v3_ycoord"
        FORM
            NAME         "APD"
            LABEL        "CALCULATED V2 - V3  COORDINATES: X COORD.(arcsec)"
        END_FORM
    END_FIELD
 
 

    FIELD  v2v3_ycoord
        TYPE            R8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "See above v2v3_xcoord for descripton of this field."
        RELATED_FIELDS  "qaposition.v2v3_xcoord"
        FORM
            NAME         "APD"
            LABEL        "CALCULATED V2 - V3  COORDINATES: Y COORD.(arcsec)"
        END_FORM
    END_FIELD
 

    FIELD  orient_type
        TYPE            C2
        DESCRIPTION     "This field, which is supplied by TRANS, specifies
                        the aperture orientation type.  The field is used
                        to determine how the information in this record
                        is to be used to obtain the alignment orientation.
                        Possible values are:

                        'NM' (nominal) = default to nominal roll,
                                         QAPOSITION.align_type = AB/OF/RT;
                        'RG' (range)   = default to nominal roll if within
                                         specified range of orientations,
                                         QAPOSITION.align_type = AB/OF/RT;
                        'AB' (absolute)= orientation specified,
                                         QAPOSITION.align_type = AB;
                        'OF' (offset)  = orientation specified as offset to the
                                         previous orientation,
                                         QAPOSITION.align_type = OF;
                        'RT'(real time)= real time spec.,
                                         QAPOSITION.align_type = RT;
                        'NL' (null)    = no change from previous orientation.
                                         QAPOSITION.align_type = NL;
                        'NO' (none)    = no target."
        FORM
            NAME         "APD"
            LABEL        "APERTURE ORIENTATION TYPE (NL/NM/RG/AB/RT/OF/NO)"
        END_FORM
        DISCRETE        " ",  "AB",  "NL",  "NM",  "NO",  "OF",  "RG",  "RT"
    END_FIELD
 

    FIELD  calc_ori_ty
        TYPE            C2
        DESCRIPTION     "This field specifies how the alignment orientation
                        is actually calculated.

			It can be calculated based solely on the information 
			contained in this record.  

			If the alignment is dependent on the previous 
			alignment's position, it specifies how the previous 
			alignment's positions were calculated.  

                        This field can have the following values:

                          'NM' (nominal) = default to nominal roll,
                                           QAPOSITION.align_type = AB/OF/RT.
                          'RG' (range)   = default to nominal roll if within
                                           specified range of orientations,
                                           QAPOSITION.align_type = AB/OF/RT.
                          'AB' (absolute)= orientation specified,
                                           QAPOSITION.align_type = AB.
                          'OF' (offset)  = orientation specified as offset to 
                                           the previous orientation,
                                           QAPOSITION.align_type = OF.
                          'RT'(real time)= real time spec.,
                                           QAPOSITION.align_type = RT.
                          'NO' (none)    = no target.

			SPSS Developer's Note:

			    The field is set by PMDB/UPDATE in the SPSS 
			    code module QUAORN as follows:

                             - set to 'NM' when QAPOSITION.orient_type = 'NM'
                             - set to QAPOSITION.calc_ori_ty of the previous
                               alignment when QAPOSITION.orient_type = 'NL' 
			       or 'OF'
                             - set to QAPOSITION.orient_type when 
			       QAPOSITION.orient_type = 'RT' or 'AB' or 'NO' "
        RELATED_FIELDS  "qaposition.align_type" "qaposition.calc_algn_ty"

        FORM
            NAME         "APD"
            LABEL        "(calc.)"
        END_FORM
        DISCRETE        " ",  "AB",  "NM",  "NO",  "RG",  "RT"
    END_FIELD
 

    FIELD  ambiguity
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "When this field is 'Y' it indicates the angle 
			specified for aperture orientation is ambiguious with
                        the angle +- 180 degrees."
        FORM
            NAME         "APD"
            LABEL        "AMBIGUITY FLAG (Y/N)"
        END_FORM
    END_FIELD
 

    FIELD          ao_delta_ang
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "This field is the aperture orientation delta position
                        angle (1 x 10e-4 precision).  The field is set only
                        when orient_type = 'OF' (offset).  The field
                        specifies the change in the aperture orientation by
                        a delta position angle from the previous aperture
                        reference axis position angle (from field aper_posang).
                        By default this field is 0.0."
        RELATED_FIELDS  "qaposition.orient_type" "qaposition.aper_posang"

        FORM
            NAME         "APD"
            LABEL        "OFFSET FROM LAST POSITION(Type=OF) (deg)"
        END_FORM
    END_FIELD
 

    FIELD  aper_posang
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "This field specifies the aperture orientation
                        position angle relative to the input SI aperture
                        coordinate system positive x-axis.  This field is
                        set when orient_type = 'RG' or 'AB' or 'RT'.

			It is calculated from the orientation offset in field
			ao_delta_ang and the previous reference axis position 
			angle in field aper_posang when orient_type = 'OF'."
        RELATED_FIELDS  "qaposition.orient_type" "qaposition.ao_delta_ang" "qaposition.aper_posang"

        FORM
            NAME         "APD"
            LABEL        "CURRENT POSITION (deg)"
        END_FORM
    END_FIELD
 

    FIELD  delta_posang
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "This field specifies the delta position angle
                        for orientation types orient_type = 'RG' or
                        'RT' or 'NM'.  The field is the deviation from the
                        aperture reference axis position angle."
        RELATED_FIELDS  "qaposition.orient_type"
        FORM
            NAME         "APD"
            LABEL        "DELTA POSITION  (Type=RG/RT) (deg)"
        END_FORM
    END_FIELD
 

    FIELD  v3_posang
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "This field specifies the V3 axis position angle or ST
                        roll orientation.  It is the angle in degrees which is
                        made by the projection of the z-axis of the
                        heliocentric equatorial coordinate system upon the
                        v2-v3 plane with the v3 axis (1 x10e-4 precision).

                        The field is calculated from aper_posang field when 
			orient_type = 'AB'.

			This field is calculated from aper_posang and 
			delta_posang fields when orient_type = 'RG' or 'RT'.

			Finally, this field is calculated from ao_delta_ang 
			and the previous position angle aper_posang fields when
                        orient_type = 'OF'."
        RELATED_FIELDS  "qaposition.orient_type" "qaposition.aper_posang" "qaposition.delta_posang" "qaposition.ao_delta_ang"

        FORM
            NAME         "APD"
            LABEL        "V3 POSITION ANGLE (deg)"
        END_FORM
    END_FIELD
 

    FIELD  v3_min_ang
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "This field specifies the minimum v3 position angle
                        calculated when orient_type = 'RG' or 'RT'.  It is
			calculated from the reference axis position angle 
			aper_posang and the deviation delta_posang.  This field
                        specifies the deviation from the v3 position angle
                        in field v3_posang."
        RELATED_FIELDS  "qaposition.orient_type" "qaposition.aper_posang" "qaposition.delta_posang" "qaposition.v3_posang"

        FORM
            NAME         "APD"
            LABEL        "MINIMUM ANGLE (deg)"
        END_FORM
    END_FIELD
 

    FIELD  v3_max_ang
        TYPE            R8
        UNITS           "DEGREES"
        DESCRIPTION     "This field specifies the maximum v3 position angle
                        calculated when orient_type = 'RG' or 'RT'.  It is
			calculated from the reference axis position angle 
			aper_posang and the deviation delta_posang.  This field
                        specifies the deviation from the v3 position angle
                        in field v3_posang."
        RELATED_FIELDS  "qaposition.orient_type" "qaposition.aper_posang" "qaposition.delta_posang" "qaposition.v3_posang"

        FORM
            NAME         "APD"
            LABEL        "MAXIMUM ANGLE (deg)"
        END_FORM
    END_FIELD
 

    FIELD  aperture_viw
        TYPE            C3
        DESCRIPTION     "This field specifies how the aperture extent may
                        affect the relationship between the target and the
                        aperture.  Possible values are:

                        'ANY' = target may appear anywhere in the aperture,
                        'ALL' = target must be viewable everywhere,
                        'PNT' = target must appear at the specified point."
        FORM
            NAME         "APD"
            LABEL        "APER.  VIEWING OPTION (ALL/ANY/PNT)"
        END_FORM
        DISCRETE        " ",  "ALL",  "ANY",  "PNT"
    END_FIELD
 

    FIELD  target_view
        TYPE            C3
        DESCRIPTION     "This field specifies how the target area may affect
                        the relationship between the target and the aperture.
                        Possible values are:

                        'ANY' = aperture may view any part of the target,
                        'ALL' = aperture must view all parts of the target,
                        'PNT' = the specified point must be viewable by the
                                aperture."
        FORM
            NAME         "APD"
            LABEL        "TARGET VIEWING OPTION (ALL/ANY/PNT)"
        END_FORM
        DISCRETE        " ",  "ALL",  "ANY",  "PNT"
    END_FIELD
 

    FIELD  clc_pos_delt
        TYPE            R8
        DESCRIPTION     "This field specifies the calculated maximum positive
                        offset from nominal roll."
        UNITS           "DEGREES"
        FORM
            NAME         "APD"
            LABEL        "MAX POSITIVE OFFSET (deg)"
        END_FORM
    END_FIELD
 

    FIELD  clc_neg_delt
        TYPE            R8
        DESCRIPTION     "This field specifies the calculated maximum negative
                        offset from nominal roll."
        UNITS           "DEGREES"
        FORM
            NAME         "APD"
            LABEL        "MAX NEGATIVE OFFSET (deg)"
        END_FORM
    END_FIELD
 
END_RECORD
 
!------------------------------------------------------------------------------
!
!   RELATION DECLARATION
!
!------------------------------------------------------------------------------
 
RELATION  qaposition
 
    TYPE             QAPOSI_TYPE
 
    DESCRIPTION      "Alignment Position Data Relation"
 
    SUBSYSTEM_USING  "SPSS", "TRANS", "PODPS"

    FORM
        NAME         "APD"
    END_FORM
 
    INDEX  qaposition_1
        TYPE         unique, clustered
        FIELDS       proposal_id, obset_id, alignment_id, version_num,
                     initial_pos
    END_INDEX
 
END_RELATION
 
!------------------------------------------------------------------------------
!
!   INSTANCE DECLARATION
!
!------------------------------------------------------------------------------
 
 
INSTANCE  qaposition
 
    GLOBAL
 
    TYPE        QAPOSI_TYPE
 
END_INSTANCE

Go to the top.