User Manual 3.3 Angles and Intervals - Historique des versions

Admin : /* Javadoc */

2018-03-01T14:54:52Z

Javadoc

← Version précédente		Version du 1 mars 2018 à 14:54
Ligne 12 :		Ligne 12 :
	\|Patrius		\|Patrius
	\|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/package-summary.html Package fr.cnes.sirius.patrius.utils]		\|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/package-summary.html Package fr.cnes.sirius.patrius.utils]
			\|-
	\|Orekit addons		\|Orekit addons
	\|[{{JavaDoc3.3}}/org/orekit/utils/package-summary.html Package org.orekit.utils]		\|[{{JavaDoc3.3}}/org/orekit/utils/package-summary.html Package org.orekit.utils]

Admin le 1 mars 2018 à 14:54

2018-03-01T14:54:38Z

← Version précédente		Version du 1 mars 2018 à 14:54
Ligne 5 :		Ligne 5 :
	=== Javadoc ===		=== Javadoc ===
	The angle-related objects are available in the package <code>fr.cnes.sirius.patrius.utils</code> in the PATRIUS library. The class defining an interval end point, though, is in the package <code>org.orekit.utils</code> from orekit-addons.		The angle-related objects are available in the package <code>fr.cnes.sirius.patrius.utils</code> in the PATRIUS library. The class defining an interval end point, though, is in the package <code>org.orekit.utils</code> from orekit-addons.
	\|=Library\|=Javadoc		{\| class="wikitable"
	\|Patrius \|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/package-summary.html Package fr.cnes.sirius.patrius.utils]		\|-
	\|Orekit addons \|[{{JavaDoc3.3}}/org/orekit/utils/package-summary.html Package org.orekit.utils]		! scope="col"\| Library
			! scope="col"\| Javadoc
			\|-
			\|Patrius
			\|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/package-summary.html Package fr.cnes.sirius.patrius.utils]
			\|Orekit addons
			\|[{{JavaDoc3.3}}/org/orekit/utils/package-summary.html Package org.orekit.utils]
			\|}

	=== Links ===		=== Links ===

Admin : /* Classes */

2018-02-27T09:42:02Z

Classes

← Version précédente		Version du 27 février 2018 à 09:42
Ligne 123 :		Ligne 123 :
	=== Classes ===		=== Classes ===
	Here is a summary of the most important classes :		Here is a summary of the most important classes :
			{\| class="wikitable"
	\|=Class\|=~~Summary~~\|=Javadoc		\|-
	\|'''IntervalEndpointType'''\|Defines an interval end point as OPEN or CLOSED.\|[{{JavaDoc3.3}}/org/orekit/~~utils~~/IntervalEndpointType.html ...]		! scope="col"\| Class
	\|'''AngleInterval'''\|Implements an interval of angles, taking angles' modulus into account.\|[{{JavaDoc3.3}}/fr/~~cnes~~/~~sirius~~/~~patrius/utils~~/AngleInterval.html ...]		! scope="col"\| Summary
	\|'''AngleTools'''\|Provides several angle-related utility methods.\|[{{JavaDoc3.3}}/fr/~~cnes~~/~~sirius~~/~~patrius/utils~~/AngleTools.html ...]		! scope="col"\| Javadoc
	\|'''GenericInterval'''\|Implements a generic interval.\|[{{JavaDoc3.3}}/fr/~~cnes~~/~~sirius~~/~~patrius/utils~~/GenericInterval.html ...]		\|-
	\|'''AbsoluteDateInterval'''\|This class implements an interval based on the AbsoluteDate class using the ComparableInterval class.\|[{{JavaDoc3.3}}/org/orekit/~~utils~~/AbsoluteDateInterval.html ...]		\|'''IntervalEndpointType'''
	\|'''ComparableInterval'''\|The class describe an interval of Comparable data.\|[{{JavaDoc3.3}}/org/orekit/~~utils~~/ComparableInterval.html ...]		\|Defines an interval end point as OPEN or CLOSED.
			\|[{{JavaDoc3.3}}/org/orekit/math/interval/IntervalEndpointType.html ...]
			\|-
			\|'''AngleInterval'''
			\|Implements an interval of angles, taking angles' modulus into account.
			\|[{{JavaDoc3.3}}/org/orekit/math/interval/AngleInterval.html ...]
			\|-
			\|'''AngleTools'''
			\|Provides several angle-related utility methods.
			\|[{{JavaDoc3.3}}/org/orekit/math/interval/AngleTools.html ...]
			\|-
			\|'''GenericInterval'''
			\|Implements a generic interval.
			\|[{{JavaDoc3.3}}/org/orekit/math/interval/GenericInterval.html ...]
			\|-
			\|'''AbsoluteDateInterval'''
			\|This class implements an interval based on the AbsoluteDate class using the ComparableInterval class.
			\|[{{JavaDoc3.3}}/org/orekit/time/AbsoluteDateInterval.html ...]
			\|-
			\|'''ComparableInterval'''
			\|The class describe an interval of Comparable data.
			\|[{{JavaDoc3.3}}/org/orekit/math/interval/ComparableInterval.html ...]
			\|}

	=== Angle intervals ===		=== Angle intervals ===

