OTSPoint3D (Open Traffic Sim core classes 1.01.00 API)

java.lang.Object
- org.opentrafficsim.core.geometry.OTSPoint3D

All Implemented Interfaces:

Serializable, Locatable
```
public class OTSPoint3D
extends Object
implements Locatable, Serializable
```
An OTSPoint3D implements a 3D-coordinate for OTS. X, y and z are stored as doubles, but it is assumed that the scale is in SI units, i.e. in meters. A distance between two points is therefore also in meters.
Copyright (c) 2013-2019 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.
$LastChangedDate: 2015-07-16 10:20:53 +0200 (Thu, 16 Jul 2015) $, @version $Revision: 1124 $, by $Author: pknoppers $, initial version Jul 22, 2015

Author:

Alexander Verbraeck, Peter Knoppers, Guus Tamminga

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`double`	`x` The internal representation of the point; x-coordinate.
`double`	`y` The internal representation of the point; y-coordinate.
`double`	`z` The internal representation of the point; z-coordinate.

Constructor Summary

Constructors
Constructor and Description
`OTSPoint3D(CartesianPoint point)`
`OTSPoint3D(com.vividsolutions.jts.geom.Coordinate coordinate)`
`OTSPoint3D(DirectedPoint point)`
`OTSPoint3D(double[] xyz)`
`OTSPoint3D(double x, double y)` The x and y in the point are assumed to be in meters relative to an origin.
`OTSPoint3D(double x, double y, double z)` The x, y and z in the point are assumed to be in meters relative to an origin.
`OTSPoint3D(OTSPoint3D point)`
`OTSPoint3D(com.vividsolutions.jts.geom.Point point)`
`OTSPoint3D(Point2D point2d)`
`OTSPoint3D(javax.vecmath.Point3d point)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static List<OTSPoint3D>`	`circleCenter(OTSPoint3D point1, OTSPoint3D point2, double radius)` Return the possible center points of a circle when two points and a radius are given.
`static List<OTSPoint3D>`	`circleIntersections(OTSPoint3D center1, double radius1, OTSPoint3D center2, double radius2)` Return the possible intersections between two circles.
`OTSPoint3D`	`closestPointOnLine(OTSLine3D line)` Return the closest point on an OTSLine3D.
`OTSPoint3D`	`closestPointOnLine2D(OTSLine3D line)` Return the closest point on an OTSLine3D.
`OTSPoint3D`	`closestPointOnSegment(OTSPoint3D segmentPoint1, OTSPoint3D segmentPoint2)` Project a point on a line segment (2D - Z-component is ignored).
`Length`	`distance(OTSPoint3D point)`
`double`	`distanceSI(OTSPoint3D point)`
`boolean`	`equals(Object obj)`
`javax.media.j3d.Bounds`	`getBounds()` This method returns a sphere with a diameter of half a meter as the default bounds for a point.
`com.vividsolutions.jts.geom.Coordinate`	`getCoordinate()`
`DirectedPoint`	`getDirectedPoint()`
`DirectedPoint`	`getLocation()`
`Point2D`	`getPoint2D()`
`int`	`hashCode()`
`Length`	`horizontalDistance(OTSPoint3D point)`
`double`	`horizontalDistanceSI(OTSPoint3D point)`
`static OTSPoint3D`	`interpolate(double ratio, OTSPoint3D zeroValue, OTSPoint3D oneValue)` Interpolate (or extrapolate) between (outside) two given points.
`static OTSPoint3D`	`intersectionOfLines(OTSPoint3D line1P1, OTSPoint3D line1P2, OTSPoint3D line2P1, OTSPoint3D line2P2)` Compute the 2D intersection of two infinite lines.
`static OTSPoint3D`	`intersectionOfLinesDumb(OTSPoint3D line1P1, OTSPoint3D line1P2, OTSPoint3D line2P1, OTSPoint3D line2P2)` Deprecated.
`static OTSPoint3D`	`intersectionOfLineSegments(OTSPoint3D line1P1, OTSPoint3D line1P2, OTSPoint3D line2P1, OTSPoint3D line2P2)` Compute the 2D intersection of two line segments.
`static OTSPoint3D`	`intersectionOfLineSegmentsDumb(OTSPoint3D line1P1, OTSPoint3D line1P2, OTSPoint3D line2P1, OTSPoint3D line2P2)` Deprecated.
`OTSPoint3D`	`normalize()` Return the point with a length of 1 to the origin.
`String`	`toString()`
`OTSPoint3D`	`translate(double factor)` Return this point translated by a factor from the origin.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - x
```
public final double x
```
    The internal representation of the point; x-coordinate.
  - y
