User Manual 3.3 Directions - Historique des versions

Admin le 26 février 2018 à 16:55

2018-02-26T16:55:49Z

← Version précédente		Version du 26 février 2018 à 16:55
Ligne 156 :		Ligne 156 :
	== [[File:lightBulb.png]] Tips & Tricks ==		== [[File:lightBulb.png]] Tips & Tricks ==
	None yet !		None yet !

			[[Category:User_Manual_3.3_Attitude]]

Admin le 26 février 2018 à 16:16

2018-02-26T16:16:36Z

← Version précédente		Version du 26 février 2018 à 16:16
Ligne 1 :		Ligne 1 :
			__NOTOC__

	== Introduction ==		== Introduction ==
	=== Scope ===		=== Scope ===
Ligne 17 :		Ligne 16 :
	The directions are available in the package <code>org.orekit.attitudes.directions</code> of the PATRIUS library.		The directions are available in the package <code>org.orekit.attitudes.directions</code> of the PATRIUS library.

	\|=Library\|=Javadoc		{\| class="wikitable"
	\| Orekit addons\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/package-summary.html Package org.orekit.attitudes.directions]		\|-
			! scope="col"\| Library
			! scope="col"\| Javadoc
			\|-
			\|Orekit addons
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/package-summary.html Package org.orekit.attitudes.directions]
			\|}

	=== Package Overview ===		=== Package Overview ===
Ligne 38 :		Ligne 43 :
	This direction is used for instance when it comes to take pictures of the ground. To avoid distortion, the satellite has to compensate the earth rotation around its yaw axis. On the following drawing, the red direction is the one that has to be followed to compensate the earth rotation.		This direction is used for instance when it comes to take pictures of the ground. To avoid distortion, the satellite has to compensate the earth rotation around its yaw axis. On the following drawing, the red direction is the one that has to be followed to compensate the earth rotation.

	[[File:vitsol.~~bmp~~\|center]]		[[File:vitsol.png\|center]]

	==== Target direction ====		==== Target direction ====
