Filling out the Geometry Orbiter Class

From The SBN Wiki
Revision as of 18:13, 13 May 2015 by Raugh (talk | contribs) (Creation - Safety Save)
Jump to navigation Jump to search

The Geometry_Orbiter class provides geometric values related to an orbiting or flyby spacecraft observation. The values in this class are specific to a single reference frame at a single reference time for at most a single target. You may repeat this class with differing values for one or all of those, if appropriate to the observation being labelled.

Contents

<geometry_reference_time>

REQUIRED

This is the UTC time for which the values in this class have been calculated. It must be in the standard YYY-MM-DDThh:mm:ss.sssZ" format.

<Reference_Frame_Identification>

REQUIRED

Waiting on SPICE-related changes.

<Central_Body_Identification>

OPTIONAL

Waiting on SPICE-related changes.

<Coordinate_System>

OPTIONAL

This class defines a coordinate system. It specifies an origin, reference frame, type, and reference time.

<coordinate_system_type>

REQUIRED

This indicates the type of coordinates that will be used. It must be one of the following standard values:

  • Cartesian
  • Planetocentric
  • Planetodetic
  • Planetographic
  • Spherical

<coordinate_system_time>

REQUIRED

This attribute provides a reference time for the instantiation of the coordinate system. It must be in the standard "YYYY-MM-DDThh:mm:ss.sss". If the time is a UTC time, add the Z zone indicator at the end.

<Coordinate_System_Origin_Identification>

REQUIRED

Waiting on SPICE-related changes.

<Reference_Frame_Identification>

REQUIRED

Waiting on SPICE-related changes.


<Target_Identification>

OPTIONAL

Waiting on SPICE-related changes.


<Distances>

OPTIONAL

This class collects scalar point-to-point distance measurements for various named intervals of interest, as well as providing a class for specifying arbitrary distance measurements as needed.

All distances are considered positive, and you must provide units of an appropriate type in each case. For example:

     <spacecraft_to_target_center_distance unit="km">15.097</spacecraft_to_target_center_distance>
     <target_geocentric_distance unit="AU">17.9</target_geocentric_distance>

<spacecraft_geocentric_distance>

OPTIONAL

Distance from the center of the spacecraft to the center of Earth

<spacecraft_heliocentric_distance>

OPTIONAL

Distance from the center of the spacecraft to the center of the sun

<spacecraft_to_central_body_distance>

OPTIONAL

Distance from the center of the spacecraft to the center of the object identified by the <Central_Body_Identification> class

<spacecraft_to_target_center_distance>

OPTIONAL

Distance from the center of the spacecraft to the center of the object identified by the <Target_Identification> class in this <Geometry_Orbiter> class.

<spacecraft_to_target_boresight_intercept_distance>

OPTIONAL

Distance from the center of the spacecraft, measured along the boresight of the observing instrument, to the point that line intercepts the surface of the object identified by the <Target_Identification> class in this <Geometry_orbiter> class.

<spacecraft_to_target_subspacecraft_distance>

OPTIONAL

Distance from the center of the spacecraft, measured along a line from the center of the spacecraft to the center of the object identified by the <Target_Identification> class in this <Geometry_Orbiter> class, to the point where that line intercepts the surface of that object.

<target_geocentric_distance>

OPTIONAL

Distance from the center of the target to the center of Earth

<target_heliocentric_distance>

OPTIONAL

Distance from the center of the target to the center of the sun

<target_ssb_distance>

OPTIONAL

Distance from the center of the target to the Solar System Barycenter (SSB)

<Distance_Generic>

OPTIONAL

This class provides an opportunity to define and record a distance measurement not included in the preceding attributes of this class. You must define the start point of the distance measurement as the "observer", and the end point as the "target" (in a generic sense, here).

<Observer_Identification>

REQUIRED

Waiting on SPICE-related changes.

<Target_identification>

REQUIRED

Waiting on SPICE-related changes.

<distance>

REQUIRED

The actual distance measurement from observer to target. You must, as always, provide an appropriate unit of measure with this attribute.


<Pixel_Dimensions>

OPTIONAL

This class provides various ways of translating pixels footprints to physical dimensions. You must provide units for these attributes as appropriate.

<horizontal_pixel_size_angular>

OPTIONAL

This attribute gives the horizontal (as defined by the <Display_Direction> class) size of a pixel in terms of its angular size.

<vertical_pixel_size_angular>

OPTIONAL

This attribute gives the vertical (as defined by the <Display_Direction> class) size of a pixel in terms of its angular size.

<horizontal_pixel_scale_factor>

OPTIONAL

This attribute gives the horizontal (as defined by the <Display_Direction> class) scaling factor needed to convert the width of a pixel to a linear extent at the point of interest - typically at the surface intercept point of a relatively close object, or at the distance of the center of a distant one.

