Package org.orekit.bodies

This package provides interface to represent the position and geometry of space objects such as stars, planets or asteroids.

See:
Description

Interface Summary

BodyShape	Interface representing the rigid surface shape of a natural body.
CelestialBody	Interface for celestial bodies like Sun, Moon or solar system planets.
CelestialBodyLoader	Interface for loading celestial bodies.
GeometricBodyShape	Extended interface for celestial bodies shapes : extends the OREKIT's BodyShape interface by adding geometric methods.
IAUPole	Interface for IAU pole and primer meridian orientations.

Class Summary

AbstractCelestialBody	Abstract implementation of the CelestialBody interface.
CelestialBodyFactory	Factory class for bodies of the solar system.
ExtendedOneAxisEllipsoid	implementation of the PatriusBodyShape interface : this an extended spheroid model to represent celestial bodies shapes.
GeodeticPoint	Point location relative to a 2D body surface.
IAUPoleFactory	Factory class for IAU poles.
JPLEphemeridesLoader	Loader for JPL ephemerides binary files (DE 4xx) and similar formats (INPOP 06/08/10).
MeeusMoon	This class implements the Moon ephemerides according to the algorithm of Meeus.
MeeusSun	This class implements the Sun ephemerides according to the algorithm of Meeus, it only provides the position.
OneAxisEllipsoid	Modeling of a one-axis ellipsoid.
PosVelChebyshev	Position-Velocity model based on Chebyshev polynomials.
UserCelestialBody	User-defined celestial body.

Enum Summary

JPLEphemeridesLoader.EphemerisType	List of supported ephemerides types.
MeeusSun.MODEL	Enumerate to choose the used Meeus model : standard, Stela or board model.

Package org.orekit.bodies Description

This package provides interface to represent the position and geometry of space objects such as stars, planets or asteroids.

The position of celestial bodies is represented by the CelestialBody interface. This interface provides the methods needed to either consider the body as an external one for its gravity or lighting influence on spacecraft (typically in perturbing force computation) or as an internal one with its own frame.

The CelestialBodyFactory class is a factory providing several predefined instances implementing the CelestialBody interface for the main solar system bodies. The Sun, the Moon, the eight planets and the Pluto dwarf planet are the supported bodies. In addition to these real bodies, two points are supported for convenience as if they were real bodies: the solar system barycenter and the Earth-Moon barycenter. The CelestialBodyFactory factory relies on the JPL DE 405, 406 or similar binary ephemerides files to compute all positions and velocities. Note that the binary files are used, not the ASCII ones, regardless of the processor endianness.

As an example, computing the position of the Sun and the Moon in the EME2000 frame, this done as follows:

CelestialBody sun  = CelestialBodyFactory.getSun();
CelestialBody moon = CelestialBodyFactory.getMoon();
Vector3D sunInEME2000 =
    sun.getPVCoordinates(date, Frame.getEME2000()).getPosition();
Vector3D moonInEME2000 =
    moon.getPVCoordinates(date, Frame.getEME2000()).getPosition();

Since the supported bodies implement the CelestialBody interface, they all provide their own body-centered inertial frame, hence adding a few more frames to the ones provided by the org.orekit.frames package. Since the frames tree is rooted at an Earth-centered frame, the solar system bodies frames tree does not seems in canonical shape. This of course is only a side effect of the arbitrary choice of GCRF as the root frame and has no effect at all on computations.

The shape of celestial bodies is represented by the BodyShape interface.

Only one implementation is provided by OREKIT for now: the OneAxisEllipsoid class which represents the natural flattened shape of big space rotating bodies like planets or the Sun.

For asteroids, it is expected that users provide their own shape models, for example based on triangulation. They should implement the BodyShape interface in order to be used by Orekit.

When using OneAxisEllipsoid body representation, points are generally described in associated body frame, by so-called geodetic coordinates (longitude, latitude, altitude). The GeodeticPoint class allows handling of such coordinates. It is a simple container that does not provide processing methods.

Author:

L. Maisonobe