org.jeospace.physics.orbit
Class BaseSatellite

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

All Implemented Interfaces:

Identifiable, KineticBody, OrbitalBody, Satellite

Direct Known Subclasses:

EarthSatellite

public class BaseSatellite

extends java.lang.Object

implements Satellite

A concrete implementation of Satellite for identifying and tracking satellites in 'unperturbed' orbits about their parent worlds. In real world situations, there really is no such thing as an unperturbed orbit. However, the orbits of small planetoids (comets and asteroids) can be tracked reasonably accurately around the epoch of their orbital elements using this class. A general solution to Kepler's equation is utilized by this class for calculating position coordinates.

Version:

$Revision: 1.1.1.1 $

Author:

Rex Melton

See Also:

Satellite, Cartesian, Spherical, ReferenceFrame, OrbitalElements, Identification

Constructor Summary

protected	BaseSatellite() Construct an instance
	BaseSatellite(Identification ident, ReferenceFrame refFrame, OrbitalElements elements) Construct a Satellite instance

Method Summary

void	getCoordinate(double timeValue, Cartesian cartesian) Calculate the position of the satellite referenced to it's orbital plane about it's parent world at the specified time and initialize the passed Cartesian object with the position coordinate.
void	getCoordinate(double timeValue, Spherical spherical) Calculate the position of the satellite referenced to it's orbital plane about it's parent world at the specified time and initialize the passed Spherical object with the position coordinate.
Identification	getIdentification() Return the Identification of this satellite
OrbitalElements	getOrbitalElements(double timeValue) Return the OrbitalElements of the satellite
ReferenceFrame	getReferenceFrame() Return the identifier of the satellite's orbital reference frame.
void	setOrbitalElements(OrbitalElements elements) Set the OrbitalElements of the satellite

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseSatellite

protected BaseSatellite()

Construct an instance

BaseSatellite

public BaseSatellite(Identification ident,
                     ReferenceFrame refFrame,
                     OrbitalElements elements)

Construct a Satellite instance

Parameters:

ident - the identification of the satellite

refFrame - the identifier of the satellite's orbital plane.

elements - the OrbitalElements of the satellite

Method Detail

getIdentification

public Identification getIdentification()

Return the Identification of this satellite

Specified by:

getIdentification in interface Identifiable

Returns:

the Identification of this satellite

getReferenceFrame

public ReferenceFrame getReferenceFrame()

Return the identifier of the satellite's orbital reference frame.

Specified by:

getReferenceFrame in interface KineticBody

Returns:

the ReferenceFrame identifier

getOrbitalElements

public OrbitalElements getOrbitalElements(double timeValue)

Return the OrbitalElements of the satellite

Specified by:

getOrbitalElements in interface OrbitalBody

Parameters:

timeValue - the time instant for calculating the object's position

Returns:

the OrbitalElements of the satellite

setOrbitalElements

public void setOrbitalElements(OrbitalElements elements)

Set the OrbitalElements of the satellite

Specified by:

setOrbitalElements in interface Satellite

Parameters:

elements - the OrbitalElements of the satellite

getCoordinate

public void getCoordinate(double timeValue,
                          Spherical spherical)

Calculate the position of the satellite referenced to it's orbital plane about it's parent world at the specified time and initialize the passed Spherical object with the position coordinate.

Specified by:

getCoordinate in interface KineticBody

Parameters:

timeValue - the time instant for calculating the world's position

spherical - the object to initialize with the satellite's position coordinate

getCoordinate

public void getCoordinate(double timeValue,
                          Cartesian cartesian)

Calculate the position of the satellite referenced to it's orbital plane about it's parent world at the specified time and initialize the passed Cartesian object with the position coordinate.

Specified by:

getCoordinate in interface KineticBody

Parameters:

timeValue - the time instant for calculating the world's position

cartesian - the object to initialize with the satellite's position coordinate