Package org.orekit.time

Class LazyLoadedTimeScales

java.lang.Object

org.orekit.time.AbstractTimeScales

org.orekit.time.LazyLoadedTimeScales

All Implemented Interfaces:

TimeScales

public class LazyLoadedTimeScales
extends AbstractTimeScales

An implementation of TimeScales that loads auxiliary data, leap seconds and UT1-UTC, when it is first accessed. The list of loaders may be modified before the first data access.

Since:

10.1

Author:

Luc Maisonobe, Evan Ward

See Also:

TimeScalesFactory

Constructor Summary

Constructors

Constructor	Description
LazyLoadedTimeScales(LazyLoadedEop lazyLoadedEop)	Create a new set of time scales with the given sources of auxiliary data.

Method Summary

Modifier and Type	Method	Description
void	addDefaultUTCTAIOffsetsLoaders()	Add the default loaders for UTC-TAI offsets history files (both IERS and USNO).
void	addUTCTAIOffsetsLoader(UTCTAIOffsetsLoader loader)	Add a loader for UTC-TAI offsets history files.
void	clearUTCTAIOffsetsLoaders()	Clear loaders for UTC-TAI offsets history files.
BDTScale	getBDT()	Get the BeiDou Navigation Satellite System time scale.
protected EOPHistory	getEopHistory(IERSConventions conventions, boolean simpleEOP)	Get the EOP history for the given conventions.
GLONASSScale	getGLONASS()	Get the GLObal NAvigation Satellite System time scale.
GMSTScale	getGMST(IERSConventions conventions, boolean simpleEOP)	Get the Greenwich Mean Sidereal Time scale.
GPSScale	getGPS()	Get the Global Positioning System scale.
GalileoScale	getGST()	Get the Galileo System Time scale.
IRNSSScale	getIRNSS()	Get the Indian Regional Navigation Satellite System time scale.
QZSSScale	getQZSS()	Get the Quasi-Zenith Satellite System time scale.
TAIScale	getTAI()	Get the International Atomic Time scale.
TCBScale	getTCB()	Get the Barycentric Coordinate Time scale.
TCGScale	getTCG()	Get the Geocentric Coordinate Time scale.
TDBScale	getTDB()	Get the Barycentric Dynamic Time scale.
TTScale	getTT()	Get the Terrestrial Time scale.
UT1Scale	getUT1(EOPHistory history)	Get the Universal Time 1 scale.
UT1Scale	getUT1(IERSConventions conventions, boolean simpleEOP)	Get the Universal Time 1 scale.
UTCScale	getUTC()	Get the Universal Time Coordinate scale.

Methods inherited from class org.orekit.time.AbstractTimeScales

createBesselianEpoch, createJulianEpoch, getBeidouEpoch, getCcsdsEpoch, getFiftiesEpoch, getFutureInfinity, getGalileoEpoch, getGlonassEpoch, getGpsEpoch, getIrnssEpoch, getJ2000Epoch, getJavaEpoch, getJulianEpoch, getModifiedJulianEpoch, getPastInfinity, getQzssEpoch

Methods inherited from class java.lang.Object

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

Constructor Detail

LazyLoadedTimeScales

public LazyLoadedTimeScales(LazyLoadedEop lazyLoadedEop)

Create a new set of time scales with the given sources of auxiliary data. This constructor uses the same DataProvidersManager for the default EOP loaders and the default leap second loaders.

Parameters:

lazyLoadedEop - loads Earth Orientation Parameters for getUT1(IERSConventions, boolean).

Method Detail

addUTCTAIOffsetsLoader

public void addUTCTAIOffsetsLoader(UTCTAIOffsetsLoader loader)

Add a loader for UTC-TAI offsets history files.

Parameters:

loader - custom loader to add

Since:

7.1

See Also:

TAIUTCDatFilesLoader, UTCTAIHistoryFilesLoader, UTCTAIBulletinAFilesLoader, getUTC(), clearUTCTAIOffsetsLoaders()

addDefaultUTCTAIOffsetsLoaders

public void addDefaultUTCTAIOffsetsLoaders()

Add the default loaders for UTC-TAI offsets history files (both IERS and USNO).

The default loaders are TAIUTCDatFilesLoader that looks for a file named tai-utc.dat that must be in USNO format, UTCTAIHistoryFilesLoader that looks for a file named UTC-TAI.history that must be in the IERS format and AGILeapSecondFilesLoader that looks for a files named LeapSecond.dat that must be in AGI format. The UTCTAIBulletinAFilesLoader isnot added by default as it is not recommended. USNO warned us that the TAI-UTC data present in bulletin A was for convenience only and was not reliable, there have been errors in several bulletins regarding these data.

Since:

7.1

See Also:

