org.orekit.time

Class TimeScalesFactory

java.lang.Object

org.orekit.time.TimeScalesFactory

All Implemented Interfaces:

Serializable

public class TimeScalesFactory
extends Object
implements Serializable

Factory for predefined time scales.

This is a utility class, so its constructor is private.

Author:

Luc Maisonobe

See Also:

Serialized Form

Method Summary

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

Methods inherited from class java.lang.Object

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

Method Detail

addUTCTAIOffsetsLoader

public static 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 static 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 and UTCTAIHistoryFilesLoader that looks fir a file named UTC-TAI.history that must be in the IERS format. The UTCTAIBulletinAFilesLoader is not 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, getUTC(), clearUTCTAIOffsetsLoaders()

clearUTCTAIOffsetsLoaders

public static void clearUTCTAIOffsetsLoaders()

Clear loaders for UTC-TAI offsets history files.

Since:

7.1

See Also:

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

getTAI

public static TAIScale getTAI()

Get the International Atomic Time scale.

Returns:

International Atomic Time scale

getUTC

public static UTCScale getUTC()
                       throws OrekitException

Get the Universal Time Coordinate scale.

If no UTCTAIOffsetsLoader has been added by calling addUTCTAIOffsetsLoader or if clearUTCTAIOffsetsLoaders has been called afterwards, the addDefaultUTCTAILoaders method will be called automatically.

Returns:

Universal Time Coordinate scale

Throws:

OrekitException - if some data can't be read or some file content is corrupted

See Also:

addDefaultUTCTAIOffsetsLoaders()

getUT1

public static UT1Scale getUT1(IERSConventions conventions,
                              boolean simpleEOP)
                       throws OrekitException

Get the Universal Time 1 scale.

UT1 scale depends on both UTC scale and Earth Orientation Parameters, so this method loads these data sets. See the TimeScalesFactory.getUTC() and FramesFactory.getEOPHistory(IERSConventions, boolean) methods for an explanation of how the corresponding data loaders can be configured.

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

Throws:

OrekitException - if some data can't be read or some file content is corrupted

See Also:

getUTC(), FramesFactory.getEOPHistory(IERSConventions, boolean)

getUT1

public static UT1Scale getUT1(EOPHistory history)
                       throws OrekitException

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 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.

Parameters:

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

Returns:

Universal Time 1 scale

Throws:

OrekitException - if some data can't be read or some file content is corrupted

See Also:

getUT1(IERSConventions, boolean)

getTT

public static TTScale getTT()

Get the Terrestrial Time scale.

Returns:

Terrestrial Time scale

getGST

public static GalileoScale getGST()

Get the Galileo System Time scale.

Returns:

Galileo System Time scale

getGLONASS

public static GLONASSScale getGLONASS()
                               throws OrekitException

Get the GLObal NAvigation Satellite System time scale.

Returns:

GLObal NAvigation Satellite System time scale

Throws:

OrekitException - if UTC time scale cannot be retrieved

getQZSS

public static QZSSScale getQZSS()

Get the Quasi-Zenith Satellite System time scale.

Returns:

Quasi-Zenith Satellite System time scale

getGPS

public static GPSScale getGPS()

Get the Global Positioning System scale.

Returns:

Global Positioning System scale

getTCG

public static TCGScale getTCG()

Get the Geocentric Coordinate Time scale.

Returns:

Geocentric Coordinate Time scale

getTDB

public static TDBScale getTDB()

Get the Barycentric Dynamic Time scale.

Returns:

Barycentric Dynamic Time scale

getTCB

public static TCBScale getTCB()

Get the Barycentric Coordinate Time scale.

Returns:

Barycentric Coordinate Time scale

getGMST

public static GMSTScale getGMST(IERSConventions conventions,
                                boolean simpleEOP)
                         throws OrekitException

Get the Greenwich Mean Sidereal Time scale.

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

Throws:

OrekitException - if some data can't be read or some file content is corrupted

Since:

7.0