User Manual 4.0 Properties and models: Sensors - Historique des versions

Admin le 21 février 2018 à 14:27

2018-02-21T14:27:33Z

← Version précédente		Version du 21 février 2018 à 14:27
Ligne 1 :		Ligne 1 :


	== Introduction ==		== Introduction ==
	=== Scope ===		=== Scope ===
Ligne 6 :		Ligne 4 :

	=== Javadoc ===		=== Javadoc ===
	The [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/assembly/models/SensorModel.html SensorModel] ais available in the package [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/assembly/models/package-summary.html fr.cnes.sirius.patrius.assembly.models].		The [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/assembly/models/SensorModel.html SensorModel] ais available in the package [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/assembly/models/package-summary.html fr.cnes.sirius.patrius.assembly.models].

	The [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/assembly/properties/SensorProperty.html SensorProperty] is available in the package [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/assembly/properties/package-summary.html fr.cnes.sirius.patrius.assembly.properties].		The [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/assembly/properties/SensorProperty.html SensorProperty] is available in the package [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/assembly/properties/package-summary.html fr.cnes.sirius.patrius.assembly.properties].

	The fields of view are available in the package [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/fieldsofview/package-summary.html fr.cnes.sirius.patrius.fieldsofview].		The fields of view are available in the package [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/fieldsofview/package-summary.html fr.cnes.sirius.patrius.fieldsofview].


Ligne 47 :		Ligne 45 :
	==== Geometric property ====		==== Geometric property ====

	The Geometric property associates a part to any shape that implements the [{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/math/geometry/euclidean/threed/SolidShape.html SolidShape] interface.<br>		The Geometric property associates a part to any shape that implements the [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/math/geometry/euclidean/threed/SolidShape.html SolidShape] interface.<br>
	(See the [MAT_GEO_Home Geometry] chapter of the Mathematics user manual for more details)<br>		(See the [MAT_GEO_Home Geometry] chapter of the Mathematics user manual for more details)<br>
	It is used in masking computations.		It is used in masking computations.

Admin : /* Contents */

2018-02-21T13:40:04Z

Contents

← Version précédente		Version du 21 février 2018 à 13:40
Ligne 155 :		Ligne 155 :
	None as of now.		None as of now.
	=== Classes ===		=== Classes ===
	\|=~~(% colspan~~="3" ~~%)Classe~~\|~~=(% colspan~~="6" %)Summary~~\|=(% colspan~~="1" %)Javadoc		{\| class="wikitable"
	\|~~(% colspan="3" %)~~'''SensorProperty'''\|~~(% colspan="6" %)~~This class is a part property for the PATRIUS assembly. It allows to define a part as a sensor, with associated fields and axis.\|~~(% colspan="1" %)~~[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/assembly/properties/SensorProperty.html ...]		\|-
	\|~~(% colspan="3" %)~~'''GeometricProperty'''\|~~(% colspan="6" %)~~This class is a part property for the PATRIUS assembly. It allows to define the part geometry for masking computations.\|~~(% colspan="1" %)~~[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/assembly/properties/GeometricProperty.html ...]		! scope="col"\| Class
	\|~~(% colspan="3" %)~~'''SensorModel'''\|~~(% colspan="6" %)~~This class is a model for a sensor integrated in a PATRIUS assembly.\|~~(% colspan="1" %)~~[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/assembly/models/SensorModel.html ...]		! scope="col"\| Summary
	\|~~(% colspan="3" %)~~'''SecondarySpacecraft'''\|~~(% colspan="6" %)~~This class is a potentially sensor-masking secondary spacecraft.\|~~(% colspan="1" %)~~[{{~~PathCurrentJavaDoc~~}}/fr/cnes/sirius/patrius/events/sensor/SecondarySpacecraft.html ...]		! scope="col"\| Javadoc
			\|-
			\|'''SensorProperty'''
			\|This class is a part property for the PATRIUS assembly. It allows to define a part as a sensor, with associated fields and axis.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/assembly/properties/SensorProperty.html ...]
			\|-
			\|'''GeometricProperty'''
			\|This class is a part property for the PATRIUS assembly. It allows to define the part geometry for masking computations.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/assembly/properties/GeometricProperty.html ...]
			\|-
			\|'''SensorModel'''
			\|This class is a model for a sensor integrated in a PATRIUS assembly.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/assembly/models/SensorModel.html ...]
			\|-
			\|'''SecondarySpacecraft'''
			\|This class is a potentially sensor-masking secondary spacecraft.
			\|[{{JavaDoc4.0}}/fr/cnes/sirius/patrius/events/sensor/SecondarySpacecraft.html ...]
			\|}

	See the dedicated [SPC_FIELD_mainPage Fields of view ] page for associated contents.		See the dedicated [SPC_FIELD_mainPage Fields of view ] page for associated contents.

	[[Category:User_Manual_4.0_Spacecraft]]		[[Category:User_Manual_4.0_Spacecraft]]

