Gazebo Math

API Reference

7.5.1

The Vector3 class represents the generic vector containing 3 elements. Since it's commonly used to keep coordinate system related information, its elements are labeled by x, y, z. More...

#include <gz/math/Vector3.hh>

Public Member Functions

constexpr Vector3 ()
 Constructor. More...
 
constexpr Vector3 (const T &_x, const T &_y, const T &_z)
 Constructor. More...
 
 Vector3 (const Vector3< T > &_v)=default
 Copy constructor. More...
 
 ~Vector3 ()=default
 Destructor. More...
 
Vector3 Abs () const
 Get the absolute value of the vector. More...
 
AbsDot (const Vector3< T > &_v) const
 Return the absolute dot product of this vector and another vector. This is similar to the Dot function, except the absolute value of each component of the vector is used. More...
 
void Correct ()
 Corrects any nan values. More...
 
Vector3 Cross (const Vector3< T > &_v) const
 Return the cross product of this vector with another vector. More...
 
Distance (const Vector3< T > &_pt) const
 Calc distance to the given point. More...
 
Distance (T _x, T _y, T _z) const
 Calc distance to the given point. More...
 
DistToLine (const Vector3< T > &_pt1, const Vector3 &_pt2)
 Get distance to an infinite line defined by 2 points. More...
 
Dot (const Vector3< T > &_v) const
 Return the dot product of this vector and another vector. More...
 
bool Equal (const Vector3 &_v, const T &_tol) const
 Equality test with tolerance. More...
 
bool Equal (const Vector3< T > &_v) const
 Equality test. More...
 
bool IsFinite () const
 See if a point is finite (e.g., not nan) More...
 
Length () const
 Returns the length (magnitude) of the vector. More...
 
Max () const
 Get the maximum value in the vector. More...
 
void Max (const Vector3< T > &_v)
 Set this vector's components to the maximum of itself and the passed in vector. More...
 
MaxAbs () const
 Get the number with the maximum absolute value in the vector. More...
 
Min () const
 Get the minimum value in the vector. More...
 
void Min (const Vector3< T > &_v)
 Set this vector's components to the minimum of itself and the passed in vector. More...
 
MinAbs () const
 Get the number with the maximum absolute value in the vector. More...
 
Vector3 Normalize ()
 Normalize the vector length. More...
 
Vector3 Normalized () const
 Return a normalized vector. More...
 
bool operator!= (const Vector3< T > &_v) const
 Not equal to operator. More...
 
Vector3< T > operator* (const Vector3< T > &_p) const
 Multiplication operator. More...
 
Vector3< T > operator* (T _s) const
 Multiplication operators. More...
 
const Vector3< T > & operator*= (const Vector3< T > &_v)
 Multiplication assignment operators. More...
 
const Vector3< T > & operator*= (T _v)
 Multiplication operator. More...
 
Vector3< T > operator+ (const T _s) const
 Addition operators. More...
 
Vector3 operator+ (const Vector3< T > &_v) const
 Addition operator. More...
 
const Vector3< T > & operator+= (const T _s)
 Addition assignment operator. More...
 
const Vector3operator+= (const Vector3< T > &_v)
 Addition assignment operator. More...
 
Vector3 operator- () const
 Negation operator. More...
 
Vector3< T > operator- (const T _s) const
 Subtraction operators. More...
 
Vector3< T > operator- (const Vector3< T > &_pt) const
 Subtraction operators. More...
 
const Vector3< T > & operator-= (const T _s)
 Subtraction assignment operator. More...
 
const Vector3< T > & operator-= (const Vector3< T > &_pt)
 Subtraction assignment operators. More...
 
const Vector3< T > operator/ (const Vector3< T > &_pt) const
 Division operator. More...
 
const Vector3< T > operator/ (T _v) const
 Division operator. More...
 
const Vector3< T > & operator/= (const Vector3< T > &_pt)
 Division assignment operator. More...
 
const Vector3< T > & operator/= (T _v)
 Division assignment operator. More...
 
bool operator< (const Vector3< T > &_pt) const
 Less than operator. More...
 
Vector3operator= (const Vector3< T > &_v)=default
 Assignment operator. More...
 
Vector3operator= (T _v)
 Assignment operator. More...
 
bool operator== (const Vector3< T > &_v) const
 Equal to operator. More...
 