Ligne 49 :		Ligne 54 :
	== Contents ==		== Contents ==
	=== Interfaces ===		=== Interfaces ===
	\|=~~(% colspan~~="3" %)Interface~~\|=(% colspan~~="6" %)Summary~~\|=(% colspan~~="1" %)Javadoc		{\| class="wikitable"
	\|~~(% colspan="3" %)~~'''IDirection '''\|~~(% colspan="6" %)~~General interface for all directions classes. All basic directions implement it.\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/IDirection.html ...]		\|-
	\|~~(% colspan="3" %)~~'''ITargetDirection'''\|~~(% colspan="6" %)~~This interface extends IDirection for the particular case of directions defined by a target point. The vector's direction is oriented from the given origin to the target.\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ITargetDirection.html ...]		! scope="col"\| Interface
			! scope="col"\| Summary
			! scope="col"\| Javadoc
			\|-
			\|'''IDirection '''
			\|General interface for all directions classes. All basic directions implement it.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/IDirection.html ...]
			\|-
			\|'''ITargetDirection'''
			\|This interface extends IDirection for the particular case of directions defined by a target point. The vector's direction is oriented from the given origin to the target.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ITargetDirection.html ...]
			\|}

	=== Classes ===		=== Classes ===
	\|=~~(% colspan~~="3" %)Class~~\|=(% colspan~~="6" %)Summary~~\|=(% colspan~~="1" %)Javadoc		{\| class="wikitable"
	\|~~(% colspan="3" %)~~'''ConstantVectorDirection'''\|~~(% colspan="6" %)~~Vector constant in one of the frames of the tree.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ConstantVectorDirection.html ...]		\|-
	\|~~(% colspan="3" %)~~'''VelocityDirection'''\|~~(% colspan="6" %)~~Velocity of the origin point expressed in a reference frame, projected in the given one.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/VelocityDirection.html ...]		! scope="col"\| Class
	\|~~(% colspan="3" %)~~'''MomentumDirection'''\|~~(% colspan="6" %)~~Momentum : normal vector to the trajectory plane of the origin point around a celestial body.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/MomentumDirection.html ...]		! scope="col"\| Summary
	\|~~(% colspan="3" %)~~'''CelestialBodyPolesAxisDirection'''\|~~(% colspan="6" %)~~Axis of the poles of a celestial body.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/CelestialBodyPolesAxisDirection.html ...]		! scope="col"\| Javadoc
	\|~~(% colspan="3" %)~~'''ToCelestialBodyCenterDirection'''\|~~(% colspan="6" %)~~Vector from the origin to the center of a celestial body.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ToCelestialBodyCenterDirection.html ...]		\|-
	\|~~(% colspan="3" %)~~'''EarthCenterDirection'''\|~~(% colspan="6" %)~~Vector from the origin to the center of the Earth central body.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/EarthCenterDirection.html ...]		\|'''ConstantVectorDirection'''
	\|~~(% colspan="3" %)~~'''GenericTargetDirection'''\|~~(% colspan="6" %)~~Defined by a PVCoordinatesProvider target.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GenericTargetDirection.html ...]		\|Vector constant in one of the frames of the tree.
	\|~~(% colspan="3" %)~~'''GroundVelocityDirection'''\|~~(% colspan="6" %)~~Defined by the location of the ground target point given by the pointing direction of the satellite and the body shape.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GroundVelocityDirection.html ...]		\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ConstantVectorDirection.html ...]
	\|~~(% colspan="3" %)~~'''NadirDirection'''\|~~(% colspan="6" %)~~Defined by the location of the nadir point and the satellite position.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/NadirDirection.html ...]		\|-
	\|~~(% colspan="3" %)~~'''CrossProductDirection'''\|~~(% colspan="6" %)~~Cross Product of two directions.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/CrossProductDirection.html ...]		\|'''VelocityDirection'''
	\|~~(% colspan="3" %)~~'''GlintApproximatePointingDirection'''\|~~(% colspan="6" %)~~Direction to the Sun specular reflexion point.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GlintApproximatePointingDirection.html ...]		\|Velocity of the origin point expressed in a reference frame, projected in the given one.
	\|~~(% colspan="3" %)~~'''EarthToCelestialBodyCenterDirection'''\|~~(% colspan="6" %)~~Direction from Earth to the celestial body center.\|~~(% colspan="1" %)~~[{{JavaDoc3.3}}/org/orekit/attitudes/directions/EarthToCelestialBodyCenterDirection.html ...]		\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/VelocityDirection.html ...]
			\|-
			\|'''MomentumDirection'''
			\|Momentum : normal vector to the trajectory plane of the origin point around a celestial body.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/MomentumDirection.html ...]
			\|-
			\|'''CelestialBodyPolesAxisDirection'''
			\|Axis of the poles of a celestial body.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/CelestialBodyPolesAxisDirection.html ...]
			\|-
			\|'''ToCelestialBodyCenterDirection'''
			\|Vector from the origin to the center of a celestial body.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ToCelestialBodyCenterDirection.html ...]
			\|-
			\|'''EarthCenterDirection'''
			\|Vector from the origin to the center of the Earth central body.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/EarthCenterDirection.html ...]
			\|-
			\|'''GenericTargetDirection'''
			\|Defined by a PVCoordinatesProvider target.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GenericTargetDirection.html ...]
			\|-
			\|'''GroundVelocityDirection'''
			\|Defined by the location of the ground target point given by the pointing direction of the satellite and the body shape.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GroundVelocityDirection.html ...]
			\|-
			\|'''NadirDirection'''
			\|Defined by the location of the nadir point and the satellite position.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/NadirDirection.html ...]
			\|-
			\|'''CrossProductDirection'''
			\|Cross Product of two directions.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/CrossProductDirection.html ...]
			\|-
			\|'''GlintApproximatePointingDirection'''
			\|Direction to the Sun specular reflexion point.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GlintApproximatePointingDirection.html ...]
			\|-
			\|'''EarthToCelestialBodyCenterDirection'''
			\|Direction from Earth to the celestial body center.
			\|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/EarthToCelestialBodyCenterDirection.html ...]
			\|}

	=== Use ===		=== Use ===

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

2018-02-26T16:08:41Z

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

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

Admin : 1 révision importée

2018-02-26T16:07:47Z

1 révision importée

← Version précédente		Version du 26 février 2018 à 16:07
(Aucune différence)

Admin le 26 février 2018 à 16:07

2018-02-26T16:07:47Z

Nouvelle page

== Introduction ==
=== Scope ===
The “direction” objects are used for attitude computation purposes to describe different types of axis in space that can evolve in time. A direction provides a vector in space at any date in a given frame.
A direction can be for example "spacecraft-moon" or "nadir direction of the spacecraft".
An attitude law can then be defined using two of those directions.

All available directions belong to the following categories:
* Defined by a "target" moving point, and a given origin point;

* Defined by a vector only known to be constant in time in a particular frame, or defined by a physical property.

The available features are listed in the description of the general <code>IDirection</code> interface or of the more specific <code>ITargetDirection</code> interface (for directions pointing a target).

=== Javadoc ===
The directions are available in the package <code>org.orekit.attitudes.directions</code> of the PATRIUS library.

|=Library|=Javadoc
| Orekit addons|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/package-summary.html Package org.orekit.attitudes.directions]

=== Package Overview ===
The following diagram represents the two main interfaces of the "directions" package, and for each interface some of the implemented directions.
[[File:PATRIMOINESIRIUSdirections.png]]

== Features Description ==
=== Directions ===
The available directions are:

==== Basic direction ====
This direction is defined at any date by a vector; this vector can be constant in a frame, or it can be defined by a physical property (for instance the axis of the poles of a celestial body, the orbit momentum, the velocity vector...).