Admin le 20 février 2018 à 13:35

2018-02-20T13:35:30Z

← Version précédente		Version du 20 février 2018 à 13:35
Ligne 162 :		Ligne 162 :

	See the dedicated [SPC_FIELD_mainPage Fields of view ] page for associated contents.		See the dedicated [SPC_FIELD_mainPage Fields of view ] page for associated contents.

			[[Category:User_Manual_4.0_Spacecraft]]

Admin : /* Sensor model */

2018-02-20T13:35:08Z

Sensor model

← Version précédente		Version du 20 février 2018 à 13:35
Ligne 57 :		Ligne 57 :
	An instance of the sensor model is associated to one part, that contains a SENSOR property. It realizes the useful computations about this particular sensor : check if the main target is in its field of view, if inhibition or maskings happen, etc...		An instance of the sensor model is associated to one part, that contains a SENSOR property. It realizes the useful computations about this particular sensor : check if the main target is in its field of view, if inhibition or maskings happen, etc...

	Here is a ~~comlete~~ list of thoses services.		Here is a complete list of thoses services.
	The model provides methods to :		The model provides methods to :

Admin : /* Geometric property */

2018-02-20T13:34:19Z

Geometric property

← Version précédente		Version du 20 février 2018 à 13:34
Ligne 47 :		Ligne 47 :
	==== Geometric property ====		==== Geometric property ====

	The Geometric property associates a part to any shape that implements the [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/math/geometry/euclidean/threed/SolidShape.html SolidShape] interface.		The Geometric property associates a part to any shape that implements the [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/math/geometry/euclidean/threed/SolidShape.html SolidShape] interface.<br>
	(See the [MAT_GEO_Home Geometry] chapter of the Mathematics user manual for more details)		(See the [MAT_GEO_Home Geometry] chapter of the Mathematics user manual for more details)<br>
	It is used in masking computations.		It is used in masking computations.

Admin : /* Geometric property */

2018-02-20T13:33:51Z

Geometric property

← Version précédente		Version du 20 février 2018 à 13:33
Ligne 52 :		Ligne 52 :


	The property type associated is <~~pre style~~="~~color:~~ green;">'''GEOMETRY'''</~~pre~~>~~(% style="color:black" %)~~.		The property type associated is <font color="green">'''GEOMETRY'''</font>.

	=== Sensor model ===		=== Sensor model ===

Admin : /* Sensor Property */

2018-02-20T13:23:29Z

Sensor Property

← Version précédente		Version du 20 février 2018 à 13:23
Ligne 43 :		Ligne 43 :
	This property shall be used through the Sensor Model.		This property shall be used through the Sensor Model.

	The property type associated is <~~pre style~~="~~color:~~ green;">'''SENSOR'''</~~pre~~>~~(% style="color:black" %)~~.		The property type associated is <font color="green">'''SENSOR'''</font>.

	==== Geometric property ====		==== Geometric property ====

Admin : Admin a déplacé la page Properties and models: Sensors vers User Manual 4.0 Properties and models: Sensors sans laisser de redirection

2018-02-20T13:22:29Z

Admin a déplacé la page Properties and models: Sensors vers User Manual 4.0 Properties and models: Sensors sans laisser de redirection

← Version précédente		Version du 20 février 2018 à 13:22
(Aucune différence)

Admin : 1 révision importée

2018-02-20T13:22:07Z

1 révision importée

← Version précédente	Version du 20 février 2018 à 13:22
(Aucune différence)

Admin le 20 février 2018 à 13:22

2018-02-20T13:22:06Z

