fr.cnes.sirius.patrius.math.geometry.euclidean.threed

Class RightCircularCylinder

java.lang.Object

fr.cnes.sirius.patrius.math.geometry.euclidean.threed.RightCircularCylinder

All Implemented Interfaces:

CrossSectionProvider, Cylinder, Shape, SolidShape, Serializable

public final class RightCircularCylinder
extends Object
implements CrossSectionProvider, Cylinder, Serializable

This is a describing class for a 3D right circular cylinder ended by two planes normal to its axis, with some algorithm to compute intersections and distances to some other objects.

Since:

1.0

Version:

$Id: RightCircularCylinder.java 17583 2017-05-10 13:05:10Z bignon $

Author:

Thomas Trapier

See Also:

Shape.distanceTo(Line), Shape.intersects(Line), Serialized Form

Use sample :

Creation with a radius, a height and two Vector3D : Vector3D origin = new Vector3D(1.0, 6.0, -2.0); Vector3D direction = new Vector3D(6.0, -3.0, -1.0); double radius = 2.0; double length = 5.0; RightCircularCylinder cylinder = new RightCircularCylinder(origin, direction, radius, height); Creation with a line, a height and a radius : RightCircularCylinder cylinder = new RightCircularCylinder(line, radius, height); Intersection with a line : boolean intersects = cylinder(line);

Concurrency :

immutable

Constructor Summary

Constructors

Constructor and Description
RightCircularCylinder(Line inDirection, double inRadius, double inLength) Build a right circular cylinder from its radius and its axis as a line
RightCircularCylinder(Vector3D inDirection, double inBaseSurface, double inTransversalSurface) Build an right circular cylinder from its base surface and transversal surface.
RightCircularCylinder(Vector3D inOrigin, Vector3D inDirection, double inRadius, double inHeight) Build a right circular cylinder from its radius and the origin and direction of its axis

Method Summary

Modifier and Type	Method and Description
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	getBaseSurface() Returns the surface of the cylinder base.
double	getCrossSection(Vector3D crossDirection) Computes the cross section from the direction defined by a Vector3D.
Vector3D	getDirection()
double	getEquivalentTransversalSurf() Get equivalent transversal surface.
static double	getHeightFromSurfaces(double inBaseSurface, double inTransversalSurface) Get height from surfaces.
static double	getHeightFromTSurfaceAndRadius(double transversalSurf, double radius) Get height from the transversal surface and radius.
Vector3D[]	getIntersectionPoints(Line line) Compute the intersection points with a line.
double	getLength()
Vector3D	getOrigin()
double	getRadius()
static double	getRadiusFramSurfaces(double inBaseSurface, double inTransversalSurface) Get radius from surfaces.
double	getTransversalSurf() Get transversal surface.
static double	getTSurfaceFromRadiusAndHeight(double radius, double height) Get transversal surface from radius and height.
boolean	intersects(Line line) Tests the intersection with a line.
String	toString() Get a representation for this right circular cylinder.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RightCircularCylinder

public RightCircularCylinder(Line inDirection,
                             double inRadius,
                             double inLength)

Build a right circular cylinder from its radius and its axis as a line

Parameters:

inDirection - the direction of the axis of the cylinder

inRadius - the radius of the cylinder

inLength - the height of the cylinder on its axis

Throws:

IllegalArgumentException - if the radius or the height is negative or null, or if the direction vector has a null norm.

RightCircularCylinder

public RightCircularCylinder(Vector3D inOrigin,
                             Vector3D inDirection,
                             double inRadius,
                             double inHeight)

Build a right circular cylinder from its radius and the origin and direction of its axis

Parameters:

inOrigin - the origin of the axis

inDirection - the direction of the axis

inRadius - the radius of the cylinder

inHeight - the height of the cylinder on its axis

Throws:

IllegalArgumentException - if the radius or the height is negative or null, or if the direction vector has a null norm.

RightCircularCylinder

public RightCircularCylinder(Vector3D inDirection,
                             double inBaseSurface,
                             double inTransversalSurface)

Build an right circular cylinder from its base surface and transversal surface.

Parameters:

inDirection - the direction of the axis

inBaseSurface - the base surface of the cylinder

inTransversalSurface - the transversal surface of the cylinder

Throws:

IllegalArgumentException - if the radius or the height is negative or null, or if the direction vector has a null norm.

Method Detail

getOrigin

public Vector3D getOrigin()

Returns:

the origin

getDirection

public Vector3D getDirection()

Returns:

the direction

getLength

public double getLength()

Returns:

the height

getRadius

public double getRadius()

Returns:

the radius

getBaseSurface

public double getBaseSurface()

Returns the surface of the cylinder base.

Returns:

the surface of the cylinder base

getTransversalSurf

public double getTransversalSurf()

Get transversal surface.

Returns:

the transversal surface

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 right circular cylinder. The given parameters are in the same order as in the constructor.

Overrides:

toString in class Object

Returns:

a representation for this right circular cylinder

getCrossSection

public double getCrossSection(Vector3D crossDirection)

Computes the cross section from the direction defined by a Vector3D.

Specified by:

getCrossSection in interface CrossSectionProvider

Parameters:

crossDirection - the direction vector

Returns:

the cross section

getEquivalentTransversalSurf

public double getEquivalentTransversalSurf()

Get equivalent transversal surface. This surface is used in order to modelize the cylinder as a parallelepiped.

Returns:

the transveral surface of the equivalent parallelepiped

getHeightFromTSurfaceAndRadius

public static double getHeightFromTSurfaceAndRadius(double transversalSurf,
                                                    double radius)

Get height from the transversal surface and radius.

Parameters:

transversalSurf - cylinder transversal surface

radius - cylinder radius

Returns:

the cylinder length

getTSurfaceFromRadiusAndHeight

public static double getTSurfaceFromRadiusAndHeight(double radius,
                                                    double height)

Get transversal surface from radius and height.

Parameters:

radius - cylinder radius

height - cylinder height

Returns:

the transversal surface

getRadiusFramSurfaces

public static double getRadiusFramSurfaces(double inBaseSurface,
                                           double inTransversalSurface)

Get radius from surfaces.

Parameters:

inBaseSurface - the base surface of the cylinder

inTransversalSurface - the transversal surface of the cylinder

getHeightFromSurfaces

public static double getHeightFromSurfaces(double inBaseSurface,
                                           double inTransversalSurface)

Get height from surfaces.

Parameters:

inBaseSurface - the base surface of the cylinder

inTransversalSurface - the transversal surface of the cylinder