User Manual 4.14 Multi events detection - Historique des versions

Admin tsn le 5 septembre 2024 à 15:26

2024-09-05T15:26:18Z

Admin tsn : Page créée avec « == Introduction == === Scope === Here are presented all the multi events detectors that could be used in multi propagation. === Javadoc === Those event detectors are avai... »

2024-09-02T08:03:58Z

Page créée avec « == Introduction == === Scope === Here are presented all the multi events detectors that could be used in multi propagation. === Javadoc === Those event detectors are avai... »

Nouvelle page

== Introduction ==
=== Scope ===
Here are presented all the multi events detectors that could be used in multi propagation.

=== Javadoc ===
Those event detectors are available in the packages :

{| class="wikitable"
|-
! scope="col"| Library
! scope="col"| Javadoc
|-
|Patrius
|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/package-summary.html Package fr.cnes.sirius.patrius.propagation.event]
|-
|Patrius
|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/events/package-summary.html Package fr.cnes.sirius.patrius.events]
|}

=== Links ===
See :
* [ORB_MPRO_Home Multi propagation chapter]
* [MIS_EVT_Home Events detection introduction chapter]

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

=== Package Overview ===
None as of now.

== Features Description ==
=== Multi events detectors ===
The following events detectors could be used in mono and multi spacecraft propagation :
* [{{JavaDoc4.13}}//fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]
* [{{JavaDoc4.13}}//fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
* [{{JavaDoc4.13}}//fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]

These three detectors extends [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/AbstractDetector.html AbstractDetector] and implements [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/multi/MultiEventDetector.html MultiEventDetector].

Using [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/numerical/multi/MultiNumericalPropagator.html multi numerical propagator], all states concerned by the detection are recovered from the global state vector.<br>
Using one of the [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/Propagator.html mono propagator] (analytical or numerical), the main state is recovered from the propagation. The others states concerned by the detection are recovered from a PVCoordinatesProvider.

The meaning of the g switching function for the concerned event detectors, and their particularities are presented in dedicated chapter :
* [MIS_ORB_Home Orbit determination events chapter]for [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector] and [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
* [MIS_STASAT_Home Ground stations and satellites events] for [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]

== Getting Started ==
In multi numerical propagation case, the states concerned by the detection are identified with their ID. Specific constructors should be used in multi numerical propagation case.<br>
These constructors take as parameter the ID of states concerned by the detection.

Here after is presented the instanciation of a SatToSatMutualVisibilityDetectorin multi propagation case :

<syntaxhighlight lang="java">
// Initialize multi numerical propagator
final FirstOrderIntegrator integratorMultiSat = new DormandPrince853Integrator(.1, 60, 1e-9, 1e-9);
MultiNumericalPropagator mainPropagator = new MultiNumericalPropagator(integratorMultiSat);
mainPropagator.addInitialState(mainState, STATE1);
mainPropagator.addInitialState(secondaryState, STATE2);
mainPropagator.setAttitudeProvider(attitudeProv, STATE1);
mainPropagator.setAttitudeProvider(attitudeProv, STATE2);

// Note that the NumericalPropagator and the MultiNumericalPropagator do not use anymore the Newtonian gravity model by default. It should now be added manually to the list of the force models before starting the propagation.
mainPropagator.addForceModel(new DirectBodyAttraction(new NewtonianGravityModel(mainState.getMu(), STATE1));
mainPropagator.addForceModel(new DirectBodyAttraction(new NewtonianGravityModel(secondaryState.getMu(), STATE2));

// Create SatToSatMultualVisibilityDetector
final MultiEventDetector detector = new SatToSatMutualVisibilityDetector(STATE1, STATE2, mainSpacecraftSensorModel1, secondarySpacecraftSensorModel2, false, 0.01, 10.e-10);

// Add detector
mainPropagator.addEventDetector(detector1);

// propagate
Map<String, SpacecraftState> endStates = mainPropagator.propagate(date.shiftedBy(duration));
</syntaxhighlight>

If a wrong constructor is used, i.e a constructor for mono propagation, an exception will be raised during propagation.

== Contents ==
=== Interfaces ===

{| class="wikitable"
|-
! scope="col"| Interface
! scope="col"| Summary
! scope="col"| Javadoc
|-
| EventDetector
|This interface represents an event finder.
|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/EventDetector.html EventDetector ]
|-
| MultiEventDetector
|This interface represents an event finder in multi propagation case.
|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/multi/MultiEventDetector.html MultiEventDetector]
|}

=== Classes ===

{| class="wikitable"
|-
! scope="col"| Class
! scope="col"| Summary
! scope="col"| Javadoc
|-
| ThreeBodiesAngleDetector
|This class handles events representing the reaching of a predetermined angle between three bodies.
|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]
|-
| ExtremaThreeBodiesAngleDetector
|This class handles events representing the reaching of of extrema for the angle between three bodies.
|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
|-
| SatToSatMutualVisibilityDetector
|This class handles events representing the mutual visibility between two spacecraft's sensors.
|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]
|}

[[Category:User_Manual_4.14_Mission]]

← Version précédente		Version du 5 septembre 2024 à 15:26
Ligne 12 :		Ligne 12 :
	\|-		\|-
	\|Patrius		\|Patrius
	\|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/package-summary.html Package fr.cnes.sirius.patrius.propagation.event]		\|[{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/package-summary.html Package fr.cnes.sirius.patrius.propagation.event]
	\|-		\|-
	\|Patrius		\|Patrius
	\|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/events/package-summary.html Package fr.cnes.sirius.patrius.events]		\|[{{JavaDoc4.14}}/fr/cnes/sirius/patrius/events/package-summary.html Package fr.cnes.sirius.patrius.events]
	\|}		\|}

