fr.cnes.sirius.patrius.frames.configuration.eop

Class EOPC04FilesLoader

java.lang.Object

fr.cnes.sirius.patrius.frames.configuration.eop.EOPC04FilesLoader

All Implemented Interfaces:

DataLoader, EOP1980HistoryLoader, EOP2000HistoryLoader

public class EOPC04FilesLoader
extends Object
implements EOP1980HistoryLoader, EOP2000HistoryLoader

Loader for EOP 05 C04 files.

EOP 05 C04 files contain Earth Orientation Parameters consistent with ITRF2005 for one year periods.

The EOP 05 C04 files are recognized thanks to their base names, which must match one of the the patterns eopc04_IAU2000.## or eopc04.## (or the same ending with .gz for gzip-compressed files) where # stands for a digit character.

Between 2002 and 2007, another series of Earth Orientation Parameters was in use: EOPC04 (without the 05). These parameters were consistent with the previous ITRS realization: ITRF2000. These files are no longer provided by IERS and only 6 files covering the range 2002 to 2007 were generated. The content of these files is not the same as the content of the new files supported by this class, however IERS uses the same file naming convention for both. If a file from the older series is found by this class, a parse error will be triggered. Users must remove such files to avoid being lured in believing they do have EOP data.

Files containing old data (back to 1962) have been regenerated in the new file format and are available at IERS web site: Index of /iers/eop/eopc04_05.

Author:

Luc Maisonobe

Constructor Summary

Constructors

Constructor and Description
EOPC04FilesLoader(String supportedNamesIn) Build a loader for IERS EOP 05 C04 files.

Method Summary

Modifier and Type	Method and Description
void	fillHistory(EOP1980History history) Load celestial body.
static void	fillHistory(EOP1980History history, InputStream istream) Fills the history object directy with data from the InputStream, bypassing the Orekit data loaders.
void	fillHistory(EOP2000History history) Load celestial body.
static void	fillHistory(EOP2000History history, InputStream istream) Fills the history object directy with data from the InputStream, bypassing the Orekit data loaders.
void	loadData(InputStream input, String name) Load data from a stream.
boolean	stillAcceptsData() Check if the loader still accepts new data.

Methods inherited from class java.lang.Object

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

Constructor Detail

EOPC04FilesLoader

public EOPC04FilesLoader(String supportedNamesIn)

Build a loader for IERS EOP 05 C04 files.

Parameters:

supportedNamesIn - regular expression for supported files names

Method Detail

stillAcceptsData

public boolean stillAcceptsData()

Check if the loader still accepts new data.

This method is used to speed up data loading by interrupting crawling the data sets as soon as a loader has found the data it was waiting for. For loaders that can merge data from any number of sources (for example JPL ephemerides or Earth Orientation Parameters that are split among several files), this method should always return true to make sure no data is left over.

Specified by:

stillAcceptsData in interface DataLoader

Returns:

true while the loader still accepts new data

loadData

public void loadData(InputStream input,
                     String name)
              throws IOException,
                     PatriusException

Load data from a stream.

Specified by:

loadData in interface DataLoader

Parameters:

input - data input stream

name - name of the file (or zip entry)

Throws:

IOException - if data can't be read

PatriusException - if some data is missing or if some loader specific error occurs

fillHistory

public void fillHistory(EOP1980History history)
                 throws PatriusException

Load celestial body.

Specified by:

fillHistory in interface EOP1980HistoryLoader

Parameters:

history - history to fill up

Throws:

PatriusException - if the history cannot be loaded

fillHistory

public void fillHistory(EOP2000History history)
                 throws PatriusException

Load celestial body.

Specified by:

fillHistory in interface EOP2000HistoryLoader

Parameters:

history - history to fill up

Throws:

PatriusException - if the history cannot be loaded

fillHistory

public static void fillHistory(EOP1980History history,
                               InputStream istream)
                        throws PatriusException,
                               IOException

Fills the history object directy with data from the InputStream, bypassing the Orekit data loaders.

Parameters:

history - history object

istream - input stream

Throws:

PatriusException - if some data is missing

IOException - if data can't be read

fillHistory

public static void fillHistory(EOP2000History history,
                               InputStream istream)
                        throws PatriusException,
                               IOException

Fills the history object directy with data from the InputStream, bypassing the Orekit data loaders.

Parameters:

history - history object

istream - input stream

Throws:

PatriusException - if some data is missing

IOException - if data can't be read