Units for this keyword are Units_of_Map_Scale - "km/pixel", for example.

<vertical_pixel_scale_factor>

OPTIONAL

This attribute gives the vertical (as defined by the <Display_Direction> class) scaling factor needed to convert the height of a pixel to a linear extent at the point of interest - typically at the surface intercept point of a relatively close object, or at the distance of the center of a far-off one.

Units for this keyword are Units_of_Map_Scale - "km/pixel", for example.

<Pixel_Size_Projected>

OPTIONAL

<reference_location>

REQUIRED

<horizontal_pixel_size_projected>

OPTIONAL

<vertical_pixel_size_projected>

OPTIONAL


<Surface_Geometry>

OPTIONAL

<Pixel_Intercept>

OPTIONAL

<reference_pixel_location>

OPTIONAL

<Reference_Pixel>

OPTIONAL

<pixel_latitude>

OPTIONAL

<pixel_longitude>

OPTIONAL

<Footprint_Vertices>

OPTIONAL

<Pixel_Intercept>

REQUIRED

<subsolar_azimuth>

OPTIONAL

<subsolar_latitude>

OPTIONAL

<subsolar_longitude>

OPTIONAL

<subspacecraft_azimuth>

OPTIONAL

<subspacecraft_latitude>

OPTIONAL

<subspacecraft_longitude>>

OPTIONAL


<Illumination_Geometry>

OPTIONAL

<Illumination_Single_Values>

OPTIONAL

<reference_location> or <reference_pixel_location>

OPTIONAL

<Reference_Pixel>

OPTIONAL

<emission_angle>

OPTIONAL

<incidence_angle>

OPTIONAL

<phase_angle>

OPTIONAL

<solar_elongation>

OPTIONAL

<Illumination_FOV_Range_Values>

OPTIONAL

<illumination_range_designation>

REQUIRED

<minimum_emission_angle>

OPTIONAL

<maximum_emission_angle>

OPTIONAL

<minimum_incidence_angle>

OPTIONAL

<maximum_incidence_angle>

OPTIONAL

<minimum_phase_angle>

OPTIONAL

<maximum_phase_angle>

OPTIONAL


<Specific_Position_Vectors>

OPTIONAL

<Central_Body_To_Spacecraft_Position_Vector_Cartesian>

OPTIONAL

<Central_Body_To_Target_Position_Vector_Cartesian>

OPTIONAL

<Spacecraft_To_Target_Position_Vector_Cartesian>

OPTIONAL

<Central_Body_To_Spacecraft_Position_Vector_Planetocentric>

OPTIONAL

<Central_Body_To_Target_Position_Vector_Planetocentric>

OPTIONAL

<Spacecraft_To_Target_Position_Vector_Planetocentric>

OPTIONAL

<SSB_To_Central_Body_Position_Vector_Cartesian>

OPTIONAL

<SSB_To_Spacecraft_Position_Vector_Cartesian>

OPTIONAL

<SSB_To_Target_Position_Vector_Cartesian>

OPTIONAL

<Sun_To_Central_Body_Position_Vector_Cartesian>

OPTIONAL

<Sun_To_Spacecraft_Position_Vector_Cartesian>

OPTIONAL

<Sun_To_Target_Position_Vector_Cartesian>

OPTIONAL

<Earth_To_Central_Body_Position_Vector_Cartesian>

OPTIONAL

<Earth_To_Spacecraft_Position_Vector_Cartesian>

OPTIONAL

<Earth_To_Target_Position_Vector_Cartesian>

OPTIONAL


<Specific_Velocity_Vectors>

OPTIONAL

<Spacecraft_Relative_To_Central_Body_Velocity_Vector_Cartesian>

OPTIONAL

<Spacecraft_Relative_To_Target_Velocity_Vector_Cartesian>

OPTIONAL

<Spacecraft_Relative_To_Earth_Velocity_Vector_Cartesian>

OPTIONAL

<Spacecraft_Relative_To_SSB_Velocity_Vector_Cartesian>

OPTIONAL

<Spacecraft_Relative_To_Sun_Velocity_Vector_Cartesian>

OPTIONAL

<Target_Relative_To_Central_Body_Velocity_Vector_Cartesian>

OPTIONAL

<Target_Relative_To_Spacecraft_Velocity_Vector_Cartesian>

OPTIONAL

<Target_Relative_To_Earth_Velocity_Vector_Cartesian>

OPTIONAL

<Target_Relative_To_SSB_Velocity_Vector_Cartesian>

OPTIONAL

<Target_Relative_To_Sun_Velocity_Vector_Cartesian>

OPTIONAL

<Spacecraft_Relative_To_Target_Velocity_Vector_Planetocentric>

OPTIONAL

<Target_Relative_To_Central_Body_Velocity_Vector_Planetocentric>

OPTIONAL

