! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! 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 ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! 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 GSSS/REPORT and GSSELECT." !------------------------------------------------------------------------------ ! ! FIELD INFORMATION ! !------------------------------------------------------------------------------ FIELD proposal_id TYPE PROPOSAL_ID_TYPE FORM NAME "GAQ" LABEL "PROPOSAL ID" END_FORM END_FIELD FIELD obset_id TYPE OBSET_ID_TYPE DESCRIPTION "This field identifies the observation set that uses this guide star data." FORM NAME "GAQ" LABEL "OBSET ID" END_FORM END_FIELD FIELD version_num TYPE VERSION_NUM_TYPE FORM NAME "GAQ" LABEL "VERSION NUM" END_FORM 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" FORM NAME "GAQ" LABEL "SCENARIO" END_FORM END_FIELD FIELD min_prob TYPE R4 DESCRIPTION "This field specifies the minimum probability of successful acquisition to support the observation set." FORM NAME "GAQ" LABEL "MINIMUM ACQUISITION PROBABILITY (1)" END_FORM END_FIELD FIELD acq_mode TYPE C1 DESCRIPTION "This field specified the acquisition mode, which indicates whether the acquisition will include an attempt to go to fine lock F or use coarse track C." FORM NAME "GAQ" LABEL "ACQUISITION MODE" END_FORM 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." FORM NAME "GAQ" LABEL "FGS 1 USABLE ?" END_FORM 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." FORM NAME "GAQ" LABEL "FGS 2 USABLE ?" END_FORM 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." FORM NAME "GAQ" LABEL "FGS 3 USABLE ?" END_FORM 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." FORM NAME "GAQ" LABEL "NUMBER OF FGS's" END_FORM RANGE "1..3" END_FIELD FIELD select_flag TYPE C1 DESCRIPTION "This specifies whether the candidate guide star/guide star pairs have been selected or not, where Y = 1,2,3 N = 0 A = 0,1,2,3" FORM NAME "GAQ" LABEL "SELECTED FLAG" END_FORM DISCRETE "A", "N", "Y" 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." FORM NAME "GAQ" LABEL "PRE USAGE FLAG" END_FORM 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 GSSS/ACQ groups as a combination. This is generally set to 1." FORM NAME "GAQ" LABEL "MINIMUM NUMBER OF PAIRS" END_FORM 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 GSSS/ACQ groups into a combination. This value is typically set to 1. GSSS/ACQ will group combinations consisting of 1 pair each into an acquisition data set." FORM NAME "GAQ" LABEL "MAXIMUM NUMBER OF PAIRS" END_FORM 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." FORM NAME "GAQ" LABEL "MAXIMUM SPOILER ACQUISITION PROBABILITY" END_FORM 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" FORM NAME "GAQ" LABEL "MINIMUM PRIMARY SINGLE SPOILER RADIUS" END_FORM 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" FORM NAME "GAQ" LABEL "MINIMUM PRIMARY DOUBLE SPOILER RADIUS" END_FORM 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" FORM NAME "GAQ" LABEL "MINIMUM SECONDARY SINGLE SPOILER RADIUS" END_FORM 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" FORM NAME "GAQ" LABEL "MINIMUM PAIR SEPARATION" END_FORM 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" FORM NAME "GAQ" LABEL "MINIMUM V3 ROLL RANGE" END_FORM 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." FORM NAME "GAQ" LABEL "MINIMUM USABILITY WINDOW" END_FORM 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" FORM NAME "GAQ" LABEL "PRIMARY SEARCH RADIUS" END_FORM 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" FORM NAME "GAQ" LABEL "SECONDARY SEARCH RADIUS" END_FORM END_FIELD FIELD st_att_unc TYPE R4 DESCRIPTION "This field specifies the ST attitude uncertainty." FORM NAME "GAQ" LABEL "ST ATTITUDE UNCERTAINTY" END_FORM 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." FORM NAME "GAQ" LABEL "ROLL RANGE OPTION FLAG" END_FORM 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." FORM NAME "GAQ" LABEL "ROLL RANGE LEVEL" END_FORM 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" FORM NAME "GAQ" LABEL "ROLL RANGE FUDGE FACTOR" END_FORM END_FIELD FIELD over_nr_off TYPE I*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" FORM NAME "GAQ" LABEL "ROLL RANGE FUDGE FACTOR" END_FORM END_FIELD FIELD over_nr_limit TYPE R*8 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" FORM NAME "GAQ" LABEL "ROLL RANGE FUDGE FACTOR" END_FORM END_FIELD FIELD max_time_pts TYPE I*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" FORM NAME "GAQ" LABEL "ROLL RANGE FUDGE FACTOR" END_FORM 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." END_FIELD FIELD comment TYPE C255 DESCRIPTION "This field is a user comment." 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.*" FORM NAME "GAQ" END_FORM 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