![]() |
Visual Servoing Platform
version 3.3.0
|
#include <vpQuaternionVector.h>
Public Member Functions | |
vpQuaternionVector () | |
vpQuaternionVector (const vpQuaternionVector &q) | |
vpQuaternionVector (const double qx, const double qy, const double qz, const double qw) | |
vpQuaternionVector (const vpRotationMatrix &R) | |
vpQuaternionVector (const vpThetaUVector &tu) | |
vpQuaternionVector (const vpColVector &q) | |
vpQuaternionVector (const std::vector< double > &q) | |
virtual | ~vpQuaternionVector () |
vpQuaternionVector | buildFrom (const double qx, const double qy, const double qz, const double qw) |
vpQuaternionVector | buildFrom (const vpRotationMatrix &R) |
vpQuaternionVector | buildFrom (const vpThetaUVector &tu) |
vpQuaternionVector | buildFrom (const vpColVector &q) |
vpQuaternionVector | buildFrom (const std::vector< double > &q) |
void | set (double x, double y, double z, double w) |
double | x () const |
double | y () const |
double | z () const |
double | w () const |
vpQuaternionVector | operator+ (const vpQuaternionVector &q) const |
vpQuaternionVector | operator- (const vpQuaternionVector &q) const |
vpQuaternionVector | operator- () const |
vpQuaternionVector | operator* (double l) const |
vpQuaternionVector | operator* (const vpQuaternionVector &rq) const |
vpQuaternionVector | operator/ (double l) const |
vpQuaternionVector & | operator= (const vpColVector &q) |
vpQuaternionVector & | operator= (const vpQuaternionVector &q)=default |
vpQuaternionVector & | operator= (const std::initializer_list< double > &list) |
vpQuaternionVector | conjugate () const |
vpQuaternionVector | inverse () const |
double | magnitude () const |
void | normalize () |
bool | operator== (const vpArray2D< float > &A) const |
Inherited functionalities from vpArray2D | |
unsigned int | getCols () const |
double | getMaxValue () const |
double | getMinValue () const |
unsigned int | getRows () const |
unsigned int | size () const |
void | resize (unsigned int nrows, unsigned int ncols, bool flagNullify=true, bool recopy_=true) |
void | reshape (unsigned int nrows, unsigned int ncols) |
bool | operator== (const vpArray2D< double > &A) const |
bool | operator!= (const vpArray2D< double > &A) const |
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, 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, 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) |
Inherited functionalities from vpRotationVector | |
double & | operator[] (unsigned int i) |
const double & | operator[] (unsigned int i) const |
vpRotationVector & | operator<< (double val) |
vpRotationVector & | operator, (double val) |
double | sumSquare () const |
vpRowVector | t () const |
std::vector< double > | toStdVector () |
unsigned int | m_index |
Implementation of a rotation vector as quaternion angle minimal representation.
Defines a quaternion and its basic operations.
The vpQuaternionVector class is derived from vpRotationVector.
A quaternion is defined by four double values: .
This class allows to compute a quaternion from a rotation matrix using either vpQuaternionVector(const vpRotationMatrix &) constructor or buildFrom() method.
It also defines common operations on a quaternion such as:
You can set values accessing each element:
You can also initialize the vector using operator<<(double):
Or you can also initialize the vector from a list of doubles if ViSP is build with c++11 enabled:
To get the values use:
or use getter:
Definition at line 110 of file vpQuaternionVector.h.
vpQuaternionVector::vpQuaternionVector | ( | ) |
Default constructor that initialize all the 4 angles to zero.
Definition at line 53 of file vpQuaternionVector.cpp.
vpQuaternionVector::vpQuaternionVector | ( | const vpQuaternionVector & | q | ) |
Copy constructor.
Definition at line 56 of file vpQuaternionVector.cpp.
vpQuaternionVector::vpQuaternionVector | ( | const double | qx, |
const double | qy, | ||
const double | qz, | ||
const double | qw | ||
) |
Constructor from doubles.
Definition at line 59 of file vpQuaternionVector.cpp.
|
explicit |
Constructs a quaternion from a rotation matrix.
R | : Matrix containing a rotation. |
Definition at line 82 of file vpQuaternionVector.cpp.
|
explicit |
Constructor that initialize Euler angles vector from a
vector.
tu | : ![]() |
Definition at line 90 of file vpQuaternionVector.cpp.
|
explicit |
Constructor from a 4-dimension vector of doubles.
Definition at line 66 of file vpQuaternionVector.cpp.
|
explicit |
Constructor from a 4-dimension vector of doubles.
Definition at line 72 of file vpQuaternionVector.cpp.
|
inlinevirtual |
Destructor.
Definition at line 125 of file vpQuaternionVector.h.
vpQuaternionVector vpQuaternionVector::buildFrom | ( | const double | qx, |
const double | qy, | ||
const double | qz, | ||
const double | qw | ||
) |
Manually change values of a quaternion.
qx | : x quaternion parameter. |
qy | : y quaternion parameter. |
qz | : z quaternion parameter. |
qw | : w quaternion parameter. |
Definition at line 115 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::buildFrom | ( | const std::vector< double > & | q | ) |
Construct a quaternion vector from a 4-dim vector (x,y,z,w).
Definition at line 153 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::buildFrom | ( | const vpColVector & | q | ) |
Construct a quaternion vector from a 4-dim vector (x,y,z,w).
Definition at line 138 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::buildFrom | ( | const vpRotationMatrix & | R | ) |
Constructs a quaternion from a rotation matrix.
R | : Rotation matrix. |
Definition at line 256 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::buildFrom | ( | const vpThetaUVector & | tu | ) |
Convert a vector into a quaternion.
tu | : ![]() |
Definition at line 127 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::conjugate | ( | ) | const |
Quaternion conjugate.
Definition at line 275 of file vpQuaternionVector.cpp.
|
inlineinherited |
Return the number of columns of the 2D array.
Definition at line 278 of file vpArray2D.h.
|
inherited |
Return the array max value.
Definition at line 912 of file vpArray2D.h.
|
inherited |
Return the array min value.
Definition at line 895 of file vpArray2D.h.
|
inlineinherited |
Return the number of rows of the 2D array.
Definition at line 288 of file vpArray2D.h.
Compute the Hadamard product (element wise matrix multiplication).
m | : Second matrix; |
Definition at line 932 of file vpArray2D.h.
vpQuaternionVector vpQuaternionVector::inverse | ( | ) | const |
Quaternion inverse.
Definition at line 282 of file vpQuaternionVector.cpp.
|
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 540 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 652 of file vpArray2D.h.
double vpQuaternionVector::magnitude | ( | ) | const |
Quaternion magnitude or norm.
Definition at line 301 of file vpQuaternionVector.cpp.
void vpQuaternionVector::normalize | ( | ) |
Normalize the quaternion.
Definition at line 306 of file vpQuaternionVector.cpp.
Not equal to comparison operator of a 2D array.
Definition at line 993 of file vpArray2D.h.
vpQuaternionVector vpQuaternionVector::operator* | ( | const vpQuaternionVector & | rq | ) | const |
Multiply two quaternions.
Definition at line 198 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::operator* | ( | double | l | ) | const |
Multiplication by scalar. Returns a quaternion defined by (lx,ly,lz,lw).
Definition at line 192 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::operator+ | ( | const vpQuaternionVector & | q | ) | const |
Quaternion addition.
Adds two quaternions. Addition is component-wise.
q | : quaternion to add. |
Definition at line 172 of file vpQuaternionVector.cpp.
|
inherited |
Set vector second and third element values.
val | : Value of the vector element [rad]. |
The following example shows how to initialize a vector from a list of 3 values [rad].
It produces the following printings:
Definition at line 161 of file vpRotationVector.cpp.
vpQuaternionVector vpQuaternionVector::operator- | ( | void | ) | const |
Negate operator. Returns a quaternion defined by (-x,-y,-z-,-w).
Definition at line 189 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::operator- | ( | const vpQuaternionVector & | q | ) | const |
Quaternion subtraction.
Substracts a quaternion from another. Subtraction is component-wise.
q | : quaternion to subtract. |
Definition at line 183 of file vpQuaternionVector.cpp.
vpQuaternionVector vpQuaternionVector::operator/ | ( | double | l | ) | const |
Division by scalar. Returns a quaternion defined by (x/l,y/l,z/l,w/l).
Definition at line 207 of file vpQuaternionVector.cpp.
|
inherited |
Set vector first element value.
val | : Value of the vector first element [rad]. |
The following example shows how to initialize a vector from a list of 3 values [rad].
It produces the following printings:
Definition at line 131 of file vpRotationVector.cpp.
vpQuaternionVector & vpQuaternionVector::operator= | ( | const std::initializer_list< double > & | list | ) |
Set vector from a list of 4 double angle values.
It produces the following printings:
Definition at line 341 of file vpQuaternionVector.cpp.
vpQuaternionVector & vpQuaternionVector::operator= | ( | const vpColVector & | q | ) |
Copy operator that initializes a quaternion vector from a 4-dimension column vector q.
q | : 4-dimension vector containing the values of the quaternion vector. |
Definition at line 239 of file vpQuaternionVector.cpp.
|
default |
Equal to comparison operator of a 2D array.
Definition at line 948 of file vpArray2D.h.
Definition at line 978 of file vpArray2D.h.
|
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 |
Definition at line 379 of file vpArray2D.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 304 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 737 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 830 of file vpArray2D.h.
void vpQuaternionVector::set | ( | double | qx, |
double | qy, | ||
double | qz, | ||
double | qw | ||
) |
Manually change values of a quaternion.
qx | : x quaternion parameter. |
qy | : y quaternion parameter. |
qz | : z quaternion parameter. |
qw | : w quaternion parameter. |
Definition at line 99 of file vpQuaternionVector.cpp.
|
inlineinherited |
Return the number of elements of the 2D array.
Definition at line 290 of file vpArray2D.h.
|
inherited |
Return the sum square of all the elements of the rotation vector r(m).
Definition at line 177 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.
double vpQuaternionVector::w | ( | ) | const |
Returns w-component of the quaternion.
Definition at line 321 of file vpQuaternionVector.cpp.
double vpQuaternionVector::x | ( | ) | const |
Returns x-component of the quaternion.
Definition at line 315 of file vpQuaternionVector.cpp.
double vpQuaternionVector::y | ( | ) | const |
Returns y-component of the quaternion.
Definition at line 317 of file vpQuaternionVector.cpp.
double vpQuaternionVector::z | ( | ) | const |
Returns z-component of the quaternion.
Definition at line 319 of file vpQuaternionVector.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 136 of file vpArray2D.h.
|
inherited |
Address of the first element of the data array.
Definition at line 144 of file vpArray2D.h.
|
protectedinherited |
Current array size (rowNum * colNum)
Definition at line 140 of file vpArray2D.h.
|
protectedinherited |
Definition at line 160 of file vpRotationVector.h.
|
protectedinherited |
Number of rows in the array.
Definition at line 134 of file vpArray2D.h.
|
protectedinherited |
Address of the first element of each rows.
Definition at line 138 of file vpArray2D.h.