```
public final double y
```
    The internal representation of the point; y-coordinate.
  - z
```
public final double z
```
    The internal representation of the point; z-coordinate.
- Constructor Detail
  - OTSPoint3D
```
public OTSPoint3D(double x,
                  double y,
                  double z)
```
    The x, y and z in the point are assumed to be in meters relative to an origin.
    
    Parameters:
    
    x - double; x-coordinate
    
    y - double; y-coordinate
    
    z - double; z-coordinate
  - OTSPoint3D
```
public OTSPoint3D(double[] xyz)
```
    Parameters:
    
    xyz - array with three elements; x, y and z are assumed to be in meters relative to an origin.
  - OTSPoint3D
```
public OTSPoint3D(OTSPoint3D point)
```
    Parameters:
    
    point - OTSPoint3D; a point to "clone".
  - OTSPoint3D
```
public OTSPoint3D(javax.vecmath.Point3d point)
```
    Parameters:
    
    point - javax.vecmath 3D double point; the x, y and z in the point are assumed to be in meters relative to an origin.
  - OTSPoint3D
```
public OTSPoint3D(CartesianPoint point)
```
    Parameters:
    
    point - javax.vecmath 3D double point; the x, y and z in the point are assumed to be in meters relative to an origin.
  - OTSPoint3D
```
public OTSPoint3D(DirectedPoint point)
```
    Parameters:
    
    point - javax.vecmath 3D double point; the x, y and z in the point are assumed to be in meters relative to an origin.
  - OTSPoint3D
```
public OTSPoint3D(Point2D point2d)
```
    Parameters:
    
    point2d - java.awt 2D point, z-coordinate will be zero; the x and y in the point are assumed to be in meters relative to an origin.
  - OTSPoint3D
```
public OTSPoint3D(com.vividsolutions.jts.geom.Coordinate coordinate)
```
    Parameters:
    
    coordinate - geotools coordinate; the x, y and z in the coordinate are assumed to be in meters relative to an origin.
  - OTSPoint3D
```
public OTSPoint3D(com.vividsolutions.jts.geom.Point point)
```
    Parameters:
    
    point - geotools point; z-coordinate will be zero; the x and y in the point are assumed to be in meters relative to an origin.
  - OTSPoint3D
```
public OTSPoint3D(double x,
                  double y)
```
    The x and y in the point are assumed to be in meters relative to an origin. z will be set to 0.
    
    Parameters:
    
    x - double; x-coordinate
    
    y - double; y-coordinate
- Method Detail
  - interpolate
```
public static OTSPoint3D interpolate(double ratio,
                                     OTSPoint3D zeroValue,
                                     OTSPoint3D oneValue)
```
    Interpolate (or extrapolate) between (outside) two given points.
    
    Parameters:
    
    ratio - double; 0 selects the zeroValue point, 1 selects the oneValue point, 0.5 selects a point halfway, etc.
    
    zeroValue - OTSPoint3D; the point that is returned when ratio equals 0
    
    oneValue - OTSPoint3D; the point that is returned when ratio equals 1
    
    Returns:
    
    OTSPoint3D
  - intersectionOfLineSegmentsDumb
```
@Deprecated
public static OTSPoint3D intersectionOfLineSegmentsDumb(OTSPoint3D line1P1,
                                                                     OTSPoint3D line1P2,
                                                                     OTSPoint3D line2P1,
                                                                     OTSPoint3D line2P2)
```
    Deprecated.
    
    Compute the 2D intersection of two line segments. The Z-component of the lines is ignored. Both line segments are defined by two points (that should be distinct). This version suffers loss of precision when called with very large coordinate values.
    
    Parameters:
    
    line1P1 - OTSPoint3D; first point of line segment 1
    
    line1P2 - OTSPoint3D; second point of line segment 1
    
    line2P1 - OTSPoint3D; first point of line segment 2
    
    line2P2 - OTSPoint3D; second point of line segment 2
    
    Returns:
    
    OTSPoint3D; the intersection of the two lines, or null if the lines are (almost) parallel, or do not intersect
  - intersectionOfLineSegments
