User Manual 3.3 Events: orbital - Historique des versions

Admin : Annulation des modifications 1419 de Admin (discussion)

2018-03-05T10:39:41Z

Annulation des modifications 1419 de Admin (discussion)

Voir les modifications

Admin le 5 mars 2018 à 10:37

2018-03-05T10:37:30Z

Voir les modifications

Admin : /* Javadoc */

2018-02-27T16:25:52Z

Javadoc

← Version précédente		Version du 27 février 2018 à 16:25
Ligne 8 :		Ligne 8 :
	Those event detectors are available in the packages :		Those event detectors are available in the packages :

			{\| class="wikitable"
	\|=Library\|=Javadoc		\|-
	\|Orekit \|[{{JavaDoc3.3}}/org/orekit/propagation/events/package-summary.html Package org.orekit.propagation.event]		! scope="col"\| Library
	\|Patrius \|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/events/package-summary.html Package fr.cnes.sirius.patrius.events]		! scope="col"\| Javadoc
			\|-
			\|Orekit
			\|[{{JavaDoc3.3}}/org/orekit/propagation/events/package-summary.html Package org.orekit.propagation.event]
			\|-
			\|Patrius
			\|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/events/package-summary.html Package fr.cnes.sirius.patrius.events]
			\|}

	== Features Description ==		== Features Description ==

Admin : /* Contents */

2018-02-27T16:24:02Z

Contents

@@ Ligne 297 : / Ligne 297 : @@
 All the detectors implement the interface :
