! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! ! SDDL Name: ZWGBRIT_OBJ.SDDL ! ! Purpose: This SDDL file defines the wgbrit_obj relation. ! ! Modification History: ! ! Date PR Who Reason ! -------- ------- --- ------------------------------------------------- ! 10/ 4/94 27329 RSL Original implementation ! 02/07/98 35442 bao New GS_REQUEST command required to perform Guide ! Star Processing ! 05/08/98 36870 MRB Add C output ! 10/30/98 37306 BAO Delete remnants of GSSS interface from SPSS ! 04/19/99 35645 MMD Added start_time, end_time, min_v3_angle and ! max_v3_angle to the unique index ! 05/24/99 35645.2 MMD Improved description ! 11/15/99 40066 bao NGSS should send back V1 reference target data ! for Moving Targets ! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ! LANGUAGE C, FORTRAN, SQL INCLUDE ZSPSS_USER_TYPES.SDDL RECORD BRTOBJ_TYPE !------------------------------------------------------------------------------ ! ! RECORD INFORMATION ! !------------------------------------------------------------------------------ DESCRIPTION "A Bright Object is a celestial object whose brightness exceeds the threshold limits for a particular macro aperture. 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 the qaapertures relation. Records are inserted into the wgbrit_obj relation by the GS_REQUEST program. When complete Bright Object alert information is requested, the Bright Object alert ids, the macro apertures the objects fall in, and the align- ments at which the alert conditions occur for the macro apertures are determined. V3 position angles and alert times are generated. If a brief report is requested, the Bright Object ids and macro aperture ids are produced without the alignment data. The Request Pro- cessor function within the GS_REQUEST program does not reference real apertures; only the macro apertures are used. Additional records are inserted into the wgbrit_obj relation by pmdb -load and pmdb -windows. The Contact Scientist supplies Bright Object data for Moving Target SUs that use a detector which is more sensitive than the Guide Star Catalog. This data is processed by pmdb -load or pmdb -windows into Bright Object alerts and stored in the wgbrit_obj relation. The bo_check tool is run after a calendar has been built. It checks the wgbrit_obj relation for any SU which is scheduled within the time and angle ranges of a Bright Object alert. Each overlapping Bright Object alert must be checked to determine whether it can be waived." !------------------------------------------------------------------------------ ! ! FIELD INFORMATION ! !------------------------------------------------------------------------------ FIELD proposal_id TYPE PROPOSAL_ID_TYPE END_FIELD FIELD obset_id TYPE OBSET_ID_TYPE END_FIELD FIELD alignment_id TYPE ALIGN_ID_TYPE END_FIELD FIELD version_num TYPE VERSION_NUM_TYPE END_FIELD FIELD macro_apr_id TYPE C4 DESCRIPTION "This field identifies the macro aperture that the Bright Object falls in. It includes a number of real apertures and is strictly used for defining Bright Object avoidance areas." RELATED_FIELDS "qaapertures.macro_apr_id" END_FIELD FIELD alert_obj_id TYPE TARGET_ID_TYPE DESCRIPTION "This field is the unique identifier of the Bright Object." RELATED_FIELDS "qtargets.target_id" END_FIELD FIELD min_v3_angle TYPE C10 DESCRIPTION "This is the minimum V3 position angle, with respect to the V1-axis position, at which the alert condition occurs." UNITS "DEGREES" RANGE "0..360" END_FIELD FIELD max_v3_angle TYPE C10 DESCRIPTION "This is the maximum V3 position angle, with respect to the V1-axis position, at which the alert condition occurs." UNITS "DEGREES" RANGE "0..360" END_FIELD FIELD start_time TYPE SOGS_CHAR_TIME_TYPE DESCRIPTION "The alert start time is the lower limit of the date range over which the alert is valid. This field is used for moving targets only." END_FIELD FIELD end_time TYPE SOGS_CHAR_TIME_TYPE DESCRIPTION "The alert end time is the upper limit of the date range over which the alert is valid. This field is used for moving targets only." END_FIELD FIELD v1_axis_ra TYPE R8 UNITS "DEGREES" DESCRIPTION "This is the right ascension of the reference V1-axis position. It is the vector average of the target positions (using the reference point for area targets) of all targets in this observation set, for fixed targets. It is specified in the heliocentric coordi- nate system relative to the mean equator and equinox at the beginning of Julian epoch J2000.0. For moving targets, the reference target id in qbs_obset will be used as the reference target for specification of the angle ranges." RANGE "0..360" RELATED_FIELDS "qbs_obset.ref_targ_id" END_FIELD FIELD v1_axis_dec TYPE R8 UNITS "DEGREES" DESCRIPTION "This is the declination of the reference V1-axis position. It is the vector average of the target positions (using the reference point for area targets) of all targets in this observation set, for fixed targets. It is specified in the heliocentric coordi- nate system relative to the mean equator and equinox at the beginning of Julian epoch J2000.0. For moving targets, the reference target id in qbs_obset will be used as the reference target for specification of the angle ranges." RANGE "-90..90" RELATED_FIELDS "qbs_obset.ref_targ_id" END_FIELD END_RECORD !------------------------------------------------------------------------------ ! ! RELATION DECLARATION ! !------------------------------------------------------------------------------ RELATION wgbrit_obj TYPE BRTOBJ_TYPE DESCRIPTION "Bright Object Alert Data Relation" SUBSYSTEM_USING "SPSS", "NGSS" INDEX wgbrit_obj_1 TYPE unique, clustered FIELDS proposal_id, obset_id, macro_apr_id, alert_obj_id, alignment_id, version_num, min_v3_angle, start_time END_INDEX END_RELATION !------------------------------------------------------------------------------ ! ! INSTANCE DECLARATION ! !------------------------------------------------------------------------------ INSTANCE wgbrit_obj GLOBAL TYPE BRTOBJ_TYPE END_INSTANCE