public class FramesFactory extends Object
Several predefined reference frames
are implemented in OREKIT.
They are linked together in a tree with the Geocentric
Celestial Reference Frame (GCRF) as the root of the tree.
This factory is designed to:
Earth Orientation Parameters
history loading.
The user can retrieve those reference frames using various static methods, the most
important ones being: getFrame(Predefined)
, getGCRF()
,
getCIRF(IERSConventions, boolean)
getTIRF(IERSConventions, boolean)
,
getITRF(IERSConventions, boolean)
, getEME2000()
,
getMOD(IERSConventions)
, getTOD(IERSConventions, boolean)
,
getGTOD(IERSConventions, boolean)
, getITRFEquinox(IERSConventions, boolean)
,
getTEME()
and getVeis1950()
.
This frame is the current (as of 2013) reference realization of the International Terrestrial Reference System produced by IERS. It is described in IERS conventions (2010). It replaces the Earth Centered Earth Fixed frame which is the reference frame for GPS satellites.
This frame is used to define position on solid Earth. It rotates with
the Earth and includes the pole motion with respect to Earth crust as
provided by IERS data
.
Its pole axis is the IERS Reference Pole (IRP).
Previous realizations of the ITRS are available and linked together using
Helmert transformations
. Parameters for all
ITRS realizations since 1988 are available from the ITRF site ftp://itrf.ensg.ign.fr/pub/itrf/ITRF.TP).
Orekit provides a utility
method to build simply several of them and link them together.
ITRF can be built using the new non-rotating origin paradigm
mandated by IAU 2000 resolution B1.8 and any supported IERS conventions
(even IERS 1996 can be used with non-rotating origin paradigm,
despite the resolution was not yet adopted at conventions publication time.
ITRF can also be built using the classical equinox paradigm used prior to IAU 2000
resolution B1.8 and any supported IERS conventions
(even
IERS 2003 and 2010 can be used with equinox paradigm, despite the resolution is
in effect now). The choice of paradigm (non-rotating origin or equinox) and the
choice of IERS conventions (i.e. the choice of precession/nutation models) can
be made independently by user, Orekit provides all alternatives.
Orekit also provides all the intermediate frames that are needed to transform between GCRF and ITRF, along the two paths: ITRF/TIRF/CIRF/GCRF for the non-rotating origin paradigm and ITRF/GTOD/TOD/MOD/EME2000/GCRF for the equinox paradigm.
This factory also handles loading of Earth Orientation Parameters (EOP) needed
for accurate transformations between inertial and Earth fixed frames, using
DataProvidersManager
features. EOP are IERS conventions
dependent, because they correspond to correction to the precession/nutation
models. When EOP should be applied, but EOP data are not available, then a null
(0.0) correction is used. This can occur when no EOP data is loaded, or when the
requested date is beyond the time span of the loaded EOP data. Using a null
correction can result in coarse accuracy. To check the time span covered by EOP data use
getEOPHistory(IERSConventions, boolean)
, EOPHistory.getStartDate()
,
and EOPHistory.getEndDate()
.
For more on configuring the EOP data Orekit uses see https://www.orekit.org/forge/projects/orekit/wiki/Configuration.
Here is a schematic representation of the predefined reference frames tree:
GCRF | |----------------------------------------------- | | Frame bias | | | EME2000 | | | | | Precession effects | | | | Bias, Precession and Nutation effects | MOD MOD (Mean Equator Of Date) | | w/o EOP corrections | | Nutation effects | (Celestial Intermediate Reference Frame) CIRF | | | TOD TOD (True Equator Of Date) Earth natural rotation | | w/o EOP corrections |------------- | Sidereal Time | | | | | (Terrestrial Intermediate Reference Frame) TIRF TIRF GTOD GTOD (Greenwich True Of Date) | w/o tidal effects w/o EOP corrections Pole motion | | | | | |------------- | | | | (International Terrestrial Reference Frame) ITRF ITRF ITRF VEIS1950 | w/o tidal effects equinox-based | | other ITRF other ITRF w/o tidal effects
This is a utility class, so its constructor is private.
Modifier and Type | Field and Description |
---|---|
static String |
BULLETINA_FILENAME
Default regular expression for the BulletinA files (IAU1980 and IAU2000 compatibles).
|
static String |
BULLETINB_1980_FILENAME
Default regular expression for the BulletinB files (IAU1980 compatibles).
|
static String |
BULLETINB_2000_FILENAME
Default regular expression for the BulletinB files (IAU2000 compatibles).
|
static String |
EOPC04_1980_FILENAME
Default regular expression for the EOPC04 files (IAU1980 compatibles).
|
static String |
EOPC04_2000_FILENAME
Default regular expression for the EOPC04 files (IAU2000 compatibles).
|
static String |
RAPID_DATA_PREDICITON_COLUMNS_2000_FILENAME
Default regular expression for the Rapid Data and Prediction EOP columns files (IAU2000 compatibles).
|
static String |
RAPID_DATA_PREDICITON_XML_2000_FILENAME
Default regular expression for the Rapid Data and Prediction EOP XML files (IAU2000 compatibles).
|
static String |
RAPID_DATA_PREDICTION_COLUMNS_1980_FILENAME
Default regular expression for the Rapid Data and Prediction EOP columns files (IAU1980 compatibles).
|
static String |
RAPID_DATA_PREDICTION_XML_1980_FILENAME
Default regular expression for the Rapid Data and Prediction EOP XML files (IAU1980 compatibles).
|
Modifier and Type | Method and Description |
---|---|
static void |
addDefaultEOP1980HistoryLoaders(String rapidDataColumnsSupportedNames,
String rapidDataXMLSupportedNames,
String eopC04SupportedNames,
String bulletinBSupportedNames,
String bulletinASupportedNames)
Add the default loaders EOP history (IAU 1980 precession/nutation).
|
static void |
addDefaultEOP2000HistoryLoaders(String rapidDataColumnsSupportedNames,
String rapidDataXMLSupportedNames,
String eopC04SupportedNames,
String bulletinBSupportedNames,
String bulletinASupportedNames)
Add the default loaders for EOP history (IAU 2000/2006 precession/nutation).
|
static void |
addEOPHistoryLoader(IERSConventions conventions,
EOPHistoryLoader loader)
Add a loader for Earth Orientation Parameters history.
|
static void |
clearEOPHistoryLoaders()
Clear loaders for Earth Orientation Parameters history.
|
static FactoryManagedFrame |
getCIRF(IERSConventions conventions,
boolean simpleEOP)
Get the CIRF2000 reference frame.
|
static Frame |
getEcliptic(IERSConventions conventions)
Get the ecliptic frame.
|
static FactoryManagedFrame |
getEME2000()
Get the unique EME2000 frame.
|
static EOPHistory |
getEOPHistory(IERSConventions conventions,
boolean simpleEOP)
Get Earth Orientation Parameters history.
|
static Frame |
getFrame(Predefined factoryKey)
Get one of the predefined frames.
|
static Frame |
getGCRF()
Get the unique GCRF frame.
|
static FactoryManagedFrame |
getGTOD(boolean applyEOPCorr)
Get the GTOD reference frame.
|
static FactoryManagedFrame |
getGTOD(IERSConventions conventions,
boolean simpleEOP)
Get the GTOD reference frame.
|
static Frame |
getICRF()
Get the unique ICRF frame.
|
static FactoryManagedFrame |
getITRF(IERSConventions conventions,
boolean simpleEOP)
Get the ITRF2008 reference frame, using IERS 2010 conventions.
|
static FactoryManagedFrame |
getITRFEquinox(IERSConventions conventions,
boolean simpleEOP)
Get the equinox-based ITRF reference frame.
|
static FactoryManagedFrame |
getMOD(boolean applyEOPCorr)
Get the MOD reference frame.
|
static FactoryManagedFrame |
getMOD(IERSConventions conventions)
Get the MOD reference frame.
|
static Transform |
getNonInterpolatingTransform(Frame from,
Frame to,
AbsoluteDate date)
Get the transform between two frames, suppressing all interpolation.
|
static <T extends RealFieldElement<T>> |
getNonInterpolatingTransform(Frame from,
Frame to,
FieldAbsoluteDate<T> date)
Get the transform between two frames, suppressing all interpolation.
|
static FactoryManagedFrame |
getTEME()
Get the TEME reference frame.
|
static FactoryManagedFrame |
getTIRF(IERSConventions conventions)
Get the TIRF reference frame, ignoring tidal effects.
|
static FactoryManagedFrame |
getTIRF(IERSConventions conventions,
boolean simpleEOP)
Get the TIRF reference frame.
|
static FactoryManagedFrame |
getTOD(boolean applyEOPCorr)
Get the TOD reference frame.
|
static FactoryManagedFrame |
getTOD(IERSConventions conventions,
boolean simpleEOP)
Get the TOD reference frame.
|
static FactoryManagedFrame |
getVeis1950()
Get the VEIS 1950 reference frame.
|
static void |
setEOPContinuityThreshold(double threshold)
Set the threshold to check EOP continuity.
|
public static final String RAPID_DATA_PREDICTION_COLUMNS_1980_FILENAME
public static final String RAPID_DATA_PREDICTION_XML_1980_FILENAME
public static final String EOPC04_1980_FILENAME
public static final String BULLETINB_1980_FILENAME
public static final String RAPID_DATA_PREDICITON_COLUMNS_2000_FILENAME
public static final String RAPID_DATA_PREDICITON_XML_2000_FILENAME
public static final String EOPC04_2000_FILENAME
public static final String BULLETINB_2000_FILENAME
public static final String BULLETINA_FILENAME
public static void addDefaultEOP1980HistoryLoaders(String rapidDataColumnsSupportedNames, String rapidDataXMLSupportedNames, String eopC04SupportedNames, String bulletinBSupportedNames, String bulletinASupportedNames)
The default loaders look for IERS EOP C04 and bulletins B files. They
correspond to IERS 1996
conventions.
rapidDataColumnsSupportedNames
- regular expression for supported
rapid data columns EOP files names
(may be null if the default IERS file names are used)rapidDataXMLSupportedNames
- regular expression for supported
rapid data XML EOP files names
(may be null if the default IERS file names are used)eopC04SupportedNames
- regular expression for supported EOP C04 files names
(may be null if the default IERS file names are used)bulletinBSupportedNames
- regular expression for supported bulletin B files names
(may be null if the default IERS file names are used)bulletinASupportedNames
- regular expression for supported bulletin A files names
(may be null if the default IERS file names are used)addEOPHistoryLoader(IERSConventions, EOPHistoryLoader)
,
clearEOPHistoryLoaders()
,
addDefaultEOP2000HistoryLoaders(String, String, String, String, String)
public static void addDefaultEOP2000HistoryLoaders(String rapidDataColumnsSupportedNames, String rapidDataXMLSupportedNames, String eopC04SupportedNames, String bulletinBSupportedNames, String bulletinASupportedNames)
The default loaders look for IERS EOP C04 and bulletins B files. They
correspond to both IERS 2003
and IERS 2010
conventions.
rapidDataColumnsSupportedNames
- regular expression for supported
rapid data columns EOP files names
(may be null if the default IERS file names are used)rapidDataXMLSupportedNames
- regular expression for supported
rapid data XML EOP files names
(may be null if the default IERS file names are used)eopC04SupportedNames
- regular expression for supported EOP C04 files names
(may be null if the default IERS file names are used)bulletinBSupportedNames
- regular expression for supported bulletin B files names
(may be null if the default IERS file names are used)bulletinASupportedNames
- regular expression for supported bulletin A files names
(may be null if the default IERS file names are used)addEOPHistoryLoader(IERSConventions, EOPHistoryLoader)
,
clearEOPHistoryLoaders()
,
addDefaultEOP1980HistoryLoaders(String, String, String, String, String)
public static void addEOPHistoryLoader(IERSConventions conventions, EOPHistoryLoader loader)
conventions
- IERS conventions to which EOP history appliesloader
- custom loader to add for the EOP historyaddDefaultEOP1980HistoryLoaders(String, String, String, String, String)
,
clearEOPHistoryLoaders()
public static void clearEOPHistoryLoaders()
public static void setEOPContinuityThreshold(double threshold)
The default threshold (used if this method is never called) is 5 Julian days. If after loading EOP entries some holes between entries exceed this threshold, an exception will be triggered.
One case when calling this method is really useful is for applications that use a single Bulletin A, as these bulletins have a roughly one month wide hole for the first bulletin of each month, which contains older final data in addition to the rapid data and the predicted data.
threshold
- threshold to use for checking EOP continuity (in seconds)public static EOPHistory getEOPHistory(IERSConventions conventions, boolean simpleEOP) throws OrekitException
If no EOPHistoryLoader
has been added by calling addEOPHistoryLoader
or if clearEOPHistoryLoaders
has been
called afterwards, the addDefaultEOP1980HistoryLoaders(String, String,
String, String, String)
and addDefaultEOP2000HistoryLoaders(String,
String, String, String, String)
methods will be called automatically with
supported file names parameters all set to null, in order to get the default
loaders configuration.
conventions
- conventions for which EOP history is requestedsimpleEOP
- if true, tidal effects are ignored when interpolating EOPOrekitException
- if the data cannot be loadedpublic static Frame getFrame(Predefined factoryKey) throws OrekitException
factoryKey
- key of the frame within the factoryOrekitException
- if frame cannot be built due to missing datapublic static Frame getGCRF()
The GCRF frame is the root frame in the frame tree.
public static Frame getICRF() throws OrekitException
The ICRF frame is centered at solar system barycenter and aligned with EME2000.
OrekitException
- if solar system ephemerides cannot be loadedpublic static Frame getEcliptic(IERSConventions conventions) throws OrekitException
MOD
.
This implementation agrees with the JPL 406 ephemerides to within 0.5 arc seconds.
conventions
- IERS conventions to applyOrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getEME2000()
The EME2000 frame is also called the J2000 frame. The former denomination is preferred in Orekit.
public static FactoryManagedFrame getITRF(IERSConventions conventions, boolean simpleEOP) throws OrekitException
conventions
- IERS conventions to applysimpleEOP
- if true, tidal effects are ignored when interpolating EOPOrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getTIRF(IERSConventions conventions) throws OrekitException
conventions
- IERS conventions to applyOrekitException
- if the precession-nutation model data embedded in the
library cannot be read.public static FactoryManagedFrame getTIRF(IERSConventions conventions, boolean simpleEOP) throws OrekitException
conventions
- IERS conventions to applysimpleEOP
- if true, tidal effects are ignored when interpolating EOPOrekitException
- if the precession-nutation model data embedded in the
library cannot be read.public static FactoryManagedFrame getCIRF(IERSConventions conventions, boolean simpleEOP) throws OrekitException
conventions
- IERS conventions to applysimpleEOP
- if true, tidal effects are ignored when interpolating EOPOrekitException
- if the precession-nutation model data embedded in the
library cannot be read.public static FactoryManagedFrame getVeis1950() throws OrekitException
Its parent frame is the GTOD frame with IERS 1996 conventions without EOP corrections.
OrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getITRFEquinox(IERSConventions conventions, boolean simpleEOP) throws OrekitException
conventions
- IERS conventions to applysimpleEOP
- if true, tidal effects are ignored when interpolating EOPOrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getGTOD(boolean applyEOPCorr) throws OrekitException
The applyEOPCorr parameter is available mainly for testing purposes or for
consistency with legacy software that don't handle EOP correction parameters.
Beware that setting this parameter to false
leads to crude accuracy
(order of magnitudes for errors might be above 250m in LEO and 1400m in GEO).
For this reason, setting this parameter to false is restricted to IERS 1996
conventions, and hence the IERS conventions
cannot be freely chosen here.
applyEOPCorr
- if true, EOP corrections are applied (here, dut1 and lod)OrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getGTOD(IERSConventions conventions, boolean simpleEOP) throws OrekitException
conventions
- IERS conventions to applysimpleEOP
- if true, tidal effects are ignored when interpolating EOPOrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getTOD(boolean applyEOPCorr) throws OrekitException
The applyEOPCorr parameter is available mainly for testing purposes or for
consistency with legacy software that don't handle EOP correction parameters.
Beware that setting this parameter to false
leads to crude accuracy
(order of magnitudes for errors might be above 1m in LEO and 10m in GEO).
For this reason, setting this parameter to false is restricted to IERS 1996
conventions, and hence the IERS conventions
cannot be freely chosen here.
applyEOPCorr
- if true, EOP corrections are applied (here, nutation)OrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getTOD(IERSConventions conventions, boolean simpleEOP) throws OrekitException
conventions
- IERS conventions to applysimpleEOP
- if true, tidal effects are ignored when interpolating EOPOrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getMOD(boolean applyEOPCorr) throws OrekitException
The applyEOPCorr parameter is available mainly for testing purposes or for
consistency with legacy software that don't handle EOP correction parameters.
Beware that setting this parameter to false
leads to crude accuracy
(order of magnitudes for errors might be above 1m in LEO and 10m in GEO).
For this reason, setting this parameter to false is restricted to IERS 1996
conventions, and hence the IERS conventions
cannot be freely chosen here.
applyEOPCorr
- if true, EOP corrections are applied (EME2000/GCRF bias compensation)OrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getMOD(IERSConventions conventions) throws OrekitException
conventions
- IERS conventions to applyOrekitException
- if data embedded in the library cannot be readpublic static FactoryManagedFrame getTEME() throws OrekitException
The TEME frame is used for the SGP4 model in TLE propagation. This frame has no official definition and there are some ambiguities about whether it should be used as "of date" or "of epoch". This frame should therefore be used only for TLE propagation and not for anything else, as recommended by the CCSDS Orbit Data Message blue book.
OrekitException
- if data embedded in the library cannot be readpublic static Transform getNonInterpolatingTransform(Frame from, Frame to, AbsoluteDate date) throws OrekitException
This method is similar to Frame.getTransformTo(Frame, AbsoluteDate)
except it removes the performance enhancing interpolation features that are
added by the factory
to some frames, in order to focus
on accuracy. The interpolation features are intended to save processing time
by avoiding doing some lengthy computation like nutation evaluation at each
time step and caching some results. This method can be used to avoid this,
when very high accuracy is desired, or for testing purposes. It should be
used with care, as doing the full computation is really costly for
some frames.
from
- frame from which transformation startsto
- frame to which transformation endsdate
- date of the transformOrekitException
- if transform cannot be computed at this datepublic static <T extends RealFieldElement<T>> FieldTransform<T> getNonInterpolatingTransform(Frame from, Frame to, FieldAbsoluteDate<T> date) throws OrekitException
This method is similar to Frame.getTransformTo(Frame, AbsoluteDate)
except it removes the performance enhancing interpolation features that are
added by the factory
to some frames, in order to focus
on accuracy. The interpolation features are intended to save processing time
by avoiding doing some lengthy computation like nutation evaluation at each
time step and caching some results. This method can be used to avoid this,
when very high accuracy is desired, or for testing purposes. It should be
used with care, as doing the full computation is really costly for
some frames.
T
- type of the field elementsfrom
- frame from which transformation startsto
- frame to which transformation endsdate
- date of the transformOrekitException
- if transform cannot be computed at this dateCopyright © 2002-2017 CS Systèmes d'information. All rights reserved.