Package org.orekit.files.sp3

Class SP3Ephemeris

java.lang.Object

org.orekit.files.sp3.SP3Ephemeris

All Implemented Interfaces:

EphemerisFile.SatelliteEphemeris<SP3Coordinate,SP3Segment>

public class SP3Ephemeris
extends Object
implements EphemerisFile.SatelliteEphemeris<SP3Coordinate,SP3Segment>

Single satellite ephemeris from an SP3 file.

Since:

12.0

Author:

Luc Maisonobe

Constructor Summary

Constructors

Constructor	Description
SP3Ephemeris(String id, double mu, Frame frame, int interpolationSamples, CartesianDerivativesFilter filter)	Create an ephemeris for a single satellite.

Method Summary

Modifier and Type	Method	Description
void	addCoordinate(SP3Coordinate coord, double maxGap)	Adds a new P/V coordinate.
AggregatedClockModel	extractClockModel()	Extract the clock model.
CartesianDerivativesFilter	getAvailableDerivatives()	Get the available derivatives.
Frame	getFrame()	Get the reference frame.
String	getId()	Get the satellite ID.
int	getInterpolationSamples()	Get the number of points to use for interpolation.
double	getMu()	Get the standard gravitational parameter for the satellite.
List<SP3Segment>	getSegments()	Get the segments of the ephemeris.
AbsoluteDate	getStart()	Get the start date of the ephemeris.
AbsoluteDate	getStop()	Get the end date of the ephemeris.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.files.general.EphemerisFile.SatelliteEphemeris

getPropagator, getPropagator

Constructor Detail

SP3Ephemeris

public SP3Ephemeris(String id,
                    double mu,
                    Frame frame,
                    int interpolationSamples,
                    CartesianDerivativesFilter filter)

Create an ephemeris for a single satellite.

Parameters:

id - of the satellite.

mu - standard gravitational parameter to use for creating Orbits from the ephemeris data.

frame - reference frame

interpolationSamples - number of points to use for interpolation

filter - available derivatives

Method Detail

getId

public String getId()

Get the satellite ID. The satellite ID is unique only within the same ephemeris file.

Specified by:

getId in interface EphemerisFile.SatelliteEphemeris<SP3Coordinate,SP3Segment>

Returns:

the satellite's ID, never null.

getMu

public double getMu()

Get the standard gravitational parameter for the satellite.

Specified by:

getMu in interface EphemerisFile.SatelliteEphemeris<SP3Coordinate,SP3Segment>

Returns:

the gravitational parameter used in EphemerisFile.SatelliteEphemeris.getPropagator(AttitudeProvider), in m³/s².

getSegments

public List<SP3Segment> getSegments()

Get the segments of the ephemeris.

Ephemeris segments are typically used to split an ephemeris around discontinuous events, such as maneuvers.

Specified by:

getSegments in interface EphemerisFile.SatelliteEphemeris<SP3Coordinate,SP3Segment>

Returns:

the segments contained in the ephemeris file for this satellite.

getStart

public AbsoluteDate getStart()

Get the start date of the ephemeris.

The date returned by this method is equivalent to getPropagator().getMinDate().

Specified by:

getStart in interface EphemerisFile.SatelliteEphemeris<SP3Coordinate,SP3Segment>

Returns:

ephemeris start date.

getStop

public AbsoluteDate getStop()

Get the end date of the ephemeris.

The date returned by this method is equivalent to getPropagator().getMaxDate().

Specified by:

getStop in interface EphemerisFile.SatelliteEphemeris<SP3Coordinate,SP3Segment>

Returns:

ephemeris end date.

getFrame

public Frame getFrame()

Get the reference frame.

Returns:

reference frame

getInterpolationSamples

public int getInterpolationSamples()

Get the number of points to use for interpolation.

Returns:

number of points to use for interpolation

getAvailableDerivatives

public CartesianDerivativesFilter getAvailableDerivatives()

Get the available derivatives.

Returns:

available derivatives

addCoordinate

public void addCoordinate(SP3Coordinate coord,
                          double maxGap)

Adds a new P/V coordinate.

Parameters:

coord - the P/V coordinate of the satellite

maxGap - maximum gap between segments

extractClockModel

public AggregatedClockModel extractClockModel()

Extract the clock model.

There are always 2n+1 AggregatedClockModel.getModels() underlying clock models when there are n segments in the ephemeris. This happens because there are spans with null data before the first segment, between all regular segments and after last segment.

Returns:

extracted clock model

Since:

12.1