Go to the bottom.
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! SDDL Name:	QAAPERTURES.SDDL
!
! Purpose:      This SDDL file defines the qaapertures relation.
!
! Modification History:
!
!   Date       OPR     Who                       Reason
! --------   -------   ---   -------------------------------------------------
! 11/15/94   27329     SSS   Original implementation
! 03/31/96   30900     MRB   Add C output
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!

LANGUAGE  C, FORTRAN, SQL

INCLUDE  ZSPSS_USER_TYPES.SDDL

RECORD  QAAPER_TYPE

    DESCRIPTION       "This relation defines the size, shape, and location
                       of the science instrument apertures.  Three fundamental
                       cartesian coordinate systems are used.  The first of 
                       these systems is the V1-V2-V3 system.  It is the three 
                       dimensional 'vehicle' coordinate system.  The V2-V3 
                       plane defines the 'aperture' plane.  The other two 
                       fundamental coordinate systems are defined in the 
                       aperture plane relative to the V1,V2,V3 frame. 
                       
                       The Science Instrument Coordinate System (SICS) is 
                       actually a set of coordinate systems; one or more for
                       each science instrument.  Coordinates are expressed
                       in arcseconds.  Generally there is one SICS defined
                       for each aperture.

                       The Science Aperture Coordinate System (SIAS) is 
                       similar to the SICS except the coordinates are 
                       expressed in units appropriate for the instrument 
                       (i.e. pixels).  SIAS is not used in SPSS.  

                       In addition to defining the size, shape, and location 
                       of each aperture, this relation also defines the 
                       conversion factors needed to transform coordinates 
                       expressed in one coordinate system to another.   See 
                       the SPSS Algorithms document (SE-06-02 Appendix B) for
                       a complete discussion of these transformations.

                       A 'macro' aperture is defined to be the region around
                       a scientific instrument where it is necessary to avoid
                       bright objects for instrument safety. The region is 
                       usually circular or rectangular, and it includes a 
                       number of real apertures. Both macro and real 
                       apertures are defined in this relation."


    FIELD  coord_id
        TYPE            C10
        DESCRIPTION     "This is the aperture coordinate system ID.  It is the
                         name of the aperture coordinate system used to specify
                         the location of the target within the aperture."
        FORM
            NAME         "APR"
            LABEL        "APERTURE COORDINATE SYSTEM ID"
        END_FORM
    END_FIELD


    FIELD  source
        TYPE            C1
        DESCRIPTION     "This field specifies the source of the record 
                         (aperture) in this relation.  The possible
                         choices are 'U' and 'S'.   'U' implies the aperture 
                         is user defined.  'S' implies the aperture is 
                         'system' defined."
        FORM
            NAME         "APR"
            LABEL        "SOURCE OF THIS RECORD (U/S)"
        END_FORM
        DISCRETE        "S",  "U"
    END_FIELD


    FIELD  macro_ap_flg
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This flag indicates whether the aperture is a macro 
                         aperture. 'Y' implies the aperture is a macro 
                         aperture.  'N' or ' ' implies the aperture is not 
                         a macro aperture."
        FORM
            NAME         "APR"
            LABEL        "MACRO APERTURE (Y/N)"
        END_FORM
    END_FIELD


    FIELD  macro_apr_id
        TYPE            C4
        DESCRIPTION     "This field specifies the macro aperture ID associated 
                         with the aperture."
        FORM
            NAME         "APR"
            LABEL        "MACRO APERTURE ID"
        END_FORM
    END_FIELD


    FIELD  center_v2
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field specifies the V2 coordinate of the center
                         of the aperture.  This defines the SICS X direction 
                         center (Xo)."
        FORM
            NAME         "APR"
            LABEL        "V2 COORDINATE (ARCSECONDS)"
        END_FORM
    END_FIELD


    FIELD  center_v3
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field specifies the V3 coordinate of the center
                         of the aperture.  This defines the SICS Y direction 
                         center (Yo)."
        FORM
            NAME         "APR"
            LABEL        "V3 COORDINATE (ARCSECONDS)"
        END_FORM
    END_FIELD


    FIELD  aper_shape
        TYPE            C1
        DESCRIPTION     "This field specifies the geometric shape of the 
                         aperture. The possible choices are 'P', 'C', 'Q', 
                         or 'R'.  

                         'P' implies a pickle shape (FGS).   'C' implies a 
                         circular shape.  'Q' implies a quadrilateral shape.
                         'R' implies a rectangular shape.
        FORM
            NAME         "APR"
            LABEL        "APERTURE SHAPE (P/C/Q/R)"
        END_FORM
        DISCRETE        "C",  "P",  "Q",  "R"
    END_FIELD


    FIELD  radius
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for circular or pickle
                         shaped apertures and is defined in the SICS system.   
                         For a circular aperture, this is the radius of the 
                         aperture measured from the center ('center_v2',
                         'center_v3'). For a pickle aperture, this is the 
                         outer radius."
        FORM
            NAME         "APR"
            LABEL        "RADIUS OF APERTURE (ARCSECONDS)"
        END_FORM
    END_FIELD


    FIELD  vertex1_x
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the X coordinate of vertex 1."
        FORM
            NAME         "APR"
            LABEL        "X COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex1_y
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the Y coordinate of vertex 1."
        FORM
            NAME         "APR"
            LABEL        "Y COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex2_x
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the X coordinate of vertex 2."
        FORM
            NAME         "APR"
            LABEL        "X COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex2_y
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the Y coordinate of vertex 2."
        FORM
            NAME         "APR"
            LABEL        "Y COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex3_x
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the X coordinate of vertex 3."
        FORM
            NAME         "APR"
            LABEL        "X COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex3_y
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the Y coordinate of vertex 3."
        FORM
            NAME         "APR"
            LABEL        "Y COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex4_x
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the X coordinate of vertex 4."
        FORM
            NAME         "APR"
            LABEL        "X COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex4_y
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         SICS system.  These apertures are defined in counter-
                         clockwise order from vertex 1 to vertex 4.  This is 
                         the Y coordinate of vertex 4."
        FORM
            NAME         "APR"
            LABEL        "Y COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex1_v2
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V2 coordinate of vertex 1."
        FORM
            NAME         "APR"
            LABEL        "V2 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex1_v3
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V3 coordinate of vertex 1."
        FORM
            NAME         "APR"
            LABEL        "V3 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex2_v2
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V2 coordinate of vertex 2."
        FORM
            NAME         "APR"
            LABEL        "V2 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex2_v3
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V3 coordinate of vertex 2."
        FORM
            NAME         "APR"
            LABEL        "V3 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex3_v2
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V2 coordinate of vertex 3."
        FORM
            NAME         "APR"
            LABEL        "V2 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex3_v3
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V3 coordinate of vertex 3."
        FORM
            NAME         "APR"
            LABEL        "V3 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex4_v2
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V2 coordinate of vertex 4."
        FORM
            NAME         "APR"
            LABEL        "V2 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  vertex4_v3
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for quadrilateral or
                         rectangular shaped apertures and is defined in the 
                         V2-V3 system.  These apertures are defined in 
                         counter-clockwise order from vertex 1 to vertex 4. 
                         This is the V3 coordinate of vertex 4."
        FORM
            NAME         "APR"
            LABEL        "V3 COORD"
        END_FORM
        RANGE           "0 .. 3600"
    END_FIELD


    FIELD  aper_ref_ang
        TYPE            R*8
        UNITS           "DEGREES"
        DESCRIPTION     "This is the aperture reference angle (Ta).  It 
                         specifies the rotation angle needed to transform 
                         from SICS to V2V3 coordinate systems.   The angle is 
                         measured counter-clockwise as viewed looking along 
                         the +V1-axis from the V3-axis to the positive side 
                         of the aperture's major axis."
        FORM
            NAME         "APR"
            LABEL        "SI APERTURE REFERENCE ANGLE (degrees)"
        END_FORM
        RANGE           "0 .. 360"
    END_FIELD


    FIELD  parity
        TYPE            I*2
        DESCRIPTION     "This is the parity value required to transform from 
                         SICS to V2V3 coordinate systems.  This field is -1
                         for left-handed SICS and +1 for right-handed SICS."
        FORM
            NAME         "APR"
            LABEL        "PARITY VALUE USED IN TRANSFORMATION"
        END_FORM
    END_FIELD


    FIELD  polynomial
        TYPE            I*2
        DESCRIPTION     "This field indicates the degree of the polynomial
                         used in the transformation from SIAS to SICS.   The
                         maximum value is 5."
        FORM
            NAME         "APR"
            LABEL        "POLYNOMIAL"
        END_FORM
    END_FIELD


    FIELD  x_sic_center
        TYPE            R*8
        DESCRIPTION     "This is the x coordinate (in pixels) of the origin 
                         of the SICS system expressed in the SIAS system. "
    END_FIELD


    FIELD  y_sic_center
        TYPE            R*8
        DESCRIPTION     "This is the y coordinate (in lines) of the origin 
                         of the SICS system expressed in the SIAS system."
    END_FIELD


    FIELD  x_sia_center
        TYPE            R*8
        DESCRIPTION     "This is the x coordinate of the origin of the SIAS
                         system expressed in the SICS system."
        FORM
            NAME         "APR"
            LABEL        "X COORD CENTER"
        END_FORM
    END_FIELD


    FIELD  y_sia_center
        TYPE            R*8
        DESCRIPTION     "This is the y coordinate of the origin of the SIAS
                         system expressed in the SICS system."
        FORM
            NAME         "APR"
            LABEL        "Y COORD CENTER"
        END_FORM
    END_FIELD


    FIELD  inner_radius
        TYPE            R*8
        UNITS           "ARCSECONDS"
        DESCRIPTION     "This field is only significant for pickle shaped 
                         apertures and is defined in the SICS system.
                         This is the inner radius of a pickle aperture."
    END_FIELD


    FIELD  inner_orient
        TYPE            R*8
        UNITS           "DEGREES"
        DESCRIPTION     "This is the inner radius orientation angle of a pickle
                         aperture.  The angle is measured counterclockwise
                         as viewed looking along the positive V1-axis from the
                         V3-axis to the center of the inner radius."
    END_FIELD


    FIELD  inner_extent
        TYPE            R*8
        UNITS           "DEGREES"
        DESCRIPTION     "This is the angular extent of the inner radius of a 
                         pickle aperture.  The angle is measured from the 
                         center of the inner radius."
    END_FIELD


    FIELD  outer_orient
        TYPE            R*8
        UNITS           "DEGREES"
        DESCRIPTION     "This is the outer radius orientation angle of a pickle
                         aperture.  The angle is measured counterclockwise as
                         viewed looking along the positive V1-axis from the 
                         V3-axis to the center of the outer radius."
    END_FIELD


    FIELD  outer_extent
        TYPE            R*8
        UNITS           "DEGREES"
        DESCRIPTION     "This is the angular extent of the outer radius of a 
                         pickle aperture. The angle is measured from the center
                         of the outer radius."
    END_FIELD

END_RECORD


RELATION  qaapertures
    TYPE             QAAPER_TYPE
    DESCRIPTION      "Science Instrument Aperture Data Relation"
    SUBSYSTEM_USING  "SPSS"
    FORM
        NAME         "APR"
    END_FORM
    INDEX  qaapertures_1
        TYPE         unique, clustered
        FIELDS       coord_id
    END_INDEX
END_RELATION


INSTANCE  qaapertures
    GLOBAL
    TYPE        QAAPER_TYPE
END_INSTANCE

Go to the top.