org.orekit.files.rinex.observation

Class RinexObservationWriter

java.lang.Object

org.orekit.files.rinex.observation.RinexObservationWriter

All Implemented Interfaces:

AutoCloseable

public class RinexObservationWriter
extends Object
implements AutoCloseable

Writer for Rinex observation file.

As RINEX file are organized in batches of observations at some dates, these observations are cached and a new batch is output only when a new date appears when calling writeObservationDataSet(ObservationDataSet) or when the file is closed by calling the close method. Failing to call close would imply the last batch of measurements is not written. This is the reason why this class implements AutoCloseable, so the close method can be called automatically in a try-with-resources statement.

Since:

12.0

Author:

Luc Maisonobe

Constructor Summary

Constructors

Constructor and Description
RinexObservationWriter(Appendable output, String outputName) Simple constructor.

Method Summary

Modifier and Type	Method and Description
void	close()
void	prepareComments(List<RinexComment> comments) Prepare comments to be emitted at specified lines.
void	writeCompleteFile(RinexObservation rinexObservation) Write a complete observation file.
void	writeHeader(RinexObservationHeader header) Write header.
void	writeObservationDataSet(ObservationDataSet observationDataSet) Write one observation data set.
void	writePendingRinex2Observations() Write one observation data set in RINEX 2 format.
void	writePendingRinex34Observations() Write one observation data set in RINEX 3/4 format.

Methods inherited from class java.lang.Object

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

Constructor Detail

RinexObservationWriter

public RinexObservationWriter(Appendable output,
                              String outputName)

Simple constructor.

Parameters:

output - destination of generated output

outputName - output name for error messages

Method Detail

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Throws:

IOException

writeCompleteFile

@DefaultDataContext
public void writeCompleteFile(RinexObservation rinexObservation)
                                           throws IOException

Write a complete observation file.

This method calls prepareComments(List) and writeHeader(RinexObservationHeader) once and then loops on calling writeObservationDataSet(ObservationDataSet) for all observation data sets in the file

Parameters:

rinexObservation - Rinex observation file to write

Throws:

IOException - if an I/O error occurs.

See Also:

writeHeader(RinexObservationHeader), writeObservationDataSet(ObservationDataSet)

prepareComments

public void prepareComments(List<RinexComment> comments)

Prepare comments to be emitted at specified lines.

Parameters:

comments - comments to be emitted

writeHeader

@DefaultDataContext
public void writeHeader(RinexObservationHeader header)
                                     throws IOException

Write header.

This method must be called exactly once at the beginning (directly or by writeCompleteFile(RinexObservation))

Parameters:

header - header to write

Throws:

IOException - if an I/O error occurs.

writeObservationDataSet

public void writeObservationDataSet(ObservationDataSet observationDataSet)
                             throws IOException

Write one observation data set.

Note that this writers output only regular observations, so the event flag is always set to 0

Parameters:

observationDataSet - observation data set to write

Throws:

IOException - if an I/O error occurs.

writePendingRinex2Observations

public void writePendingRinex2Observations()
                                    throws IOException

Write one observation data set in RINEX 2 format.

Throws:

IOException - if an I/O error occurs.

writePendingRinex34Observations

public void writePendingRinex34Observations()
                                     throws IOException

Write one observation data set in RINEX 3/4 format.

Throws:

IOException - if an I/O error occurs.