jat.timeRef
Class EarthRef

java.lang.Object
  jat.timeRef.EarthRef

All Implemented Interfaces:

BodyRef

Deprecated.

public class EarthRef
extends java.lang.Object
implements BodyRef

The EarthRef Class provides methods of converting between various types of Earth reference systems. Reference: Satellite Orbits by Montenbruck and Gill. This is basically their C++ code converted to Java. The interface to this class is an input Terrestrial time in MJD format, which is available from either the CalDate or GPSTimeFormat classes. For general use of Earth based coordinate systems, see jat.spacetime.EarthRef.java

Version:

1.0

Author:

Richard C. Page III, Dave Gaylor

See Also:

EarthRef, EarthRef

Field Summary

int	increment Deprecated.
static double	MJD_J2000 Deprecated. Modified Julian Date of the J2000 Epoch.
int	n Deprecated.
boolean	use_moon Deprecated.
boolean	use_sun Deprecated.

Constructor Summary

EarthRef(CalDate date)
Deprecated. Construct an EarthRef object using UTC Time in CalDate format.

EarthRef(double mjd_UTC)
Deprecated. Construct an EarthRef object using UTC Time in Modified Julian Date format.

EarthRef(double mjd_UTC, boolean usingmatlab)
Deprecated.

Method Summary

Matrix	body_to_inertial(Time t) Deprecated. Transformation - body to inertial
int	dayOfYear() Deprecated. Converts the MJD expressed in UTC to give the days since Jan 01 00:00
Matrix	eci2ecef() Deprecated. ECI to ECEF Transformation
Matrix	ECI2ECEF() Deprecated. Returns the ECI to ECEF (ICRF to ITRF) Transformation Matrix.
RotationMatrix	EclMatrix() Deprecated. Transformation of equatorial to ecliptical coordinates.
double	EqnEquinox() Deprecated. Computation of the equation of the equinoxes.
double	GAST() Deprecated. Greenwich Apparent Sidereal Time.
double	get_grav_const() Deprecated. Get gravitational constant
VectorN	get_JPL_Moon_Vector() Deprecated. Get the current JPL vector to the Moon [km]
VectorN	get_JPL_Sun_Vector() Deprecated. Get the current JPL vector to the Sun [km]
double	get_mean_radius() Deprecated. Get mean radius
double	get_omega_e() Deprecated.
double	get_sim_time() Deprecated.
double	get_spin_rate(Time t) Deprecated. Spin rate
RotationMatrix	GHAMatrix() Deprecated. Transformation from true equator and equinox to Earth equator and Greenwich meridian system.
double	GMST() Deprecated. Greenwich Mean Sidereal Time.
void	incrementTime(double sec) Deprecated. Increment time to allow the computation of reference frames at a new time
Matrix	inertial_to_body(Time t) Deprecated. Transformation - inertial to body frame
double	jd_tt() Deprecated. Return the current TT time in JD format.
double	jd_utc() Deprecated. Return the current UTC time in JD format.
double	MeanObliquity() Deprecated. Computes the mean obliquity of the ecliptic.
double	mjd_tdb() Deprecated.
double	mjd_tt() Deprecated. Return the current Terrestrial time in MJD format.
double	mjd_ut1() Deprecated. Return the current UT1 time in MJD format.
double	MJD_UTC_START() Deprecated. Returns the Modified Julian Date of the start of the simulation
double	mjd_utc() Deprecated. Return the current UTC time in MJD format.
VectorN	moonVector() Deprecated. Computes the Moon's geocentric position using a low precision analytical series.
void	NutAngles() Deprecated. Computes Nutation in longitude and obliquity using the IAU 1980 nutation theory.
Matrix	NutMatrix() Deprecated. Transformation from mean to true equator and equinox.
Matrix	PoleMatrix() Deprecated. Transformation from pseudo Earth-fixed to Earth-fixed coordinates for a given date.
Matrix	PrecMatrix() Deprecated. Precession transformation of equatorial coordinates.
double	secOfDay() Deprecated. Converts the MJD expressed in UTC to give the seconds since 00:00 UTC
void	set_use_moon(boolean b) Deprecated.
void	set_use_sun(boolean b) Deprecated.
void	setIERS(double x, double y, double d) Deprecated. Set the IERS (Earth Rotation) Data
VectorN	sunVector() Deprecated. Computes the Sun's geocentric position using a low precision analytical series.
Matrix	TOD() Deprecated. Returns the J2000 to True of Date (ICRF to TOD) Transformation Matrix.
Matrix	trueOfDate() Deprecated. J2000 to TOD Transformation
Matrix	trueOfDate(Time t) Deprecated. Transformation from J2000 to true of date equinox
void	updateTimeSinceStart(double sec) Deprecated. Updates the Earth model a number of seconds since the initial epoch.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

