Admin : Page créée avec « ====Definition==== The lines are defined by an origin point and a direction vector (both Vector3D). center ====Implementation==== Please refer to the [... »

2018-04-04T13:32:48Z

Page créée avec « ====Definition==== The lines are defined by an origin point and a direction vector (both Vector3D). center ====Implementation==== Please refer to the [... »

Nouvelle page

====Definition====
The lines are defined by an origin point and a direction vector (both Vector3D).

[[File:line.png|center]]

====Implementation====
Please refer to the [{{JavaDoc3.3}}/org/apache/commons/math3/geometry/euclidean/threed/Line.html Javadoc] for a complete list of public methods.

====Instantiation====
A Line(geometry.euclidian.threed) can be created in twi different ways :

* Using the constructor, by giving it two different points of the line.

<syntaxhighlight lang="java">
Vector3D p1 = new Vector3D(8, -12, 2);
Vector3D p2 = new Vector3D(-3, 4, 1);
Line l2 = new Line(p1, p2, true);
</syntaxhighlight>

* Using the static method createLine(Vector3D, Vector3D) : the first Vector3D is a point of the line, the second one is the direction.

<syntaxhighlight lang="java">
Vector3D origin = new Vector3D(-6, 4, 2);
Vector3D direction = new Vector3D(2, 0, -9);
Line l1 = Line.createLine(origin, direction );
</syntaxhighlight>

The origin of the line is always computed to be the closest one of the line to the (0, 0, 0) point.

====Usage====
The Line class proposes methods to :

* Test if the line identical to another one (they are similar if the contain the same points) :

<syntaxhighlight lang="java">
boolean similarLines = line1.isSimilarTo(line2);
</syntaxhighlight>

* the coordinates of the projection of any point of space in the local frame (origin, direction)

<syntaxhighlight lang="java">
Vector3D point = new Vector3D(2, 3, 5);
Vector1D pointOnLine = line.toSubSpace(point);
</syntaxhighlight>

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

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

* Test if a point belongs to it

<syntaxhighlight lang="java">
Vector3D point = new Vector3D(2, 3, 5);
boolean containsPoint = line1.contains(point);
</syntaxhighlight>

Please refer to the [[MAT_GEO_Home#HInteractions|Interactions with other geometrical objects section]] for other methods : Line does not implement the Shape interface (it is not a "shape"), but contains methods for interactions with other lines and points (clostestPointTo, distance...).

User Manual 3.3 Lines - Historique des versions

Admin : Page créée avec « ====Definition==== The lines are defined by an origin point and a direction vector (both Vector3D). center ====Implementation==== Please refer to the [... »

Admin : Page créée avec « ====Definition==== The lines are defined by an origin point and a direction vector (both Vector3D). center ====Implementation==== Please refer to the [... »