T & operator[] (const std::size_t _index)
 Array subscript operator. More...
 
operator[] (const std::size_t _index) const
 Const-qualified array subscript operator. More...
 
Vector3 Perpendicular () const
 Return a vector that is perpendicular to this one. More...
 
Vector3 Round ()
 Round to near whole number, return the result. More...
 
void Round (int _precision)
 Round all values to _precision decimal places. More...
 
Vector3 Rounded () const
 Get a rounded version of this vector. More...
 
void Set (T _x=0, T _y=0, T _z=0)
 Set the contents of the vector. More...
 
SquaredLength () const
 Return the square of the length (magnitude) of the vector. More...
 
Sum () const
 Return the sum of the values. More...
 
T & X ()
 Get a mutable reference to the x value. More...
 
X () const
 Get the x value. More...
 
void X (const T &_v)
 Set the x value. More...
 
T & Y ()
 Get a mutable reference to the y value. More...
 
Y () const
 Get the y value. More...
 
void Y (const T &_v)
 Set the y value. More...
 
T & Z ()
 Get a mutable reference to the z value. More...
 
Z () const
 Get the z value. More...
 
void Z (const T &_v)
 Set the z value. More...
 

Static Public Member Functions

static Vector3 Normal (const Vector3< T > &_v1, const Vector3< T > &_v2, const Vector3< T > &_v3)
 Get a normal vector to a triangle. More...
 

Static Public Attributes

static const Vector3NaN = detail::gVector3NaN<T>
 math::Vector3(NaN, NaN, NaN) More...
 
static const Vector3One = detail::gVector3One<T>
 math::Vector3(1, 1, 1) More...
 
static const Vector3UnitX = detail::gVector3UnitX<T>
 math::Vector3(1, 0, 0) More...
 
static const Vector3UnitY = detail::gVector3UnitY<T>
 math::Vector3(0, 1, 0) More...
 
static const Vector3UnitZ = detail::gVector3UnitZ<T>
 math::Vector3(0, 0, 1) More...
 
static const Vector3Zero = detail::gVector3Zero<T>
 math::Vector3(0, 0, 0) More...
 

Detailed Description

template<typename T>
class gz::math::Vector3< T >

The Vector3 class represents the generic vector containing 3 elements. Since it's commonly used to keep coordinate system related information, its elements are labeled by x, y, z.

Constructor & Destructor Documentation

◆ Vector3() [1/3]

◆ Vector3() [2/3]

constexpr Vector3 ( const T &  _x,
const T &  _y,
const T &  _z 
)
inlineconstexpr

Constructor.

Parameters
[in]_xvalue along x
[in]_yvalue along y
[in]_zvalue along z

◆ Vector3() [3/3]

Vector3 ( const Vector3< T > &  _v)
default

Copy constructor.

Parameters
[in]_va vector

◆ ~Vector3()

~Vector3 ( )
default

Destructor.

Member Function Documentation

◆ Abs()

Vector3 Abs ( ) const
inline

Get the absolute value of the vector.

Returns
a vector with positive elements

References Vector3< T >::Vector3().

Referenced by Quaternion< T >::SetFrom2Axes(), and OrientedBox< T >::Size().

◆ AbsDot()

T AbsDot ( const Vector3< T > &  _v) const
inline

Return the absolute dot product of this vector and another vector. This is similar to the Dot function, except the absolute value of each component of the vector is used.

result = abs(x1 * x2) + abs(y1 * y2) + abs(z1 *z2)

Parameters
[in]_vthe vector
Returns
The absolute dot product

◆ Correct()

void Correct ( )
inline

Corrects any nan values.

References std::isfinite().

◆ Cross()

Vector3 Cross ( const Vector3< T > &  _v) const
inline

Return the cross product of this vector with another vector.

Parameters
[in]_va vector
Returns
the cross product

References Vector3< T >::Vector3().

Referenced by Vector3< T >::DistToLine(), Plane< T >::Intersection(), Vector3< T >::Normal(), Quaternion< T >::operator*(), Vector3< T >::Perpendicular(), Matrix3< T >::SetFrom2Axes(), and Quaternion< T >::SetFrom2Axes().

◆ Distance() [1/2]

T Distance ( const Vector3< T > &  _pt) const
inline

Calc distance to the given point.

Parameters
[in]_ptthe point
Returns
the distance

Referenced by Vector3< T >::Distance().

