org.apache.commons.math3.geometry.euclidean.threed
Class EllipticCone

java.lang.Object
  extended by org.apache.commons.math3.geometry.euclidean.threed.EllipticCone
All Implemented Interfaces:
Serializable, Cone, Shape, SolidShape

public final class EllipticCone
extends Object
implements Cone, Serializable

This is a describing class for a 3D oblique circular cone ended by a plane normal to its axis, with some algorithm to compute intersections and distances to some other objects.

Since:
1.0
Version:
$Id: EllipticCone.java 11374 2014-10-30 15:39:29Z sabatini $
Author:
Thomas Trapier
See Also:
Shape.distanceTo(Line), Shape.intersects(Line), Serialized Form
Use sample :

Creation with two angles, a height and three Vector3D : Vector3D origin = new Vector3D(1.0, 6.0, -2.0); Vector3D direction = new Vector3D(6.0, -3.0, -1.0); Vector3D uVector = new Vector3D(-5.0, 3.0, 0.0); double angleU = 2.0; double angleV = 2.0; double height = 5.0; ObliqueCircularCone cone = new ObliqueCircularCone(origin, direction, uVector, angleU, angleV, length); Intersection with a line : boolean intersects = cone(line);

Concurrency :
immutable

Constructor Summary
EllipticCone(Vector3D inOrigin, Vector3D inDirection, Vector3D inUvector, double inAngleU, double inAngleV, double inHeight)
          Build an oblique circular cone from its radius, the height, the origin (apex), the approximative u vector of the local frame and direction of its axis.
 
Method Summary
 Vector3D[] closestPointTo(Line line)
          Computes the points of the shape and the line realizing the shortest distance.
 double distanceTo(Line line)
          Computes the distance to a line.
 double getAngleU()
           
 double getAngleV()
           
 Vector3D getDirection()
           
 double getHeight()
           
 Vector3D[] getIntersectionPoints(Line line)
          Compute the intersection points with a line.
 Vector3D getOrigin()
           
 Vector3D getU()
           
 Vector3D getV()
           
 boolean intersects(Line line)
          Tests the intersection with a line.
 String toString()
          Get a representation for this oblique circular cone.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

EllipticCone

public EllipticCone(Vector3D inOrigin,
                    Vector3D inDirection,
                    Vector3D inUvector,
                    double inAngleU,
                    double inAngleV,
                    double inHeight)
Build an oblique circular cone from its radius, the height, the origin (apex), the approximative u vector of the local frame and direction of its axis.

Parameters:
inOrigin - the origin of the axis
inDirection - the direction of the axis
inUvector - approximative U vector of the local frame : corrected to be orthogonal to the direction
inAngleU - the angle of the cone on U direction
inAngleV - the angle of the cone on V direction
inHeight - the height of the cone on its axis
Throws:
IllegalArgumentException - if one angle or the height is negative or null, or if the direction vector or u vector has a null norm, or if they are parallel.
Method Detail

getHeight

public double getHeight()
Returns:
the height

getOrigin

public Vector3D getOrigin()
Returns:
the origin

getDirection

public Vector3D getDirection()
Returns:
the direction

getAngleU

public double getAngleU()
Returns:
the angle in U/W plane

getAngleV

public double getAngleV()
Returns:
the angle in U/W plane

getU

public Vector3D getU()
Returns:
the u vector for the local frame

getV

public Vector3D getV()
Returns:
the v vector for the local frame

intersects

public boolean intersects(Line line)
Tests the intersection with a line.

Specified by:
intersects in interface Shape
Parameters:
line - the line
Returns:
true if the line intersects the shape

getIntersectionPoints

public Vector3D[] getIntersectionPoints(Line line)
Compute the intersection points with a line.

Specified by:
getIntersectionPoints in interface Shape
Parameters:
line - the line
Returns:
the intersection points if they exist. If no intersection is found, the dimension is zero

distanceTo

public double distanceTo(Line line)
Computes the distance to a line.

Specified by:
distanceTo in interface Shape
Parameters:
line - the line
Returns:
the shortest distance between the the line and the shape

closestPointTo

public Vector3D[] closestPointTo(Line line)
Computes the points of the shape and the line realizing the shortest distance. If the line intersects the shape, the returned points are identical : this point is the first common point found.

Specified by:
closestPointTo in interface Shape
Parameters:
line - the line
Returns:
the two points : first the one from the line, and the one from the shape.

toString

public String toString()
Get a representation for this oblique circular cone. The given parameters are in the same order as in the constructor.

Overrides:
toString in class Object
Returns:
a representation for this oblique circular cone


Copyright © 2016 CNES. All Rights Reserved.