Nouvelle page

== Introduction ==
=== Scope ===
In this section are presented the sensor model for a PATRIUS assembly, the associated part property and the fields of view that are necessary to describe it.

=== Javadoc ===
The [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/assembly/models/SensorModel.html SensorModel] ais available in the package [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/assembly/models/package-summary.html fr.cnes.sirius.patrius.assembly.models].

The [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/assembly/properties/SensorProperty.html SensorProperty] is available in the package [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/assembly/properties/package-summary.html fr.cnes.sirius.patrius.assembly.properties].

The fields of view are available in the package [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/fieldsofview/package-summary.html fr.cnes.sirius.patrius.fieldsofview].

=== Links ===
None as of now.

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

=== Package overview ===
The sensor model is associated to one part of an assembly that must have a "SensorProperty" property.

Its main and inhibition targets are several PVCoordinatesProvider (and their radiuses are doubles), its main and inhibition fields of view are under the IFieldOfView interface, in the "fieldsofview" package.

[[File:sensors.PNG|center]]

== Features Description ==
=== Properties ===
==== Sensor Property ====

To create a sensor model, one part of the assembly must be associated to a SENSOR property.

A sensor property contains :
* a sight axis (not optional)
* (optional) a main spherical target defined by its center and radius (that can be set to zero to create a simple point)
* (optional)if a main target has been defined : a main field of view
* (optional) two arrays (same length) for the inhibition fields and the associated targets (as the main one, they are spherical, with radiuses that can be set to zero to create a simple point)
* (optional) an array of reference axis

All of them are expressed in the sensor part/frame.

This property shall be used through the Sensor Model.

The property type associated is <pre style="color: green;">'''SENSOR'''</pre>(% style="color:black" %).

==== Geometric property ====

