!FILE NAME: ZNSPSUP.DDL -
!PURPOSE: COMMON BLOCK FOR PODPS OBSERVATION DATA -
!------------------------------------------------------------------------
! SPR HISTORY -
! SPR # DATE BUILD DESCRIPTION -
! ----- -------- ------ ------------------------------------------ -
! 12072 11/07/86 17.0.0 Addition of new DG2 parameters -
! 14562 10/26/88 20.4 V2/V3 offsets -
! 22824/ -
! 21420 05/06/92 29.1 Clarify description of NSPAPA_APER_POS_ANGLE -
!------------------------------------------------------------------------
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
! SDDL Name: PODPS_OBSERVATION_DATA.SDDL
!
! Purpose: This include file contains observation data for all proposals
!
! Modification History:
!
! Date OPR Who Reason
! -------- ------- --- -------------------------------------------------
! 12/16/94 27329 MRB Original implementation
!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!
!
LANGUAGE FORTRAN
INCLUDE ZSPSS_USER_TYPES.SDDL
RECORD NSPSUP_TYPE
!------------------------------------------------------------------------------
!
! RECORD INFORMATION
!
!------------------------------------------------------------------------------
DESCRIPTION "observation data for all proposals"
!------------------------------------------------------------------------------
!
! FIELD INFORMATION
!
!------------------------------------------------------------------------------
FIELD proposal_id
TYPE PROPOSAL_ID_TYPE
DESCRIPTION "the proposal id assigned by the science
institute. A base 36 number. "
END_FIELD
FIELD program_id
TYPE PROGRAM_ID_TYPE
DESCRIPTION "a base 36 program id assigned by the pm software to
a proposal that has been accepted.
(1-46,655 possible ids) "
END_FIELD
FIELD obset_id
TYPE OBSET_ID_TYPE
DESCRIPTION "the observation set id, these are numbered
sequentially throughout the proposal.
a base 36 number which allows
for 1295 observation sets "
END_FIELD
FIELD alignment_id
TYPE ALIGN_ID_TYPE
DESCRIPTION " (1-99) alignments are numbered sequentially
for each observation set"
END_FIELD
FIELD version_num
TYPE VERSION_NUM_TYPE
DESCRIPTION "(1-99) the version number of the exposure
default to 1. "
END_FIELD
FIELD ob_number
TYPE C2
DESCRIPTION "observations are numbered sequentially throughout
an observation set and are assigned by sms
(base 36 number max. 1295 observations per obset)"
END_FIELD
FIELD exposure_id
TYPE EXPOSURE_ID_TYPE
DESCRIPTION "(1-99) exposure id"
END_FIELD
FIELD crtl_rec_id
TYPE C*5
DESCRIPTION "control record id."
!
! Required by PODPS.
!
END_FIELD
FIELD expected_pkt
TYPE I4
DESCRIPTION "expected number of source packets for an
observation for the si science instrument data.
this value is used to determine whether data
collected
by data partitioning has all been collected.
the estimate includes science data, unique
definition log, and science header packets."
!
! Required by PM processing to determine execution status.
!
END_FIELD
FIELD executed_flg
TYPE C*1
DESCRIPTION "flag indicating the status of this observations.
where: u = unexecuted
e = executed "
!
! Required by PM for the time utilization report (SE-06-01 req.)
!
END_FIELD
FIELD duration
TYPE I4
DESCRIPTION "predicted observation duration time in seconds."
!**********************************************************************
! *
! DATA GROUP II DATA *
! *
!**********************************************************************
END_FIELD
FIELD word_11_14
TYPE I2
DESCRIPTION "word 11/14 ... a number assigned by sms for each
observation. THE word 11/14 is a count which is
kept for each instrument and updated for each
observation using
the instrument. THE count rolls over every 255. "
END_FIELD
FIELD target_id
TYPE TARGET_ID_TYPE
DESCRIPTION "this is the unique primary astronomical name for
the target used. "
END_FIELD
FIELD ra_target
TYPE R*8
UNITS "DEGREES"
DESCRIPTION "right ascension of the target position.
this is in heliocentric j2000.0."
END_FIELD
FIELD dec_target
TYPE R*8
UNITS "DEGREES"
DESCRIPTION "declination of the target position.
this is in heliocentric j2000.0. "
END_FIELD
FIELD ref_obj_ra
TYPE R*8
UNITS "DEGREES"
DESCRIPTION "right ascension of the reference target.
the epoch and equinox of the target position is j2000.
for moving target, the epoch of the target position
is the predicted start time for the observation."
END_FIELD
FIELD ref_obj_dec
TYPE R*8
UNITS "DEGREES"
DESCRIPTION "declination of the reference target.
the epoch and equinox of the target position is j2000.
for moving target, the epoch of the target position
is the predicted start time for the observation."
END_FIELD
FIELD target_distance
TYPE R*8
DESCRIPTION "distance to the target from the center of the earth,
in kilometers."
END_FIELD
FIELD annparra
TYPE R*4
DESCRIPTION "the magnitude of the parallactic shift in the
position of the non-solar system target at the time
of observation."
END_FIELD
FIELD si_id
TYPE C*4
DESCRIPTION "specifies which science instrument was used for the
observation. THE instrument mnemonics are as defined in
st-icd-26 part iii."
END_FIELD
FIELD apersky
TYPE C10
DESCRIPTION "si sky aperture and coordinate system id:
specifies the aperture and
coordinate system of the instrument to be
used for the sky background light observations
in conjuction with the observation of the target.
it is the aperture id concatenated with the
aperture coordinate system id.
these ids are defined in st_icd_26 part iii. "
END_FIELD
FIELD coord_id
TYPE C10
DESCRIPTION "si object aperture and coordinate system id:
specifies the aperture and
coordinate system of the instrument to be
used for the observation of the target.
it is the aperture id concatenated with the
aperture coordinate system id.
these ids are defined in st_icd_26 part iii.
specify the location of the target within the
aperture."
END_FIELD
FIELD coord_typ
TYPE C4
DESCRIPTION "sics/sias/sids... aperture coordinate system type.
where sics = si corrected system,
sias = si aperture system,
sids = si detector system. "
END_FIELD
FIELD aperoffx
TYPE R*4
DESCRIPTION "x component of the offset of the target from
the center of the aperture.
if qobctp_coord_typ = sias, then units are pixels;
if qobctp_coord_typ = sics, then units are
arc-seconds."
END_FIELD
FIELD aperoffy
TYPE R*4
DESCRIPTION "y component of the offset of the target from
the center of the aperture.
if qobctp_coord_typ = sias, then units are lines;
if qobctp_coord_typ = sics, then units are
arc-seconds."
END_FIELD
FIELD v2v3_xcoord
TYPE R4
UNITS "ARCSEC"
DESCRIPTION "the x component of the aperture offset position in
the st coordinate system. THE v2 offset of the target
from the aperture center."
END_FIELD
FIELD v2v3_ycoord
TYPE R4
UNITS "ARCSEC"
DESCRIPTION "the y component of the aperture offset position in
the st coordinate system. THE v2 offset of the target
from the aperture center."
END_FIELD
FIELD aper_angle
TYPE R*4
UNITS "DEGREES"
DESCRIPTION "position angle of the reference axis (y-axis) of the
aperture coordinate system used for the observation
of the target. IT is specified in the j2000.0
coordinate system and measured counterclockwise
(eastward) from north as seen looking toward the
the +v1 axis."
END_FIELD
FIELD pred_strt_tm
TYPE C17
DESCRIPTION "yyyy.DDD:HH:MM:SS predicted date and time of
execution when this observation was started where
yyyy is year, ddd is day of year, hh is
hour, mm is minutes, ss is seconds. "
END_FIELD
FIELD pred_stop_tm
TYPE C17
DESCRIPTION "yyyy.DDD:HH:MM:SS predicted date and time of
execution when this observation was finished where
yyyy is year, ddd is day of year, hh is
hour, mm is minutes, ss is seconds. "
END_FIELD
FIELD rtascnv1
TYPE R*8
UNITS "DEGREES"
DESCRIPTION "right ascension of v1 axis of space telescope in
geocentric j2000 coordinates. tHE v1 axis is the optical
axis of the space telescope (more or less the ''roll'"
END_FIELD
FIELD declnv1
TYPE R*8
UNITS "DEGREES"
DESCRIPTION "declination of v1 axis of space telescope in
geocentric j2000 coordinates. THE v1 axis is the optical
axis of the space telescope (more or less the ''roll'"
END_FIELD
FIELD psanglv3
TYPE R*4
DESCRIPTION "position angle of v3 axis of st in geocentric
coordinate system j2000.0 measured counterclockwise
from north as seen looking toward the +v1 axis.
(measured eastward from the north direction. )"
END_FIELD
FIELD postnstx
TYPE R*8
DESCRIPTION "x axis coordinate of the space telescope position
in orbit at the time of observation. IN geocentric
j2000.0 inertial coordinate system.
this is a orthogonal right handed
coordinate system centered in the earth, with the x axis
pointing towards the vernal equinox for the year 2000,
the z axis pointing towards the north celestial pole for
the year 2000, and the y axis orthogonal to both."
END_FIELD
FIELD postnsty
TYPE R*8
DESCRIPTION "y axis coordinate of the space telescope position
in orbit at the time of observation. IN geocentric
j2000.0 inertial coordinate system.
this is a orthogonal right handed
coordinate system centered in the earth, with the x axis
pointing towards the vernal equinox for the year 2000,
the z axis pointing towards the north celestial pole for
the year 2000, and the y axis orthogonal to both."
END_FIELD
FIELD postnstz
TYPE R*8
DESCRIPTION "z axis coordinate of the space telescope position
in orbit at the time of observation. IN geocentric
j2000.0 inertial coordinate system.
this is a orthogonal right handed
coordinate system centered in the earth, with the x axis
pointing towards the vernal equinox for the year 2000,
the z axis pointing towards the north celestial pole for
the year 2000, and the y axis orthogonal to both. "
END_FIELD
FIELD velocstx
TYPE R*8
DESCRIPTION "x component of the velocity of space telescope in
geocentric j2000,0 inertial coordinates.
this is a orthogonal right handed
coordinate system centered in the earth, with the x axis
pointing towards the vernal equinox for the year 2000,
the z axis pointing towards the north celestial pole for
the year 2000, and the y axis orthogonal to both."
END_FIELD
FIELD velocsty
TYPE R*8
DESCRIPTION "y component of the velocity of space telescope in
geocentric j2000,0 inertial coordinates.
this is a orthogonal right handed
coordinate system centered in the earth, with the x axis
pointing towards the vernal equinox for the year 2000,
the z axis pointing towards the north celestial pole for
the year 2000, and the y axis orthogonal to both."
END_FIELD
FIELD velocstz
TYPE R*8
DESCRIPTION "y component of the velocity of space telescope in
geocentric j2000,0 inertial coordinates.
this is a orthogonal right handed
coordinate system centered in the earth, with the x axis
pointing towards the vernal equinox for the year 2000,
the z axis pointing towards the north celestial pole for
the year 2000, and the y axis orthogonal to both. "
END_FIELD
FIELD rtascsun
TYPE R*8
DESCRIPTION "right ascension of sun in geocentric j2000.0 "
END_FIELD
FIELD declnsun
TYPE R*8
DESCRIPTION "declination of sun in geocentric j2000.0 "
END_FIELD
FIELD rtasmoon
TYPE R*8
DESCRIPTION "right ascension of moon in geocentric j2000.0 "
END_FIELD
FIELD declmoon
TYPE R*8
DESCRIPTION "declination of moon in geocentric j2000.0 "
END_FIELD
FIELD target_acqmd
TYPE C2
DESCRIPTION "(00-03)...THE target acquisition mode used for the
observation. WHERE
00 = null,
01 = ground assisted,
02 = onboard computer assisted,
03 = fixed simple pointing. "
END_FIELD
FIELD position_ang
TYPE R4
UNITS "DEGREES"
DESCRIPTION "the position angle of the target offset from the
reference object. MEASURED counterclockwise from
north as seen looking from the earth. (THE angle
measured eastward from the north direction
about the position of the reference object to locate
the target position, specified in the coordinate
system in which the target position is specified.) "
END_FIELD
FIELD angular_sep
TYPE R4
UNITS "ARCSECONDS"
DESCRIPTION "the angle separation of the target offset from
the reference object. "
END_FIELD
FIELD saa_model
TYPE C2
DESCRIPTION "the saa model which was used by spss to schedule
saa avoidance. AN interger value with range of
02-99. "
END_FIELD
FIELD dominant_gs
TYPE C12
DESCRIPTION "the fgs idd (f1, f2, f3) concatenated with the
dominant gs id. "
END_FIELD
FIELD subdominant
TYPE C12
DESCRIPTION "the fgs idd (f1, f2, f3) concatenated with the
subdominant gs id. "
END_FIELD
FIELD velabbra
TYPE R*4
DESCRIPTION "magnitude of aberration due to st and earth
velocities. THIS is the absolute angular
correction that must be
applied to the apparent position of the target as
seen from the st to compensate for the velocity of
the st and the earth. "
!
! Moving Target Parameters
!
END_FIELD
FIELD north_ra
TYPE R*4
UNITS "DEGREES"
DESCRIPTION "planetographic coordinate system parameters:
right ascension of north pole of planetary
target. "
END_FIELD
FIELD north_dec
TYPE R*4
UNITS "DEGREES"
DESCRIPTION "planetographic coordinate system parameters:
declination of north pole of planetary target. "
END_FIELD
FIELD long_prim_mer
TYPE R*4
UNITS "DEGREES"
DESCRIPTION "planetographic coordinate system parameters:
longitude of prime meridian of planetary target. "
END_FIELD
FIELD epoch_prim_mer
TYPE R*4
UNITS "DEGREES/DAY"
DESCRIPTION "planetographic coordinate system parameters:
epoch of longitude of prime meridian of planetary
target. "
END_FIELD
FIELD longitude_rate
TYPE R*4
UNITS "DEGREES/DAY"
DESCRIPTION "planetographic coordinate system parameters:
range of change of longitude. "
END_FIELD
FIELD equ_radius
TYPE R*4
UNITS "KILOMETRES"
DESCRIPTION "planetographic coordinate system parameters:
equatorial radius of planetary target. "
END_FIELD
FIELD flattening
TYPE R*4
DESCRIPTION "planetographic coordinate system parameters:
flattening of planetary target, the difference
between the equatorial and polar radius divided
by the equatorial radius. "
END_FIELD
FIELD feature_lat
TYPE R*4
UNITS "DEGREES"
DESCRIPTION "planetographic coordinate system parameters:
latitude of surface feature. "
END_FIELD
FIELD feature_long
TYPE R*4
UNITS "DEGREES"
DESCRIPTION "planetographic coordinate system parameters:
longitude of surface feature. "
END_FIELD
FIELD feature_alt
TYPE R*4
UNITS "KILOMETRES"
DESCRIPTION "planetographic coordinate system parameters:
altitude of surface feature. "
END_FIELD
FIELD mt_flag
TYPE C*1
DESCRIPTION "moving target flag; t => this is a moving target. "
!
END_FIELD
FIELD so_inv
UNITS "1/KILOMETERS"
TYPE R*8
DESCRIPTION "so inverse magnitude. "
!
END_FIELD
FIELD sox_dir
TYPE R*8
DESCRIPTION "so x direction. "
!
END_FIELD
FIELD soy_dir
TYPE R*8
DESCRIPTION "so y direction. "
!
END_FIELD
FIELD soz_dir
TYPE R*8
DESCRIPTION "so z direction. "
!
END_FIELD
FIELD cms
UNITS "UTC"
TYPE R*8
DESCRIPTION "command start time; seconds from 1980. "
!
END_FIELD
FIELD cme
UNITS "UTC"
TYPE R*8
DESCRIPTION "command end time; seconds from 1980. "
!
END_FIELD
FIELD a_1x
TYPE R*8
DESCRIPTION "coefficient a(1,x) of the #48 command. "
!
END_FIELD
FIELD a_1y
TYPE R*8
DESCRIPTION "coefficient a(1,y) of the #48 command. "
!
END_FIELD
FIELD a_1z
TYPE R*8
DESCRIPTION "coefficient a(1,z) of the #48 command. "
!
END_FIELD
FIELD a_2x
TYPE R*8
DESCRIPTION "coefficient a(2,x) of the #48 command. "
!
END_FIELD
FIELD a_2y
TYPE R*8
DESCRIPTION "coefficient a(2,y) of the #48 command. "
!
END_FIELD
FIELD a_2z
TYPE R*8
DESCRIPTION "coefficient a(2,z) of the #48 command. "
!
END_FIELD
FIELD a_3x
TYPE R*8
DESCRIPTION "coefficient a(3,x) of the #48 command. "
!
END_FIELD
FIELD a_3y
TYPE R*8
DESCRIPTION "coefficient a(3,y) of the #48 command. "
!
END_FIELD
FIELD a_3z
TYPE R*8
DESCRIPTION "coefficient a(3,z) of the #48 command. "
!
END_FIELD
FIELD a_4x
TYPE R*8
DESCRIPTION "coefficient a(4,x) of the #48 command. "
!
END_FIELD
FIELD a_4y
TYPE R*8
DESCRIPTION "coefficient a(4,y) of the #48 command. "
!
END_FIELD
FIELD a_4z
TYPE R*8
DESCRIPTION "coefficient a(4,z) of the #48 command. "
!
END_FIELD
FIELD a_5x
TYPE R*8
DESCRIPTION "coefficient a(5,x) of the #48 command. "
!
END_FIELD
FIELD a_5y
TYPE R*8
DESCRIPTION "coefficient a(5,y) of the #48 command. "
!
END_FIELD
FIELD a_5z
TYPE R*8
DESCRIPTION "coefficient a(5,z) of the #48 command. "
END_FIELD
END_RECORD
!------------------------------------------------------------------------------
!
! INSTANCE DECLARATION
!
!------------------------------------------------------------------------------
INSTANCE podps_observation_data
FILE
TYPE NSPSUP_TYPE
GLOBAL
END_INSTANCE