Go to the bottom.
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! 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
Go to the top.