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

Class BulletinBFilesLoader

java.lang.Object

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

All Implemented Interfaces:

DataLoader, EOP1980HistoryLoader, EOP2000HistoryLoader

public class BulletinBFilesLoader
extends Object
implements EOP1980HistoryLoader, EOP2000HistoryLoader

Loader for bulletin B files.

Bulletin B files contain Earth Orientation Parameters for a few months periods.

The bulletin B files are recognized thanks to their base names, which must match one of the the patterns bulletinb_IAU2000-###.txt, bulletinb_IAU2000.###, bulletinb-###.txt or bulletinb.### (or the same ending with .gz for gzip-compressed files) where # stands for a digit character. The files with IAU_2000 in their names correspond to the IAU-2000 precession-nutation model wheareas the files without any identifier correspond to the IAU-1980 precession-nutation model.

Note that since early 2010, IERS has ceased publication of bulletin B for both precession-nutation models from its main site. The files for IAU-1980 only are still available from Paris-Meudon observatory site in a new format (but with the same name pattern bulletinb.###). This class handles both the old and the new format and takes care to use the new format only for the IAU-2000 precession-nutation model.

Author:

Luc Maisonobe

Constructor Summary

Constructors

Constructor and Description
BulletinBFilesLoader() Build a loader for IERS bulletins B files.
BulletinBFilesLoader(String supportedNamesIn) Build a loader for IERS bulletins B files.

Method Summary

Modifier and Type	Method and Description
void	fillHistory(EOP1980History history) Load celestial body.
void	fillHistory(EOP2000History history) Load celestial body.
void	fillHistory(EOP2000History history, InputStream istream) Load celestial body.
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

BulletinBFilesLoader

public BulletinBFilesLoader()

Build a loader for IERS bulletins B files.

BulletinBFilesLoader

public BulletinBFilesLoader(String supportedNamesIn)

Build a loader for IERS bulletins B 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 PatriusException,
                     IOException

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:

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

IOException - if data can't be read

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 void fillHistory(EOP2000History history,
                        InputStream istream)
                 throws PatriusException,
                        IOException

Load celestial body.

Parameters:

history - history to fill up

istream - input data stream

Throws:

PatriusException - if the history cannot be loaded

IOException - if data can't be read