Filling Out the Geometry Vector Classes

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

The Geometry Discipline dictionary contains definitions for five generic vectors that provide common terminology for components and related attributes. The generic vectors described are derived from the same parent classes as the specific vectors, like Earth_To_Spacecraft_Position_Vector_Cartesian, but also require that you specify the origin ("observer") and end point ("target"). The descriptions below indicate which attributes are omitted from specific vectors derived from the same parents as these generic vectors.

<Position_Vector_Cartesian_Generic>

This vector indicates a position as (x,y,z) components in a specified Cartesian coordinate system.

<x_position>

REQUIRED

X component of the position. You must specify a unit of length for this attribute.

<y_position>

REQUIRED

Y component of the position. You must specify a unit of length for this attribute.

<z_position>

REQUIRED

Z component of the position. You must specify a unit of length for this attribute.

<light_time_correction_applied>

REQUIRED

This attribute indicates which light time corrections, if any, have been applied in deriving this position. It must have one of these values:

  • Received_Light_Time
  • Received_Light_Time_Stellar_Abb
  • Transmitted_Light_Time
  • Transmitted_Light_Time_Stellar_Abb
  • None

<Coordinate_System>

OPTIONAL

This class contains all the attributes needed to define a coordinate system: reference frame, origin, coordinate type, and a reference time.

Note: If you are submitting data to the SBN and you are defining a generic vector, you must indicate the coordinate system of the vector.

<coordinate_system_type>

REQUIRED

This indicates the type of components comprising the vector. It must be one of the following values:

  • Azimuth-Elevation
  • Cartesian
  • Planetocentric
  • Planetodetic
  • Planetographic
  • Spherical

<coordinate_system_time>

REQUIRED

This attribute defines the instantiation time for the coordinate system. This must be given in the standard "YYYY-MM-DDThh:mm:ss.sss" format. Include the Z zone indicator if this is a UTC time.

Note: If you are submitting data to the SBN that makes use of this class, you must provide a UTC time for this attribute.

<Coordinate_System_Origin_Identification>

REQUIRED

Waiting on SPICE changes

<Reference_Frame_Identification>

REQUIRED

Waiting on SPICE changes

<Observer_Identification>

REQUIRED  —  This subclass is optional in specific vector classes.

Waiting on SPICE changes

<Target_Identification>

REQUIRED  —  This subclass is optional in specific vector classes.

Waiting on SPICE changes



<Velocity_Vector_Cartesian_Generic>

This vector indicates a velocity as (x,y,z) components in a specified Cartesian coordinate system.

<x_velocity>

REQUIRED

X component of the velocity. You must specify a unit of velocity (e.g., "km/s") for this attribute.

<y_velocity>

REQUIRED

Y component of the velocity. You must specify a unit of velocity for this attribute.

<z_velocity>

REQUIRED

Z component of the velocity. You must specify a unit of velocity for this attribute.

<light_time_correction_applied>

REQUIRED

This attribute indicates which light time corrections, if any, have been applied in deriving this position. It must have one of these values:

  • Received_Light_Time
  • Received_Light_Time_Stellar_Abb
  • Transmitted_Light_Time
  • Transmitted_Light_Time_Stellar_Abb
  • None

<Coordinate_System>

OPTIONAL

This class contains all the attributes needed to define a coordinate system: reference frame, origin, coordinate type, and a reference time. It is filled out identically to the class of the same name in <Position_Vector_Cartesian_Generic>

Note: If you are submitting data to the SBN and you are defining a generic vector, you must indicate the coordinate system of the vector.

<Observer_Identification>

REQUIRED  —  This subclass is optional in specific vector classes.


This class is filled out identically to the class of the same name in <Position_Vector_Cartesian_Generic>.

Waiting on SPICE changes

<Target_Identification>

REQUIRED  —  This subclass is optional in specific vector classes.

This class is filled out identically to the class of the same name in <Position_Vector_Cartesian_Generic>.

Waiting on SPICE changes