◆ Distance() [2/2]

T Distance ( _x,
_y,
_z 
) const
inline

Calc distance to the given point.

Parameters
[in]_xvalue along x
[in]_yvalue along y
[in]_zvalue along z
Returns
the distance

References Vector3< T >::Vector3(), and Vector3< T >::Distance().

◆ DistToLine()

T DistToLine ( const Vector3< T > &  _pt1,
const Vector3< T > &  _pt2 
)
inline

Get distance to an infinite line defined by 2 points.

Parameters
[in]_pt1first point on the line
[in]_pt2second point on the line
Returns
the minimum distance from this point to the line

References Vector3< T >::Cross(), and Vector3< T >::Length().

◆ Dot()

T Dot ( const Vector3< T > &  _v) const
inline

Return the dot product of this vector and another vector.

Parameters
[in]_vthe vector
Returns
the dot product

Referenced by Triangle3< T >::Contains(), Line3< T >::Distance(), Plane< T >::Distance(), Plane< T >::Intersection(), Triangle3< T >::Intersects(), Matrix3< T >::SetFrom2Axes(), and Quaternion< T >::SetFrom2Axes().

◆ Equal() [1/2]

bool Equal ( const Vector3< T > &  _v,
const T &  _tol 
) const
inline

Equality test with tolerance.

Parameters
[in]_vthe vector to compare to
[in]_tolequality tolerance.
Returns
true if the elements of the vectors are equal within the tolerence specified by _tol.

Referenced by Vector3< T >::operator==(), and MassMatrix3< T >::PrincipalAxesOffset().

◆ Equal() [2/2]

bool Equal ( const Vector3< T > &  _v) const
inline

Equality test.

Remarks
This is equivalent to the == operator
Parameters
[in]_vthe other vector
Returns
true if the 2 vectors have the same values, false otherwise

◆ IsFinite()

bool IsFinite ( ) const
inline

See if a point is finite (e.g., not nan)

Returns
true if is finite or false otherwise

References std::isfinite().

◆ Length()

T Length ( ) const
inline

Returns the length (magnitude) of the vector.

Returns
the length

References Vector3< T >::SquaredLength().

Referenced by Line3< T >::Distance(), Vector3< T >::DistToLine(), and Vector3< T >::Normalize().

◆ Max() [1/2]

T Max ( ) const
inline

Get the maximum value in the vector.

Returns
the maximum element

References std::max().

◆ Max() [2/2]

void Max ( const Vector3< T > &  _v)
inline

Set this vector's components to the maximum of itself and the passed in vector.

Parameters
[in]_vthe maximum clamping vector

◆ MaxAbs()

T MaxAbs ( ) const
inline

Get the number with the maximum absolute value in the vector.

Returns
the element with maximum absolute value

References gz::math::max(), and std::max().

◆ Min() [1/2]

T Min ( ) const
inline

Get the minimum value in the vector.

Returns
the minimum element

References std::min().

◆ Min() [2/2]

void Min ( const Vector3< T > &  _v)
inline

Set this vector's components to the minimum of itself and the passed in vector.

Parameters
[in]_vthe minimum clamping vector

Referenced by MassMatrix3< T >::SetFromBox().

◆ MinAbs()

T MinAbs ( ) const
inline

Get the number with the maximum absolute value in the vector.

Returns
the element with minimum absolute value

References gz::math::min(), and std::min().

◆ Normal()

static Vector3 Normal ( const Vector3< T > &  _v1,
const Vector3< T > &  _v2,
const Vector3< T > &  _v3 
)
inlinestatic

Get a normal vector to a triangle.

Parameters
[in]_v1first vertex of the triangle
[in]_v2second vertex
[in]_v3third vertex
Returns
the normal

References Vector3< T >::Cross(), and Vector3< T >::Normalize().

Referenced by Triangle3< T >::Normal().

◆ Normalize()

Vector3 Normalize ( )
inline

◆ Normalized()

Vector3 Normalized ( ) const
inline

Return a normalized vector.

Returns
unit length vector

References Vector3< T >::Normalize().

◆ operator!=()

bool operator!= ( const Vector3< T > &  _v) const
inline

Not equal to operator.

Parameters
[in]_vThe vector to compare against
Returns
false if each component is equal within a default tolerence (1e-3), true otherwise

◆ operator*() [1/2]