The Geometric property associates a part to any shape that implements the [{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/math/geometry/euclidean/threed/SolidShape.html SolidShape] interface.
(See the [MAT_GEO_Home Geometry] chapter of the Mathematics user manual for more details)
It is used in masking computations.

The property type associated is <pre style="color: green;">'''GEOMETRY'''</pre>(% style="color:black" %).

=== Sensor model ===
An instance of the sensor model is associated to one part, that contains a SENSOR property. It realizes the useful computations about this particular sensor : check if the main target is in its field of view, if inhibition or maskings happen, etc...

Here is a comlete list of thoses services.
The model provides methods to :

* Check if the main spherical target is in the field of view at a date

Important : for "is in" boolean tests, all spherical targets (main and inhibition) are considered to be in the associated field as soon as a part of them is in.

<syntaxhighlight lang="java">
// the model is build from an assembly, giving the name of the part that contains the SENSOR property.
SensorModel sensor = new SensorModel(assembly, partName);
boolean targetIsInField = sensor.isMainTargetInField(date);
</syntaxhighlight>

* Check if at least an inhibition spherical target is in its associated inhibition field at a date

<syntaxhighlight lang="java">
boolean noInhibition = sensor.noInhibition(date);
</syntaxhighlight>

* Check if the main spherical target is in the field of view AND no inhibition target in its inhibition field at a given date

<syntaxhighlight lang="java">
boolean visibilityIsOk = sensor.visibilityOk(date);
</syntaxhighlight>

* Computes the angular distance of the main target CENTER to the border of the main field of view at a date.

<code>double angularDistance = sensor.getTargetCenterFOVAngle(date);</code>
The result is positive if the target is in the field.
NB : in some particular cases of Boolean Field of view, this angular distance is approximated (but the sign is still right).

* Computes the main spherical target direction vector in the part's frame (CX, CY, CZ)

<syntaxhighlight lang="java">
Vector3D targetInFrame = sensor.getTargetVectorInSensorFrame(date);
</syntaxhighlight>

* Computes the dihedral angles (AX = atan2(CZ, CY), AY = atan2(CX, CZ), AZ = atan2(CY, CX))

<syntaxhighlight lang="java">
// the order in this array is : AX, AY, AZ
double[] angles = sensor.getTargetDihedralAngles(date);
</syntaxhighlight>

* Computes the vector angles (of the main target to the sight axis or one of the reference axis)

<syntaxhighlight lang="java">
// to the sight axis
double angleSightAxis = sensor.getTargetSightAxisAngle(date);

// to the reference axis number N (for the first N = 1 !!)
double angleRefAxis = sensor.getTargetRefAxisAngle(date, N);
</syntaxhighlight>

* Computes the elevation angles (of the main target to the plane orthogonal to the sight axis or to one of the reference axis)

<syntaxhighlight lang="java">
// to the sight axis
double angleSightAxis = sensor.getTargetSightAxisElevation(date);

// to the reference axis number N (for the first N = 1 !!)
double angleRefAxis = sensor.getTargetRefAxisElevation(date, N);
</syntaxhighlight>

* Set potentially masking objects and test the masking at a date. Those objects can be parts of the same spacecraft (the one carrying the sensor), parts of [MIS_SENSORS_SecondSpc secondary spacecrafts] or [MIS_SENSORS_PatriusBodySpheroid celestial bodies].

<syntaxhighlight lang="java">
// two potentially masking celestial bodies
GeometricBodyShape earth = new ExtendedOneAxisEllipsoid(aeEarth, fEarth, attachedFrameEarth, "earth");
GeometricBodyShape moon= new ExtendedOneAxisEllipsoid(aeMoon, fMoon, attachedFrameMoon, "moon");

sensor.addMaskingCelestialBody(earth);
sensor.addMaskingCelestialBody(moon);

// a potentially masking spacecraft (the concerned Assembly's parts must have the right GEOMETRY property)
SecondarySpacecraft issStation = new SecondarySpacecraft (assemblyISS, propagatorISS, "ISS");

// its potentially masking parts names
String[] maskingPartsISS = {"solar panel 1", "solar panel 2"};

sensor.addSecondaryMaskingSpacecraft(issStation, maskingPartsISS );

// the same spacecraft's potentially masking parts (that must have each a GEOMERTY property)
String[] maskingPartsSameSpacecraft = {"solar panel", "big antenna"};

sensor.addOwnMaskingParts(maskingPartsSameSpacecraft);
</syntaxhighlight>

=== Fields of view ===
See the dedicated [SPC_FIELD_mainPage Fields of view ] page.

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

== Contents ==
=== Interfaces ===
None as of now.
=== Classes ===
|=(% colspan="3" %)Classe|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc
|(% colspan="3" %)'''SensorProperty'''|(% colspan="6" %)This class is a part property for the PATRIUS assembly. It allows to define a part as a sensor, with associated fields and axis.|(% colspan="1" %)[{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/assembly/properties/SensorProperty.html ...]
|(% colspan="3" %)'''GeometricProperty'''|(% colspan="6" %)This class is a part property for the PATRIUS assembly. It allows to define the part geometry for masking computations.|(% colspan="1" %)[{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/assembly/properties/GeometricProperty.html ...]
|(% colspan="3" %)'''SensorModel'''|(% colspan="6" %)This class is a model for a sensor integrated in a PATRIUS assembly.|(% colspan="1" %)[{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/assembly/models/SensorModel.html ...]
|(% colspan="3" %)'''SecondarySpacecraft'''|(% colspan="6" %)This class is a potentially sensor-masking secondary spacecraft.|(% colspan="1" %)[{{PathCurrentJavaDoc}}/fr/cnes/sirius/patrius/events/sensor/SecondarySpacecraft.html ...]

See the dedicated [SPC_FIELD_mainPage Fields of view ] page for associated contents.

User Manual 4.0 Properties and models: Sensors - Historique des versions

Admin le 21 février 2018 à 14:27

Admin : /* Contents */

Admin le 20 février 2018 à 13:35

Admin : /* Sensor model */

Admin : /* Geometric property */

Admin : /* Geometric property */

Admin : /* Sensor Property */

Admin : Admin a déplacé la page Properties and models: Sensors vers User Manual 4.0 Properties and models: Sensors sans laisser de redirection

Admin : 1 révision importée

Admin le 20 février 2018 à 13:22

Admin : /* Contents */

Admin : /* Sensor model */

Admin : /* Geometric property */

Admin : /* Geometric property */

Admin : /* Sensor Property */

Admin : Admin a déplacé la page Properties and models: Sensors vers User Manual 4.0 Properties and models: Sensors sans laisser de redirection

Admin : 1 révision importée