Admin le 5 avril 2018 à 07:30

2018-04-05T07:30:51Z

← Version précédente		Version du 5 avril 2018 à 07:30
Ligne 27 :		Ligne 27 :
	</syntaxhighlight>		</syntaxhighlight>

	* One needing a [~~MAT_GEO_Lines_CL~~ line] and a point belonging to the plane. The Origin point (the closest one to 0,0,0) and the local frame are then computed.		* One needing a [[User Manual 4.0 Lines\|line]] and a point belonging to the plane. The Origin point (the closest one to 0,0,0) and the local frame are then computed.

	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">

Admin : Page créée avec « ====Definition==== The planes are defined by an origin point and a local frame, the W vector being the normal to the plane. center ====Implementation... »

2018-04-04T08:08:54Z

Page créée avec « ====Definition==== The planes are defined by an origin point and a local frame, the W vector being the normal to the plane. center ====Implementation... »

Nouvelle page

====Definition====
The planes are defined by an origin point and a local frame, the W vector being the normal to the plane.

[[File:plane1.png|center]]

====Implementation====
The Plane object in the SIRIUS library implements the [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/math/geometry/euclidean/threed/InfiniteShape.html infinite shape interface ]. Please refer to the [{{JavaDoc4.0}}/fr/cnes/sirius/patrius/math/geometry/euclidean/threed/Plane.html Plane javadoc] for a complete list of public methods.

====Instantiation====
The Plane class (geometry.euclidian.threed) has several constructors :

* One needing one point of the plane and its normal. The Origin point (the closest one to 0,0,0) and the local frame are then computed.

<syntaxhighlight lang="java">
Vector3D normal = new Vector3D(7.2,-2.4, -5.8);
Vector3D orig = new Vector3D(0, 2, 7);
Plane p = new Plane(orig , normal);
</syntaxhighlight>

* One needing three different points of the plane. The Origin point (the closest one to 0,0,0) and the local frame are then computed.

<syntaxhighlight lang="java">
Vector3D p1 = new Vector3D(1.2, 3.4,-5.8);
Vector3D p2 = new Vector3D(3.4,-5.8, 1.2);
Vector3D p3 = new Vector3D(-2.0, 4.3, 0.7);
Plane p = new Plane(p1, p2, p3);
</syntaxhighlight>

* One needing a [MAT_GEO_Lines_CL line] and a point belonging to the plane. The Origin point (the closest one to 0,0,0) and the local frame are then computed.

<syntaxhighlight lang="java">
Vector3D point= new Vector3D(2,-8, 4);
Line line = new Line(origin, direction);
Plane p = new Plane(point, line);
</syntaxhighlight>

* One needing a line and a direction vector. The Origin point (the closest one to 0,0,0) and the local frame are then computed.

<syntaxhighlight lang="java">
Vector3D vector = new Vector3D(5, 22,-7);
Line line = new Line(origin, direction);
Plane p = new Plane(line, vector);
</syntaxhighlight>

* One needing one point of the plane, two direction vectors and a boolean (isFrame) to decide if the frame must be computed (like it is done for the rest of the constructors) or if the given point and vectors must constitute the local frame. If this boolean is true, the first given vector is U, the second V : they may not be orthogonal.

<syntaxhighlight lang="java">
Vector3D orig = new Vector3D(0, 2, 7);
Vector3D v1 = new Vector3D(3, 1, 0);
Vector3D v2 = new Vector3D(0, 2, 0);

Plane p = new Plane(orig, v1, v2, false);
</syntaxhighlight>

* One needing only the normal vector. The created plane contains the origin(0, 0, 0)

<syntaxhighlight lang="java">
Vector3D normal = new Vector3D(7.2,-2.4, -5.8);
Plane p = new Plane(normal);
</syntaxhighlight>

* One copy constructor

<syntaxhighlight lang="java">
Plane p1 = new Plane(p2);
</syntaxhighlight>

====Usage====

It provides methods to compute :

* the point resulting of the intersection of three planes (static method)

<syntaxhighlight lang="java">
Vector3D point = Plane.intersection(p1, p2, p3);
</syntaxhighlight>

* the line resulting of the intersection of two planes

<syntaxhighlight lang="java">
Line line = p1.intersection(p2);
</syntaxhighlight>

* the point resulting of the intersection of the plane and a line

<syntaxhighlight lang="java">
Vector3D point = p1.intersection(line);
</syntaxhighlight>

* the distance between a point and the plane (zero if the point belongs to the plane)

<syntaxhighlight lang="java">
double distance = p.distanceTo(point);
</syntaxhighlight>

* the comparison to another plane (they are similar if they contain the same points) :

<syntaxhighlight lang="java">
boolean similarPlanes = plane1.isSimilarTo(plane2);
</syntaxhighlight>

* the test of the belonging of a point to the plane

<syntaxhighlight lang="java">
boolean isInThePlane = p.contains(point);
</syntaxhighlight>

* the distance between a line and the plane (not zero only if the line does not intersect the plane)

<syntaxhighlight lang="java">
double distance = p.distanceTo(line);
</syntaxhighlight>

* the coordinates of the projection of any point of space in the local frame

<syntaxhighlight lang="java">
Vector2D pointInPlane = p1.toSubSpace(point);
</syntaxhighlight>

* the coordinates in the global frame of a point expressed in the local frame

<syntaxhighlight lang="java">
Vector3D point = p1.toSpace(pointInPlane);
</syntaxhighlight>

* translation and rotation of the plane

<syntaxhighlight lang="java">
Plane p2 = p1.rotate(center, rotation);
</syntaxhighlight>

<syntaxhighlight lang="java">
Plane p2 = p1.translate(vector);
</syntaxhighlight>

Please refer to the [MAT_GEO_Home#HInteractions Interactions with other geometrical objects section] for methods inherited from the Shape interface.

User Manual 4.0 Planes - Historique des versions

Admin le 5 avril 2018 à 07:30

Admin : Page créée avec « ====Definition==== The planes are defined by an origin point and a local frame, the W vector being the normal to the plane. center ====Implementation... »

Admin : Page créée avec « ====Definition==== The planes are defined by an origin point and a local frame, the W vector being the normal to the plane. center ====Implementation... »