Admin : 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... »

2022-05-06T07:40:47Z

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.9}}/fr/cnes/sirius/patrius/propagation/events/package-summary.html Package fr.cnes.sirius.patrius.propagation.event]
|-
|Patrius
|[{{JavaDoc4.9}}/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.9}}//fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]
* [{{JavaDoc4.9}}//fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
* [{{JavaDoc4.9}}//fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]

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

Using [{{JavaDoc4.9}}/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.9}}/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.9}}/fr/cnes/sirius/patrius/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector] and [{{JavaDoc4.9}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
* [MIS_STASAT_Home Ground stations and satellites events] for [{{JavaDoc4.9}}/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);

// 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.9}}/fr/cnes/sirius/patrius/propagation/events/EventDetector.html EventDetector ]
|-
| MultiEventDetector
|This interface represents an event finder in multi propagation case.
|[{{JavaDoc4.9}}/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.9}}/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.9}}/fr/cnes/sirius/patrius/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
|-
| SatToSatMutualVisibilityDetector
|This class handles events representing the mutual visibility between two spacecraft's sensors.
|[{{JavaDoc4.9}}/fr/cnes/sirius/patrius/events/sensor/SatToSatMutualVisibilityDetector.html SatToSatMutualVisibilityDetector]
|}

[[Category:User_Manual_4.9_Mission]]

User Manual 4.9 Multi events detection - Historique des versions

Admin : 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 : 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... »