public class OEMParser extends ODMParser implements EphemerisFileParser
Constructor and Description |
---|
OEMParser()
Simple constructor.
|
OEMParser(DataContext dataContext)
Constructor with data context.
|
Modifier and Type | Method and Description |
---|---|
OEMFile |
parse(BufferedReader reader,
String fileName)
Parse an ephemeris file from a stream.
|
OEMFile |
parse(InputStream stream)
Parse a CCSDS Orbit Data Message.
|
OEMFile |
parse(InputStream stream,
String fileName)
Parse a CCSDS Orbit Data Message.
|
OEMFile |
parse(String fileName)
Parse a CCSDS Orbit Data Message.
|
OEMParser |
withConventions(IERSConventions newConventions)
Set IERS conventions.
|
OEMParser |
withDataContext(DataContext dataContext)
Set the data context.
|
OEMParser |
withInternationalDesignator(int newLaunchYear,
int newLaunchNumber,
String newLaunchPiece)
Set international designator.
|
OEMParser |
withMissionReferenceDate(AbsoluteDate newMissionReferenceDate)
Set initial date.
|
OEMParser |
withMu(double newMu)
Set gravitational coefficient.
|
OEMParser |
withSimpleEOP(boolean newSimpleEOP)
Set EOP interpolation method.
|
getConventions, getDataContext, getLaunchNumber, getLaunchPiece, getLaunchYear, getMissionReferenceDate, getMu, isSimpleEOP, parseCCSDSFrame, parseComment, parseDate, parseGeneralStateDataEntry, parseHeaderEntry, parseMetaDataEntry
@DefaultDataContext public OEMParser()
This class is immutable, and hence thread safe. When parts
must be changed, such as reference date for Mission Elapsed Time or
Mission Relative Time time systems, or the gravitational coefficient or
the IERS conventions, the various withXxx
methods must be called,
which create a new immutable instance with the new parameters. This
is a combination of the
builder design
pattern and a
fluent
interface.
The initial date for Mission Elapsed Time and Mission Relative Time time systems is not set here.
If such time systems are used, it must be initialized before parsing by calling withMissionReferenceDate(AbsoluteDate)
.
The gravitational coefficient is not set here. If it is needed in order
to parse Cartesian orbits where the value is not set in the CCSDS file, it must
be initialized before parsing by calling withMu(double)
.
The IERS conventions to use is not set here. If it is needed in order to
parse some reference frames or UT1 time scale, it must be initialized before
parsing by calling withConventions(IERSConventions)
.
This method uses the default data context
. See
withDataContext(DataContext)
.
public OEMParser(DataContext dataContext)
This class is immutable, and hence thread safe. When parts
must be changed, such as reference date for Mission Elapsed Time or
Mission Relative Time time systems, or the gravitational coefficient or
the IERS conventions, the various withXxx
methods must be called,
which create a new immutable instance with the new parameters. This
is a combination of the
builder design
pattern and a
fluent
interface.
The initial date for Mission Elapsed Time and Mission Relative Time time systems is not set here.
If such time systems are used, it must be initialized before parsing by calling withMissionReferenceDate(AbsoluteDate)
.
The gravitational coefficient is not set here. If it is needed in order
to parse Cartesian orbits where the value is not set in the CCSDS file, it must
be initialized before parsing by calling withMu(double)
.
The IERS conventions to use is not set here. If it is needed in order to
parse some reference frames or UT1 time scale, it must be initialized before
parsing by calling withConventions(IERSConventions)
.
dataContext
- used by the parser.OEMParser()
,
withDataContext(DataContext)
public OEMParser withMissionReferenceDate(AbsoluteDate newMissionReferenceDate)
withMissionReferenceDate
in class ODMParser
newMissionReferenceDate
- mission reference date to use while parsingODMParser.getMissionReferenceDate()
public OEMParser withMu(double newMu)
withMu
in class ODMParser
newMu
- gravitational coefficient to use while parsingODMParser.getMu()
public OEMParser withConventions(IERSConventions newConventions)
withConventions
in class ODMParser
newConventions
- IERS conventions to use while parsingODMParser.getConventions()
public OEMParser withSimpleEOP(boolean newSimpleEOP)
withSimpleEOP
in class ODMParser
newSimpleEOP
- if true, tidal effects are ignored when interpolating EOPODMParser.isSimpleEOP()
public OEMParser withInternationalDesignator(int newLaunchYear, int newLaunchNumber, String newLaunchPiece)
This method may be used to ensure the launch year number and pieces are correctly set if they are not present in the CCSDS file header in the OBJECT_ID in the form YYYY-NNN-P{PP}. If they are already in the header, they will be parsed automatically regardless of this method being called or not (i.e. header information override information set here).
withInternationalDesignator
in class ODMParser
newLaunchYear
- launch yearnewLaunchNumber
- launch numbernewLaunchPiece
- piece of launch (from "A" to "ZZZ")public OEMParser withDataContext(DataContext dataContext)
ODMParser
withDataContext
in class ODMParser
dataContext
- used for frames, time scales, and celestial bodies.public OEMFile parse(String fileName)
parse
in interface EphemerisFileParser
parse
in class ODMParser
fileName
- name of the file containing the messagepublic OEMFile parse(InputStream stream)
public OEMFile parse(InputStream stream, String fileName)
public OEMFile parse(BufferedReader reader, String fileName)
EphemerisFileParser
parse
in interface EphemerisFileParser
reader
- containing the ephemeris file.fileName
- to use in error messages.Copyright © 2002-2020 CS Group. All rights reserved.