public class SpacecraftState extends Object implements TimeStamped, TimeShiftable<SpacecraftState>, TimeInterpolable<SpacecraftState>, Serializable
It contains an orbital state
at a current
AbsoluteDate
both handled by an Orbit
, plus the current
mass and attitude. Orbit and state are guaranteed to be consistent in terms
of date and reference frame. The spacecraft state may also contain additional
states, which are simply named double arrays which can hold any userdefined
data.
The state can be slightly shifted to close dates. This shift is based on a simple Keplerian model for orbit, a linear extrapolation for attitude taking the spin rate into account and no mass change. It is not intended as a replacement for proper orbit and attitude propagation but should be sufficient for either small time shifts or coarse accuracy.
The instance SpacecraftState
is guaranteed to be immutable.
NumericalPropagator
,
Serialized FormConstructor and Description 

SpacecraftState(Orbit orbit)
Build a spacecraft state from orbit only.

SpacecraftState(Orbit orbit,
Attitude attitude)
Build a spacecraft state from orbit and attitude provider.

SpacecraftState(Orbit orbit,
Attitude attitude,
double mass)
Build a spacecraft state from orbit, attitude provider and mass.

SpacecraftState(Orbit orbit,
Attitude attitude,
double mass,
Map<String,double[]> additional)
Build a spacecraft state from orbit, attitude provider and mass.

SpacecraftState(Orbit orbit,
Attitude attitude,
Map<String,double[]> additional)
Build a spacecraft state from orbit and attitude provider.

SpacecraftState(Orbit orbit,
double mass)
Create a new instance from orbit and mass.

SpacecraftState(Orbit orbit,
double mass,
Map<String,double[]> additional)
Create a new instance from orbit and mass.

SpacecraftState(Orbit orbit,
Map<String,double[]> additional)
Build a spacecraft state from orbit only.

Modifier and Type  Method and Description 

SpacecraftState 
addAdditionalState(String name,
double... value)
Add an additional state.

void 
ensureCompatibleAdditionalStates(SpacecraftState state)
Check if two instances have the same set of additional states available.

double 
getA()
Get the semimajor axis.

double[] 
getAdditionalState(String name)
Get an additional state.

Map<String,double[]> 
getAdditionalStates()
Get an unmodifiable map of additional states.

Attitude 
getAttitude()
Get the attitude.

AbsoluteDate 
getDate()
Get the date.

double 
getE()
Get the eccentricity.

double 
getEquinoctialEx()
Get the first component of the eccentricity vector (as per equinoctial parameters).

double 
getEquinoctialEy()
Get the second component of the eccentricity vector (as per equinoctial parameters).

Frame 
getFrame()
Get the inertial frame.

double 
getHx()
Get the first component of the inclination vector (as per equinoctial parameters).

double 
getHy()
Get the second component of the inclination vector (as per equinoctial parameters).

double 
getI()
Get the inclination.

double 
getKeplerianMeanMotion()
Get the Keplerian mean motion.

double 
getKeplerianPeriod()
Get the Keplerian period.

double 
getLE()
Get the eccentric latitude argument (as per equinoctial parameters).

double 
getLM()
Get the mean latitude argument (as per equinoctial parameters).

double 
getLv()
Get the true latitude argument (as per equinoctial parameters).

double 
getMass()
Gets the current mass.

double 
getMu()
Get the central attraction coefficient.

Orbit 
getOrbit()
Gets the current orbit.

TimeStampedPVCoordinates 
getPVCoordinates()
Get the
TimeStampedPVCoordinates in orbit definition frame. 
TimeStampedPVCoordinates 
getPVCoordinates(Frame outputFrame)
Get the
TimeStampedPVCoordinates in given output frame. 
boolean 
hasAdditionalState(String name)
Check if an additional state is available.

SpacecraftState 
interpolate(AbsoluteDate date,
Stream<SpacecraftState> sample)
Get an interpolated instance.