Vector3<T> operator* ( const Vector3< T > &  _p) const
inline

Multiplication operator.

Remarks
this is an element wise multiplication, not a cross product
Parameters
[in]_pmultiplier operator
Returns
a vector

References Vector3< T >::Vector3().

◆ operator*() [2/2]

Vector3<T> operator* ( _s) const
inline

Multiplication operators.

Parameters
[in]_sthe scaling factor
Returns
a scaled vector

◆ operator*=() [1/2]

const Vector3<T>& operator*= ( const Vector3< T > &  _v)
inline

Multiplication assignment operators.

Remarks
this is an element wise multiplication, not a cross product
Parameters
[in]_va vector
Returns
this

◆ operator*=() [2/2]

const Vector3<T>& operator*= ( _v)
inline

Multiplication operator.

Parameters
[in]_vscaling factor
Returns
this

◆ operator+() [1/2]

Vector3<T> operator+ ( const T  _s) const
inline

Addition operators.

Parameters
[in]_sthe scalar addend
Returns
sum vector

◆ operator+() [2/2]

Vector3 operator+ ( const Vector3< T > &  _v) const
inline

Addition operator.

Parameters
[in]_vvector to add
Returns
the sum vector

References Vector3< T >::Vector3().

◆ operator+=() [1/2]

const Vector3<T>& operator+= ( const T  _s)
inline

Addition assignment operator.

Parameters
[in]_sscalar addend
Returns
this

◆ operator+=() [2/2]

const Vector3& operator+= ( const Vector3< T > &  _v)
inline

Addition assignment operator.

Parameters
[in]_vvector to add
Returns
the sum vector

◆ operator-() [1/3]

Vector3 operator- ( ) const
inline

Negation operator.

Returns
negative of this vector

References Vector3< T >::Vector3().

◆ operator-() [2/3]

Vector3<T> operator- ( const T  _s) const
inline

Subtraction operators.

Parameters
[in]_sthe scalar subtrahend
Returns
difference vector

◆ operator-() [3/3]

Vector3<T> operator- ( const Vector3< T > &  _pt) const
inline

Subtraction operators.

Parameters
[in]_pta vector to substract
Returns
a vector after the substraction

References Vector3< T >::Vector3().

◆ operator-=() [1/2]

const Vector3<T>& operator-= ( const T  _s)
inline

Subtraction assignment operator.

Parameters
[in]_sscalar subtrahend
Returns
this

◆ operator-=() [2/2]

const Vector3<T>& operator-= ( const Vector3< T > &  _pt)
inline

Subtraction assignment operators.

Parameters
[in]_ptsubtrahend
Returns
a vector after the substraction

◆ operator/() [1/2]

const Vector3<T> operator/ ( const Vector3< T > &  _pt) const
inline

Division operator.

Remarks
this is an element wise division
Parameters
[in]_ptthe vector divisor
Returns
a vector

References Vector3< T >::Vector3().

◆ operator/() [2/2]

const Vector3<T> operator/ ( _v) const
inline

Division operator.

Remarks
this is an element wise division
Parameters
[in]_vthe divisor
Returns
a vector

References Vector3< T >::Vector3().

◆ operator/=() [1/2]

const Vector3<T>& operator/= ( const Vector3< T > &  _pt)
inline

Division assignment operator.

Remarks
this is an element wise division
Parameters
[in]_ptthe vector divisor
Returns
a vector

◆ operator/=() [2/2]

const Vector3<T>& operator/= ( _v)
inline

Division assignment operator.

Remarks
this is an element wise division
Parameters
[in]_vthe divisor
Returns
this

◆ operator<()

bool operator< ( const Vector3< T > &  _pt) const
inline

Less than operator.

Parameters
[in]_ptVector to compare.
Returns
True if this vector's X(), Y(), or Z() value is less than the given vector's corresponding values.

◆ operator=() [1/2]

Vector3& operator= ( const Vector3< T > &  _v)
default

Assignment operator.

Parameters
[in]_va new value
Returns
this

◆ operator=() [2/2]

Vector3& operator= ( _v)
inline

Assignment operator.

Parameters
[in]_vassigned to all elements
Returns
this

◆ operator==()

bool operator== ( const Vector3< T > &  _v) const
inline

Equal to operator.

Parameters
[in]_vThe vector to compare against
Returns
true if each component is equal within a default tolerence (1e-3), false otherwise

