User Manual 3.3 SpacecraftState - Historique des versions

Admin : /* Transform */

2018-03-01T15:33:12Z

Transform

← Version précédente		Version du 1 mars 2018 à 15:33
Ligne 126 :		Ligne 126 :
	final Vector3D pos = transform.transformPosition(sun.getPVCoordinates().getPosition());		final Vector3D pos = transform.transformPosition(sun.getPVCoordinates().getPosition());
	</syntaxhighlight>		</syntaxhighlight>
	If an [{{JavaDoc3.3}}//fr/cnes/sirius/patrius/assembly/Assembly.html Assembly] is used, this is not necessary to use these methods because the conversion methods are included in Assembly functionalities (see [~~SPC_VBU_Home~~ dedicated User Manual]).		If an [{{JavaDoc3.3}}/fr/cnes/sirius/patrius/assembly/Assembly.html Assembly] is used, this is not necessary to use these methods because the conversion methods are included in Assembly functionalities (see [[User Manual 3.3 Assemblies in PATRIUS: Building and using an assembly\|dedicated User Manual]]).

	== Getting Started ==		== Getting Started ==

Admin : /* Links */

2018-03-01T15:31:24Z

Links

← Version précédente		Version du 1 mars 2018 à 15:31
Ligne 11 :		Ligne 11 :
	=== Links ===		=== Links ===
	Here is only described the SpacecraftState structure.		Here is only described the SpacecraftState structure.
	Please refer to [~~ORB_PRO_Home~~ propagation chapter].		Please refer to [[User Manual 3.3 Numerical propagation\|propagation chapter]].

	=== Useful Documents ===		=== Useful Documents ===

Admin : /* Contents */

2018-02-27T08:58:52Z

Contents

@@ Ligne 133 : / Ligne 133 : @@
 == Contents ==
 === Interfaces ===
-|=(% colspan="3" %)Interface|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc
+{| class="wikitable"
-|(% colspan="3" %)'''MassProvider'''|(% colspan="6" %)Interface providing the mass for spacecraft models.|[{{JavaDoc3.3}}/org/orekit/propagation/MassProvider.html ...]
+|-
 === Classes ===
-|=(% colspan="3" %)Class|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc
+[[Category:User_Manual_3.3_Flight_Dynamics]]
 == Tutorials ==

Admin : /* Features Description */

2018-02-27T08:56:24Z

Features Description

Admin : /* Overview */

2018-02-27T08:54:39Z

Overview

← Version précédente		Version du 27 février 2018 à 08:54
Ligne 17 :		Ligne 17 :

	=== Overview ===		=== Overview ===
	The [{{JavaDoc3.3}}//org/orekit/propagation/SpacecraftState.html SpacecraftState] is composed of :		The [{{JavaDoc3.3}}//org/orekit/propagation/SpacecraftState.html SpacecraftState] is composed of :<br>
	- an [{{JavaDoc3.3}}//org/orekit/orbits/Orbit.html orbit]		- an [{{JavaDoc3.3}}//org/orekit/orbits/Orbit.html orbit]<br>
	- an [{{JavaDoc3.3}}//org/orekit/attitudes/Attitude.html attitude for forces computation]		- an [{{JavaDoc3.3}}//org/orekit/attitudes/Attitude.html attitude for forces computation] <br>
	- an [{{JavaDoc3.3}}//org/orekit/attitudes/Attitude.html attitude for events computation]		- an [{{JavaDoc3.3}}//org/orekit/attitudes/Attitude.html attitude for events computation]<br>
	- a map of additional states (including mass states added from [{{JavaDoc3.3}}//org/orekit/propagation/MassProvider.html MassProvider]).		- a map of additional states (including mass states added from [{{JavaDoc3.3}}//org/orekit/propagation/MassProvider.html MassProvider]).

Admin : Admin a déplacé la page SpacecraftState vers User Manual 3.3 SpacecraftState sans laisser de redirection

2018-02-27T08:54:14Z

Admin a déplacé la page SpacecraftState vers User Manual 3.3 SpacecraftState sans laisser de redirection

← Version précédente		Version du 27 février 2018 à 08:54
(Aucune différence)

Admin : 1 révision importée

2018-02-27T08:53:57Z

1 révision importée

← Version précédente		Version du 27 février 2018 à 08:53
(Aucune différence)

Admin le 27 février 2018 à 08:53

2018-02-27T08:53:56Z

Nouvelle page

== Introduction ==
=== Scope ===
This section describes the SpacecraftState object provided by the Orekit library.

=== Javadoc ===
The object [{{JavaDoc3.3}}//org/orekit/propagation/SpacecraftState.html SpacecraftState] is available in the package <code>org.orekit.propagation</code> of OREKIT.

=== Links ===
Here is only described the SpacecraftState structure.
Please refer to [ORB_PRO_Home propagation chapter].

=== Useful Documents ===
None as of now.

=== Overview ===
The [{{JavaDoc3.3}}//org/orekit/propagation/SpacecraftState.html SpacecraftState] is composed of :
- an [{{JavaDoc3.3}}//org/orekit/orbits/Orbit.html orbit]
- an [{{JavaDoc3.3}}//org/orekit/attitudes/Attitude.html attitude for forces computation]
- an [{{JavaDoc3.3}}//org/orekit/attitudes/Attitude.html attitude for events computation]
- a map of additional states (including mass states added from [{{JavaDoc3.3}}//org/orekit/propagation/MassProvider.html MassProvider]).

Two attitudes are stored in order to apply (if needed) a different treatment to each attitude.

== Features Description ==
=== One orbit ===
The [{{JavaDoc3.3}}''org/orekit/propagation/SpacecraftState.html SpacecraftState] is composed of one [{{JavaDoc3.3}}''org/orekit/orbits/Orbit.html Orbit].
It is possible to simply declare a SpacecraftState with an orbit :
<code>final SpacecraftState state = new SpacecraftState(orbit);</code>

The orbit could be updated using the following method :
<code>final SpacecraftState newState = state.updateOrbit(newOrbit);</code>
The attitude and additional states will remain the same and a new SpacecraftState will be created.

=== Two attitudes ===
The user can use one single [{{JavaDoc3.3}}''org/orekit/attitudes/Attitude.html Attitude] or two different [{{JavaDoc3.3}}''org/orekit/attitudes/Attitude.html Attitude] objects : one for forces computation and one for events computation. The following constructor can be used :

<code>final SpacecraftState state = new SpacecraftState(orbit, attitudeForces, attitudeEvents);</code>

It is possible to get the attitude for forces or events computation using the following methods:

<syntaxhighlight lang="java">final Attitude attForces = state.getAttitudeForces();
final Attitude attEvents = state.getAttitudeEvents();</syntaxhighlight>

The user can deals with a single attitude in the SpacecraftState using the following constructor:
<syntaxhighlight lang="java">final SpacecraftState state = new SpacecraftState(orbit, attitude);
final Attitude att = state.getAttitude();</syntaxhighlight>

If the following constructor is used, both attitudes are set to null value:
<code>final SpacecraftState state = new SpacecraftState(orbit);</code>
Then calling <code>getAttitude</code> or <code>getAttitudeForces</code> or <code>getAttitudeEvents</code> will return null attitude.

=== Additional states ===
The additional states are stored in the SpacecraftState using a Map with the additional states names as keys. The additional states are in the type <code>double[]</code>.
The additional states map could be given directly to the constructor as follow :

<syntaxhighlight lang="java">Map<String, double[]> addStates = new HashMap<String, double[]>();
addStates.put("name", new double[]{1.0});
SpacecraftState state = new SpacecraftState(orbit, attitudeForces, attitudeEvents, addStates); </syntaxhighlight>

It is possible to add an additional state to a SpacecraftState using'''''addAdditionalState''''':

<code>state2 = state.addAdditionalState("name2", new double[]{0.1, 0.1});</code>

Note :'''''addAdditionalState''''' returns a new SpacecraftState with the added additional state. It is necessary to store the returned object. The additional state is not added to the current state.

=== Mass ===
A [{{JavaDoc3.3}}/org/orekit/propagation/MassProvider.html MassProvider] can be provided to the SpacecraftState. In that case, the mass information are automaticaly stored as additional states. Be careful, the mass values can never be negative:

<syntaxhighlight lang="java">final SpacecraftState state = new SpacecraftState(orbit, massProvider);
final SpacecraftState state = new SpacecraftState(orbit, attitudeForces, attitudeEvents, massProvider, addStates); </syntaxhighlight>

The mass provider can be added to the SpacecraftState after its initilisation with the method <code>addMassProvider</code> :
<syntaxhighlight lang="java">final SpacecraftState state = new SpacecraftState(orbit);
final SpacecraftState newState = state.addMassProvider(massProvider);</syntaxhighlight>

The mass parts from MassProvider are added to additional states map with the key : "MASS_<partName>".

The total mass of the SpacecraftState could not be obtained.

It is possible to obtain the mass of a given part :
<code>state.getMass("part1"); </code>

and to update the mass of a given part :
<code>state.updateMass("part1", 1000.0); </code>

=== State vector ===
The [{{JavaDoc3.3}}/org/orekit/propagation/SpacecraftState.html SpacecraftState] object could be created from a state vector :
<code>final SpacecraftState state = new SpacecraftState(stateVector, OrbitType.CARTESIAN, PositionAngle.MEAN, date, mu, frame, addStatesInfo, attProviderForces, attProviderEvents);</code>

To build the SpacecraftState, it is necessary to know the size and the index of all additional states in the state vector. This information could be obtained from an old state using the following method :
<code>final Map<String, AdditionalStateInfo> addStatesInfos = state.getAdditionalStatesInfos();</code>

The state vector could be obtained from a SpacecraftState :
<syntaxhighlight lang="java">final double[] stateVector = new double[]{};
state.mapStateToArray(OrbitType.CARTESIAN, PositionAngle.MEAN, stateVector); </syntaxhighlight>

=== Transform ===
The [{{JavaDoc3.3}}//org/orekit/propagation/SpacecraftState.html SpacecraftState] class contains methods to compute the following transformations :
- <code>toTransform()</code> or <code>toTransformForces()</code> : Transform from orbit/attitude reference frame to spacecraft frame (attitude used for forces computation which is the default attitude).
- <code>toTransformEvents()</code> : Transform from orbit/attitude reference frame to spacecraft frame attitude used for events computation (same as toTransform if there is no specific attitude for Events).
- <code>toTransform(Frame)</code> or <code>toTransformForces(Frame)</code> : Transform from specified [{{JavaDoc3.3}}//org/orekit/frames/Frame.html Frame] to spacecraft frame (attitude used for forces computation which is the default attitude).
- <code>toTransformEvents(Frame)</code> : Transform from specified [{{JavaDoc3.3}}//org/orekit/frames/Frame.html Frame] to spacecraft frame attitude used for events computation (same as toTransform(Frame) if there is no attitude specific for Events).
- <code>toTransform(LOFType)</code> : Transform from orbit/attitude reference frame to local orbital frame ([{{JavaDoc3.3}}//org/orekit/frames/LOFType.html LOFType]).
- <code>toTransform(Frame, LOFType)</code> : Transform from specified [{{JavaDoc3.3}}''org/orekit/frames/Frame.html Frame] to local orbital frame ([{{JavaDoc3.3}}''org/orekit/frames/LOFType.html LOFType]).

Here after is presented the computation of a station position in spacecraft frame:
<syntaxhighlight lang="java">
// Station position defined in GCRF
final Vector3D station_InGCRF = new Vector3D(Constants.EGM96_EARTH_EQUATORIAL_RADIUS, 0, 0);
final Frame gcrf = FramesFactory.getGCRF();
// Compute transform from GCRF to spacecraft frame
final Transform transform = state.toTransform(gcrf);
// Station position in spacecraft frame
final Vector3D station_InSpacecraftFrame = transform.transformVector(station_InGCRF);
</syntaxhighlight>

Here after is presented the computation of the Sun direction in spacecraft frame.
<syntaxhighlight lang="java">
// Compute transform from orbit/attitude reference frame to local orbital frame TNW
final Transform transform = state.toTransform(LOFType.TNW);
// Position of Sun in local orbital frame TNW
final Vector3D pos = transform.transformPosition(sun.getPVCoordinates().getPosition());
</syntaxhighlight>
If an [{{JavaDoc3.3}}//fr/cnes/sirius/patrius/assembly/Assembly.html Assembly] is used, this is not necessary to use these methods because the conversion methods are included in Assembly functionalities (see [SPC_VBU_Home dedicated User Manual]).

== Getting Started ==
{{specialInclusion prefix=$theme_sub section="GettingStarted"/}}

== Contents ==
=== Interfaces ===
|=(% colspan="3" %)Interface|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc
|(% colspan="3" %)'''MassProvider'''|(% colspan="6" %)Interface providing the mass for spacecraft models.|[{{JavaDoc3.3}}/org/orekit/propagation/MassProvider.html ...]

=== Classes ===

|=(% colspan="3" %)Class|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc
|(% colspan="3" %)'''SpacecraftState'''|(% colspan="6" %)This class is the representation of a complete state holding orbit, attitude for forces and for events computation and additional states at a given date.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/propagation/SpacecraftState.html ...]
|(% colspan="3" %)'''Attitude'''|(% colspan="6" %)Object representing the attitude of the spacecraft for a specific date and in a specific frame.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/Attitude.html ...]

== Tutorials ==
=== Tutorial 1 ===

=== Tutorial 2 ===

== [[File:lightBulb.png]] Tips & Tricks ==
None yet.

← Version précédente		Version du 27 février 2018 à 08:56
Ligne 27 :		Ligne 27 :
	== Features Description ==		== Features Description ==
	=== One orbit ===		=== One orbit ===
	The [{{JavaDoc3.3}}''org/orekit/propagation/SpacecraftState.html SpacecraftState] is composed of one [{{JavaDoc3.3}}''org/orekit/orbits/Orbit.html Orbit].		The [{{JavaDoc3.3}}/org/orekit/propagation/SpacecraftState.html SpacecraftState] is composed of one [{{JavaDoc3.3}}/org/orekit/orbits/Orbit.html Orbit].
	It is possible to simply declare a SpacecraftState with an orbit :		It is possible to simply declare a SpacecraftState with an orbit :
	<code>final SpacecraftState state = new SpacecraftState(orbit);</code>		<code>final SpacecraftState state = new SpacecraftState(orbit);</code>
Ligne 36 :		Ligne 36 :

	=== Two attitudes ===		=== Two attitudes ===
	The user can use one single [{{JavaDoc3.3}}''org/orekit/attitudes/Attitude.html Attitude] or two different [{{JavaDoc3.3}}''org/orekit/attitudes/Attitude.html Attitude] objects : one for forces computation and one for events computation. The following constructor can be used :		The user can use one single [{{JavaDoc3.3}}/org/orekit/attitudes/Attitude.html Attitude] or two different [{{JavaDoc3.3}}/org/orekit/attitudes/Attitude.html Attitude] objects : one for forces computation and one for events computation. The following constructor can be used :

	<code>final SpacecraftState state = new SpacecraftState(orbit, attitudeForces, attitudeEvents);</code>		<code>final SpacecraftState state = new SpacecraftState(orbit, attitudeForces, attitudeEvents);</code>
Ligne 61 :		Ligne 61 :
	SpacecraftState state = new SpacecraftState(orbit, attitudeForces, attitudeEvents, addStates); </syntaxhighlight>		SpacecraftState state = new SpacecraftState(orbit, attitudeForces, attitudeEvents, addStates); </syntaxhighlight>

	It is possible to add an additional state to a SpacecraftState using'''''addAdditionalState''''':		It is possible to add an additional state to a SpacecraftState using '''''addAdditionalState''''':

	<code>state2 = state.addAdditionalState("name2", new double[]{0.1, 0.1});</code>		<code>state2 = state.addAdditionalState("name2", new double[]{0.1, 0.1});</code>

	Note :'''''addAdditionalState''''' returns a new SpacecraftState with the added additional state. It is necessary to store the returned object. The additional state is not added to the current state.		Note : '''''addAdditionalState''''' returns a new SpacecraftState with the added additional state. It is necessary to store the returned object. The additional state is not added to the current state.

	=== Mass ===		=== Mass ===
Ligne 100 :		Ligne 100 :

	=== Transform ===		=== Transform ===
	The [{{JavaDoc3.3}}//org/orekit/propagation/SpacecraftState.html SpacecraftState] class contains methods to compute the following transformations :		The [{{JavaDoc3.3}}//org/orekit/propagation/SpacecraftState.html SpacecraftState] class contains methods to compute the following transformations :<br>
	- <code>toTransform()</code> or <code>toTransformForces()</code> : Transform from orbit/attitude reference frame to spacecraft frame (attitude used for forces computation which is the default attitude).		- <code>toTransform()</code> or <code>toTransformForces()</code> : Transform from orbit/attitude reference frame to spacecraft frame (attitude used for forces computation which is the default attitude).<br>
	- <code>toTransformEvents()</code> : Transform from orbit/attitude reference frame to spacecraft frame attitude used for events computation (same as toTransform if there is no specific attitude for Events).		- <code>toTransformEvents()</code> : Transform from orbit/attitude reference frame to spacecraft frame attitude used for events computation (same as toTransform if there is no specific attitude for Events).<br>
	- <code>toTransform(Frame)</code> or <code>toTransformForces(Frame)</code> : Transform from specified [{{JavaDoc3.3}}//org/orekit/frames/Frame.html Frame] to spacecraft frame (attitude used for forces computation which is the default attitude).		- <code>toTransform(Frame)</code> or <code>toTransformForces(Frame)</code> : Transform from specified [{{JavaDoc3.3}}//org/orekit/frames/Frame.html Frame] to spacecraft frame (attitude used for forces computation which is the default attitude).<br>
	- <code>toTransformEvents(Frame)</code> : Transform from specified [{{JavaDoc3.3}}//org/orekit/frames/Frame.html Frame] to spacecraft frame attitude used for events computation (same as toTransform(Frame) if there is no attitude specific for Events).		- <code>toTransformEvents(Frame)</code> : Transform from specified [{{JavaDoc3.3}}//org/orekit/frames/Frame.html Frame] to spacecraft frame attitude used for events computation (same as toTransform(Frame) if there is no attitude specific for Events).<br>
	- <code>toTransform(LOFType)</code> : Transform from orbit/attitude reference frame to local orbital frame ([{{JavaDoc3.3}}//org/orekit/frames/LOFType.html LOFType]).		- <code>toTransform(LOFType)</code> : Transform from orbit/attitude reference frame to local orbital frame ([{{JavaDoc3.3}}//org/orekit/frames/LOFType.html LOFType]).<br>
	- <code>toTransform(Frame, LOFType)</code> : Transform from specified [{{JavaDoc3.3}}''org/orekit/frames/Frame.html Frame] to local orbital frame ([{{JavaDoc3.3}}''org/orekit/frames/LOFType.html LOFType]).		- <code>toTransform(Frame, LOFType)</code> : Transform from specified [{{JavaDoc3.3}}/org/orekit/frames/Frame.html Frame] to local orbital frame ([{{JavaDoc3.3}}/org/orekit/frames/LOFType.html LOFType]).

	Here after is presented the computation of a station position in spacecraft frame:		Here after is presented the computation of a station position in spacecraft frame:

User Manual 3.3 SpacecraftState - Historique des versions

Admin : /* Transform */

Admin : /* Links */

Admin : /* Contents */

Admin : /* Features Description */

Admin : /* Overview */

Admin : Admin a déplacé la page SpacecraftState vers User Manual 3.3 SpacecraftState sans laisser de redirection

Admin : 1 révision importée