![]() |
Visual Servoing Platform
version 3.2.0
|
#include <vpThetaUVector.h>
Public Member Functions | |
vpThetaUVector () | |
vpThetaUVector (const vpThetaUVector &tu) | |
vpThetaUVector (const vpHomogeneousMatrix &M) | |
vpThetaUVector (const vpPoseVector &p) | |
vpThetaUVector (const vpRotationMatrix &R) | |
vpThetaUVector (const vpRzyxVector &rzyx) | |
vpThetaUVector (const vpRzyzVector &rzyz) | |
vpThetaUVector (const vpRxyzVector &rxyz) | |
vpThetaUVector (const vpQuaternionVector &q) | |
vpThetaUVector (const vpColVector &tu) | |
vpThetaUVector (const std::vector< double > &tu) | |
vpThetaUVector (const double tux, const double tuy, const double tuz) | |
virtual | ~vpThetaUVector () |
vpThetaUVector | buildFrom (const vpHomogeneousMatrix &M) |
vpThetaUVector | buildFrom (const vpPoseVector &p) |
vpThetaUVector | buildFrom (const vpRotationMatrix &R) |
vpThetaUVector | buildFrom (const vpRzyxVector &rzyx) |
vpThetaUVector | buildFrom (const vpRzyzVector &zyz) |
vpThetaUVector | buildFrom (const vpRxyzVector &xyz) |
vpThetaUVector | buildFrom (const vpQuaternionVector &q) |
vpThetaUVector | buildFrom (const vpColVector &tu) |
vpThetaUVector | buildFrom (const std::vector< double > &tu) |
void | buildFrom (const double tux, const double tuy, const double tuz) |
void | extract (double &theta, vpColVector &u) const |
double | getTheta () const |
vpColVector | getU () const |
vpThetaUVector & | operator= (const vpColVector &tu) |
vpThetaUVector & | operator= (double x) |
Inherited functionalities from vpRotationVector | |
double & | operator[] (unsigned int i) |
const double & | operator[] (unsigned int i) const |
vpColVector | operator* (double x) const |
double | sumSquare () const |
vpRowVector | t () const |
std::vector< double > | toStdVector () |
Inherited functionalities from vpArray2D | |
unsigned int | getCols () const |
double | getMaxValue () const |
double | getMinValue () const |
unsigned int | getRows () const |
unsigned int | size () const |
void | resize (const unsigned int nrows, const unsigned int ncols, const bool flagNullify=true, const bool recopy_=true) |
vpArray2D< double > | hadamard (const vpArray2D< double > &m) const |
Static Public Member Functions | |
Inherited I/O from vpArray2D with Static Public Member Functions | |
static bool | load (const std::string &filename, vpArray2D< double > &A, const bool binary=false, char *header=NULL) |
static bool | loadYAML (const std::string &filename, vpArray2D< double > &A, char *header=NULL) |
static bool | save (const std::string &filename, const vpArray2D< double > &A, const bool binary=false, const char *header="") |
static bool | saveYAML (const std::string &filename, const vpArray2D< double > &A, const char *header="") |
Public Attributes | |
double * | data |
Protected Attributes | |
unsigned int | rowNum |
unsigned int | colNum |
double ** | rowPtrs |
unsigned int | dsize |
Related Functions | |
(Note that these are not member functions.) | |
vpColVector | operator* (const double &x, const vpRotationVector &v) |
enum | vpGEMMmethod |
void | vpGEMM (const vpArray2D< double > &A, const vpArray2D< double > &B, const double &alpha, const vpArray2D< double > &C, const double &beta, vpArray2D< double > &D, const unsigned int &ops=0) |
Implementation of a rotation vector as axis-angle minimal representation.
Class that consider the case of the parameterization for the rotation.
The vpThetaUVector class is derived from vpRotationVector.
The representation is one of the minimal representation of a rotation matrix, where
is a unit vector representing the rotation axis and
is the rotation angle.
From the representation it is possible to build the rotation matrix
using the Rodrigues formula:
with the identity matrix of dimension
and
the skew matrix:
From the implementation point of view, it is nothing more than an array of three floats.
The code below shows first how to initialize a vector, than how to contruct a rotation matrix from a vpThetaUVector and finaly how to extract the theta U angles from the build rotation matrix.
Definition at line 145 of file vpThetaUVector.h.
vpThetaUVector::vpThetaUVector | ( | ) |
Default constructor that initialize all the 3 angles to zero.
Definition at line 52 of file vpThetaUVector.cpp.
vpThetaUVector::vpThetaUVector | ( | const vpThetaUVector & | tu | ) |
Copy constructor.
Definition at line 54 of file vpThetaUVector.cpp.
|
explicit |
Initialize a vector from an homogeneous matrix.
Definition at line 64 of file vpThetaUVector.cpp.
|
explicit |
Initialize a vector from a pose vector.
Definition at line 68 of file vpThetaUVector.cpp.
|
explicit |
Initialize a vector from a rotation matrix.
Definition at line 72 of file vpThetaUVector.cpp.
|
explicit |
Initialize a vector from an Euler z-y-x representation vector.
Definition at line 77 of file vpThetaUVector.cpp.
|
explicit |
Initialize a vector from an Euler z-y-z representation vector.
Definition at line 81 of file vpThetaUVector.cpp.
|
explicit |
Initialize a vector from an Euler x-y-z representation vector.
Definition at line 85 of file vpThetaUVector.cpp.
|
explicit |
Initialize a vector from a quaternion representation vector.
Definition at line 89 of file vpThetaUVector.cpp.
|
explicit |
Copy constructor from a 3-dimension vector.
Definition at line 56 of file vpThetaUVector.cpp.
|
explicit |
Build a vector from a vector of 3 angles in radian.
Definition at line 102 of file vpThetaUVector.cpp.
vpThetaUVector::vpThetaUVector | ( | const double | tux, |
const double | tuy, | ||
const double | tuz | ||
) |
Build a vector from 3 angles in radian.
Definition at line 94 of file vpThetaUVector.cpp.
|
inlinevirtual |
Destructor.
Definition at line 172 of file vpThetaUVector.h.
void vpThetaUVector::buildFrom | ( | const double | tux, |
const double | tuy, | ||
const double | tuz | ||
) |
Build a vector from 3 angles in radian.
Definition at line 434 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const std::vector< double > & | tu | ) |
Build a vector from a 3-dim vectors.
Definition at line 236 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpColVector & | tu | ) |
Build a vector from a 3-dim vector.
Definition at line 251 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpHomogeneousMatrix & | M | ) |
Converts an homogeneous matrix into a vector.
Definition at line 110 of file vpThetaUVector.cpp.
Referenced by vpSimulatorAfma6::setPosition().
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpPoseVector & | p | ) |
Converts a pose vector into a vector copying the
values contained in the pose vector.
Definition at line 123 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpQuaternionVector & | q | ) |
Build a vector from a quaternion representation vector.
Definition at line 225 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpRotationMatrix & | R | ) |
Converts a rotation matrix into a vector.
Definition at line 134 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpRxyzVector & | rxyz | ) |
Build a vector from an Euler x-y-z representation vector.
Definition at line 214 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpRzyxVector & | rzyx | ) |
Build a vector from an Euler z-y-x representation vector.
Definition at line 194 of file vpThetaUVector.cpp.
vpThetaUVector vpThetaUVector::buildFrom | ( | const vpRzyzVector & | rzyz | ) |
Build a vector from an Euler z-y-z representation vector.
Definition at line 204 of file vpThetaUVector.cpp.
void vpThetaUVector::extract | ( | double & | theta, |
vpColVector & | u | ||
) | const |
Extract the rotation angle and the unit vector
from the
representation.
theta | : Rotation angle ![]() |
u | : 3-dim unit vector ![]() |
The following example shows how to use this function:
Definition at line 355 of file vpThetaUVector.cpp.
|
inlineinherited |
Return the number of columns of the 2D array.
Definition at line 145 of file vpArray2D.h.
|
inherited |
Return the array max value.
Definition at line 693 of file vpArray2D.h.
|
inherited |
Return the array min value.
Definition at line 676 of file vpArray2D.h.
|
inlineinherited |
Return the number of rows of the 2D array.
Definition at line 155 of file vpArray2D.h.
double vpThetaUVector::getTheta | ( | ) | const |
Get the rotation angle from the
representation.
The following example shows how to use this function:
Definition at line 391 of file vpThetaUVector.cpp.
vpColVector vpThetaUVector::getU | ( | ) | const |
Get the unit vector from the
representation.
The following example shows how to use this function:
Definition at line 416 of file vpThetaUVector.cpp.
Compute the Hadamard product (element wise matrix multiplication).
m | : Second matrix; |
Definition at line 713 of file vpArray2D.h.
|
inlinestaticinherited |
Load a matrix from a file.
filename | : Absolute file name. |
A | : Array to be loaded |
binary | : If true the matrix is loaded from a binary file, else from a text file. |
header | : Header of the file is loaded in this parameter. |
Definition at line 321 of file vpArray2D.h.
|
inlinestaticinherited |
Load an array from a YAML-formatted file.
filename | : absolute file name. |
A | : array to be loaded from the file. |
header | : header of the file is loaded in this parameter. |
Definition at line 433 of file vpArray2D.h.
|
inherited |
Operator that allows to multiply each element of a rotation vector by a scalar.
x | : The scalar. |
Definition at line 88 of file vpRotationVector.cpp.
vpThetaUVector & vpThetaUVector::operator= | ( | const vpColVector & | tu | ) |
Copy operator that initializes a vector from a 3-dimension column vector tu.
tu | : 3-dimension vector containing the values of the ![]() |
Definition at line 315 of file vpThetaUVector.cpp.
vpThetaUVector & vpThetaUVector::operator= | ( | double | v | ) |
Initialize each element of the vector to the same angle value v.
v | : Angle value to set for each element of the ![]() |
Definition at line 284 of file vpThetaUVector.cpp.
|
inlineinherited |
Operator that allows to set the value of an element of the rotation vector: r[i] = value
Definition at line 126 of file vpRotationVector.h.
|
inlineinherited |
Operator that allows to get the value of an element of the rotation vector: value = r[i]
Definition at line 131 of file vpRotationVector.h.
|
inlineinherited |
Set the size of the array and initialize all the values to zero.
nrows | : number of rows. |
ncols | : number of column. |
flagNullify | : if true, then the array is re-initialized to 0 after resize. If false, the initial values from the common part of the array (common part between old and new version of the array) are kept. Default value is true. |
recopy_ | : if true, will perform an explicit recopy of the old data if needed and if flagNullify is set to false. |
Definition at line 170 of file vpArray2D.h.
|
inlinestaticinherited |
Save a matrix to a file.
filename | : Absolute file name. |
A | : Array to be saved. |
binary | : If true the matrix is saved in a binary file, else a text file. |
header | : Optional line that will be saved at the beginning of the file. |
Warning : If you save the matrix as in a text file the precision is less than if you save it in a binary file.
Definition at line 518 of file vpArray2D.h.
|
inlinestaticinherited |
Save an array in a YAML-formatted file.
filename | : absolute file name. |
A | : array to be saved in the file. |
header | : optional lines that will be saved at the beginning of the file. Should be YAML-formatted and will adapt to the indentation if any. |
Here is an example of outputs.
Content of matrix.yml:
Content of matrixIndent.yml:
Definition at line 611 of file vpArray2D.h.
|
inlineinherited |
Return the number of elements of the 2D array.
Definition at line 157 of file vpArray2D.h.
|
inherited |
Return the sum square of all the elements of the rotation vector r(m).
Definition at line 114 of file vpRotationVector.cpp.
|
inherited |
Return the transpose of the rotation vector.
Definition at line 55 of file vpRotationVector.cpp.
|
inherited |
Converts the vpRotationVector to a std::vector.
Definition at line 69 of file vpRotationVector.cpp.
|
related |
Allows to multiply a scalar by rotaion vector.
Definition at line 101 of file vpRotationVector.cpp.
|
related |
This function performs generalized matrix multiplication: D = alpha*op(A)*op(B) + beta*op(C), where op(X) is X or X^T. Operation on A, B and C matrices is described by enumeration vpGEMMmethod().
For example, to compute D = alpha*A^T*B^T+beta*C we need to call :
If C is not used, vpGEMM must be called using an empty array null. Thus to compute D = alpha*A^T*B, we have to call:
vpException::incorrectMatrixSizeError | if the sizes of the matrices do not allow the operations. |
A | : An array that could be a vpMatrix. |
B | : An array that could be a vpMatrix. |
alpha | : A scalar. |
C | : An array that could be a vpMatrix. |
beta | : A scalar. |
D | : The resulting array that could be a vpMatrix. |
ops | : A scalar describing operation applied on the matrices. Possible values are the one defined in vpGEMMmethod(): VP_GEMM_A_T, VP_GEMM_B_T, VP_GEMM_C_T. |
|
related |
Enumeration of the operations applied on matrices in vpGEMM() function.
Operations are :
|
protectedinherited |
Number of columns in the array.
Definition at line 75 of file vpArray2D.h.
|
inherited |
Address of the first element of the data array.
Definition at line 83 of file vpArray2D.h.
|
protectedinherited |
Current array size (rowNum * colNum)
Definition at line 79 of file vpArray2D.h.
|
protectedinherited |
Number of rows in the array.
Definition at line 73 of file vpArray2D.h.
|
protectedinherited |
Address of the first element of each rows.
Definition at line 77 of file vpArray2D.h.