Package org.orekit.files.ccsds.ndm.tdm
Class TdmParser
- java.lang.Object
-
- org.orekit.files.ccsds.utils.parsing.AbstractMessageParser<T>
-
- org.orekit.files.ccsds.utils.parsing.AbstractConstituentParser<TdmHeader,Tdm,TdmParser>
-
- org.orekit.files.ccsds.ndm.tdm.TdmParser
-
- All Implemented Interfaces:
MessageParser<Tdm>
public class TdmParser extends AbstractConstituentParser<TdmHeader,Tdm,TdmParser>
Class for CCSDS Tracking Data Message parsers.Note than starting with Orekit 11.0, CCSDS message parsers are mutable objects that gather the data being parsed, until the message is complete and the
parseMessage
method has returned. This implies that parsers should not be used in a multi-thread context. The recommended way to use parsers is to either dedicate one parser for each message and drop it afterwards, or to use a single-thread loop.References:
- CCSDS 503.0-B-1 recommended standard ("Tracking Data Message", Blue Book, Issue 1, November 2007)
- CCSDS 505.0-B-1 recommended standard ("XML Specification for Navigation Data Message", Blue Book, Issue 1, December 2010)
- Since:
- 9.0
- Author:
- Maxime Journot
-
-
Constructor Summary
Constructors Constructor Description TdmParser(IERSConventions conventions, boolean simpleEOP, DataContext dataContext, ParsedUnitsBehavior parsedUnitsBehavior, RangeUnitsConverter converter, Function<ParseToken,List<ParseToken>>[] filters)
Complete constructor.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Tdm
build()
Build the file from parsed entries.boolean
finalizeData()
Finalize data after parsing.boolean
finalizeHeader()
Finalize header after parsing.boolean
finalizeMetadata()
Finalize metadata after parsing.TdmHeader
getHeader()
Get file header to fill.boolean
inData()
Acknowledge data parsing has started.boolean
inHeader()
Acknowledge header parsing has started.boolean
inMetadata()
Acknowledge metada parsing has started.boolean
prepareData()
Prepare data for parsing.boolean
prepareHeader()
Prepare header for parsing.boolean
prepareMetadata()
Prepare metadata for parsing.void
reset(FileFormat fileFormat)
Reset parser to initial state before parsing.-
Methods inherited from class org.orekit.files.ccsds.utils.parsing.AbstractConstituentParser
getConventions, getDataContext, getParsedUnitsBehavior, isSimpleEOP
-
Methods inherited from class org.orekit.files.ccsds.utils.parsing.AbstractMessageParser
anticipateNext, getCurrent, getFileFormat, getFormatVersionKey, getSpecialXmlElementsBuilders, parseMessage, process, reset, setEndTagSeen, setFallback, wasEndTagSeen
-
-
-
-
Constructor Detail
-
TdmParser
public TdmParser(IERSConventions conventions, boolean simpleEOP, DataContext dataContext, ParsedUnitsBehavior parsedUnitsBehavior, RangeUnitsConverter converter, Function<ParseToken,List<ParseToken>>[] filters)
Complete constructor.Calling this constructor directly is not recommended. Users should rather use
parserBuilder.buildTdmParser()
.- Parameters:
conventions
- IERS ConventionssimpleEOP
- if true, tidal effects are ignored when interpolating EOPdataContext
- used to retrieve frames, time scales, etc.parsedUnitsBehavior
- behavior to adopt for handling parsed unitsconverter
- converter forRange Units
(may be null if there are no range observations inRange Units
)filters
- filters to apply to parse tokens- Since:
- 12.0
-
-
Method Detail
-
getHeader
public TdmHeader getHeader()
Get file header to fill.- Specified by:
getHeader
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- file header to fill
-
reset
public void reset(FileFormat fileFormat)
Reset parser to initial state before parsing.- Parameters:
fileFormat
- format of the file ready to be parsed
-
build
public Tdm build()
Build the file from parsed entries.- Returns:
- parsed file
-
prepareHeader
public boolean prepareHeader()
Prepare header for parsing.- Specified by:
prepareHeader
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
inHeader
public boolean inHeader()
Acknowledge header parsing has started.- Specified by:
inHeader
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
finalizeHeader
public boolean finalizeHeader()
Finalize header after parsing.- Specified by:
finalizeHeader
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
prepareMetadata
public boolean prepareMetadata()
Prepare metadata for parsing.- Specified by:
prepareMetadata
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
inMetadata
public boolean inMetadata()
Acknowledge metada parsing has started.- Specified by:
inMetadata
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
finalizeMetadata
public boolean finalizeMetadata()
Finalize metadata after parsing.- Specified by:
finalizeMetadata
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
prepareData
public boolean prepareData()
Prepare data for parsing.- Specified by:
prepareData
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
inData
public boolean inData()
Acknowledge data parsing has started.- Specified by:
inData
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
finalizeData
public boolean finalizeData()
Finalize data after parsing.- Specified by:
finalizeData
in classAbstractConstituentParser<TdmHeader,Tdm,TdmParser>
- Returns:
- true if parser was able to perform the action
-
-