-|=Interface|=Summary|=Javadoc
+{| class="wikitable"
-| EventDetector|This interface represents an event finder.|[{{JavaDoc3.3}}/org/orekit/propagation/events/EventDetector.html EventDetector ]
+|-
-=== Classes ===
+{| class="wikitable"
-|=Classe|=Summary|=Javadoc
+|-
-| AlignmentDetector|This class handles (satellite/central body/projection in the orbital plane of secondary body) alignment events.|[{{JavaDoc3.3}}/org/orekit/propagation/events/AlignmentDetector.html AlignmentDetector]
+! scope="col"| Class
-| AltitudeDetector|This class handles satellite altitude crossing events.|[{{JavaDoc3.3}}/org/orekit/propagation/events/AltitudeDetector.html AltitudeDetector]
+! scope="col"| Summary
-| ApsideDetector|This class handles satellite apogee and perigee crossing events.|[{{JavaDoc3.3}}/org/orekit/propagation/events/ApsideDetector.html ApsideDetector]
+! scope="col"| Javadoc
-| DateDetector|This class handles the occurrence of predefined dates.|[{{JavaDoc3.3}}/org/orekit/propagation/events/DateDetector.html DateDetector]
+|-
-| EclipseDetector|This class handles total or partial eclipse events.|[{{JavaDoc3.3}}/org/orekit/propagation/events/EclipseDetector.html EclipseDetector]
+| AlignmentDetector
-| NodeDetector|This class handles satellite equator crossing events.|[{{JavaDoc3.3}}/org/orekit/propagation/events/NodeDetector.html NodeDetector]
+|This class handles (satellite/central body/projection in the orbital plane of secondary body) alignment events.
-| DistanceDetector|This class handles events relating to the distance between the satellite and a given body.|[{{JavaDoc3.3}}/org/orekit/propagation/events/DistanceDetector.html DistanceDetector]
+|[{{JavaDoc3.3}}/org/orekit/propagation/events/AlignmentDetector.html AlignmentDetector]
-| ExtremaDistanceDetector|This class handles events representing the reaching of extrema for the distance to a given body.|[{{JavaDoc3.3}}/org/orekit/propagation/events/ExtremaDistanceDetector.html ExtremaDistanceDetector]
+|-
-| ExtremaLatitudeDetector|This class handles events representing the reaching of extrema for the geodetic latitude.|[{{JavaDoc3.3}}/org/orekit/propagation/events/ExtremaLatitudeDetector.html ExtremaLatitudeDetector]
+| AltitudeDetector
-| ExtremaLongitudeDetector|This class handles events representing the reaching of extrema for the longitude.|[{{JavaDoc3.3}}/org/orekit/propagation/events/ExtremaLongitudeDetector.html ExtremaLongitudeDetector]
+|This class handles satellite altitude crossing events.
-| LatitudeDetector|This class handles events representing the reaching of a given geodetic latitude, the earth shape being known.|[{{JavaDoc3.3}}/org/orekit/propagation/events/LatitudeDetector.html LatitudeDetector]
+|[{{JavaDoc3.3}}/org/orekit/propagation/events/AltitudeDetector.html AltitudeDetector]
-| LongitudeDetector|This class handles events representing the reaching of a given longitude|[{{JavaDoc3.3}}/org/orekit/propagation/events/LongitudeDetector.html LongitudeDetector]
+|-
-| AnomalyDetector|This class handles events representing the reaching of an anomaly angle.|[{{JavaDoc3.3}}/org/orekit/propagation/events/AnomalyDetector.html AnomalyDetector]
+| ApsideDetector
-| AOLDetector|This class handles events representing the reaching of an argument of latitude value.|[{{JavaDoc3.3}}/org/orekit/propagation/events/AOLDetector.html AOLDetector]
+|This class handles satellite apogee and perigee crossing events.
-| ThreeBodiesAngleDetector|This class handles events representing the reaching of a predetermined angle between three bodies.|[{{JavaDoc3.3}}/org/orekit/propagation/events/ThreeBodiesAngleDetector.html ThreeBodiesAngleDetector]
+|[{{JavaDoc3.3}}/org/orekit/propagation/events/ApsideDetector.html ApsideDetector]
-| ExtremaThreeBodiesAngleDetector|This class handles events representing the reaching of of extrema for the angle between three bodies.|[{{JavaDoc3.3}}/org/orekit/propagation/events/ExtremaThreeBodiesAngleDetector.html ExtremaThreeBodiesAngleDetector]
+|-
-| BetaAngleDetector|This class handles the event : reaching a given beta angle value for a spacecraft.|[{{JavaDoc3.3}}/org/orekit/propagation/events/BetaAngleDetector.html BetaAngleDetector]
+| DateDetector
-| LocalTimeDetector|This class handles events representing the reaching of a predetermined spacecraft local time.|[{{JavaDoc3.3}}/org/orekit/propagation/events/LocalTimeDetector.html LocalTimeDetector]
+|This class handles the occurrence of predefined dates.
-| SolarTimeDetector|This class handles events representing the reaching of a predetermined spacecraft solar time.|[{{JavaDoc3.3}}/org/orekit/propagation/events/SolarTimeDetector.html SolarTimeDetector]
+|[{{JavaDoc3.3}}/org/orekit/propagation/events/DateDetector.html DateDetector]
-| NadirSolarIncidenceDetector|This class handles events representing the reaching of a predetermined spacecraft nadir point solar incidence.|[{{JavaDoc3.3}}/org/orekit/propagation/events/NadirSolarIncidenceDetector.html NadirSolarIncidenceDetector]
+|-
-| EarthZoneDetector|This class handles events representing the entering and leaving of earth zones.|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/events/EarthZoneDetector.html EarthZoneDetector]
+| EclipseDetector
 == Tutorials ==

Admin : /* EarthZoneDetector */

2018-02-27T16:21:06Z

EarthZoneDetector

← Version précédente		Version du 27 février 2018 à 16:21
Ligne 269 :		Ligne 269 :

	The zones can be described two ways :		The zones can be described two ways :
	* As an array of {latitude, longitudes} that define the geodetic points with a zero altitude on a BodyShape. With this definition, the test made will be the entering of the spacecraft's NADIR point in the zone.		* As an array of {latitude, longitudes} that define the geodetic points with a zero altitude on a BodyShape. With this definition, the test made will be the entering of the spacecraft's NADIR point in the zone.<br>
	* As an array of vectors expressed in a given frame. With this definition, the entering of the spacecraft itself in the conic field from the center of the given frame to those points will be detected. Note that the given frame must be a terrestrial frame for the detection of earth zones entering, but the use of other frames is possible (other bodies, inertial frames…).		* As an array of vectors expressed in a given frame. With this definition, the entering of the spacecraft itself in the conic field from the center of the given frame to those points will be detected. Note that the given frame must be a terrestrial frame for the detection of earth zones entering, but the use of other frames is possible (other bodies, inertial frames…).

Admin : /* NadirSolarIncidenceDetector */

2018-02-27T16:20:48Z

NadirSolarIncidenceDetector

← Version précédente		Version du 27 février 2018 à 16:20
Ligne 259 :		Ligne 259 :
	==== NadirSolarIncidenceDetector ====		==== NadirSolarIncidenceDetector ====

	The <code>NadirSolarIncidenceDetector</code> detects when the solar incidence, seen from the nadir point of the spacecraft, reaches a predetermined value.		The <code>NadirSolarIncidenceDetector</code> detects when the solar incidence, seen from the nadir point of the spacecraft, reaches a predetermined value.<br>
	The solar incidence is the angle between the nadir- satellite vector and the nadir - sun vector.		The solar incidence is the angle between the nadir- satellite vector and the nadir - sun vector.

	[[File:nadirsolarincidence.png\|center]]		[[File:nadirsolarincidence.png\|center]]


	==== EarthZoneDetector ====		==== EarthZoneDetector ====

Admin : /* SolarTimeDetector */

2018-02-27T16:20:39Z

SolarTimeDetector

← Version précédente		Version du 27 février 2018 à 16:20
Ligne 250 :		Ligne 250 :
	==== SolarTimeDetector ====		==== SolarTimeDetector ====

	The <code>SolarTimeDetector</code> detects when the spacecraft solar time is equal to a predetermined value; the spacecraft solar time is the angle between the the Earth-Sun projection in the orbital plane and the Earth-spacecraft vector. The solar time angle is zero at 12.00h and is PI at 0.00h.		The <code>SolarTimeDetector</code> detects when the spacecraft solar time is equal to a predetermined value; the spacecraft solar time is the angle between the the Earth-Sun projection in the orbital plane and the Earth-spacecraft vector. The solar time angle is zero at 12.00h and is PI at 0.00h. <br>
	The solar time is always increasing with time. It is mesured around the orbit momentum.		The solar time is always increasing with time. It is mesured around the orbit momentum.

	The g switching function returns the sinus of the difference between the spacecraft current solar time <math>\theta</math> and the threshold solar time value <math>\theta_{t}</math>:		The g switching function returns the sinus of the difference between the spacecraft current solar time <math>\theta</math> and the threshold solar time value <math>\theta_{t}</math>:<br>
	<math>g=sin(\theta- \theta_{t})</math>		<math>g=sin(\theta- \theta_{t})</math><br>
	Like the <code>AOLDetector</code>, a solar time event is triggered only if the g-function slope is positive at its zero.		Like the <code>AOLDetector</code>, a solar time event is triggered only if the g-function slope is positive at its zero.

Admin : /* ExtremaThreeBodiesAngleDetector */

2018-02-27T16:18:49Z

ExtremaThreeBodiesAngleDetector

← Version précédente		Version du 27 février 2018 à 16:18
Ligne 220 :		Ligne 220 :

	==== ExtremaThreeBodiesAngleDetector ====		==== ExtremaThreeBodiesAngleDetector ====
	The <code>ExtremaThreeBodiesAngleDetector</code> detects when the angle between three bodies (defined the same way as in the <code>ThreeBodiesAngleDetector</code>) reaches its minimal or maximal value.		The <code>ExtremaThreeBodiesAngleDetector</code> detects when the angle between three bodies (defined the same way as in the <code>ThreeBodiesAngleDetector</code>) reaches its minimal or maximal value.<br>
	The choice of the detected extremum (maximum, minimum, or both) is done with the constructor, through the <code>extremumType</code> parameter.		The choice of the detected extremum (maximum, minimum, or both) is done with the constructor, through the <code>extremumType</code> parameter.

	The g switching function returns the derivative of the angle value (in fact, part of the derivative : a factor with a		The g switching function returns the derivative of the angle value (in fact, part of the derivative : a factor with a
	constant sign has been ignored).		constant sign has been ignored).<br>
	This derivative is obtained by expressing all the positions and velocities of the two extreme points (<math>P_{1}</math> and <math>P_{3}</math>) in a frame linked to the one at the angle origin (<math>P_{2}</math>).		This derivative is obtained by expressing all the positions and velocities of the two extreme points (<math>P_{1}</math> and <math>P_{3}</math>) in a frame linked to the one at the angle origin (<math>P_{2}</math>).<br>
	If the two vectors from the new origin are <math>\vec{P_{21}}</math> and <math>\vec{P_{23}}</math> the angle expression is : <math>\arccos(\vec{P_{21}}.\vec{P_{23}} / (\|\vec{P_{21}}\|.\|\vec{P_{23}}\|))</math>		If the two vectors from the new origin are <math>\vec{P_{21}}</math> and <math>\vec{P_{23}}</math> the angle expression is : <math>\arccos(\vec{P_{21}}.\vec{P_{23}} / (\|\vec{P_{21}}\|.\|\vec{P_{23}}\|))</math><br>
	Once derivated as <math>(gof)' = (g'of).f'</math> and the <math>arccos</math> derivative being always negative, the switching function is minus the derivative of the inner expression <math>\vec{P_{21}}.\vec{P_{23}} / (\|\vec{P_{21}}\|.\|\vec{P_{23}}\|)</math>.		Once derivated as <math>(gof)' = (g'of).f'</math> and the <math>arccos</math> derivative being always negative, the switching function is minus the derivative of the inner expression <math>\vec{P_{21}}.\vec{P_{23}} / (\|\vec{P_{21}}\|.\|\vec{P_{23}}\|)</math>.


	==== BetaAngleDetector ====		==== BetaAngleDetector ====

Admin : /* ThreeBodiesAngleDetector */

2018-02-27T16:18:32Z

ThreeBodiesAngleDetector

← Version précédente		Version du 27 février 2018 à 16:18
Ligne 212 :		Ligne 212 :
	==== ThreeBodiesAngleDetector ====		==== ThreeBodiesAngleDetector ====

	The <code>ThreeBodiesAngleDetector</code> detects when the angle between three bodies (they can be celestial bodies, spacecrafts, ground stations, ...) is equal to a predetermined value.		The <code>ThreeBodiesAngleDetector</code> detects when the angle between three bodies (they can be celestial bodies, spacecrafts, ground stations, ...) is equal to a predetermined value.<br>
	If <math>\vec{P_{1}}</math>, <math>\vec{P_{2}}</math> and <math>\vec{P_{3}}</math> are the positions of the three bodies, and <math>\vec{P_{21}}</math> is the difference <math>\vec{P_{2}}-\vec{P_{1}}</math> and <math>\vec{P_{23}}</math> the difference <math>\vec{P_{2}}-\vec{P_{3}}</math>, the computed angle will be: <math>\widehat{\vec{P_{21}} \vec{P_{23}}}</math>		If <math>\vec{P_{1}}</math>, <math>\vec{P_{2}}</math> and <math>\vec{P_{3}}</math> are the positions of the three bodies, and <math>\vec{P_{21}}</math> is the difference <math>\vec{P_{2}}-\vec{P_{1}}</math> and <math>\vec{P_{23}}</math> the difference <math>\vec{P_{2}}-\vec{P_{3}}</math>, the computed angle will be: <math>\widehat{\vec{P_{21}} \vec{P_{23}}}</math>

Admin : /* AnomalyDetector */

2018-02-27T16:18:13Z

AnomalyDetector

← Version précédente		Version du 27 février 2018 à 16:18
Ligne 200 :		Ligne 200 :
	==== AnomalyDetector ====		==== AnomalyDetector ====

	The <code>AnomalyDetector</code> detects when the spacecraft reaches a predetermined anomaly; the anomaly is the angle between the spacecraft position and the perigee.		The <code>AnomalyDetector</code> detects when the spacecraft reaches a predetermined anomaly; the anomaly is the angle between the spacecraft position and the perigee.<br>
	Three types of anomaly can be detected: true, mean and eccentric anomaly.		Three types of anomaly can be detected: true, mean and eccentric anomaly.

	The g switching function returns the sinus of the difference between the spacecraft current anomaly and the threshold anomaly value:		The g switching function returns the sinus of the difference between the spacecraft current anomaly and the threshold anomaly value:<br>
	<math>g=sin(\alpha- \alpha_{input})</math>		<math>g=sin(\alpha- \alpha_{input})</math><br>
	(This g function is identical to the AOLDetector g function).		(This g function is identical to the AOLDetector g function).<br>
	Like the <code>AOLDetector</code>, an anomaly event is triggered only if the g-function slope is positive at its zero.		Like the <code>AOLDetector</code>, an anomaly event is triggered only if the g-function slope is positive at its zero.

User Manual 3.3 Events: orbital - Historique des versions

Admin : Annulation des modifications 1419 de Admin (discussion)

Admin le 5 mars 2018 à 10:37

Admin : /* Javadoc */

Admin : /* Contents */

Admin : /* EarthZoneDetector */

Admin : /* NadirSolarIncidenceDetector */

Admin : /* SolarTimeDetector */

Admin : /* ExtremaThreeBodiesAngleDetector */

Admin : /* ThreeBodiesAngleDetector */

Admin : /* AnomalyDetector */