Ligne 32 :		Ligne 32 :
	=== Multi events detectors ===		=== Multi events detectors ===
	The following events detectors could be used in mono and multi spacecraft propagation :		The following events detectors could be used in mono and multi spacecraft propagation :
	* [{{JavaDoc4.13}}//fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]		* [{{JavaDoc4.14}}//fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]
	* [{{JavaDoc4.13}}//fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]		* [{{JavaDoc4.14}}//fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
	* [{{JavaDoc4.13}}//fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]		* [{{JavaDoc4.14}}//fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]

	These three detectors extends [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/AbstractDetector.html AbstractDetector] and implements [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/multi/MultiEventDetector.html MultiEventDetector].		These three detectors extends [{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/AbstractDetector.html AbstractDetector] and implements [{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/multi/MultiEventDetector.html MultiEventDetector].

	Using [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/numerical/multi/MultiNumericalPropagator.html multi numerical propagator], all states concerned by the detection are recovered from the global state vector.<br>		Using [{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/numerical/multi/MultiNumericalPropagator.html multi numerical propagator], all states concerned by the detection are recovered from the global state vector.<br>
	Using one of the [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/Propagator.html mono propagator] (analytical or numerical), the main state is recovered from the propagation. The others states concerned by the detection are recovered from a PVCoordinatesProvider.		Using one of the [{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/Propagator.html mono propagator] (analytical or numerical), the main state is recovered from the propagation. The others states concerned by the detection are recovered from a PVCoordinatesProvider.

	The meaning of the g switching function for the concerned event detectors, and their particularities are presented in dedicated chapter :		The meaning of the g switching function for the concerned event detectors, and their particularities are presented in dedicated chapter :
	* [MIS_ORB_Home Orbit determination events chapter]for [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector] and [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]		* [MIS_ORB_Home Orbit determination events chapter]for [{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector] and [{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
	* [MIS_STASAT_Home Ground stations and satellites events] for [{{JavaDoc4.13}}/fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]		* [MIS_STASAT_Home Ground stations and satellites events] for [{{JavaDoc4.14}}/fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]

	== Getting Started ==		== Getting Started ==
Ligne 87 :		Ligne 87 :
	\| EventDetector		\| EventDetector
	\|This interface represents an event finder.		\|This interface represents an event finder.
	\|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/EventDetector.html EventDetector ]		\|[{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/EventDetector.html EventDetector ]
	\|-		\|-
	\| MultiEventDetector		\| MultiEventDetector
	\|This interface represents an event finder in multi propagation case.		\|This interface represents an event finder in multi propagation case.
	\|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/multi/MultiEventDetector.html MultiEventDetector]		\|[{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/multi/MultiEventDetector.html MultiEventDetector]
	\|}		\|}

Ligne 104 :		Ligne 104 :
	\| ThreeBodiesAngleDetector		\| ThreeBodiesAngleDetector
	\|This class handles events representing the reaching of a predetermined angle between three bodies.		\|This class handles events representing the reaching of a predetermined angle between three bodies.
	\|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]		\|[{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]
	\|-		\|-
	\| ExtremaThreeBodiesAngleDetector		\| ExtremaThreeBodiesAngleDetector
	\|This class handles events representing the reaching of of extrema for the angle between three bodies.		\|This class handles events representing the reaching of of extrema for the angle between three bodies.
	\|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]		\|[{{JavaDoc4.14}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
	\|-		\|-
	\| SatToSatMutualVisibilityDetector		\| SatToSatMutualVisibilityDetector
	\|This class handles events representing the mutual visibility between two spacecraft's sensors.		\|This class handles events representing the mutual visibility between two spacecraft's sensors.
	\|[{{JavaDoc4.13}}/fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]		\|[{{JavaDoc4.14}}/fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]
	\|}		\|}

	[[Category:User_Manual_4.14_Mission]]		[[Category:User_Manual_4.14_Mission]]

User Manual 4.14 Multi events detection - Historique des versions

Admin tsn le 5 septembre 2024 à 15:26

Admin tsn : Page créée avec « == Introduction == === Scope === Here are presented all the multi events detectors that could be used in multi propagation. === Javadoc === Those event detectors are avai... »

Admin tsn : Page créée avec « == Introduction == === Scope === Here are presented all the multi events detectors that could be used in multi propagation. === Javadoc === Those event detectors are avai... »