```
public static OTSPoint3D intersectionOfLineSegments(OTSPoint3D line1P1,
                                                    OTSPoint3D line1P2,
                                                    OTSPoint3D line2P1,
                                                    OTSPoint3D line2P2)
```
    Compute the 2D intersection of two line segments. The Z-component of the lines is ignored. Both line segments are defined by two points (that should be distinct).
    
    Parameters:
    
    line1P1 - OTSPoint3D; first point of line segment 1
    
    line1P2 - OTSPoint3D; second point of line segment 1
    
    line2P1 - OTSPoint3D; first point of line segment 2
    
    line2P2 - OTSPoint3D; second point of line segment 2
    
    Returns:
    
    OTSPoint3D; the intersection of the two lines, or null if the lines are (almost) parallel, or do not intersect
  - intersectionOfLinesDumb
```
@Deprecated
public static OTSPoint3D intersectionOfLinesDumb(OTSPoint3D line1P1,
                                                              OTSPoint3D line1P2,
                                                              OTSPoint3D line2P1,
                                                              OTSPoint3D line2P2)
```
    Deprecated.
    
    Compute the 2D intersection of two infinite lines. The Z-component of the lines is ignored. Both lines are defined by two points (that should be distinct). This version suffers loss of precision when called with very large coordinate values.
    
    Parameters:
    
    line1P1 - OTSPoint3D; first point of line 1
    
    line1P2 - OTSPoint3D; second point of line 1
    
    line2P1 - OTSPoint3D; first point of line 2
    
    line2P2 - OTSPoint3D; second point of line 2
    
    Returns:
    
    OTSPoint3D; the intersection of the two lines, or null if the lines are (almost) parallel
  - intersectionOfLines
```
public static OTSPoint3D intersectionOfLines(OTSPoint3D line1P1,
                                             OTSPoint3D line1P2,
                                             OTSPoint3D line2P1,
                                             OTSPoint3D line2P2)
```
    Compute the 2D intersection of two infinite lines. The Z-component of the lines is ignored. Both lines are defined by two points (that should be distinct).
    
    Parameters:
    
    line1P1 - OTSPoint3D; first point of line 1
    
    line1P2 - OTSPoint3D; second point of line 1
    
    line2P1 - OTSPoint3D; first point of line 2
    
    line2P2 - OTSPoint3D; second point of line 2
    
    Returns:
    
    OTSPoint3D; the intersection of the two lines, or null if the lines are (almost) parallel
  - closestPointOnSegment
```
public final OTSPoint3D closestPointOnSegment(OTSPoint3D segmentPoint1,
                                              OTSPoint3D segmentPoint2)
```
    Project a point on a line segment (2D - Z-component is ignored). If the the projected points lies outside the line segment, the nearest end point of the line segment is returned. Otherwise the returned point lies between the end points of the line segment.
    Adapted from example code provided by Paul Bourke.
    
    Parameters:
    
    segmentPoint1 - OTSPoint3D; start of line segment
    
    segmentPoint2 - OTSPoint3D; end of line segment
    
    Returns:
    
    Point2D.Double; either lineP1, or lineP2 or a new OTSPoint3D that lies somewhere in between those two. The Z-component of the result matches the Z-component of the line segment at that point
  - closestPointOnLine
```
public final OTSPoint3D closestPointOnLine(OTSLine3D line)
```
    Return the closest point on an OTSLine3D. This method takes the Z-component of this point and the line into account.
    
    Parameters:
    
    line - OTSLine3D; the line
    
    Returns:
    
    OTSPoint3D; the Z-component of the returned point matches the Z-component of the line at that point
  - closestPointOnLine2D
```
public final OTSPoint3D closestPointOnLine2D(OTSLine3D line)
```
    Return the closest point on an OTSLine3D. This method ignores the Z-component of this point and the line when computing the distance.
    
    Parameters:
    
    line - OTSLine3D; the line
    
    Returns:
    
    OTSPoint3D; the Z-component of the returned point matches the Z-component of the line at that point
  - normalize
