

PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 
java.lang.Object HiRISE.HiPlan.SPICE.Distance_Utilities
public class Distance_Utilities
A utility class for manipulating and calculating HiRISErelated times. This class uses the NAIF SPICE toolkit via the ASUdeveloped JSPICE system.
Field Summary  

static String 
ID
Class identification name with source code version and date. 
static double 
LIGHT_SECOND
A lightsecond in astronomical units. 
Method Summary  

static double 
altitude(double et)
Gets the altitude of the spacecraft above Mars given the ephemeris time of the observation. 
static double 
altitude(double et,
double elevation)
Gets the altitude of the spacecraft above Mars given the ephemeris time of the observation and the elevation of the point below. 
static double 
altitude(String time)
Gets the altitude of the spacecraft above Mars given the ephemeris time of the observation. 
static double 
altitude(String time,
double elevation)
Gets the altitude of the spacecraft above Mars given the ephemeris time of the observation and the elevation of the point below. 
static double 
getGeocentricDistance(double et)
Gets the geocentric distance for Mars at the given ephemeris time. 
static double 
getGeocentricDistance(String time)
Gets the geocentric distance for Mars at the given ephemeris time. 
static double 
getHeliocentricDistance(double et)
Gets the heliocentric distance for Mars at the given ephemeris time. 
static double 
getHeliocentricDistance(String time)
Gets the heliocentric distance for Mars at the given ephemeris time. 
static double 
getOwlt(double et)
Gets the oneway light time between Earth and Mars at the given ephemeris time. 
static double 
getOwltFromDistance(double au)
Gets the amount of time it takes for light to travel the indicated number of astronomical units. 
static double 
target_distance(double et,
double roll_angle)
Gets the distance from the spacecraft to the observation target on the surface of Mars. 
static double 
target_distance(double et,
double roll_angle,
double elevation)
Gets the distance from the spacecraft to the observation target on the surface of Mars. 
static double 
target_distance(String time,
double roll_angle)
Gets the distance from the spacecraft to the observation target on the surface of Mars. 
static double 
target_distance(String time,
double roll_angle,
double elevation)
Gets the distance from the spacecraft to the observation target on the surface of Mars. 
Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 
Field Detail 

public static final String ID
public static final double LIGHT_SECOND
Method Detail 

public static double target_distance(double et, double roll_angle, double elevation) throws SPICE_Exception
At present, this method uses the JS
utilities from the ASU package.
These utilities have some overhead unnecessary to the strict computation of
line time for HiRISE: they use the JMARS configuration system and the JMARS
logging system.
et
 the ephemeris time of the center point of the observation.roll_angle
 the spacecraft roll angle for the observation.elevation
 the elevation of the center point of the observation
target in km.
SPICE_Exception
 if there is a problem computing the distance.public static double target_distance(double et, double roll_angle) throws SPICE_Exception
et
 the ephemeris time of the center point of the observation.roll_angle
 the spacecraft roll angle for the observation.
SPICE_Exception
 if there is a problem computing the distance.target_distance(double,double,double)
public static double target_distance(String time, double roll_angle, double elevation) throws SPICE_Exception
time
 the ephemeris time text of the center point of the
observation.roll_angle
 the spacecraft roll angle for the observation.elevation
 the elevation of the center point of the observation
target in km.
SPICE_Exception
 if there is a problem computing the distance.target_distance(double,double,double)
public static double target_distance(String time, double roll_angle) throws SPICE_Exception
time
 the ephemeris time text of the center point of the
observation.roll_angle
 the spacecraft roll angle for the observation.
SPICE_Exception
 if there is a problem computing the distance.target_distance(double,double,double)
public static double altitude(double et, double elevation) throws SPICE_Exception
target_distance(double, double, double)
when roll_angle is 0 degrees.
et
 the ephemeris time of the center point of the observation.elevation
 the elevation of the center point of the observation
target in km.
SPICE_Exception
 if there is a problem computing the altitude.target_distance(double,double,double)
public static double altitude(double et) throws SPICE_Exception
target_distance(double, double, double)
when roll_angle is 0 degrees.
et
 the ephemeris time of the center point of the observation.
SPICE_Exception
 if there is a problem computing the altitude.target_distance(double,double,double)
public static double altitude(String time, double elevation) throws SPICE_Exception
target_distance(double, double, double)
when roll_angle is 0 degrees.
time
 the ephemeris time text of the center point of the
observation.elevation
 the elevation of the center point of the observation
target in km.
SPICE_Exception
 if there is a problem computing the altitude.target_distance(double,double,double)
public static double altitude(String time) throws SPICE_Exception
target_distance(double, double, double)
when roll_angle is 0 degrees.
time
 the ephemeris time text of the center point of the
observation.
SPICE_Exception
 if there is a problem computing the altitude.target_distance(double,double,double)
public static double getHeliocentricDistance(double et) throws SPICE_Exception
et
 the ephemeris time for the heliocentric distance.
SPICE_Exception
 if there is a problem computing the distance.public static double getHeliocentricDistance(String time) throws SPICE_Exception
time
 the ephemeris time text for the heliocentric distance.
SPICE_Exception
 if there is a problem computing the distance or if
the time text cannot be parsed.public static double getGeocentricDistance(double et) throws SPICE_Exception
et
 the ephemeris time for the geocentric distance.
SPICE_Exception
 if there is a problem computing the distance.public static double getGeocentricDistance(String time) throws SPICE_Exception
time
 the ephemeris time text for the geocentric distance.
SPICE_Exception
 if there is a problem computing the distance or if
the time text cannot be parsed.public static double getOwlt(double et) throws SPICE_Exception
et
 the ephemeris time.
SPICE_Exception
 if there is a problem computing the OWLT.public static double getOwltFromDistance(double au)
getOwlt(double)
, except it does not use SPICE and can
be used with any distance in AU.
au
 the distance in AU.


PREV CLASS NEXT CLASS  FRAMES NO FRAMES  
SUMMARY: NESTED  FIELD  CONSTR  METHOD  DETAIL: FIELD  CONSTR  METHOD 