Difference between revisions of "Filling out the Geometry Orbiter Class"

From The SBN Wiki
Jump to navigation Jump to search
(Creation - Safety Save)
(Creation - Safety Save)
Line 588: Line 588:
  
 
''OPTIONAL''
 
''OPTIONAL''
 +
 +
==== <Observer_Identification> ====
 +
 +
''REQUIRED''
 +
 +
==== <Target_Identification> ====
 +
 +
''REQUIRED''
  
 
=== <Velocity_Vector_Planetocentric_Generic> ===
 
=== <Velocity_Vector_Planetocentric_Generic> ===

Revision as of 17:22, 13 May 2015

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

<Reference_Frame_Identification>

REQUIRED

<Central_Body_Identification>

OPTIONAL

Waiting on SPICE-related changes.

<Coordinate_System>

OPTIONAL

<coordinate_system_type>

REQUIRED

<coordinate_system_time>

REQUIRED

<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 names 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

<spacecraft_heliocentric_distance>

OPTIONAL

<spacecraft_to_central_body_distance>

OPTIONAL

<spacecraft_to_target_center_distance>

OPTIONAL

<spacecraft_to_target_boresight_intercept_distance>

OPTIONAL

<spacecraft_to_target_subspacecraft_distance>

OPTIONAL

<target_geocentric_distance>

OPTIONAL

<target_heliocentric_distance>

OPTIONAL

<target_ssb_distance>

OPTIONAL

<Distance_Generic>

OPTIONAL

<Observer_Identification>

REQUIRED

Waiting on SPICE-related changes.

<Target_identification>

REQUIRED

Waiting on SPICE-related changes.

<distance>

REQUIRED


<Pixel_Dimensions>

OPTIONAL

<horizontal_pixel_size_angular>

OPTIONAL

<vertical_pixel_size_angular

OPTIONAL

<horizontal_pixel_scale_factor

OPTIONAL

<vertical_pixel_scale_factor

OPTIONAL

<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