org.orekit.files.sinex

Class SinexLoader

java.lang.Object

org.orekit.files.sinex.SinexLoader

All Implemented Interfaces:

EOPHistoryLoader

public class SinexLoader
extends Object
implements EOPHistoryLoader

Loader for Solution INdependent EXchange (SINEX) files.

For now only few keys are supported: SITE/ID, SITE/ECCENTRICITY, SOLUTION/EPOCHS and SOLUTION/ESTIMATE. They represent the minimum set of parameters that are interesting to consider in a SINEX file.

The parsing of EOP parameters for multiple files in different SinexLoader object, fed into the default DataContext might pose a problem in case validity dates are overlapping. As Sinex daily solution files provide a single EOP entry, the Sinex loader will add points at the limits of data dates (startDate, endDate) of the Sinex file, which in case of overlap will lead to inconsistencies in the final EOPHistory object. Multiple files can be parsed using a single SinexLoader with a regex to overcome this issue.

Since:

10.3

Author:

Bryan Cazabonne

Constructor Summary

Constructors

Constructor and Description
SinexLoader(DataSource source) Simple constructor.
SinexLoader(DataSource source, TimeScale utc) Loads SINEX from the given input stream using the specified auxiliary data.
SinexLoader(String supportedNames) Simple constructor.
SinexLoader(String supportedNames, DataProvidersManager dataProvidersManager, TimeScale utc) Construct a loader by specifying the source of SINEX auxiliary data files.

Method Summary

Modifier and Type	Method and Description
void	fillHistory(IERSConventions.NutationCorrectionConverter converter, SortedSet<EOPEntry> history) Load celestial body.
ITRFVersion	getITRFVersion() Get the ITRF version used for the EOP entries processing.
Map<AbsoluteDate,SinexEopEntry>	getParsedEop() Get the parsed EOP data.
Station	getStation(String siteCode) Get the station corresponding to the given site code.
Map<String,Station>	getStations() Get the parsed station data.
void	setITRFVersion(int year) Set the ITRF version used in EOP entries processing.

Methods inherited from class java.lang.Object

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

Constructor Detail

SinexLoader

@DefaultDataContext
public SinexLoader(String supportedNames)

Simple constructor. This constructor uses the default data context.

Parameters:

supportedNames - regular expression for supported files names

See Also:

SinexLoader(String, DataProvidersManager, TimeScale)

SinexLoader

public SinexLoader(String supportedNames,
                   DataProvidersManager dataProvidersManager,
                   TimeScale utc)

Construct a loader by specifying the source of SINEX auxiliary data files.

For EOP loading, a default ITRFVersion.ITRF_2014 is used. It is possible to update the version using the setITRFVersion(int) method.

Parameters:

supportedNames - regular expression for supported files names

dataProvidersManager - provides access to auxiliary data.

utc - UTC time scale

SinexLoader

@DefaultDataContext
public SinexLoader(DataSource source)

Simple constructor. This constructor uses the default data context.

For EOP loading, a default ITRFVersion.ITRF_2014 is used. It is possible to update the version using the setITRFVersion(int) method.

Parameters:

source - source for the RINEX data

See Also:

SinexLoader(String, DataProvidersManager, TimeScale)

SinexLoader

public SinexLoader(DataSource source,
                   TimeScale utc)

Loads SINEX from the given input stream using the specified auxiliary data.

For EOP loading, a default ITRFVersion.ITRF_2014 is used. It is possible to update the version using the setITRFVersion(int) method.

Parameters:

source - source for the RINEX data

utc - UTC time scale

Method Detail

setITRFVersion

public void setITRFVersion(int year)

Set the ITRF version used in EOP entries processing.

Parameters:

year - Year of the ITRF Version used for parsing EOP.

Since:

11.2

getITRFVersion

public ITRFVersion getITRFVersion()

Get the ITRF version used for the EOP entries processing.

Returns:

the ITRF Version used for the EOP processing.

Since:

11.2

getStations

public Map<String,Station> getStations()

Get the parsed station data.

Returns:

unmodifiable view of parsed station data

getParsedEop

public Map<AbsoluteDate,SinexEopEntry> getParsedEop()

Get the parsed EOP data.

Returns:

unmodifiable view of parsed station data

Since:

11.2

getStation

public Station getStation(String siteCode)

Get the station corresponding to the given site code.

Parameters:

siteCode - site code

Returns:

the corresponding station

fillHistory

public void fillHistory(IERSConventions.NutationCorrectionConverter converter,
                        SortedSet<EOPEntry> history)

Load celestial body.

Specified by:

fillHistory in interface EOPHistoryLoader

Parameters:

converter - converter to use for nutation corrections

history - history to fill up