public class Distance_Utilities
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
ID
Class identification name with source code version and date.
|
static double |
LIGHT_SECOND
A light-second in astronomical units.
|
Modifier and Type | Method and Description |
---|---|
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(java.lang.String time)
Gets the altitude of the spacecraft above Mars given the ephemeris time of
the observation.
|
static double |
altitude(java.lang.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(java.lang.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(java.lang.String time)
Gets the heliocentric distance for Mars at the given ephemeris time.
|
static double |
getOwlt(double et)
Gets the one-way 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(java.lang.String time,
double roll_angle)
Gets the distance from the spacecraft to the observation target on the
surface of Mars.
|
static double |
target_distance(java.lang.String time,
double roll_angle,
double elevation)
Gets the distance from the spacecraft to the observation target on the
surface of Mars.
|
public static final java.lang.String ID
public static final double LIGHT_SECOND
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(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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(java.lang.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.Copyright \ (C) Arizona Board of Regents on behalf of the \ Planetary Image Research Laboratory, Lunar and \ Planetary Laboratory at the University of Arizona