Package org.opentrafficsim.core.math

Class Acceleration3D

java.lang.Object

org.opentrafficsim.core.math.Acceleration3D

All Implemented Interfaces:

Serializable

public class Acceleration3D
extends Object
implements Serializable

A 3D acceleration vector, decomposed in X, Y, and Z-acceleration with easy conversion from and to a spherical coordinate system.
Physicists and mathematicians do not agree on the meaning of theta and phi. In this class the convention in the physics domain is used:

• theta is the angle from the z direction.
• phi is the projected angle in the xy-plane from the x direction.

N.B. In the geography domain yet another convention is used.

Copyright (c) 2013-2022 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See OpenTrafficSim License.

$LastChangedDate: 2015-07-24 02:58:59 +0200 (Fri, 24 Jul 2015) $, @version $Revision: 1147 $, by $Author: averbraeck $, initial version Dec 10, 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor	Description
Acceleration3D(double x, double y, double z, AccelerationUnit unit)	Construct a new Acceleration3D from three double Cartesian coordinates and a acceleration unit.
Acceleration3D(Acceleration x, Acceleration y, Acceleration z)	Construct a new Acceleration3D from three strongly typed Cartesian coordinates.
Acceleration3D(Acceleration acceleration, Direction theta, Direction phi)	Construct a new Acceleration3D from a strongly typed acceleration and polar coordinates.
Acceleration3D(AccelerationVector acceleration)	Construct a new Acceleration3D from vector of strongly typed Cartesian coordinates.

Method Summary

Modifier and Type	Method	Description
Acceleration	getAcceleration()	Retrieve the norm of this Acceleration3D.
Direction	getPhi()	Retrieve the phi of this Acceleration3D.
Direction	getTheta()	Retrieve the theta of this Acceleration3D.
Acceleration	getX()	Retrieve the x-component of this Acceleration3D.
Acceleration	getY()	Retrieve the y-component of this Acceleration3D.
Acceleration	getZ()	Retrieve the z-component of this Acceleration3D.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Acceleration3D

public Acceleration3D(AccelerationVector acceleration)
               throws ValueRuntimeException

Construct a new Acceleration3D from vector of strongly typed Cartesian coordinates.

Parameters:

acceleration - AccelerationVector; the accelerations in 3D (YPR coded)

Throws:

ValueRuntimeException - in case the vector does not have exactly three elements

Acceleration3D

public Acceleration3D(Acceleration x,
                      Acceleration y,
                      Acceleration z)
               throws ValueRuntimeException

Construct a new Acceleration3D from three strongly typed Cartesian coordinates.

Parameters:

x - Acceleration; the acceleration in the x-direction

y - Acceleration; the acceleration in the y-direction

z - Acceleration; the acceleration in the z-direction

Throws:

ValueRuntimeException - in case the units are incorrect

Acceleration3D

public Acceleration3D(double x,
                      double y,
                      double z,
                      AccelerationUnit unit)
               throws ValueRuntimeException

Construct a new Acceleration3D from three double Cartesian coordinates and a acceleration unit.

Parameters:

x - double; the acceleration in the x-direction

y - double; the acceleration in the y-direction

z - double; the acceleration in the z-direction

unit - AccelerationUnit; the unit of the xyz parameters

Throws:

ValueRuntimeException - in case the units are incorrect

Acceleration3D

public Acceleration3D(Acceleration acceleration,
                      Direction theta,
                      Direction phi)
               throws ValueRuntimeException

Construct a new Acceleration3D from a strongly typed acceleration and polar coordinates.

Parameters:

acceleration - Acceleration; the acceleration in the direction of the angle along the vector

theta - Direction; the angle from the z direction

phi - Direction; the projected angle in the xy-plane from the x direction

Throws:

ValueRuntimeException - in case the vector does not have exactly three elements

Method Detail

getX

public final Acceleration getX()

Retrieve the x-component of this Acceleration3D.

Returns:

the acceleration in the x-direction.

getY

public final Acceleration getY()

Retrieve the y-component of this Acceleration3D.

Returns:

the acceleration in the y-direction.

getZ

public final Acceleration getZ()

Retrieve the z-component of this Acceleration3D.

Returns:

the acceleration in the z-direction.

getTheta

public final Direction getTheta()

Retrieve the theta of this Acceleration3D.

Returns:

the angle of direction perpendicular to the xy-plane

getPhi

public final Direction getPhi()

Retrieve the phi of this Acceleration3D.

Returns:

the projected angle of direction in the xy-plane

getAcceleration

public final Acceleration getAcceleration()

Retrieve the norm of this Acceleration3D.

Returns:

the combined acceleration in the direction of the angle

toString

public final String toString()

Overrides:

toString in class Object