org.orekit.time

Class UTCTAIBulletinAFilesLoader

java.lang.Object

org.orekit.data.AbstractSelfFeedingLoader

org.orekit.time.UTCTAIBulletinAFilesLoader

All Implemented Interfaces:

UTCTAIOffsetsLoader

public class UTCTAIBulletinAFilesLoader
extends AbstractSelfFeedingLoader
implements UTCTAIOffsetsLoader

Loader for UTC-TAI extracted from bulletin A files.

This class is a modified version of BulletinAFileLoader that only parses the TAI-UTC header line and checks the UT1-UTC column for discontinuities.

Note that extracting UTC-TAI from bulletin A files is NOT recommended. There are known issues in some past bulletin A (for example bulletina-xix-001.txt from 2006-01-05 has a wrong year for last leap second and bulletina-xxi-053.txt from 2008-12-31 has an off by one value for TAI-UTC on MJD 54832). This is a known problem, and the Earth Orientation Department at USNO told us this TAI-UTC data was only provided as a convenience and this data should rather be sourced from other official files. As the bulletin A files are a record of past publications, they cannot modify archived bulletins, hence the errors above will remain forever. This UTC-TAI loader should therefore be used with great care.

This class is immutable and hence thread-safe

Since:

7.1

Author:

Luc Maisonobe

Constructor Summary

Constructors

Constructor and Description
UTCTAIBulletinAFilesLoader(String supportedNames) Build a loader for IERS bulletins A files.
UTCTAIBulletinAFilesLoader(String supportedNames, DataProvidersManager manager) Build a loader for IERS bulletins A files.

Method Summary

Modifier and Type	Method and Description
List<OffsetModel>	loadOffsets() Load UTC-TAI offsets entries.

Methods inherited from class org.orekit.data.AbstractSelfFeedingLoader

feed, getDataProvidersManager, getSupportedNames, setSupportedNames

Methods inherited from class java.lang.Object

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

Constructor Detail

UTCTAIBulletinAFilesLoader

@DefaultDataContext
public UTCTAIBulletinAFilesLoader(String supportedNames)

Build a loader for IERS bulletins A files. This constructor uses the default data context.

Parameters:

supportedNames - regular expression for supported files names

UTCTAIBulletinAFilesLoader

public UTCTAIBulletinAFilesLoader(String supportedNames,
                                  DataProvidersManager manager)

Build a loader for IERS bulletins A files.

Parameters:

supportedNames - regular expression for supported files names

manager - provides access to the bulletin A files.

Method Detail

loadOffsets

public List<OffsetModel> loadOffsets()

Load UTC-TAI offsets entries.

Specified by:

loadOffsets in interface UTCTAIOffsetsLoader

Returns:

sorted UTC-TAI offsets entries (if the linear offsets used prior to 1972 are missing, they will be inserted automatically)