SpacecraftState 
shiftedBy(double dt)
Get a timeshifted state.

Transform 
toTransform()
Compute the transform from orbite/attitude reference frame to spacecraft frame.

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
interpolate
public SpacecraftState(Orbit orbit) throws OrekitException
Attitude and mass are set to unspecified nonnull arbitrary values.
orbit
 the orbitOrekitException
 if default attitude cannot be computedpublic SpacecraftState(Orbit orbit, Attitude attitude) throws IllegalArgumentException
Mass is set to an unspecified nonnull arbitrary value.
orbit
 the orbitattitude
 attitudeIllegalArgumentException
 if orbit and attitude dates
or frames are not equalpublic SpacecraftState(Orbit orbit, double mass) throws OrekitException
Attitude law is set to an unspecified default attitude.
orbit
 the orbitmass
 the mass (kg)OrekitException
 if default attitude cannot be computedpublic SpacecraftState(Orbit orbit, Attitude attitude, double mass) throws IllegalArgumentException
orbit
 the orbitattitude
 attitudemass
 the mass (kg)IllegalArgumentException
 if orbit and attitude dates
or frames are not equalpublic SpacecraftState(Orbit orbit, Map<String,double[]> additional) throws OrekitException
Attitude and mass are set to unspecified nonnull arbitrary values.
orbit
 the orbitadditional
 additional statesOrekitException
 if default attitude cannot be computedpublic SpacecraftState(Orbit orbit, Attitude attitude, Map<String,double[]> additional) throws IllegalArgumentException
Mass is set to an unspecified nonnull arbitrary value.
orbit
 the orbitattitude
 attitudeadditional
 additional statesIllegalArgumentException
 if orbit and attitude dates
or frames are not equalpublic SpacecraftState(Orbit orbit, double mass, Map<String,double[]> additional) throws OrekitException
Attitude law is set to an unspecified default attitude.
orbit
 the orbitmass
 the mass (kg)additional
 additional statesOrekitException
 if default attitude cannot be computedpublic SpacecraftState(Orbit orbit, Attitude attitude, double mass, Map<String,double[]> additional) throws IllegalArgumentException
orbit
 the orbitattitude
 attitudemass
 the mass (kg)additional
 additional states (may be null if no additional states are available)IllegalArgumentException
 if orbit and attitude dates
or frames are not equalpublic SpacecraftState addAdditionalState(String name, double... value)
SpacecraftState
instances are immutable,
so this method does not change the instance, but rather
creates a new instance, which has the same orbit, attitude, mass
and additional states as the original instance, except it also
has the specified state. If the original instance already had an
additional state with the same name, it will be overridden. If it
did not have any additional state with that name, the new instance
will have one more additional state than the original instance.
name
 name of the additional statevalue
 value of the additional statehasAdditionalState(String)
,
getAdditionalState(String)
,
getAdditionalStates()
public SpacecraftState shiftedBy(double dt)
The state can be slightly shifted to close dates. This shift is based on simple models. For orbits, the model is a Keplerian one if no derivatives are available in the orbit, or Keplerian plus quadratic effect of the nonKeplerian acceleration if derivatives are available. For attitude, a polynomial model is used. Neither mass nor additional states change. Shifting is not intended as a replacement for proper orbit and attitude propagation but should be sufficient for small time shifts or coarse accuracy.
As a rough order of magnitude, the following table shows the extrapolation
errors obtained between this simple shift method and an numerical
propagator
for a low Earth Sun Synchronous Orbit, with a 20x20 gravity field,
Sun and Moon third bodies attractions, drag and solar radiation pressure.
Beware that these results will be different for other orbits.
interpolation time (s)  position error without derivatives (m)  position error with derivatives (m) 

60  18  1.1 
120  72  9.1 
300  447  140 
600  1601  1067 
900  3141  3307 
shiftedBy
in interface TimeShiftable<SpacecraftState>
dt
 time shift in secondspublic SpacecraftState interpolate(AbsoluteDate date, Stream<SpacecraftState> sample) throws OrekitException
