org.jeospace.physics.orbit
Class UnperturbedEllipticMotion

java.lang.Object
  org.jeospace.physics.orbit.UnperturbedEllipticMotion

All Implemented Interfaces:

EllipticMotion

public class UnperturbedEllipticMotion

extends java.lang.Object

implements EllipticMotion

A solution to the equation of Kepler for calculating the elliptic motion of an object in orbit. This solution, as it's name implies, has no capability to compensate for any perturbances to the motion of the object such as the gravitational effects of other objects, gravitational irregularities of the parent world that the object is orbiting or environmental effects such as the atmospheric drag of the object's parent world.

As such, this class is most suitable for predicting the path of objects in the solar system such as asteroids and comets for relatively short periods of time close to the epoch of their orbital elements.

The solution for the equation of Kepler has been derived from:
Meeus, Astronomical Algorithms, Chapter 29 Equation of Kepler.

For additional reference see: http://scienceworld.wolfram.com/physics/Orbit.html

Version:

$Revision: 1.1.1.1 $

Author:

Rex Melton

See Also:

EllipticMotion, OrbitalElements, Spherical, Cartesian

Constructor Summary

UnperturbedEllipticMotion(OrbitalElements oe)
Construct an instance

Method Summary

void	getValue(AnomalyType type, double anomalyArgument, Cartesian position) Return the position of the orbital object for the anomaly type and argument in the passed Cartesian object.
void	getValue(double julianDay, Cartesian position) Return the position of the orbital object for the given Julian day in the passed Cartesian object.
void	getValue(double julianDay, Spherical spherical) Return the position of the orbital object for the given Julian Day in the passed Spherical object.
void	set(OrbitalElements oe) Set the value of the orbital elements to be used in the calculation of the orbital object in it's elliptic motion

Methods inherited from class java.lang.Object

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

Constructor Detail

UnperturbedEllipticMotion

public UnperturbedEllipticMotion(OrbitalElements oe)

Construct an instance

Parameters:

oe - the orbital elements of the object

Method Detail

set

public void set(OrbitalElements oe)

Set the value of the orbital elements to be used in the calculation of the orbital object in it's elliptic motion

Specified by:

set in interface EllipticMotion

Parameters:

oe - the orbital elements

getValue

public void getValue(AnomalyType type,
                     double anomalyArgument,
                     Cartesian position)

Return the position of the orbital object for the anomaly type and argument in the passed Cartesian object.

Parameters:

type - the anomaly type to calculate

anomalyArgument - the 'starting value' to be used for the eccentric anomaly

position - the Cartesian object to initialize with the orbital object's position

getValue

public void getValue(double julianDay,
                     Cartesian position)

Return the position of the orbital object for the given Julian day in the passed Cartesian object.

Specified by:

getValue in interface EllipticMotion

Parameters:

julianDay - the Julian day

position - the Cartesian object to initialize with the orbital object's position

getValue

public void getValue(double julianDay,
                     Spherical spherical)

Return the position of the orbital object for the given Julian Day in the passed Spherical object. If the argument Spherical object is null, a new object will be created and returned.

Specified by:

getValue in interface EllipticMotion

Parameters:

julianDay - the Julian day

spherical - the Spherical object to initialize with the orbital object's position.