<Target_Relative_To_Spacecraft_Velocity_Vector_Planetocentric>

OPTIONAL


<Specific_Cartesian_Vectors>

OPTIONAL

If you prefer, you may group your vectors according to the vector type (Cartesian vs. planetocentric) rather than their content (position vs. velocity). This class combines all the Cartesian vectors mentioned in the previous two classes into a single class. Each is optional in this class - use the ones that apply. The vectors included in this class, in label order, are:

Position Vectors
  • Central_Body_To_Spacecraft_Position_Vector_Cartesian
  • Central_Body_To_Target_Position_Vector_Cartesian
  • Spacecraft_To_Target_Position_Vector_Cartesian
  • SSB_To_Central_Body_Position_Vector_Cartesian
  • SSB_To_Spacecraft_Position_Vector_Cartesian
  • SSB_To_Target_Position_Vector_Cartesian
  • Sun_To_Central_Body_Position_Vector_Cartesian
  • Sun_To_Spacecraft_Position_Vector_Cartesian
  • Sun_To_Target_Position_Vector_Cartesian
  • Earth_To_Central_Body_Position_Vector_Cartesian
  • Earth_To_Spacecraft_Position_Vector_Cartesian
  • Earth_To_Target_Position_Vector_Cartesian
Velocity Vectors
  • Spacecraft_Relative_To_Central_Body_Velocity_Vector_Cartesian
  • Spacecraft_Relative_To_Target_Velocity_Vector_Cartesian
  • Spacecraft_Relative_To_Earth_Velocity_Vector_Cartesian
  • Spacecraft_Relative_To_SSB_Velocity_Vector_Cartesian
  • Spacecraft_Relative_To_Sun_Velocity_Vector_Cartesian
  • Target_Relative_To_Central_Body_Velocity_Vector_Cartesian
  • Target_Relative_To_Spacecraft_Velocity_Vector_Cartesian
  • Target_Relative_To_Earth_Velocity_Vector_Cartesian
  • Target_Relative_To_SSB_Velocity_Vector_Cartesian
  • Target_Relative_To_Sun_Velocity_Vector_Cartesian


<Specific_Planetocentric_Vectors>

OPTIONAL

If you prefer, you may group your vectors according to the vector type (Cartesian vs. planetocentric) rather than their content (position vs. velocity). This class combines all the planetocentric vectors mentioned in the first two "Specific Vectors classes into a single class. Each is optional in this class - use the ones that apply. The vectors included in this class, in label order, are:

Position Vectors
  • Central_Body_To_Spacecraft_Position_Vector_Planetocentric
  • Central_Body_To_Target_Position_Vector_Planetocentric
  • Spacecraft_To_Target_Position_Vector_Planetocentric
  • Spacecraft_Relative_To_Target_Velocity_Vector_Planetocentric
  • Target_Relative_To_Central_Body_Velocity_Vector_Planetocentric
  • Target_Relative_To_Spacecraft_Velocity_Vector_Planetocentric


<Generic_Vectors>

OPTIONAL

<Position_Vector_Cartesian_Generic>

OPTIONAL

<x_position>

REQUIRED

<y_position>

REQUIRED

<z_position>

REQUIRED

<light_time_correction_applied>

REQUIRED

<Coordinate_System>

OPTIONAL

<Observer_Identification>

REQUIRED

<Target_Identification>

REQUIRED

<Velocity_Vector_Cartesian_Generic>

OPTIONAL

<x_velocity>

REQUIRED

<y_velocity>

REQUIRED

<z_velocity>

REQUIRED

<light_time_correction_applied>

REQUIRED

<Coordinate_System>

OPTIONAL

<Observer_Identification>

REQUIRED

<Target_Identification>

REQUIRED

<Acceleration_Vector_Cartesian_Generic>

OPTIONAL

<x_acceleration>

REQUIRED

<y_acceleration>

REQUIRED

<z_acceleration>

REQUIRED

<light_time_correction_applied>

REQUIRED

<Coordinate_System>

OPTIONAL

<Observer_Identification>

REQUIRED

<Target_Identification>

REQUIRED

<Position_Vector_Planetocentric_Generic>

OPTIONAL

<radius_position>

REQUIRED

<longitude_position>

REQUIRED

<latitude_position>

REQUIRED

<light_time_correction_applied>

REQUIRED

<Coordinate_System>

OPTIONAL

<Observer_Identification>

REQUIRED

<Target_Identification>

REQUIRED

<Velocity_Vector_Planetocentric_Generic>

OPTIONAL

<radial_velocity>

OPTIONAL

<longitude_velocity>

OPTIONAL

<latitude_velocity>

OPTIONAL

<light_time_correction_applied>

REQUIRED

<Coordinate_System>

OPTIONAL

<Observer_Identification>

REQUIRED

<Target_Identification>

REQUIRED