Package org.orekit.frames

package org.orekit.frames

This package provides classes to handle frames and transforms between them.

The Transform class represents a full transform: combined rotation and translation, and their first time derivatives to handle kinematics.

Each Frame is defined by a transform linking it to another one, called its parent frame. The only exception is the root frame which has no parent. This implies that all frames are naturally organized as a tree with a single root. The predefined GCRF inertial frame was arbitrary chosen as the root for every tree.

The FramesFactory class implements several predefined reference frames. One set correspond to the frames from the various IERS conventions (ITRF and others). Other frames not belonging to the previous set are the EME2000 frame that was used prior to GCRF and which is linked to GCRF by a simple bias rotation, the MOD (Mean Of Date) frame which involves the IAU 1976 precession model, the TOD (True Of Date) frame which involves the IAU 1980 nutation model, the GTOD (Greenwich True Of Date) which involves the IAU 1982 Greenwich sidereal time model and the Veis 1950 frame which involves a Veis modified sidereal time model.

Some other frames are predefined outside of this package, in the CelestialBodies class. They correspond to the Sun, Moon, planets, solar system barycenter and Earth-Moon barycenter. For convenience, the very important solar system barycenter frame, which is the ICRF, can also be retrieved from the factory in this package even if it is really implemented in the bodies package.

The frames can be time dependent (for example the ITRF frame depends on time due to precession/nutation, Earth rotation and pole motion). In order to get a transform from one frame to another one, the date must be specified, and TransformProvider.getTransform(AbsoluteDate) is called under the hood. If a user wants to implement his own date synchronized frame, he has to implement his own TransformProvider class and provide it to the frame constructor.

Author:

Luc Maisonobe, Fabien Maussion, Véronique Pommier-Maurussane, Pascal Parraud

Related Packages

Package	Description
org.orekit.frames.encounter	Package specific to encounter local orbital frame.

Class	Description
AbstractEopLoader	Base class for EOP loaders.
AbstractFrames	This class is an implementation of Frames that creates frames when they are first used and uses synchronization to ensure that each frame is only created once.
AngularTransformProvider	Transform provider used to match the orientation of a given frame.
CachedTransformProvider	Thread-safe cached provider for frame transforms.
CR3BPRotatingFrame	Class creating the rotating frame centered on the barycenter of the CR3BP System.
EclipticProvider	An inertial frame aligned with the ecliptic.
EOPBasedTransformProvider	Interface for Transform providers that use Earth Orientation Parameters.
EopDataType	EOP data types.
EOPEntry	This class holds an Earth Orientation Parameters entry.
EOPFittedModel	Container for fitted model for Earth Orientation Parameters.
EOPFitter	Earth Orientation Parameters fitter for EOP prediction.
EOPHistory	This class loads any kind of Earth Orientation Parameter data throughout a large time range.
EopHistoryLoader	Interface for loading Earth Orientation Parameters history.
EopHistoryLoader.Parser	Interface for parsing EOP data files.
FactoryManagedFrame	Base class for the predefined frames that are managed by Frames.
FieldCachedTransformProvider<T extends CalculusFieldElement<T>>	Thread-safe cached provider for frame transforms.
FieldKinematicTransform<T extends CalculusFieldElement<T>>	A transform that only includes translation and rotation as well as their respective rates.
FieldPoleCorrection<T extends CalculusFieldElement<T>>	Simple container class for pole correction parameters.
FieldStaticTransform<T extends CalculusFieldElement<T>>	A transform that only includes translation and rotation.
FieldTransform<T extends CalculusFieldElement<T>>	Transformation class in three-dimensional space.
FieldTransformGenerator<T extends CalculusFieldElement<T>>	Generator to use field transforms in GenericTimeStampedCache.
FixedTransformProvider	Transform provider using fixed transform.
Frame	Tridimensional references frames class.
Frames	A collection of commonly used Frames.
FramesFactory	Factory for predefined reference frames.
GTODProvider	Greenwich True Of Date Frame, also known as True of Date Rotating frame (TDR) or Greenwich Rotating Coordinate frame (GCR).
HelmertTransformation	Transformation class for geodetic systems.
HelmertTransformation.Predefined	Enumerate for predefined Helmert transformations.
InterpolatingTransformProvider	Transform provider using thread-safe interpolation on transforms sample.
ITRFVersion	Enumerate for ITRF versions.
ITRFVersion.Converter	Specialized transform provider between ITRF frames.
ITRFVersionLoader	Loader for ITRF version configuration file.
ITRFVersionLoader.ITRFVersionConfiguration	ITRF version configuration entry.
ItrfVersionProvider	Interface for retrieving the ITRF version for a given set of EOP data.
KinematicTransform	A transform that only includes translation and rotation as well as their respective rates.
L1Frame	Class to create a L1 centered frame with L1TransformProvider.
L1TransformProvider	L1 Transform provider for a frame on the L1 Lagrange point of two celestial bodies.
L2Frame	Class to create a L2 centered frame with L2TransformProvider.
LazyLoadedEop	Loads Earth Orientation Parameters (EOP) from a configured set of EopHistoryLoaders on demand.
LazyLoadedFrames	This class lazily loads auxiliary data when it is needed by a requested frame.
LocalMagneticFieldFrame	This class handles a magnetic field variation attitude provider.
LocalMagneticFieldFrame.LOFBuilderVector	Enum defining how the +j axis of the local orbital frame will be defined.
LocalOrbitalFrame	Class for frames moving with an orbiting satellite.
LOF	Interface for local orbital frame.
LOFType	Enumerate for different types of Local Orbital Frames.
OriginTransformProvider	Transform provider that shifts the origin and keeps the orientation of another Frame.
OrphanFrame	Prototype frame that can be built from leaf to roots and later attached to a tree.
PoleCorrection	Simple container class for pole correction parameters.
Predefined	Predefined frames provided by Frames.
PredictedEOPHistory	This class extends an EOPHistory for some weeks using fitting.
ShiftingTransformProvider	Transform provider using thread-safe shifts on transforms sample.
SingleParameterFitter	Fitter for one Earth Orientation Parameter.
StaticTransform	A transform that only includes translation and rotation.
TopocentricFrame	Topocentric frame.
Transform	Transformation class in three dimensional space.
TransformGenerator	Generator to use transforms in GenericTimeStampedCache.
TransformProvider	Interface for Transform providers.
TransformProviderUtils	Utility for Transform providers.
TwoBodiesBaryFrame	Class creating the inertial barycenter frame from two bodies.
UpdatableFrame	Frame whose transform from its parent can be updated.
VersionedITRF	Specific version of International Terrestrial Reference Frame.