! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! 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