The <code>getVector</code> and <code>getLine</code> methods of this interface use a <code>PVCoordinatesProvider</code> to represent the origin of the direction, but for some of them this input parameter is unused (for instance for the poles of a celestial body direction). See each javadoc for the associated behavior.

All directions can also provide the line containing the given origin and directed by the vector, expressed in any frame of the tree.

===== Ground velocity direction =====
This direction is used for instance when it comes to take pictures of the ground. To avoid distortion, the satellite has to compensate the earth rotation around its yaw axis. On the following drawing, the red direction is the one that has to be followed to compensate the earth rotation.

[[File:vitsol.bmp|center]]

==== Target direction ====
This direction also implements the methods of basic directions.
It is defined at any date by the position of two points of space: the target (that defines the direction) and the origin given by the user. The associated vector (and line) is computed from the origin to the target.

== Getting Started ==
TBD

== Contents ==
=== Interfaces ===
|=(% colspan="3" %)Interface|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc
|(% colspan="3" %)'''IDirection '''|(% colspan="6" %)General interface for all directions classes. All basic directions implement it.|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/IDirection.html ...]
|(% colspan="3" %)'''ITargetDirection'''|(% colspan="6" %)This interface extends IDirection for the particular case of directions defined by a target point. The vector's direction is oriented from the given origin to the target.|[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ITargetDirection.html ...]

=== Classes ===
|=(% colspan="3" %)Class|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc
|(% colspan="3" %)'''ConstantVectorDirection'''|(% colspan="6" %)Vector constant in one of the frames of the tree.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ConstantVectorDirection.html ...]
|(% colspan="3" %)'''VelocityDirection'''|(% colspan="6" %)Velocity of the origin point expressed in a reference frame, projected in the given one.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/VelocityDirection.html ...]
|(% colspan="3" %)'''MomentumDirection'''|(% colspan="6" %)Momentum : normal vector to the trajectory plane of the origin point around a celestial body.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/MomentumDirection.html ...]
|(% colspan="3" %)'''CelestialBodyPolesAxisDirection'''|(% colspan="6" %)Axis of the poles of a celestial body.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/CelestialBodyPolesAxisDirection.html ...]
|(% colspan="3" %)'''ToCelestialBodyCenterDirection'''|(% colspan="6" %)Vector from the origin to the center of a celestial body.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/ToCelestialBodyCenterDirection.html ...]
|(% colspan="3" %)'''EarthCenterDirection'''|(% colspan="6" %)Vector from the origin to the center of the Earth central body.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/EarthCenterDirection.html ...]
|(% colspan="3" %)'''GenericTargetDirection'''|(% colspan="6" %)Defined by a PVCoordinatesProvider target.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GenericTargetDirection.html ...]
|(% colspan="3" %)'''GroundVelocityDirection'''|(% colspan="6" %)Defined by the location of the ground target point given by the pointing direction of the satellite and the body shape.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GroundVelocityDirection.html ...]
|(% colspan="3" %)'''NadirDirection'''|(% colspan="6" %)Defined by the location of the nadir point and the satellite position.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/NadirDirection.html ...]
|(% colspan="3" %)'''CrossProductDirection'''|(% colspan="6" %)Cross Product of two directions.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/CrossProductDirection.html ...]
|(% colspan="3" %)'''GlintApproximatePointingDirection'''|(% colspan="6" %)Direction to the Sun specular reflexion point.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/GlintApproximatePointingDirection.html ...]
|(% colspan="3" %)'''EarthToCelestialBodyCenterDirection'''|(% colspan="6" %)Direction from Earth to the celestial body center.|(% colspan="1" %)[{{JavaDoc3.3}}/org/orekit/attitudes/directions/EarthToCelestialBodyCenterDirection.html ...]

=== Use ===
==== For all directions ====

All the directions implement the "IDirection" interface and so provide the "getVector" method. This method needs a date and a frame to express the vector, and the PV coordinates of the origin point (unused for some of them). It shall be used this way :

<syntaxhighlight lang="java">
Vector3D directionVector = myDirection.getVector(pvCoordinatesProvider, date, frame);
</syntaxhighlight>

They also provide the "getLine" method, with the same arguments.

<syntaxhighlight lang="java">
Line directionLine = myDirection.getLine(pvCoordinatesProvider, date, frame);
</syntaxhighlight>

NB : when the PVCoordinatesProvider is null then the origin of the direction is tacitly the frame origin.

==== For target directions ====

The directions that implement the "ITargetDirection" interface also provide the "getTarget" method :

<syntaxhighlight lang="java">
PVCoordinates directionTarget = myTargetDirection.getTargetPVCoordinates(date, frame);
</syntaxhighlight>

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

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

User Manual 3.3 Directions - Historique des versions

Admin le 26 février 2018 à 16:55

Admin le 26 février 2018 à 16:16

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

Admin : 1 révision importée

Admin le 26 février 2018 à 16:07

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

Admin : 1 révision importée