References Vector3< T >::Equal().

◆ operator[]() [1/2]

T& operator[] ( const std::size_t  _index)
inline

Array subscript operator.

Parameters
[in]_indexThe index, where 0 == x, 1 == y, 2 == z. The index is clamped to the range [0,2].
Returns
The value.

References gz::math::clamp(), gz::math::GZ_TWO_SIZE_T, and gz::math::GZ_ZERO_SIZE_T.

◆ operator[]() [2/2]

T operator[] ( const std::size_t  _index) const
inline

Const-qualified array subscript operator.

Parameters
[in]_indexThe index, where 0 == x, 1 == y, 2 == z. The index is clamped to the range [0,2].
Returns
The value.

References gz::math::clamp(), gz::math::GZ_TWO_SIZE_T, and gz::math::GZ_ZERO_SIZE_T.

◆ Perpendicular()

Vector3 Perpendicular ( ) const
inline

Return a vector that is perpendicular to this one.

Returns
an orthogonal vector

References Vector3< T >::Vector3(), Vector3< T >::Cross(), and Vector3< T >::SquaredLength().

◆ Round() [1/2]

Vector3 Round ( )
inline

Round to near whole number, return the result.

Returns
the result

References std::nearbyint().

Referenced by Vector3< T >::Rounded().

◆ Round() [2/2]

void Round ( int  _precision)
inline

Round all values to _precision decimal places.

Parameters
[in]_precisionthe decimal places

References gz::math::precision().

◆ Rounded()

Vector3 Rounded ( ) const
inline

Get a rounded version of this vector.

Returns
a rounded vector

References Vector3< T >::Round().

◆ Set()

void Set ( _x = 0,
_y = 0,
_z = 0 
)
inline

Set the contents of the vector.

Parameters
[in]_xvalue along x
[in]_yvalue along y
[in]_zvalue aling z

Referenced by Quaternion< T >::AxisAngle(), Quaternion< T >::SetFrom2Axes(), and Matrix4< T >::TransformAffine().

◆ SquaredLength()

T SquaredLength ( ) const
inline

Return the square of the length (magnitude) of the vector.

Returns
the squared length

Referenced by Quaternion< T >::Integrate(), Vector3< T >::Length(), Vector3< T >::Perpendicular(), Matrix3< T >::SetFrom2Axes(), and Quaternion< T >::SetFrom2Axes().

◆ Sum()

T Sum ( ) const
inline

Return the sum of the values.

Returns
the sum

Referenced by MassMatrix3< T >::Epsilon(), and MassMatrix3< T >::PrincipalMoments().

◆ X() [1/3]

T& X ( )
inline

Get a mutable reference to the x value.

Returns
The x component of the vector

◆ X() [2/3]

◆ X() [3/3]

void X ( const T &  _v)
inline

Set the x value.

Parameters
[in]_vValue for the x component.

◆ Y() [1/3]

T& Y ( )
inline

Get a mutable reference to the y value.

Returns
The y component of the vector

◆ Y() [2/3]

◆ Y() [3/3]

void Y ( const T &  _v)
inline

Set the y value.

Parameters
[in]_vValue for the y component.

◆ Z() [1/3]

T& Z ( )
inline

Get a mutable reference to the z value.

Returns
The z component of the vector

◆ Z() [2/3]

◆ Z() [3/3]

void Z ( const T &  _v)
inline

Set the z value.

Parameters
[in]_vValue for the z component.

Member Data Documentation

◆ NaN

const Vector3< T > & NaN = detail::gVector3NaN<T>
static

math::Vector3(NaN, NaN, NaN)

◆ One

const Vector3< T > & One = detail::gVector3One<T>
static

math::Vector3(1, 1, 1)

◆ UnitX

const Vector3< T > & UnitX = detail::gVector3UnitX<T>
static

math::Vector3(1, 0, 0)

◆ UnitY

const Vector3< T > & UnitY = detail::gVector3UnitY<T>
static

math::Vector3(0, 1, 0)

◆ UnitZ

const Vector3< T > & UnitZ = detail::gVector3UnitZ<T>
static

math::Vector3(0, 0, 1)

◆ Zero

const Vector3< T > & Zero = detail::gVector3Zero<T>
static

math::Vector3(0, 0, 0)


The documentation for this class was generated from the following file: