org.orekit.frames

Class LazyLoadedEop

java.lang.Object

org.orekit.frames.LazyLoadedEop

public class LazyLoadedEop
extends Object

Loads Earth Orientation Parameters (EOP) from a configured set of EOPHistoryLoaders on demand. Methods are synchronized so it is safe for access from multiple threads.

Since:

10.1

Author:

Guylaine Prat, Luc Maisonobe, Pascal Parraud, Evan Ward

See Also:

LazyLoadedFrames, FramesFactory

Constructor Summary

Constructors

Constructor and Description
LazyLoadedEop(DataProvidersManager dataProvidersManager) Create a new instance for loading EOP data from multiple EOPHistoryLoaders.

Method Summary

Modifier and Type	Method and Description
void	addDefaultEOP1980HistoryLoaders(String rapidDataColumnsSupportedNames, String rapidDataXMLSupportedNames, String eopC04SupportedNames, String bulletinBSupportedNames, String bulletinASupportedNames, Supplier<TimeScale> utcSupplier) Add the default loaders EOP history (IAU 1980 precession/nutation).
void	addDefaultEOP2000HistoryLoaders(String rapidDataColumnsSupportedNames, String rapidDataXMLSupportedNames, String eopC04SupportedNames, String bulletinBSupportedNames, String bulletinASupportedNames, Supplier<TimeScale> utcSupplier) Add the default loaders for EOP history (IAU 2000/2006 precession/nutation).
void	addEOPHistoryLoader(IERSConventions conventions, EOPHistoryLoader loader) Add a loader for Earth Orientation Parameters history.
void	clearEOPHistoryLoaders() Clear loaders for Earth Orientation Parameters history.
DataProvidersManager	getDataProvidersManager() Get the data providers manager for this instance.
EOPHistory	getEOPHistory(IERSConventions conventions, boolean simpleEOP, TimeScales timeScales) Get Earth Orientation Parameters history.
void	setEOPContinuityThreshold(double threshold) Set the threshold to check EOP continuity.

Methods inherited from class java.lang.Object

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

Constructor Detail

LazyLoadedEop

public LazyLoadedEop(DataProvidersManager dataProvidersManager)

Create a new instance for loading EOP data from multiple EOPHistoryLoaders.

Parameters:

dataProvidersManager - provides access to the needed EOP data files.

Method Detail

getDataProvidersManager

public DataProvidersManager getDataProvidersManager()

Get the data providers manager for this instance.

Returns:

the provider of EOP data files.

addDefaultEOP1980HistoryLoaders

public void addDefaultEOP1980HistoryLoaders(String rapidDataColumnsSupportedNames,
                                            String rapidDataXMLSupportedNames,
                                            String eopC04SupportedNames,
                                            String bulletinBSupportedNames,
                                            String bulletinASupportedNames,
                                            Supplier<TimeScale> utcSupplier)

Add the default loaders EOP history (IAU 1980 precession/nutation).

The default loaders look for IERS EOP C04 and bulletins B files. They correspond to IERS 1996 conventions.

Parameters:

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)

utcSupplier - UTC time scale supplier. Value is not accessed until attempting to load EOP.

See Also:

IERS EOP C04 files, addEOPHistoryLoader(IERSConventions, EOPHistoryLoader), clearEOPHistoryLoaders(), addDefaultEOP2000HistoryLoaders(String, String, String, String, String, Supplier)

addDefaultEOP2000HistoryLoaders

public void addDefaultEOP2000HistoryLoaders(String rapidDataColumnsSupportedNames,
                                            String rapidDataXMLSupportedNames,
                                            String eopC04SupportedNames,
                                            String bulletinBSupportedNames,
                                            String bulletinASupportedNames,
                                            Supplier<TimeScale> utcSupplier)

Add the default loaders for EOP history (IAU 2000/2006 precession/nutation).

The default loaders look for IERS EOP C04 and bulletins B files. They correspond to both IERS 2003 and IERS 2010 conventions.

Parameters:

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)

utcSupplier - UTC time scale supplier. Value is not accessed until attempting to load EOP.

See Also:

IERS EOP C04 files, addEOPHistoryLoader(IERSConventions, EOPHistoryLoader), clearEOPHistoryLoaders(), addDefaultEOP1980HistoryLoaders(String, String, String, String, String, Supplier)

addEOPHistoryLoader

public void addEOPHistoryLoader(IERSConventions conventions,
                                EOPHistoryLoader loader)

Add a loader for Earth Orientation Parameters history.

Parameters:

conventions - IERS conventions to which EOP history applies

loader - custom loader to add for the EOP history

See Also:

addDefaultEOP1980HistoryLoaders(String, String, String, String, String, Supplier), clearEOPHistoryLoaders()

clearEOPHistoryLoaders

public void clearEOPHistoryLoaders()

Clear loaders for Earth Orientation Parameters history.

See Also:

addEOPHistoryLoader(IERSConventions, EOPHistoryLoader), addDefaultEOP1980HistoryLoaders(String, String, String, String, String, Supplier)

setEOPContinuityThreshold

public void setEOPContinuityThreshold(double threshold)

Set the threshold to check EOP continuity.

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.

Parameters:

threshold - threshold to use for checking EOP continuity (in seconds)

getEOPHistory

public EOPHistory getEOPHistory(IERSConventions conventions,
                                boolean simpleEOP,
                                TimeScales timeScales)

Get Earth Orientation Parameters history.

If no EOPHistoryLoader has been added by calling addEOPHistoryLoader or if clearEOPHistoryLoaders has been called afterwards, the addDefaultEOP1980HistoryLoaders(String, String, String, String, String, Supplier) and addDefaultEOP2000HistoryLoaders(String, String, String, String, String, Supplier) methods will be called automatically with supported file names parameters all set to null, in order to get the default loaders configuration.

Parameters:

conventions - conventions for which EOP history is requested

simpleEOP - if true, tidal effects are ignored when interpolating EOP

timeScales - to use when loading EOP and computing corrections.

Returns:

Earth Orientation Parameters history