```
public final OTSPoint3D normalize()
```
    Return the point with a length of 1 to the origin.
    
    Returns:
    
    OTSPoint3D; the normalized point
  - translate
```
public final OTSPoint3D translate(double factor)
```
    Return this point translated by a factor from the origin.
    
    Parameters:
    
    factor - double; the translation factor
    
    Returns:
    
    OTSPoint3D; the translated point
  - circleCenter
```
public static final List<OTSPoint3D> circleCenter(OTSPoint3D point1,
                                                  OTSPoint3D point2,
                                                  double radius)
```
    Return the possible center points of a circle when two points and a radius are given.
    
    Parameters:
    
    point1 - OTSPoint3D; the first point
    
    point2 - OTSPoint3D; the second point
    
    radius - double; the radius
    
    Returns:
    
    List<OTSPoint3D> a list of zero, one or two points
  - circleIntersections
```
public static final List<OTSPoint3D> circleIntersections(OTSPoint3D center1,
                                                         double radius1,
                                                         OTSPoint3D center2,
                                                         double radius2)
```
    Return the possible intersections between two circles.
    
    Parameters:
    
    center1 - OTSPoint3D; the center of circle 1
    
    radius1 - double; the radius of circle 1
    
    center2 - OTSPoint3D; the center of circle 2
    
    radius2 - double; the radius of circle 2
    
    Returns:
    
    List<OTSPoint3D> a list of zero, one or two points
  - distanceSI
```
public final double distanceSI(OTSPoint3D point)
```
    Parameters:
    
    point - OTSPoint3D; the point to which the distance has to be calculated.
    
    Returns:
    
    the distance in 3D according to Pythagoras, expressed in the SI unit for length (meter)
  - horizontalDistanceSI
```
public final double horizontalDistanceSI(OTSPoint3D point)
```
    Parameters:
    
    point - OTSPoint3D; the point to which the distance has to be calculated.
    
    Returns:
    
    the distance in 3D according to Pythagoras, expressed in the SI unit for length (meter)
  - horizontalDistance
```
public final Length horizontalDistance(OTSPoint3D point)
```
    Parameters:
    
    point - OTSPoint3D; the point to which the distance has to be calculated.
    
    Returns:
    
    the distance in 3D according to Pythagoras
  - distance
```
public final Length distance(OTSPoint3D point)
```
    Parameters:
    
    point - OTSPoint3D; the point to which the distance has to be calculated.
    
    Returns:
    
    the distance in 3D according to Pythagoras
  - getCoordinate
```
public final com.vividsolutions.jts.geom.Coordinate getCoordinate()
```
    Returns:
    
    the equivalent geotools Coordinate of this point.
  - getDirectedPoint
```
public final DirectedPoint getDirectedPoint()
```
    Returns:
    
    the equivalent DSOL DirectedPoint of this point. Should the result be cached?
  - getPoint2D
```
public final Point2D getPoint2D()
```
    Returns:
    
    a Point2D with the x and y structure.
  - getLocation
```
public final DirectedPoint getLocation()
```
    Specified by:
    
    getLocation in interface Locatable
  - getBounds
```
public final javax.media.j3d.Bounds getBounds()
```
    This method returns a sphere with a diameter of half a meter as the default bounds for a point.
    
    Specified by:
    
    getBounds in interface Locatable
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object

Class OTSPoint3D

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

x

y

z

Constructor Detail

OTSPoint3D

OTSPoint3D

OTSPoint3D

OTSPoint3D

OTSPoint3D

OTSPoint3D

OTSPoint3D

OTSPoint3D

OTSPoint3D

OTSPoint3D

Method Detail

interpolate

intersectionOfLineSegmentsDumb

intersectionOfLineSegments

intersectionOfLinesDumb

intersectionOfLines

closestPointOnSegment

closestPointOnLine

closestPointOnLine2D

normalize

translate

circleCenter

circleIntersections

distanceSI

horizontalDistanceSI

horizontalDistance

distance

getCoordinate

getDirectedPoint

getPoint2D

getLocation

getBounds

toString

hashCode

equals