Go to the bottom.
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! SDDL Name:	QBACQS.SDDL
!
! Purpose:      This SDDL file defines the qbacqs relation.
!
! Modification History:
!
!   Date       OPR      Who                       Reason
! --------   -------    ---   -------------------------------------------------
! 11/11/94    27329     RJS   Original implementation
! 05/23/96    27745     bao   Eliminate two-step GS acquisition support 
!			      from database and SPSS
! 11/12/97    35442     sfs   Add C to language list.  Add over_nr_off,
!                             over_nr_limit, max_time_pts, rec_id, and comment
! 04/13/98    36218     sfs   Elaborated on description of rec_id and comment
! 11/02/98    37306     bao   Delete remnants of GSSS interface from SPSS
! 02/02/99    37931     sfs   Deleted min_prob.
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
!
 
LANGUAGE	C, FORTRAN, SQL

INCLUDE         ZSPSS_USER_TYPES.SDDL
 
RECORD  QBACQS_TYPE
 
!------------------------------------------------------------------------------
!
!   RECORD INFORMATION
!
!------------------------------------------------------------------------------
 
 
    DESCRIPTION       "The records within this relation are linked to the
                       QBS_OBSET relation through a join with the field
                       scenario_acq.  Fields within this relation specify
                       the criteria by which guide stars for an FGS mode
                       obset will be selected.  The table QBACQD_DEF contains
                       matching fields and provides the default selection
                       criteria for a particular acquisition if no matching
                       record is found in QBACQS.  Two SPSS commands perform
		       the filtering process which use the data from this table,
		       namely GS_REQUEST and GSSELECT."

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

    FIELD  proposal_id
        TYPE PROPOSAL_ID_TYPE
    END_FIELD
 

    FIELD  obset_id
        TYPE OBSET_ID_TYPE
        DESCRIPTION     "This field identifies the observation set that
                         uses this guide star data."
    END_FIELD
 

    FIELD  version_num
        TYPE VERSION_NUM_TYPE
    END_FIELD
 

    FIELD  scenario_acq
        TYPE            C8
        DESCRIPTION     "This field is the scenario name associated
                        with an obset's guide star acquisition."
        RELATED_FIELDS  "qbs_obset.scenario_acq"
    END_FIELD
 

    FIELD  acq_mode
        TYPE            C1
        DESCRIPTION     "This field specifies the acquisition mode, which
                        indicates whether the acquisition will include
                        an attempt to go to fine lock F or use coarse
                        track C."
        DISCRETE        "C",  "F"
    END_FIELD
 

    FIELD  use_fgs_1
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field specifies if FGS 1 can be used for
                        the selection of guide stars for the acquisition."
    END_FIELD
 

    FIELD  use_fgs_2
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field specifies if FGS 2 can be used for 
			the selection of guide stars for the acquisition."
    END_FIELD
 

    FIELD  use_fgs_3
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field specifies if FGS 3 can be used for 
			the selection of guide stars for the acquisition."
    END_FIELD
 

    FIELD  num_fgs
        TYPE            I4
        DESCRIPTION     "This field gives the number of FGSs which can be used 
			for the selection of guide stars for the acquisition."
        RANGE           "1..3"
    END_FIELD
 

    FIELD  select_flag
        TYPE            C1
        DESCRIPTION     "This field specifies whether the candidate guide star
			pairs, which may have been selected at a prior time, 
			should be (re)selected or not, where
			    Y = 1,2,3 - only select pairs which have been
				previously selected			
			    N = 0 - only select pairs which have not been
				previously selected
                            A = 0,1,2,3 - select pairs whether they have been
				previously selected or not"
        DISCRETE        "A",  "N",  "Y"
	RELATED_FIELDS  "wggs_pairs.selected"
    END_FIELD
 

    FIELD  pre_use_flag
        TYPE YES_NO_FLAG_TYPE
        DESCRIPTION     "This field specifies whether guide star pairs
                        which have the same previously used guide star
                        may be considered as independent guide star pairs."
    END_FIELD
 

    FIELD  min_gs_pair
        TYPE            I4
        DESCRIPTION     "This field specifies the minimum number of
                        independent guide star pairs which can be used
                        for the acquisition.  This is the minimum
                        number of guide star pairs that the command
                        GS_REQUEST groups as a combination.  This is
                        generally set to 1."
    END_FIELD
 

    FIELD  max_gs_pair
        TYPE            I4
        DESCRIPTION     "This field specifies the maximum number of
                        independent guide star pairs which can
                        be used for the acquisition.  This is the
                        maximum number of guide star pairs that the
                        command GS_REQUEST groups into a combination.
                        This value is typically set to 1.  GS_REQUEST
                        will group combinations consisting of 1 pair
                        each into an acquisition data set."
    END_FIELD
 

    FIELD  max_spoiler
        TYPE            R4
        DESCRIPTION     "This field specifies the estimate of the
                        maximum probability that an object other than
                        the guide star pair will be in the magnitude window
                        recommended for acquisition; i.e., the maximum
                        likelihood that another object can spoil the
                        acquisition of a guide star pair."
    END_FIELD
 

    FIELD  min_s_spl_pr
        TYPE            R4
        DESCRIPTION     "This field specifies the minimum estimated single
                        spoiler radius for the primary star (the star in a pair
                        which is acquired first).  It is used to specify
                        the minimum radial distance from the guide star
                        within which there is a significant probability that
                        at least ONE spoiler object has a magnitude
                        less than the guide star upper magnitude setting."
        UNITS           "ARCSECONDS"
    END_FIELD
 

    FIELD  min_d_spl_pr
        TYPE            R4
        DESCRIPTION     "This field specifies the minimum estimated double
                        spoiler radius for the primary star (the star in a pair
                        which is acquired first).  It is used to specify the
                        minimum radial distance from the guide star within which
                        there is a significant probability that at least TWO
                        spoiler objects have a magnitude less than the guide
                        star upper magnitude setting."
        UNITS           "ARCSECONDS"
    END_FIELD
 

    FIELD  min_s_spl_sc
        TYPE            R4
        DESCRIPTION     "This field specifies the estimated single spoiler
                        radius for the secondary guide star (the star in a pair
                        which is acquired last).  It is used to specify the
                        minimum radial distance from the guide star within
                        which there is a significant probability that
                        at least one spoiler object has a magnitude
                        less than the guide star upper magnitude setting."
        UNITS           "ARCSECONDS"
    END_FIELD
 

    FIELD  f1_min_gs_mag
        TYPE            R4
        DESCRIPTION     "This field is the minimum guide star magnitude
                        for FGS 1.  It specifies the minimum acceptable
                        magnitude for each candidate guide star
                        pair which is considered for the acquisition."
        UNITS           "MAGNITUDE"
    END_FIELD
 

     FIELD  f2_min_gs_mag
        TYPE            R4
        DESCRIPTION     "This field is the minimum guide star magnitude
                        for FGS 2. It specifies the minimum acceptable
                        magnitude for each candidate guide star
                        which is considered for the acquisition."
        UNITS           "MAGNITUDE"
    END_FIELD
  

    FIELD  f3_min_gs_mag
        TYPE            R4
        DESCRIPTION     "This field is the minimum guide star magnitude
                        for FGS 3. It specifies the minimum acceptable
                        magnitude for each candidate guide star
                        is considered for the acquisition."
        UNITS           "MAGNITUDE"
    END_FIELD
  

    FIELD  min_gs_sep
        TYPE            R4
        DESCRIPTION     "This is the minimum guide star pair separation.
                        It specifies the minimum separation between guide
                        stars of a guide star pair."
        UNITS           "ARCSECONDS"
    END_FIELD
  

    FIELD  min_roll_rng
        TYPE            R8
        DESCRIPTION     "This field specifies the minimum intersected
                        V3-axis position angle range.  It specifies the
                        minimum size of the intersection of guide star pair
                        roll ranges for those guide star pairs which
                        satisfy the acquisition criteria for an acquisition."
        UNITS           "DEGREES"
    END_FIELD
 

     FIELD  min_usbl_wnd
        TYPE            C17
        DESCRIPTION     "This is the minimum intersected usability window,
                        used only for moving targets.  It specifies the
                        minimum size of the intersection of the guide star
                        pair usability windows for those guide star pairs
                        that satisfy the acquisition criteria for an
                        acquisition.  This is a delta_time field whose format
                        of YYYY.DDD.HH:MM:SS. A blank field means 0."
        RANGE           "0000.000:00:00:00..0050.365.23:59:59"
    END_FIELD
 

    FIELD  p_sea_rad
        TYPE            R4
        DESCRIPTION     "This is the maximum primary search radius, which
                        specifies the maximum search radius for the primary
                        guide star.  The primary guide star is the star in
                        a pair that is acquired first."
        UNITS           "ARCSECONDS"
    END_FIELD
 

    FIELD  s_sea_rad
        TYPE            R4
        DESCRIPTION     "This is the maximum secondary search radius, which
                        specifies the maximum search radius for the secondary
                        guide star.  The secondary star is the star in a pair
                        that is acquired after the primary star."
        UNITS           "ARCSECONDS"
    END_FIELD
 

    FIELD  st_att_unc
        TYPE            R4
        DESCRIPTION     "This field specifies the ST attitude uncertainty."
    END_FIELD
 

    FIELD  rr_opt
        TYPE            C1
        DESCRIPTION     "This field is the roll range option flag.
                        It specifies the type of roll range data for which
                        the quide star pairs shall be selected.  A 'C'
                        indicates they can be centerlined, an 'A' indicates
                        they can be acquired, and a 'G' indicates the
                        guide star roll range."
        DISCRETE        "A",  "C",  "G"
    END_FIELD
 

    FIELD  rr_lvl
        TYPE            C1
        DESCRIPTION     "This field specifies the roll range level.  It is
                        valid for a roll range option flag value of 'C'.
                        It indicates the level of centerline roll ranges
                        to be selected.
                            1 means both guide stars must be placed on
                              the centerline,
                            2 means level 1 or the guide stars must be
                              placed above the centerline without overlapping
                              the outer edge of the FGS FOV,
                            3 means level 2 or the guide stars must be placed
                              above the centerline such that both stars
                              overlap the outer edge of the FGS FOV."
        DISCRETE        " ",  "1",  "2",  "3"
    END_FIELD
 

    FIELD  rr_ff
        TYPE            R*4
        DESCRIPTION     "This field specifies a roll range fudge factor.
                        It is used to further restrict the selected roll
                        ranges.  The field is added to the selected minimum
                        V3 position angle and subtracted from the maximum
                        V3 position angle."
        UNITS           "DEGREES"
    END_FIELD


    FIELD  over_nr_off
        TYPE            I*4
        DESCRIPTION     "Flag indicating whether to override nominal roll 
                         offset for a guide star request.  Only used for ST
                         orientation type of nominal.  When this flag is TRUE
                         (non-zero), the field qbacqs.over_nr_limit is used
                         instead of the request's nominal roll offset."
    END_FIELD
 

    FIELD  over_nr_limit
        TYPE            R*8
        DESCRIPTION     "If qbacqs.over_nr_off is TRUE (non-zero) and this 
                        field is non-zero, then this value is used instead of
                        the request's nominal roll offset.  Only used for ST
                        orientation type of nominal."
        UNITS           "DEGREES"
    END_FIELD
 

    FIELD  max_time_pts
        TYPE            I*4
        DESCRIPTION     "This field specifies the number of track segment
                        lengths to be calculated for moving target guide star
                        requests."
    END_FIELD
 

    FIELD  rec_id
        TYPE            I*4
        DESCRIPTION     "This field allows more than one qbacqs record per
                        obset.  This field serves as a key for the various
                        records for a given observation set.  When a guide
                        star request is performed on this obset, the qbacqs
                        record with the record id matching the qbs_obset
                        override_rec_id field will be used for the request."
        RELATED_FIELDS  "qbs_obset.override_rec_id"
    END_FIELD


    FIELD  comment
        TYPE            C255
        DESCRIPTION     "This field is a user comment.  When a new QBACQS
                        record is created via the gs_request GUI, the user
                        can enter an explanatory comment about the new record,
                        which is stored in this field."
    END_FIELD
END_RECORD
 
!------------------------------------------------------------------------------
!
!   RELATION DECLARATION
!
!------------------------------------------------------------------------------
 
RELATION  qbacqs
 
    TYPE             QBACQS_TYPE
 
    DESCRIPTION      "Guide Star Acquisition Criteria Data Relation"
 
    SUBSYSTEM_USING  "SPSS"

    RELATED_FIELDS  "qbacqd_def.*"

    INDEX  qbacqs_1
        TYPE         unique, clustered
        FIELDS       proposal_id, obset_id, version_num, scenario_acq, rec_id
    END_INDEX
 
END_RELATION
 
!------------------------------------------------------------------------------
!
!   INSTANCE DECLARATION
!
!------------------------------------------------------------------------------
 
 
INSTANCE  qbacqs
 
    GLOBAL
 
    TYPE        QBACQS_TYPE
 
END_INSTANCE

Go to the top.