Admin le 27 février 2018 à 09:40

2018-02-27T09:40:31Z

← Version précédente		Version du 27 février 2018 à 09:40
Ligne 254 :		Ligne 254 :
	== [[File:lightBulb.png]] Tips & Tricks ==		== [[File:lightBulb.png]] Tips & Tricks ==
	None as of now.		None as of now.

			[[Category:User_Manual_3.3_Mathematics]]

Admin : /* Features Description */

2018-02-27T09:40:06Z

Features Description

← Version précédente		Version du 27 février 2018 à 09:40
Ligne 26 :		Ligne 26 :
	An interval is made of two endpoints, and each endpoint may be closed or opened.		An interval is made of two endpoints, and each endpoint may be closed or opened.

	This is the most generic implementation of intervals : the class ~~GenericInterval~~<~~pre style="color: rgb(102, 102, 102);"~~><T~~(% style="color: rgb(102, 102, 102);" %)~~></~~pre~~>. The enumeration provides the endpoint types : CLOSED and OPEN.		This is the most generic implementation of intervals : the class <code>GenericInterval<T></code>. The enumeration provides the endpoint types : CLOSED and OPEN.

	This class is meant to be used as a parent class for all intervals implementations.		This class is meant to be used as a parent class for all intervals implementations.
Ligne 38 :		Ligne 38 :
	Examples :		Examples :

			<syntaxhighlight lang="java">
	~~(((~~		final IntervalEndpointType lowType = IntervalEndpointType.OPEN;
	~~(% style~~="~~font-weight: bold; color: rgb(0, 128, 0);~~" %)final IntervalEndpointType lowType ~~<pre style="color: rgb(102, 102, 102);">~~=~~</pre>~~ IntervalEndpointType~~<pre style="color: rgb(102, 102, 102);">~~.~~<pre style="color: rgb(125, 144, 41);">~~OPEN~~</pre>(% style="color: rgb(102, 102, 102)~~;~~" %);</pre>~~		final Double lowValue = new Double(34.56);
	~~(% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~final~~(%%)~~ Double lowValue ~~<pre style="color: rgb(102, 102, 102);">~~=~~</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~new~~(%%)~~ Double~~<pre style="color: rgb(102, 102, 102);">~~(34.56);~~</pre>~~		final IntervalEndpointType upType = IntervalEndpointType.CLOSED;
	~~(% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~final~~(%%)~~ IntervalEndpointType upType ~~<pre style="color: rgb(102, 102, 102);">~~=~~</pre>~~ IntervalEndpointType~~<pre style="color: rgb(102, 102, 102);">~~.~~<pre style="color: rgb(125, 144, 41);">~~CLOSED~~</pre>(% style="color: rgb(102, 102, 102);" %)~~;~~</pre>~~		final Double upValue = new Double(-2.3e34);
	~~(% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~final~~(%%)~~ Double upValue ~~<pre style="color: rgb(102, 102, 102);">=</pre> (% style~~=~~"font-weight: bold; color: rgb(0, 128, 0);" %)~~new~~(%%)~~ Double~~<pre style="color: rgb(102, 102, 102);">~~(-2.3e34);~~</pre>~~		// Note the order of values is off : this class cannot enforce an order
	~~(% style="color: rgb(64, 128, 128);" %)~~~/~/ Note the order of values is off : this class cannot enforce an order		final GenericInterval<Double> tgi = new GenericInterval<Double>(lowType, lowValue, upValue, upType);
	~~(%%) (% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~final~~(%%)~~ GenericInterval<~~pre style="color: rgb(102, 102, 102);"><</pre>~~Double~~<pre style="color: rgb(102, 102, 102);">></pre~~> tgi ~~<pre style~~=~~"color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~new~~(%%)~~ GenericInterval<~~pre style="color: rgb(102, 102, 102);"><</pre>~~Double~~<pre style="color: rgb(102, 102, 102);">~~>(~~</pre>~~lowType~~<pre style="color: rgb(102, 102, 102);">~~,~~</pre>~~ lowValue~~<pre style="color: rgb(102~~, ~~102, 102);">,</pre>~~ upValue~~<pre style="color: rgb(102, 102, 102);">~~,~~</pre>~~ upType~~<pre style="color: rgb(102, 102, 102~~);~~">);</pre>~~		final Double gLow = tgi.getLowerData();
	~~(% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~final~~(%%)~~ Double gLow ~~<pre style="color: rgb(102, 102, 102);">~~=~~</pre>~~ tgi~~<pre style="color: rgb(102, 102, 102);">~~.~~<pre style="color: rgb(125, 144, 41);">~~getLowerData~~</pre>(% style="color: rgb(102, 102, 102);" %)~~();~~</pre>~~		assertTrue(gLow.equals(lowValue));
	assertTrue~~<pre style="color: rgb(102, 102, 102);">~~(~~</pre>~~gLow~~<pre style="color: rgb(102, 102, 102);">~~.~~<pre style="color: rgb~~(~~125, 144, 41~~)~~;">equals</pre><pre style="color: rgb(102, 102, 102~~);~~">(</pre>lowValue~~</~~pre~~>~~(% style="color: rgb(102, 102, 102);" %)));~~		</syntaxhighlight>
	~~)))~~

	Please see the Javadoc for more information.		Please see the Javadoc for more information.
Ligne 59 :		Ligne 58 :

	=== Comparable intervals ===		=== Comparable intervals ===
	This implementation of intervals, ~~ComparableInterval~~<~~pre style="color: rgb(102, 102, 102);"~~><T ~~(% style="font-weight: bold; color: rgb(0, 128, 0);" %)~~extends~~</pre>~~ Comparable<~~pre style="color: rgb(102, 102, 102);"><</pre>~~T~~<pre style="color: rgb(102, 102, 102);">~~>></~~pre~~>, is for types implementing the Comparable interface ( for instance : Integer~~(% style="color: rgb(102, 102, 102);" %)~~, Double ).		This implementation of intervals, <code>ComparableInterva<T extends Comparable<T>></code>, is for types implementing the Comparable interface ( for instance : <code>Integer</code>, <code>Double</code> ).

	This implementation inherits from ~~GenericInterval~~<~~pre style="color: rgb(102, 102, 102);"~~><T~~(% style="color: rgb(102, 102, 102);" %)~~></~~pre~~>; in addition to inherited capabilities, it enforces a proper order on the lower and upper endpoints. A ComparableInterval can also tell :		This implementation inherits from <code>GenericInterval<T></code>; in addition to inherited capabilities, it enforces a proper order on the lower and upper endpoints. A <code>ComparableInterval</code> can also tell :

	* if a given value is inside an interval		* if a given value is inside an interval

Admin le 27 février 2018 à 09:24

2018-02-27T09:24:12Z

← Version précédente		Version du 27 février 2018 à 09:24
Ligne 1 :		Ligne 1 :
			== Introduction ==
			=== Scope ===
	~~#set($a=0)~~
	~~#set($b=0)~~
	~~#set($c=0)~~
	~~#set($d=0)~~

	== ~~{{t/}}~~ Introduction ==
	=== ~~{{tt/}}~~ Scope ===
	This section describes how angles, intervals and angle intervals are defined and used in the PATRIUS library.		This section describes how angles, intervals and angle intervals are defined and used in the PATRIUS library.

	=== ~~{{tt/}}~~ Javadoc ===		=== Javadoc ===
	The angle-related objects are available in the package <code>fr.cnes.sirius.patrius.utils</code> in the PATRIUS library. The class defining an interval end point, though, is in the package <code>org.orekit.utils</code> from orekit-addons.		The angle-related objects are available in the package <code>fr.cnes.sirius.patrius.utils</code> in the PATRIUS library. The class defining an interval end point, though, is in the package <code>org.orekit.utils</code> from orekit-addons.
	\|=Library\|=Javadoc		\|=Library\|=Javadoc
Ligne 16 :		Ligne 9 :
	\|Orekit addons \|[{{JavaDoc3.3}}/org/orekit/utils/package-summary.html Package org.orekit.utils]		\|Orekit addons \|[{{JavaDoc3.3}}/org/orekit/utils/package-summary.html Package org.orekit.utils]

	=== ~~{{tt/}}~~ Links ===		=== Links ===
	None as of now.		None as of now.

	=== ~~{{tt/}}~~ Useful Documents ===		=== Useful Documents ===
	None as of now.		None as of now.

	=== ~~{{tt/}}~~ Package Overview ===		=== Package Overview ===
	The package <code>org.orekit.utils</code> contains the class IntervalEndPoint that defines the type of boundary (CLOSED, OPEN) of an interval end.		The package <code>org.orekit.utils</code> contains the class IntervalEndPoint that defines the type of boundary (CLOSED, OPEN) of an interval end.

Ligne 29 :		Ligne 22 :
	[[File:PATRIMOINESIRIUSSUMDiagAngles.png]]		[[File:PATRIMOINESIRIUSSUMDiagAngles.png]]

	== ~~{{t/}}~~ Features Description ==		== Features Description ==
	=== ~~{{tt/}}~~ Generic intervals ===		=== Generic intervals ===
	An interval is made of two endpoints, and each endpoint may be closed or opened.		An interval is made of two endpoints, and each endpoint may be closed or opened.

Ligne 65 :		Ligne 58 :
	</syntaxhighlight>		</syntaxhighlight>

	=== ~~{{tt/}}~~ Comparable intervals ===		=== Comparable intervals ===
	This implementation of intervals, ComparableInterval<pre style="color: rgb(102, 102, 102);"><T (% style="font-weight: bold; color: rgb(0, 128, 0);" %)extends</pre> Comparable<pre style="color: rgb(102, 102, 102);"><</pre>T<pre style="color: rgb(102, 102, 102);">>></pre>, is for types implementing the Comparable interface ( for instance : Integer(% style="color: rgb(102, 102, 102);" %), Double ).		This implementation of intervals, ComparableInterval<pre style="color: rgb(102, 102, 102);"><T (% style="font-weight: bold; color: rgb(0, 128, 0);" %)extends</pre> Comparable<pre style="color: rgb(102, 102, 102);"><</pre>T<pre style="color: rgb(102, 102, 102);">>></pre>, is for types implementing the Comparable interface ( for instance : Integer(% style="color: rgb(102, 102, 102);" %), Double ).

Ligne 112 :		Ligne 105 :
	Please see the Javadoc for more information.		Please see the Javadoc for more information.

	=== ~~{{tt/}}~~ Angle intervals ===		=== Angle intervals ===
	The AngleInterval class represents an interval of doubles that shall be used to deal with angles. It contains the end points values and types (enum OPENED and CLOSED, class IntervalEndPointType), the mid value (“reference”) and the interval length.		The AngleInterval class represents an interval of doubles that shall be used to deal with angles. It contains the end points values and types (enum OPENED and CLOSED, class IntervalEndPointType), the mid value (“reference”) and the interval length.

	=== ~~{{tt/}}~~ Angle tools ===		=== Angle tools ===
	This class is a toolbox containing static methods to perform operations on angles, for instance :		This class is a toolbox containing static methods to perform operations on angles, for instance :

Ligne 122 :		Ligne 115 :
	* supplementary, complementary angles computation		* supplementary, complementary angles computation

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

	== ~~{{t/}}~~ Contents ==		== Contents ==
	=== ~~{{tt/}}~~ Interfaces ===		=== Interfaces ===
	None as of now.		None as of now.

	=== ~~{{tt/}}~~ Classes ===		=== Classes ===
	Here is a summary of the most important classes :		Here is a summary of the most important classes :

Ligne 140 :		Ligne 133 :
	\|'''ComparableInterval'''\|The class describe an interval of Comparable data.\|[{{JavaDoc3.3}}/org/orekit/utils/ComparableInterval.html ...]		\|'''ComparableInterval'''\|The class describe an interval of Comparable data.\|[{{JavaDoc3.3}}/org/orekit/utils/ComparableInterval.html ...]

	=== ~~{{tt/}}~~ Angle intervals ===		=== Angle intervals ===
	Two constructors are available for an AngleInterval instance :		Two constructors are available for an AngleInterval instance :

Ligne 166 :		Ligne 159 :
	Those intervals are impossible to modify once created : they have no setters. To get an interval with different values, a new one shall be constructed.		Those intervals are impossible to modify once created : they have no setters. To get an interval with different values, a new one shall be constructed.

	=== ~~{{tt/}}~~ Angle tools ===		=== Angle tools ===
	==== The method "angleInInterval" ====		==== The method "angleInInterval" ====

Ligne 253 :		Ligne 246 :
	The result is here computable, its value is PI/4.		The result is here computable, its value is PI/4.

	== ~~{{t/}}~~ Tutorials ==		== Tutorials ==
	=== ~~{{tt/}}~~ Tutorial 1 ===		=== Tutorial 1 ===
	{{specialInclusion prefix=$theme_sub section="Tuto1"/}}		{{specialInclusion prefix=$theme_sub section="Tuto1"/}}

	=== ~~{{tt/}}~~ Tutorial 2 ===		=== Tutorial 2 ===
	{{specialInclusion prefix=$theme_sub section="Tuto2"/}}		{{specialInclusion prefix=$theme_sub section="Tuto2"/}}

	== ~~{{t/}}~~ [[File:lightBulb.png]] Tips & Tricks ==		== [[File:lightBulb.png]] Tips & Tricks ==
	None as of now.		None as of now.

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

2018-02-27T09:14:32Z

Admin a déplacé la page Angles and Intervals vers User Manual 3.3 Angles and Intervals sans laisser de redirection

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

Admin : 1 révision importée

2018-02-27T09:14:03Z

1 révision importée

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

Admin le 27 février 2018 à 09:14

2018-02-27T09:14:03Z

Nouvelle page

#set($a=0)
#set($b=0)
#set($c=0)
#set($d=0)

== {{t/}} Introduction ==
=== {{tt/}} Scope ===
This section describes how angles, intervals and angle intervals are defined and used in the PATRIUS library.

=== {{tt/}} Javadoc ===
The angle-related objects are available in the package <code>fr.cnes.sirius.patrius.utils</code> in the PATRIUS library. The class defining an interval end point, though, is in the package <code>org.orekit.utils</code> from orekit-addons.
|=Library|=Javadoc
|Patrius |[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/package-summary.html Package fr.cnes.sirius.patrius.utils]
|Orekit addons |[{{JavaDoc3.3}}/org/orekit/utils/package-summary.html Package org.orekit.utils]

=== {{tt/}} Links ===
None as of now.

=== {{tt/}} Useful Documents ===
None as of now.

=== {{tt/}} Package Overview ===
The package <code>org.orekit.utils</code> contains the class IntervalEndPoint that defines the type of boundary (CLOSED, OPEN) of an interval end.

The package <code>fr.cnes.sirius.patrius.utils</code> contains the actual angle-related classes.

[[File:PATRIMOINESIRIUSSUMDiagAngles.png]]

== {{t/}} Features Description ==
=== {{tt/}} Generic intervals ===
An interval is made of two endpoints, and each endpoint may be closed or opened.

This is the most generic implementation of intervals : the class GenericInterval<pre style="color: rgb(102, 102, 102);"><T(% style="color: rgb(102, 102, 102);" %)></pre>. The enumeration provides the endpoint types : CLOSED and OPEN.

This class is meant to be used as a parent class for all intervals implementations.

This class makes no assumption on the nature of the parameter class T, so it may create intervals of anything- but the functionality for this class is limited (we only have getters for the endpoints values, and their type). That's why it's meant to be used as a parent class.

The class is immutable, in the sense that the endpoints objects are set at the interval creation.

'''Mutable types should not be used as endpoint value types!'''

Examples :

(((
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final IntervalEndpointType lowType <pre style="color: rgb(102, 102, 102);">=</pre> IntervalEndpointType<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">OPEN</pre>(% style="color: rgb(102, 102, 102);" %);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double lowValue <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(34.56);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) IntervalEndpointType upType <pre style="color: rgb(102, 102, 102);">=</pre> IntervalEndpointType<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">CLOSED</pre>(% style="color: rgb(102, 102, 102);" %);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double upValue <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(-2.3e34);</pre>
(% style="color: rgb(64, 128, 128);" %)~/~/ Note the order of values is off : this class cannot enforce an order
(%%) (% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) GenericInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">></pre> tgi <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) GenericInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">>(</pre>lowType<pre style="color: rgb(102, 102, 102);">,</pre> lowValue<pre style="color: rgb(102, 102, 102);">,</pre> upValue<pre style="color: rgb(102, 102, 102);">,</pre> upType<pre style="color: rgb(102, 102, 102);">);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double gLow <pre style="color: rgb(102, 102, 102);">=</pre> tgi<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">getLowerData</pre>(% style="color: rgb(102, 102, 102);" %)();</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(</pre>gLow<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">equals</pre><pre style="color: rgb(102, 102, 102);">(</pre>lowValue</pre>(% style="color: rgb(102, 102, 102);" %)));
)))

Please see the Javadoc for more information.

Example with doubles: interval [1.0, 2.0[ :

<syntaxhighlight lang="java">
GenericInterval<Double> interval = new GenericInterval<Double>(IntervalEndpointType.CLOSED, 1.0, 2.0, IntervalEndpointType.OPEN);
</syntaxhighlight>

=== {{tt/}} Comparable intervals ===
This implementation of intervals, ComparableInterval<pre style="color: rgb(102, 102, 102);"><T (% style="font-weight: bold; color: rgb(0, 128, 0);" %)extends</pre> Comparable<pre style="color: rgb(102, 102, 102);"><</pre>T<pre style="color: rgb(102, 102, 102);">>></pre>, is for types implementing the Comparable interface ( for instance : Integer(% style="color: rgb(102, 102, 102);" %), Double ).

This implementation inherits from GenericInterval<pre style="color: rgb(102, 102, 102);"><T(% style="color: rgb(102, 102, 102);" %)></pre>; in addition to inherited capabilities, it enforces a proper order on the lower and upper endpoints. A ComparableInterval can also tell :

* if a given value is inside an interval
* if an interval is inside another
* if two intervals overlap

Examples :

(((
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final Double d1 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(-4.44);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double d2 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(2.22);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double d3 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(6.23);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double d4 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(8.72);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) IntervalEndpointType open <pre style="color: rgb(102, 102, 102);">=</pre> IntervalEndpointType<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">OPEN</pre>(% style="color: rgb(102, 102, 102);" %);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) IntervalEndpointType closed <pre style="color: rgb(102, 102, 102);">=</pre> IntervalEndpointType<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">CLOSED</pre>(% style="color: rgb(102, 102, 102);" %);</pre>
(% style="color: rgb(64, 128, 128);" %)~/~/ Interval : [-4.44 ; 2.22 [
(%%) (% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">></pre> ti1 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">>(</pre>closed<pre style="color: rgb(102, 102, 102);">,</pre> d1<pre style="color: rgb(102, 102, 102);">,</pre> d2<pre style="color: rgb(102, 102, 102);">,</pre> open<pre style="color: rgb(102, 102, 102);">);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double inside1 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(-4.44);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double inside2 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(-2.24);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double outside1 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(-0.2313E96);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) Double outside2 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) Double<pre style="color: rgb(102, 102, 102);">(-4.45);</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(</pre>ti1<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">contains</pre>(% style="color: rgb(102, 102, 102);" %)(</pre>inside1<pre style="color: rgb(102, 102, 102);">));</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(</pre>ti1<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">contains</pre>(% style="color: rgb(102, 102, 102);" %)(</pre>inside2<pre style="color: rgb(102, 102, 102);">));</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(!</pre>ti1<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">contains</pre>(% style="color: rgb(102, 102, 102);" %)(</pre>outside1<pre style="color: rgb(102, 102, 102);">));</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(!</pre>ti1<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">contains</pre>(% style="color: rgb(102, 102, 102);" %)(</pre>outside2<pre style="color: rgb(102, 102, 102);">));</pre>
(% style="color: rgb(64, 128, 128);" %)~/~/ Two open overlapping intervals
(%%) (% style="color: rgb(64, 128, 128);" %)~/~/ ] d1 ; d3 [
(%%) (% style="color: rgb(64, 128, 128);" %)~/~/ ...] d2 ; d4 [
(%%) (% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">></pre> ovo1 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">>(</pre>open<pre style="color: rgb(102, 102, 102);">,</pre> d1<pre style="color: rgb(102, 102, 102);">,</pre> d3<pre style="color: rgb(102, 102, 102);">,</pre> open<pre style="color: rgb(102, 102, 102);">);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">></pre> ovo2 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">>(</pre>open<pre style="color: rgb(102, 102, 102);">,</pre> d2<pre style="color: rgb(102, 102, 102);">,</pre> d4<pre style="color: rgb(102, 102, 102);">,</pre> open<pre style="color: rgb(102, 102, 102);">);</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(</pre>ovo1<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">overlaps</pre>(% style="color: rgb(102, 102, 102);" %)(</pre>ovo2<pre style="color: rgb(102, 102, 102);">));</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(</pre>ovo2<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">overlaps</pre>(% style="color: rgb(102, 102, 102);" %)(</pre>ovo1<pre style="color: rgb(102, 102, 102);">));</pre>
(% style="color: rgb(64, 128, 128);" %)~/~/ Two closed intervals, first includes second
(%%) (% style="color: rgb(64, 128, 128);" %)~/~/ [ d1 .....;..... d4 ]
(%%) (% style="color: rgb(64, 128, 128);" %)~/~/ .....[ d2 ; d3 ]
(%%) (% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">></pre> clos1 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">>(</pre>closed<pre style="color: rgb(102, 102, 102);">,</pre> d1<pre style="color: rgb(102, 102, 102);">,</pre> d4<pre style="color: rgb(102, 102, 102);">,</pre> closed<pre style="color: rgb(102, 102, 102);">);</pre>
(% style="font-weight: bold; color: rgb(0, 128, 0);" %)final(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">></pre> clos2 <pre style="color: rgb(102, 102, 102);">=</pre> (% style="font-weight: bold; color: rgb(0, 128, 0);" %)new(%%) ComparableInterval<pre style="color: rgb(102, 102, 102);"><</pre>Double<pre style="color: rgb(102, 102, 102);">>(</pre>closed<pre style="color: rgb(102, 102, 102);">,</pre> d2<pre style="color: rgb(102, 102, 102);">,</pre> d3<pre style="color: rgb(102, 102, 102);">,</pre> closed<pre style="color: rgb(102, 102, 102);">);</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(</pre>clos1<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">includes</pre>(% style="color: rgb(102, 102, 102);" %)(</pre>clos2<pre style="color: rgb(102, 102, 102);">));</pre>
assertTrue<pre style="color: rgb(102, 102, 102);">(!</pre>clos2<pre style="color: rgb(102, 102, 102);">.<pre style="color: rgb(125, 144, 41);">includes</pre><pre style="color: rgb(102, 102, 102);">(</pre>clos1</pre>(% style="color: rgb(102, 102, 102);" %)));
)))

Please see the Javadoc for more information.

=== {{tt/}} Angle intervals ===
The AngleInterval class represents an interval of doubles that shall be used to deal with angles. It contains the end points values and types (enum OPENED and CLOSED, class IntervalEndPointType), the mid value (“reference”) and the interval length.

=== {{tt/}} Angle tools ===
This class is a toolbox containing static methods to perform operations on angles, for instance :

* angleInInterval : tells if a given angle value (as a double) is inside an angle interval
* angle comparisons
* supplementary, complementary angles computation

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

== {{t/}} Contents ==
=== {{tt/}} Interfaces ===
None as of now.

=== {{tt/}} Classes ===
Here is a summary of the most important classes :

|=Class|=Summary|=Javadoc
|'''IntervalEndpointType'''|Defines an interval end point as OPEN or CLOSED.|[{{JavaDoc3.3}}/org/orekit/utils/IntervalEndpointType.html ...]
|'''AngleInterval'''|Implements an interval of angles, taking angles' modulus into account.|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/AngleInterval.html ...]
|'''AngleTools'''|Provides several angle-related utility methods.|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/AngleTools.html ...]
|'''GenericInterval'''|Implements a generic interval.|[{{JavaDoc3.3}}/fr/cnes/sirius/patrius/utils/GenericInterval.html ...]
|'''AbsoluteDateInterval'''|This class implements an interval based on the AbsoluteDate class using the ComparableInterval class.|[{{JavaDoc3.3}}/org/orekit/utils/AbsoluteDateInterval.html ...]
|'''ComparableInterval'''|The class describe an interval of Comparable data.|[{{JavaDoc3.3}}/org/orekit/utils/ComparableInterval.html ...]

=== {{tt/}} Angle intervals ===
Two constructors are available for an AngleInterval instance :

* One needing directly the end points values and types. Its signature is in the writing order. For example, to create [0.0, 2PI[ :

<syntaxhighlight lang="java">
AngleInterval angleInterval1 = new AngleInterval(IntervalEndpointType.CLOSED, 0.0,
MathUtils.TWO_PI, IntervalEndpointType.OPEN);
</syntaxhighlight>

* One needing the reference and length values, and the end points nature. Here, the signature is : “reference”, “length”, “lower end point type”, “upper end point type”. To create [-PI, PI[ :

<syntaxhighlight lang="java">
AngleInterval angleInterval1 = new AngleInterval(0.0, MathUtils.TWO_PI,
IntervalEndpointType.CLOSED, IntervalEndpointType.OPEN);
</syntaxhighlight>

Those constructors throw an exception « MathIllegalArgumentException » if the interval is not valid. It is considered not valid if :

* The length is strictly greater than 2PI
* The length is equal to 2PI and both end points are “closed”
* The length is negative
* The length is zero and at least one end point is opened (an interval with only one double in it is accepted)

Those intervals are impossible to modify once created : they have no setters. To get an interval with different values, a new one shall be constructed.

=== {{tt/}} Angle tools ===
==== The method "angleInInterval" ====

The method « angleInInterval » computes the (2PI) modulus of an angle (given as a double) in an angle interval (AngleInterval object) :

* If a (2PI) modulus of the input angle exists in the interval, its value is returned. Because the angles have a maximum length of 2PI with at least an open end point, there can be only one solution.
* If no value in the interval is a solution, it means the operation is impossible with the given inputs, and a « MathIllegalArgumentException » is thrown.

Use example :

<syntaxhighlight lang="java">
try {
// Angle
double angle = 6*FastMath.PI;

// Interval creation
AngleInterval angleInterval = new AngleInterval(IntervalEndpointType.OPEN,
- MathUtils.HALF_PI, MathUtils.HALF_PI, IntervalEndpointType.OPEN);

// angle in interval
double result = AngleTools.angleInInterval(angle, angleInterval);
}
catch (MathIllegalArgumentException e) {
// correct catch!
}

</syntaxhighlight>

« result » value is here 0.0 : the modulus of 6PI in ]-PI/2,-PI/2[

==== Comparisons methods ====

The comparison methods available in the AngleTools class are the same as the one for doubles in the « Comparators » class : relative comparisons using a default epsilon. Input angles are only expressed in the input interval before the comparison.

If the computation in the interval of one of the input angles is not possible, a « MathIllegalArgumentException » is thrown.

Use example :

<syntaxhighlight lang="java">
try {
// Angle
double angle1 = 6*FastMath.PI;
double angle2 = 4*FastMath.PI + 0.1;

// Interval creation
AngleInterval angleInterval = new AngleInterval(IntervalEndpointType.OPEN,
- MathUtils.HALF_PI, MathUtils.HALF_PI, IntervalEndpointType.OPEN);

// angle in interval
boolean isLowerOrEqual = AngleTools.lowerOrEqual(angle1, angle2, angleInterval);
}
catch (MathIllegalArgumentException e) {
// correct catch !
}

</syntaxhighlight>

Both angles are here computable in the given interval. The first one is lower than the second once in the interval : the returned result is “true”

==== Supplementary, complementary and opposite angles ====

The tools box AngleTools proposes the methods to compute supplementary (method supplementaryAngle), complementary (method complementaryAngle) and opposite (method oppositeAngle) angles, taking into account an angle interval (of the type AngleInterval previously described)

Those methods first compute a common supplementary, complementary or opposite angle, and then try to express the result in the given interval. If this last operation is not possible, an exception is thrown (MathIllegalArgumentException).

Use example :

<syntaxhighlight lang="java">
try {
// Interval creation
AngleInterval angleInterval = new AngleInterval(IntervalEndpointType.OPEN,
- MathUtils.HALF_PI, MathUtils.HALF_PI, IntervalEndpointType.OPEN);

// computation
double angle = 3.0/4.0*FastMath.PI + 6.0*FastMath.PI;
double res = AngleTools.supplementaryAngle(angle, angleInterval);

}
catch (MathIllegalArgumentException e) {
// correct catch !

}

</syntaxhighlight>

The result is here computable, its value is PI/4.

== {{t/}} Tutorials ==
=== {{tt/}} Tutorial 1 ===
{{specialInclusion prefix=$theme_sub section="Tuto1"/}}

=== {{tt/}} Tutorial 2 ===
{{specialInclusion prefix=$theme_sub section="Tuto2"/}}

== {{t/}} [[File:lightBulb.png]] Tips & Tricks ==
None as of now.

User Manual 3.3 Angles and Intervals - Historique des versions

Admin : /* Javadoc */

Admin le 1 mars 2018 à 14:54

Admin : /* Classes */