public class FieldSpacecraftState<T extends CalculusFieldElement<T>> extends Object implements FieldTimeStamped<T>, FieldTimeShiftable<FieldSpacecraftState<T>,T>, FieldTimeInterpolable<FieldSpacecraftState<T>,T>
It contains an orbital state
at a current
FieldAbsoluteDate
both handled by an FieldOrbit
, plus the current
mass and attitude. FieldOrbitand 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 user-defined
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 FieldSpacecraftState
is guaranteed to be immutable.
NumericalPropagator
Constructor and Description |
---|
FieldSpacecraftState(Field<T> field,
SpacecraftState state)
Convert a
FieldSpacecraftState . |
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva)
Build a spacecraft state from orbit only.
|
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva,
FieldAttitude<T> attitude)
Build a spacecraft state from orbit and attitude provider.
|
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva,
FieldAttitude<T> attitude,
Map<String,T[]> additional)
Build a spacecraft state from orbit and attitude provider.
|
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva,
FieldAttitude<T> attitude,
T mass)
Build a spacecraft state from orbit, attitude provider and mass.
|
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva,
FieldAttitude<T> attitude,
T mass,
Map<String,T[]> additional)
Build a spacecraft state from orbit, attitude provider and mass.
|
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva,
Map<String,T[]> additional)
Build a spacecraft state from orbit only.
|
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva,
T mass)
Create a new instance from orbit and mass.
|
FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva,
T mass,
Map<String,T[]> additional)
Create a new instance from orbit and mass.
|
FieldSpacecraftState(FieldOrbit<T> orbit)
Build a spacecraft state from orbit only.
|
FieldSpacecraftState(FieldOrbit<T> orbit,
FieldAttitude<T> attitude)
Build a spacecraft state from orbit and attitude provider.
|
FieldSpacecraftState(FieldOrbit<T> orbit,
FieldAttitude<T> attitude,
Map<String,T[]> additional)
Build a spacecraft state from orbit and attitude provider.
|
FieldSpacecraftState(FieldOrbit<T> orbit,
FieldAttitude<T> attitude,
T mass)
Build a spacecraft state from orbit, attitude provider and mass.
|
FieldSpacecraftState(FieldOrbit<T> orbit,
FieldAttitude<T> attitude,
T mass,
Map<String,T[]> additional)
Build a spacecraft state from orbit, attitude provider and mass.
|
FieldSpacecraftState(FieldOrbit<T> orbit,
Map<String,T[]> additional)
Build a spacecraft state from orbit only.
|
FieldSpacecraftState(FieldOrbit<T> orbit,
T mass)
Create a new instance from orbit and mass.
|
FieldSpacecraftState(FieldOrbit<T> orbit,
T mass,
Map<String,T[]> additional)
Create a new instance from orbit and mass.
|
Modifier and Type | Method and Description |
---|---|
FieldSpacecraftState<T> |
addAdditionalState(String name,
T... value)
Add an additional state.
|
void |
ensureCompatibleAdditionalStates(FieldSpacecraftState<T> state)
Check if two instances have the same set of additional states available.
|
T |
getA()
Get the semi-major axis.
|
FieldAbsolutePVCoordinates<T> |
getAbsPVA()
Get the absolute position-velocity-acceleration.
|
T[] |
getAdditionalState(String name)
Get an additional state.
|
Map<String,T[]> |
getAdditionalStates()
Get an unmodifiable map of additional states.
|
FieldAttitude<T> |
getAttitude()
Get the attitude.
|
FieldAbsoluteDate<T> |
getDate()
Get the date.
|
T |
getE()
Get the eccentricity.
|
T |
getEquinoctialEx()
Get the first component of the eccentricity vector (as per equinoctial parameters).
|
T |
getEquinoctialEy()
Get the second component of the eccentricity vector (as per equinoctial parameters).
|
Frame |
getFrame()
Get the defining frame.
|
T |
getHx()
Get the first component of the inclination vector (as per equinoctial parameters).
|
T |
getHy()
Get the second component of the inclination vector (as per equinoctial parameters).
|
T |
getI()
Get the inclination.
|
T |
getKeplerianMeanMotion()
Get the Keplerian mean motion.
|
T |
getKeplerianPeriod()
Get the Keplerian period.
|
T |
getLE()
Get the eccentric latitude argument (as per equinoctial parameters).
|
T |
getLM()
Get the mean longitude argument (as per equinoctial parameters).
|
T |
getLv()
Get the true latitude argument (as per equinoctial parameters).
|
T |
getMass()
Gets the current mass.
|
T |
getMu()
Get the central attraction coefficient.
|
FieldOrbit<T> |
getOrbit()
Get the current orbit.
|
TimeStampedFieldPVCoordinates<T> |
getPVCoordinates()
Get the
TimeStampedFieldPVCoordinates in orbit definition frame. |
TimeStampedFieldPVCoordinates<T> |
getPVCoordinates(Frame outputFrame)
Get the
TimeStampedFieldPVCoordinates in given output frame. |
boolean |
hasAdditionalState(String name)
Check if an additional state is available.
|
FieldSpacecraftState<T> |
interpolate(FieldAbsoluteDate<T> date,
Stream<FieldSpacecraftState<T>> sample)
Get an interpolated instance.
|
boolean |
isOrbitDefined()
Check if the state contains an orbit part.
|
FieldSpacecraftState<T> |
shiftedBy(double dt)
Get a time-shifted state.
|
FieldSpacecraftState<T> |
shiftedBy(T dt)
Get a time-shifted state.
|
SpacecraftState |
toSpacecraftState()
To convert a FieldSpacecraftState instance into a SpacecraftState instance.
|
String |
toString() |
FieldTransform<T> |
toTransform()
Compute the transform from state defining frame to spacecraft frame.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
interpolate
public FieldSpacecraftState(FieldOrbit<T> orbit)
FieldAttitude and mass are set to unspecified non-null arbitrary values.
orbit
- the orbitpublic FieldSpacecraftState(FieldOrbit<T> orbit, FieldAttitude<T> attitude) throws IllegalArgumentException
Mass is set to an unspecified non-null arbitrary value.
orbit
- the orbitattitude
- attitudeIllegalArgumentException
- if orbit and attitude dates
or frames are not equalpublic FieldSpacecraftState(FieldOrbit<T> orbit, T mass)
FieldAttitude law is set to an unspecified default attitude.
orbit
- the orbitmass
- the mass (kg)public FieldSpacecraftState(FieldOrbit<T> orbit, FieldAttitude<T> attitude, T mass) throws IllegalArgumentException
orbit
- the orbitattitude
- attitudemass
- the mass (kg)IllegalArgumentException
- if orbit and attitude dates
or frames are not equalpublic FieldSpacecraftState(FieldOrbit<T> orbit, Map<String,T[]> additional)
FieldAttitude and mass are set to unspecified non-null arbitrary values.
orbit
- the orbitadditional
- additional statespublic FieldSpacecraftState(FieldOrbit<T> orbit, FieldAttitude<T> attitude, Map<String,T[]> additional) throws IllegalArgumentException
Mass is set to an unspecified non-null arbitrary value.
orbit
- the orbitattitude
- attitudeadditional
- additional statesIllegalArgumentException
- if orbit and attitude dates
or frames are not equalpublic FieldSpacecraftState(FieldOrbit<T> orbit, T mass, Map<String,T[]> additional)
FieldAttitude law is set to an unspecified default attitude.
orbit
- the orbitmass
- the mass (kg)additional
- additional statespublic FieldSpacecraftState(FieldOrbit<T> orbit, FieldAttitude<T> attitude, T mass, Map<String,T[]> 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 FieldSpacecraftState(Field<T> field, SpacecraftState state)
FieldSpacecraftState
.field
- field to which the elements belongstate
- state to convertpublic FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva)
Attitude and mass are set to unspecified non-null arbitrary values.
absPva
- position-velocity-accelerationpublic FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva, FieldAttitude<T> attitude) throws IllegalArgumentException
Mass is set to an unspecified non-null arbitrary value.
absPva
- position-velocity-accelerationattitude
- attitudeIllegalArgumentException
- if orbit and attitude dates
or frames are not equalpublic FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva, T mass)
Attitude law is set to an unspecified default attitude.
absPva
- position-velocity-accelerationmass
- the mass (kg)public FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva, FieldAttitude<T> attitude, T mass) throws IllegalArgumentException
absPva
- position-velocity-accelerationattitude
- attitudemass
- the mass (kg)IllegalArgumentException
- if orbit and attitude dates
or frames are not equalpublic FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva, Map<String,T[]> additional)
Attitude and mass are set to unspecified non-null arbitrary values.
absPva
- position-velocity-accelerationadditional
- additional statespublic FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva, FieldAttitude<T> attitude, Map<String,T[]> additional) throws IllegalArgumentException
Mass is set to an unspecified non-null arbitrary value.
absPva
- position-velocity-accelerationattitude
- attitudeadditional
- additional statesIllegalArgumentException
- if orbit and attitude dates
or frames are not equalpublic FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva, T mass, Map<String,T[]> additional)
Attitude law is set to an unspecified default attitude.
absPva
- position-velocity-accelerationmass
- the mass (kg)additional
- additional statespublic FieldSpacecraftState(FieldAbsolutePVCoordinates<T> absPva, FieldAttitude<T> attitude, T mass, Map<String,T[]> additional) throws IllegalArgumentException
absPva
- position-velocity-accelerationattitude
- 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 equal@SafeVarargs public final FieldSpacecraftState<T> addAdditionalState(String name, T... 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 boolean isOrbitDefined()
A state contains either an absolute
position-velocity-acceleration
or an orbit
.
getOrbit()
will not throw an exception), or false if the state contains an
absolut position-velocity-acceleration (in which case getAbsPVA()
will not throw an exception)public FieldSpacecraftState<T> shiftedBy(double dt)
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 neither mass nor additional states changes. It 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 FieldTimeShiftable<FieldSpacecraftState<T extends CalculusFieldElement<T>>,T extends CalculusFieldElement<T>>
dt
- time shift in secondspublic FieldSpacecraftState<T> shiftedBy(T dt)
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 neither mass nor additional states changes. It 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 FieldTimeShiftable<FieldSpacecraftState<T extends CalculusFieldElement<T>>,T extends CalculusFieldElement<T>>
dt
- time shift in secondspublic FieldSpacecraftState<T> interpolate(FieldAbsoluteDate<T> date, Stream<FieldSpacecraftState<T>> sample)
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 10-20 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.
The instance and all the sample instances must be based on similar
trajectory data, i.e. they must either all be based on orbits or all be based
on absolute position-velocity-acceleration. Any inconsistency will trigger
an OrekitIllegalStateException
.
As this implementation of interpolation is polynomial, it should be used only with small samples (about 10-20 points) in order to avoid Runge's phenomenon and numerical problems (including NaN appearing).
interpolate
in interface FieldTimeInterpolable<FieldSpacecraftState<T extends CalculusFieldElement<T>>,T extends CalculusFieldElement<T>>
date
- interpolation datesample
- sample points on which interpolation should be doneOrekitIllegalStateException
- if some instances are not based on
similar trajectory datapublic FieldAbsolutePVCoordinates<T> getAbsPVA() throws OrekitIllegalStateException
A state contains either an absolute
position-velocity-acceleration
or an orbit
. Which
one is present can be checked using isOrbitDefined()
.
OrekitIllegalStateException
- if position-velocity-acceleration is null,
which mean the state rather contains an FieldOrbit
isOrbitDefined()
,
getOrbit()
public FieldOrbit<T> getOrbit() throws OrekitIllegalStateException
A state contains either an absolute
position-velocity-acceleration
or an orbit
. Which
one is present can be checked using isOrbitDefined()
.
OrekitIllegalStateException
- if orbit is null,
which means the state rather contains an absolute
position-velocity-acceleration
isOrbitDefined()
,
getAbsPVA()
public FieldAbsoluteDate<T> getDate()
getDate
in interface FieldTimeStamped<T extends CalculusFieldElement<T>>
public Frame getFrame()
public boolean hasAdditionalState(String name)
name
- name of the additional stateaddAdditionalState(String, CalculusFieldElement...)
,
getAdditionalState(String)
,
getAdditionalStates()
public void ensureCompatibleAdditionalStates(FieldSpacecraftState<T> state) throws MathIllegalArgumentException
Only the names and dimensions of the additional states are compared, not their values.
state
- state to compare to instanceMathIllegalArgumentException
- if an additional state does not have
the same dimension in both statespublic T[] getAdditionalState(String name)
name
- name of the additional stateaddAdditionalState(String, CalculusFieldElement...)
,
hasAdditionalState(String)
,
getAdditionalStates()
public Map<String,T[]> getAdditionalStates()
addAdditionalState(String, CalculusFieldElement...)
,
hasAdditionalState(String)
,
getAdditionalState(String)
public FieldTransform<T> toTransform()
The spacecraft frame origin is at the point defined by the orbit, and its orientation is defined by the attitude.
public T getMu()
public T getKeplerianPeriod()
The Keplerian period is computed directly from semi major axis and central acceleration constant.
public T getKeplerianMeanMotion()
The Keplerian mean motion is computed directly from semi major axis and central acceleration constant.
public T getA()
public T getEquinoctialEx()
getE()
public T getEquinoctialEy()
getE()
public T getHx()
getI()
public T getHy()
getI()
public T getLv()
public T getLE()
public T getLM()
public T getE()
getEquinoctialEx()
,
getEquinoctialEy()
public TimeStampedFieldPVCoordinates<T> getPVCoordinates()
TimeStampedFieldPVCoordinates
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
TimeStampedFieldPVCoordinates
, so the caller is responsible to copy it in a separate
TimeStampedFieldPVCoordinates
if it needs to keep the value for a while.
public TimeStampedFieldPVCoordinates<T> getPVCoordinates(Frame outputFrame)
TimeStampedFieldPVCoordinates
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
TimeStampedFieldPVCoordinates
, so the caller is responsible to copy it in a separate
TimeStampedFieldPVCoordinates
if it needs to keep the value for a while.
outputFrame
- frame in which coordinates should be definedpublic FieldAttitude<T> getAttitude()
public T getMass()
public SpacecraftState toSpacecraftState()
Copyright © 2002-2021 CS GROUP. All rights reserved.