Note that the state of the current instance may not be used in the interpolation process, only its type and non interpolable fields are used (for example central attraction coefficient or frame when interpolating orbits). The interpolable fields taken into account are taken only from the states of the sample points. So if the state of the instance must be used, the instance should be included in the sample points.
Note that this method is designed for small samples only (say up to about 1020 points) so it can be implemented using polynomial interpolation (typically Hermite interpolation). Using too much points may induce Runge's phenomenon and numerical problems (including NaN appearing).
The additional states that are interpolated are the ones already present in the instance. The sample instances must therefore have at least the same additional states has the instance. They may have more additional states, but the extra ones will be ignored.
As this implementation of interpolation is polynomial, it should be used only with small samples (about 1020 points) in order to avoid Runge's phenomenon and numerical problems (including NaN appearing).
interpolate
in interface TimeInterpolable<SpacecraftState>
date
 interpolation datesample
 sample points on which interpolation should be doneOrekitException
 if interpolation cannot be performedpublic Orbit getOrbit()
public AbsoluteDate getDate()
getDate
in interface TimeStamped
public Frame getFrame()
public boolean hasAdditionalState(String name)
name
 name of the additional stateaddAdditionalState(String, double[])
,
getAdditionalState(String)
,
getAdditionalStates()
public void ensureCompatibleAdditionalStates(SpacecraftState state) throws OrekitException, MathIllegalStateException
Only the names and dimensions of the additional states are compared, not their values.
state
 state to compare to instanceOrekitException
 if either instance or state supports an additional
state not supported by the other oneMathIllegalStateException
 if an additional state does not have
the same dimension in both statespublic double[] getAdditionalState(String name) throws OrekitException
name
 name of the additional stateOrekitException
 if no additional state with that name existsaddAdditionalState(String, double[])
,
hasAdditionalState(String)
,
getAdditionalStates()
public Map<String,double[]> getAdditionalStates()
addAdditionalState(String, double[])
,
hasAdditionalState(String)
,
getAdditionalState(String)
public Transform toTransform()
The spacecraft frame origin is at the point defined by the orbit, and its orientation is defined by the attitude.
public double getMu()
public double getKeplerianPeriod()
The Keplerian period is computed directly from semi major axis and central acceleration constant.
public double getKeplerianMeanMotion()
The Keplerian mean motion is computed directly from semi major axis and central acceleration constant.
public double getA()
public double getEquinoctialEx()
getE()
public double getEquinoctialEy()
getE()
public double getHx()
getI()
public double getHy()
getI()
public double getLv()
public double getLE()
public double getLM()
public double getE()
getEquinoctialEx()
,
getEquinoctialEy()
public double getI()
public TimeStampedPVCoordinates getPVCoordinates()
TimeStampedPVCoordinates
in orbit definition frame.
Compute the position and velocity of the satellite. This method caches its
results, and recompute them only when the method is called with a new value
for mu. The result is provided as a reference to the internally cached
TimeStampedPVCoordinates
, so the caller is responsible to copy it in a separate
TimeStampedPVCoordinates
if it needs to keep the value for a while.public TimeStampedPVCoordinates getPVCoordinates(Frame outputFrame) throws OrekitException
TimeStampedPVCoordinates
in given output frame.
Compute the position and velocity of the satellite. This method caches its
results, and recompute them only when the method is called with a new value
for mu. The result is provided as a reference to the internally cached
TimeStampedPVCoordinates
, so the caller is responsible to copy it in a separate
TimeStampedPVCoordinates
if it needs to keep the value for a while.outputFrame
 frame in which coordinates should be definedOrekitException
 if the transformation between frames cannot be computedpublic Attitude getAttitude()
public double getMass()
Copyright © 20022017 CS Systèmes d'information. All rights reserved.