USNO tai-utc.dat file, IERS UTC-TAI.history file, TAIUTCDatFilesLoader, UTCTAIHistoryFilesLoader, AGILeapSecondFilesLoader, getUTC(), clearUTCTAIOffsetsLoaders()

clearUTCTAIOffsetsLoaders

public void clearUTCTAIOffsetsLoaders()

Clear loaders for UTC-TAI offsets history files.

Since:

7.1

See Also:

getUTC(), addUTCTAIOffsetsLoader(UTCTAIOffsetsLoader), addDefaultUTCTAIOffsetsLoaders()

getTAI

public TAIScale getTAI()

Description copied from interface: TimeScales

Get the International Atomic Time scale.

Returns:

International Atomic Time scale

getUTC

public UTCScale getUTC()

Description copied from interface: TimeScales

Get the Universal Time Coordinate scale.

Returns:

Universal Time Coordinate scale

getUT1

public UT1Scale getUT1(IERSConventions conventions,
                       boolean simpleEOP)

Description copied from interface: TimeScales

Get the Universal Time 1 scale.

Specified by:

getUT1 in interface TimeScales

Overrides:

getUT1 in class AbstractTimeScales

Parameters:

conventions - IERS conventions for which EOP parameters will provide dUT1

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

Returns:

Universal Time 1 scale

See Also:

TimeScales.getUTC(), Frames.getEOPHistory(IERSConventions, boolean)

getEopHistory

protected EOPHistory getEopHistory(IERSConventions conventions,
                                   boolean simpleEOP)

Description copied from class: AbstractTimeScales

Get the EOP history for the given conventions.

Specified by:

getEopHistory in class AbstractTimeScales

Parameters:

conventions - to use in computing the EOP history.

simpleEOP - whether to ignore some small tidal effects.

Returns:

EOP history.

getUT1

public UT1Scale getUT1(EOPHistory history)

Get the Universal Time 1 scale.

As this method allow associating any history with the time scale, it may involve large data sets. So this method does not cache the resulting UT1Scale instance, a new instance will be returned each time. In order to avoid wasting memory, calling AbstractTimeScales.getUT1(IERSConventions, boolean) with the single enumerate corresponding to the conventions may be a better solution. This method is made available only for expert use.

Overrides:

getUT1 in class AbstractTimeScales

Parameters:

history - EOP parameters providing dUT1 (may be null if no correction is desired)

Returns:

Universal Time 1 scale

See Also:

AbstractTimeScales.getUT1(IERSConventions, boolean)

getTT

public TTScale getTT()

Description copied from interface: TimeScales

Get the Terrestrial Time scale.

Returns:

Terrestrial Time scale

getGST

public GalileoScale getGST()

Description copied from interface: TimeScales

Get the Galileo System Time scale.

Returns:

Galileo System Time scale

getGLONASS

public GLONASSScale getGLONASS()

Description copied from interface: TimeScales

Get the GLObal NAvigation Satellite System time scale.

Returns:

GLObal NAvigation Satellite System time scale

getQZSS

public QZSSScale getQZSS()

Description copied from interface: TimeScales

Get the Quasi-Zenith Satellite System time scale.

Returns:

Quasi-Zenith Satellite System time scale

getGPS

public GPSScale getGPS()

Description copied from interface: TimeScales

Get the Global Positioning System scale.

Returns:

Global Positioning System scale

getTCG

public TCGScale getTCG()

Description copied from interface: TimeScales

Get the Geocentric Coordinate Time scale.

Returns:

Geocentric Coordinate Time scale

getTDB

public TDBScale getTDB()

Description copied from interface: TimeScales

Get the Barycentric Dynamic Time scale.

Returns:

Barycentric Dynamic Time scale

getTCB

public TCBScale getTCB()

Description copied from interface: TimeScales

Get the Barycentric Coordinate Time scale.

Returns:

Barycentric Coordinate Time scale

getGMST

public GMSTScale getGMST(IERSConventions conventions,
                         boolean simpleEOP)

Description copied from interface: TimeScales

Get the Greenwich Mean Sidereal Time scale.

Specified by:

getGMST in interface TimeScales

Overrides:

getGMST in class AbstractTimeScales

Parameters:

conventions - IERS conventions for which EOP parameters will provide dUT1

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

Returns:

Greenwich Mean Sidereal Time scale

getIRNSS

public IRNSSScale getIRNSS()

Description copied from interface: TimeScales

Get the Indian Regional Navigation Satellite System time scale.

Returns:

Indian Regional Navigation Satellite System time scale

getBDT

public BDTScale getBDT()

Description copied from interface: TimeScales

Get the BeiDou Navigation Satellite System time scale.

Returns:

BeiDou Navigation Satellite System time scale