org.orekit.frames.configuration.eop
Class EOP08C04FilesLoader

java.lang.Object
  org.orekit.frames.configuration.eop.EOP08C04FilesLoader

All Implemented Interfaces:

DataLoader, EOP1980HistoryLoader, EOP2000HistoryLoader

public class EOP08C04FilesLoader
extends Object
implements EOP1980HistoryLoader, EOP2000HistoryLoader

Loader for EOP 08 C04 files.

EOP 08 C04 files contain Earth Orientation Parameters consistent with ITRF2008 for one year periods.

The EOP 08 C04 files are recognized thanks to their base names, which must match one of the the patterns eopc04_(08)?_IAU2000.## or eopc04_(08)?.## (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 08). These parameters were consistent with the previous ITRS realization: ITRF2000.

Between 2008 and 2011, another series of Earth Orientation Parameters was in use: EOP 05 C04 (instead of 08). These parameters were consistent with the previous ITRS realization: ITRF2005.

These files are no longer provided by IERS and only the new files consitent with ITRF 2008 are available now (as of early 2012). The content of the older pre-2005 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 all of them. 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 /eoppc/eop/eopc04.

Author:

Luc Maisonobe

Constructor Summary

EOP08C04FilesLoader(String supportedNames)
Build a loader for IERS EOP 08 C04 files.

Method Summary

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

EOP08C04FilesLoader

public EOP08C04FilesLoader(String supportedNames)

Build a loader for IERS EOP 08 C04 files.

Parameters:

supportedNames - 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,
                     OrekitException

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

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

fillHistory

public void fillHistory(EOP1980History history)
                 throws OrekitException

Load celestial body.

Specified by:

fillHistory in interface EOP1980HistoryLoader

Parameters:

history - history to fill up

Throws:

OrekitException - if the history cannot be loaded

fillHistory

public void fillHistory(EOP2000History history)
                 throws OrekitException

Load celestial body.

Specified by:

fillHistory in interface EOP2000HistoryLoader

Parameters:

history - history to fill up

Throws:

OrekitException - if the history cannot be loaded

fillHistory

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

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

Parameters:

history - history object

istream - input stream

Throws:

OrekitException - if some data is missing

IOException - if data can't be read

fillHistory

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

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

Parameters:

history - history object

istream - input stream

Throws:

OrekitException - if some data is missing

IOException - if data can't be read