n

public int n

Deprecated.

increment

public int increment

Deprecated.

use_moon

public boolean use_moon

Deprecated.

use_sun

public boolean use_sun

Deprecated.

MJD_J2000

public static final double MJD_J2000

Deprecated.

Modified Julian Date of the J2000 Epoch.

See Also:

Constant Field Values

Constructor Detail

EarthRef

public EarthRef(double mjd_UTC)

Deprecated.

Construct an EarthRef object using UTC Time in Modified Julian Date format.

Parameters:

mjd_UTC - UTC time in MJD format.

EarthRef

public EarthRef(CalDate date)

Deprecated.

Construct an EarthRef object using UTC Time in CalDate format.

Parameters:

date - CalDate object containing UTC time.

EarthRef

public EarthRef(double mjd_UTC,
                boolean usingmatlab)

Deprecated.

Method Detail

setIERS

public void setIERS(double x,
                    double y,
                    double d)

Deprecated.

Set the IERS (Earth Rotation) Data

Parameters:

x - x_pole coordinate (rad)

y - y_pole coordinate (rad)

d - UT1 - UTC difference in s.

MJD_UTC_START

public double MJD_UTC_START()

Deprecated.

Returns the Modified Julian Date of the start of the simulation

Returns:

modified julian date of the start of the simulation in UTC

ECI2ECEF

public Matrix ECI2ECEF()

Deprecated.

Returns the ECI to ECEF (ICRF to ITRF) Transformation Matrix.

Returns:

ECI to ECEF Transformation Matrix.

TOD

public Matrix TOD()

Deprecated.

Returns the J2000 to True of Date (ICRF to TOD) Transformation Matrix.

Returns:

J2000 to TOD Transformation Matrix.

mjd_tt

public double mjd_tt()

Deprecated.

Return the current Terrestrial time in MJD format.

Returns:

MJD of current Terrestrial time.

mjd_tdb

public double mjd_tdb()

Deprecated.

mjd_utc

public double mjd_utc()

Deprecated.

Return the current UTC time in MJD format.

Returns:

MJD of current UTC time.

jd_utc

public double jd_utc()

Deprecated.

Return the current UTC time in JD format.

Returns:

JD of current UTC time.

jd_tt

public double jd_tt()

Deprecated.

Return the current TT time in JD format.

Returns:

JD of current TT time.

mjd_ut1

public double mjd_ut1()

Deprecated.

Return the current UT1 time in MJD format.

Returns:

MJD of current UT1 time.

MeanObliquity

public double MeanObliquity()

Deprecated.

Computes the mean obliquity of the ecliptic. Uses Mjd_TT (Terrestrial Time).

Returns:

Mean obliquity of the ecliptic

EclMatrix

public RotationMatrix EclMatrix()

Deprecated.

Transformation of equatorial to ecliptical coordinates. Uses Mjd_TT (Terrestrial Time).

Returns:

Transformation matrix

PrecMatrix

public Matrix PrecMatrix()

Deprecated.

Precession transformation of equatorial coordinates. Uses Mjd_TT (Terrestrial Time).

Returns:

Precession transformation matrix

NutAngles

public void NutAngles()

Deprecated.

Computes Nutation in longitude and obliquity using the IAU 1980 nutation theory. Uses Mjd_TT (Terrestrial Time).

NutMatrix

public Matrix NutMatrix()

Deprecated.

Transformation from mean to true equator and equinox. Uses Mjd_TT (Terrestrial Time).

Returns:

Nutation matrix

EqnEquinox

public double EqnEquinox()

Deprecated.

Computation of the equation of the equinoxes. Uses Mjd_TT (Terrestrial Time). Notes: The equation of the equinoxes dpsi*Math.cos(eps) is the right ascension of the mean equinox referred to the true equator and equinox and is equal to the difference between apparent and mean sidereal time.

Returns:

Equation of the equinoxes

GMST

public double GMST()

Deprecated.

Greenwich Mean Sidereal Time. Uses Mjd_UT1.

Returns:

GMST in [rad]

GAST

public double GAST()

Deprecated.

Greenwich Apparent Sidereal Time.

Returns:

GAST in [rad]

GHAMatrix

public RotationMatrix GHAMatrix()

Deprecated.

Transformation from true equator and equinox to Earth equator and Greenwich meridian system.

Returns:

Greenwich Hour Angle matrix

PoleMatrix

public Matrix PoleMatrix()

Deprecated.

Transformation from pseudo Earth-fixed to Earth-fixed coordinates for a given date. Uses Mjd_UTC if poles are a function of UTC.

Returns:

Pole matrix

trueOfDate

public Matrix trueOfDate()

Deprecated.

J2000 to TOD Transformation

Returns:

J2000 to ECEF transformation matrix

eci2ecef

public Matrix eci2ecef()

Deprecated.

ECI to ECEF Transformation

Returns:

ECI to ECEF transformation matrix

incrementTime

public void incrementTime(double sec)

Deprecated.

Increment time to allow the computation of reference frames at a new time

Parameters:

sec - Increment to move time in seconds. Can be + or -.

updateTimeSinceStart

public void updateTimeSinceStart(double sec)

Deprecated.

Updates the Earth model a number of seconds since the initial epoch. Since the RungeKutta algorithm requires the ability to look at an arbitrary point in time, it is necessary to allow arbitrary stepping of time in the Earth model.

Parameters:

sec: - seconds since MJD_UTC_START

get_omega_e

public double get_omega_e()

Deprecated.

sunVector

public VectorN sunVector()

Deprecated.

Computes the Sun's geocentric position using a low precision analytical series.

Returns:

Solar position vector [m] with respect to the mean equator and equinox of J2000 (EME2000, ICRF)

get_JPL_Sun_Vector

public VectorN get_JPL_Sun_Vector()

Deprecated.

Description copied from interface: BodyRef

Get the current JPL vector to the Sun [km]

Specified by:

get_JPL_Sun_Vector in interface BodyRef

Returns:

Vector [km]

get_JPL_Moon_Vector

public VectorN get_JPL_Moon_Vector()

Deprecated.

Description copied from interface: BodyRef

Get the current JPL vector to the Moon [km]

Specified by:

get_JPL_Moon_Vector in interface BodyRef

Returns:

Vector [km]

set_use_sun

public void set_use_sun(boolean b)

Deprecated.

set_use_moon

public void set_use_moon(boolean b)

Deprecated.

moonVector

public VectorN moonVector()

Deprecated.

Computes the Moon's geocentric position using a low precision analytical series.

Returns:

Lunar position vector [m] with respect to the mean equator and equinox of J2000 (EME2000, ICRF).

dayOfYear

public int dayOfYear()

Deprecated.

Converts the MJD expressed in UTC to give the days since Jan 01 00:00

Returns:

The number of days since the beginning of the current year.

secOfDay

public double secOfDay()

Deprecated.

Converts the MJD expressed in UTC to give the seconds since 00:00 UTC

Returns:

The number of seconds since the beginning of the current day (UTC).

get_sim_time

public double get_sim_time()

Deprecated.

get_spin_rate

public double get_spin_rate(Time t)

Deprecated.

Description copied from interface: BodyRef

Spin rate

Specified by:

get_spin_rate in interface BodyRef

Parameters:

t - Time object

Returns:

scalar spin rate [rad/s]

get_mean_radius

public double get_mean_radius()

Deprecated.

Description copied from interface: BodyRef

Get mean radius

Specified by:

get_mean_radius in interface BodyRef

Returns:

radius [m]

get_grav_const

public double get_grav_const()

Deprecated.

Description copied from interface: BodyRef

Get gravitational constant

Specified by:

get_grav_const in interface BodyRef

Returns:

grav_constant [m^3/s^2]

inertial_to_body

public Matrix inertial_to_body(Time t)

Deprecated.

Description copied from interface: BodyRef

Transformation - inertial to body frame

Specified by:

inertial_to_body in interface BodyRef

Parameters:

t - Time object

Returns:

Transformation matrix

body_to_inertial

public Matrix body_to_inertial(Time t)

Deprecated.

Description copied from interface: BodyRef

Transformation - body to inertial

Specified by:

body_to_inertial in interface BodyRef

Parameters:

t - Time object

Returns:

Transformation matrix

trueOfDate

public Matrix trueOfDate(Time t)

Deprecated.

Description copied from interface: BodyRef

Transformation from J2000 to true of date equinox

Specified by:

trueOfDate in interface BodyRef

Parameters:

t - Time object

Returns:

Transformation matrix