ML Reference
|
ML integer image vector class to be specialized for different purposes. More...
#include <mlIntegerVector.h>
Public Types | |
enum | { NumberOfDimensions = ParentClass::NumberOfDimensions } |
Enumerator defining the dimension of this class. More... | |
typedef TVectorBase::ComponentType | ComponentType |
Integer type used by this vector. | |
typedef TVectorBase | ParentClass |
Parent class of this class. | |
Public Member Functions | |
std::string | print (const std::string &openStr="", const std::string &sepStr=" ", const std::string &termStr="", const MLint16 numDigits=-1) const |
Returns the string openStr + v.array[0] + sepStr + ... + v.array[NumberOfDimensions-2] + sepStr + v.array[NumberOfDimensions-1] + termStr. | |
Initialization | |
TVector () | |
Constructor. All components are initialized to 0. | |
TVector (const ComponentType i) | |
Constructor which initializes all components to i. | |
TVector (const TVector< TVectorBase > &v2) | |
TVector< TVectorBase > & | operator= (const TVector< TVectorBase > &v2) |
template<typename TVectorBase2 > | |
TVector (const TVector< TVectorBase2 > &v2) | |
Copy constructor from another TVector of same or other integer type, values are cast. | |
TVector (const ComponentType xp, const TVector &p) | |
Constructor which assigns X to x and copies other elements from p. | |
TVector (const MLint num, const ComponentType *const arr, const ComponentType deflt) | |
Constructor which initializes the vector components by copying them from arr[0] ,..., arr[num-1]. | |
void | copy (const MLint num, ComponentType *const arr) const |
Copy the first num elements from internal array into arr starting with array[0] to arr[0] to array[num-1] to arr[num-1], respectively. | |
void | set (const ComponentType v=0) |
Sets all components to v or - if v is not specified - to 0. | |
void | set (const TVector &v) |
Like assignment operator. | |
Functions and operators. | |
TVector< TVectorBase > | operator+ (const TVector &b) const |
Add the corresponding component from b to each component. | |
TVector< TVectorBase > & | operator+= (const TVector< TVectorBase > &b) |
Adds the corresponding component from b to each component. | |
TVector< TVectorBase > | operator- (const TVector< TVectorBase > &b) const |
Calculates and returns *this-b. | |
TVector< TVectorBase > & | operator-= (const TVector< TVectorBase > &b) |
Subtracts the corresponding component from b from each component. | |
TVector< TVectorBase > | operator* (const TVector< TVectorBase > &b) const |
Calculates and returns the multiplication of each component of this with its corresponding component from b. | |
TVector< TVectorBase > & | operator*= (const TVector< TVectorBase > &b) |
Multiplies each component with its corresponding components from b. | |
TVector< TVectorBase > | operator+ (const ComponentType b) const |
Calculates and returns the addition of each component of *this with scalar b. | |
TVector< TVectorBase > | operator- (const ComponentType b) const |
Subtracts the scalar b from all components. | |
TVector< TVectorBase > | operator* (const ComponentType b) const |
Multiplies all components with scalar b. | |
TVector< TVectorBase > | operator/ (const TVector< TVectorBase > &b) const |
Calculates and returns the division of each component of *this by its corresponding component from b. | |
TVector< TVectorBase > & | operator/= (const TVector< TVectorBase > &b) |
Divides each component by its corresponding component from b. | |
bool | operator== (const TVector< TVectorBase > &b) const |
Equality operator: Returns whether each component of a is equal to its corresponding component of b. | |
bool | operator!= (const TVector< TVectorBase > &b) const |
Inequality operator: Returns whether any component differs from its corresponding component of b. | |
bool | operator< (const TVector< TVectorBase > &b) const |
"Smaller" comparison operator, return whether the 'smaller' relation is valid for all components. | |
bool | operator<= (const TVector< TVectorBase > &b) const |
"Smaller Or Equal" comparison operator, return whether the 'smaller or equal' relation is valid for all components. | |
bool | operator> (const TVector< TVectorBase > &b) const |
"Greater" comparison operator, return whether the 'greater' relation is valid for all components. | |
bool | operator>= (const TVector< TVectorBase > &b) const |
"Greater or Equal" comparison operator, return whether the 'greater or equal' relation is valid for all components. | |
TVector< TVectorBase > | operator& (const TVector< TVectorBase > &b) const |
Performs a binary "And" of all components with the corresponding components of another Vector. | |
TVector< TVectorBase > | operator| (const TVector< TVectorBase > &b) const |
Performs a binary "Or" of all components with the corresponding components of another Vector. | |
TVector< TVectorBase > | operator^ (const TVector< TVectorBase > &b) const |
Performs a binary "Xor" of all components with the corresponding components of another Vector. | |
TVector< TVectorBase > & | operator&= (const TVector< TVectorBase > &b) |
Performs a binary "And" of all components with the corresponding components of another Vector. | |
TVector< TVectorBase > & | operator|= (const TVector< TVectorBase > &b) |
Performs a binary "Or" of all components with the corresponding components of another Vector. | |
TVector< TVectorBase > & | operator^= (const TVector< TVectorBase > &b) |
Performs a binary "Xor" of all components with the corresponding components of another Vector. | |
TVector< TVectorBase > | operator& (const ComponentType b) const |
Performs a binary "And" of all components with an integer. | |
TVector< TVectorBase > | operator| (const ComponentType b) const |
Performs a binary "Or" of all components with an integer. | |
TVector< TVectorBase > | operator^ (const ComponentType b) const |
Performs a binary "Xor" of all components with an integer. | |
TVector< TVectorBase > & | operator&= (const ComponentType b) |
Performs a binary "And" of all components with an integer. | |
TVector< TVectorBase > & | operator|= (const ComponentType b) |
Performs a binary "Or" of all components with an integer. | |
TVector< TVectorBase > & | operator^= (const ComponentType b) |
Performs a binary "Xor" of all components with an integer. | |
TVector< TVectorBase > | operator>> (const int b) const |
Performs a binary right shift ">>" on each vector component. | |
TVector< TVectorBase > | operator<< (const int b) const |
Performs a binary left shift "<<" on each vector component. | |
TVector< TVectorBase > & | operator>>= (const int b) |
Performs a binary right shift unary ">>=" on each vector component. | |
TVector< TVectorBase > & | operator<<= (const int b) |
Performs a binary left shift unary "<<=" on each vector component. | |
TVector< TVectorBase > | operator- () const |
Performs an unary "-" on each vector component. | |
ComponentType | operator[] (const size_t i) const |
Constant indexing operator permits read access to array[0], ..., array[NumberOfDimensions-1] via indexes 0,1, ..., NumberOfDimensions-1, respectively. | |
ComponentType & | operator[] (const size_t i) |
Indexing operator permits read and write access to array[0], ..., array[NumberOfDimensions-1] via indexes 0,1, ..., NumberOfDimensions-1, respectively. | |
MLint | getMaxIdx () const |
Searches the maximum component and returns the index of its first occurrence. | |
ComponentType | getMax () const |
Returns the maximum component value. | |
MLint | getMinIdx () const |
Searches the minimum component and returns the index of its first occurrence. | |
ComponentType | getMin () const |
Returns the minimum component value. | |
TVector< TVectorBase > | getStrides (const ComponentType offset=1) const |
Interprets the vector as image extension and returns a stride vector. | |
TVector< TVectorBase > | getVectorPosition (ComponentType offsetPos) const |
Interprets the vector as a stride vector of an image and returns the offset position offsetPos from the image origin to the coordinate specified by the vector. | |
MLint | getExtDimension () const |
Returns the index to the highest vector component which is not 1 which is useful to get the real dimensional extent of an image. | |
bool | hasNegativeComp () const |
Returns whether any component is negative. | |
bool | allBiggerZero () const |
Returns whether all components > 0. | |
bool | sanityCheckNumberOfVoxels () const |
Returns whether product of all components is in range of integer type. | |
Arithmetics as static and member functions | |
TVector< TVectorBase > | divCeil (const TVector< TVectorBase > &b) const |
Returns the component wise division of the vector this by vector b with rounding up. | |
TVector< TVectorBase > | compMin (const TVector< TVectorBase > &b) const |
Returns the component wise minimum of components of this and b. | |
TVector< TVectorBase > | compMax (const TVector< TVectorBase > &b) const |
Returns the component wise maximum of components of this and b. | |
TVector< TVectorBase > | compMod (const TVector< TVectorBase > &b) const |
Returns the rest of the division of this by b component wise. | |
TVector< TVectorBase > | compAbs () const |
Returns a vector with all components of this replaced by their absolute values. | |
ComponentType | compMul () const |
Returns the product of all components. There is no check for integer overflow. | |
ComponentType | compSum () const |
Returns the sum of all components. There is no check for integer overflow. | |
ComponentType | dot (const TVector< TVectorBase > &b) const |
Returns the scalar product of vectors this and b. There is no check for integer overflow. | |
void | fillSmallerComps (const ComponentType threshold=0, const ComponentType fillVal=0) |
Sets the components which are smaller than threshold to fillVal. | |
void | fillGreaterComps (const ComponentType threshold=0, const ComponentType fillVal=0) |
Sets the components which are greater than threshold to fillVal. | |
void | fillEqualComps (const ComponentType threshold=0, const ComponentType fillVal=0) |
Sets the components which are equal to threshold to fillVal. | |
static TVector< TVectorBase > | divCeil (const TVector< TVectorBase > &a, const TVector< TVectorBase > &b) |
Static version: Returns the component wise division of the vector a by vector b with rounding up. | |
static TVector< TVectorBase > | compMin (const TVector< TVectorBase > &a, const TVector< TVectorBase > &b) |
Static version: Returns the component wise minimum of vectors a and b. | |
static TVector< TVectorBase > | compMax (const TVector< TVectorBase > &a, const TVector< TVectorBase > &b) |
Static version: Returns the component wise maximum of vectors a and b. | |
static TVector< TVectorBase > | compMod (const TVector< TVectorBase > &a, const TVector< TVectorBase > &b) |
Static version: Returns the rest dividing vector a by b component wise. | |
static TVector< TVectorBase > | compAbs (const TVector< TVectorBase > &a) |
Static version: Returns a vector with all components of a replaced by their absolute values. | |
static ComponentType | compMul (const TVector< TVectorBase > &a) |
Static version: Returns the product of all components without check for integer overflow. | |
static ComponentType | compSum (const TVector< TVectorBase > &a) |
Static version: Returns the sum of all components without check for integer overflow. | |
static ComponentType | dot (const TVector< TVectorBase > &a, const TVector< TVectorBase > &b) |
Static version: Returns the scalar product of vectors a and b without check for integer overflow. | |
ML integer image vector class to be specialized for different purposes.
It is a template to handle and calculate with n dimensional cardinal coordinates and vectors.
It represents a vector to address coordinates and offsets into images. The methods provide elementary arithmetic vector operations and support the stride concept for efficient image addressing.
The members of this class define a ND vector of type integer which is specialized normally to the ImageVector class which has the MLMaxImageDimension (defined in mlImageVector.h) with MLint as component type.
This class can also be instantiated with higher NumberOfDimensions arguments or other CompIntType arguments to compile arbitrary dimensional vectors with an arbitrary integer base type.
Example for vector initialization:
Notes:
TVectorBase | should be TVector6DBase for 6D ML image vector types or TVectorNDBase for other dimensional vectors. |
Definition at line 111 of file mlIntegerVector.h.
typedef TVectorBase::ComponentType ml::TVector< TVectorBase >::ComponentType |
Integer type used by this vector.
Definition at line 116 of file mlIntegerVector.h.
typedef TVectorBase ml::TVector< TVectorBase >::ParentClass |
Parent class of this class.
Definition at line 119 of file mlIntegerVector.h.
anonymous enum |
Enumerator defining the dimension of this class.
Enumerator | |
---|---|
NumberOfDimensions |
Definition at line 122 of file mlIntegerVector.h.
|
inline |
Constructor. All components are initialized to 0.
Definition at line 130 of file mlIntegerVector.h.
|
inlineexplicit |
Constructor which initializes all components to i.
Definition at line 136 of file mlIntegerVector.h.
|
inline |
Definition at line 145 of file mlIntegerVector.h.
|
inlineexplicit |
Copy constructor from another TVector of same or other integer type, values are cast.
Only valid elements are copied if vectors have different lengths.
Definition at line 162 of file mlIntegerVector.h.
References ml::TVector< TVectorBase >::NumberOfDimensions.
|
inlineexplicit |
Constructor which assigns X to x and copies other elements from p.
Definition at line 181 of file mlIntegerVector.h.
|
explicit |
Constructor which initializes the vector components by copying them from arr[0] ,..., arr[num-1].
All other elements are initialized to the value deflt.
Definition at line 662 of file mlIntegerVector.h.
References ML_CHECK_THROW, and ml::TVector< TVectorBase >::NumberOfDimensions.
|
inline |
Returns whether all components > 0.
Definition at line 503 of file mlIntegerVector.h.
|
inline |
Returns a vector with all components of this replaced by their absolute values.
Definition at line 538 of file mlIntegerVector.h.
|
static |
Static version: Returns a vector with all components of a replaced by their absolute values.
Definition at line 779 of file mlIntegerVector.h.
|
static |
Static version: Returns the component wise maximum of vectors a and b.
Definition at line 754 of file mlIntegerVector.h.
|
inline |
Returns the component wise maximum of components of this and b.
Definition at line 533 of file mlIntegerVector.h.
|
static |
Static version: Returns the component wise minimum of vectors a and b.
Definition at line 743 of file mlIntegerVector.h.
|
inline |
Returns the component wise minimum of components of this and b.
Definition at line 531 of file mlIntegerVector.h.
|
static |
Static version: Returns the rest dividing vector a by b component wise.
Division by zero caused by zero components of b must be avoided by caller.
Definition at line 767 of file mlIntegerVector.h.
References ML_CHECK_THROW.
|
inline |
Returns the rest of the division of this by b component wise.
Division by zero caused by zero components of b must be avoided by caller.
Definition at line 536 of file mlIntegerVector.h.
|
inline |
Returns the product of all components. There is no check for integer overflow.
Definition at line 541 of file mlIntegerVector.h.
|
inlinestatic |
Static version: Returns the product of all components without check for integer overflow.
Definition at line 562 of file mlIntegerVector.h.
|
inline |
Returns the sum of all components. There is no check for integer overflow.
Definition at line 543 of file mlIntegerVector.h.
|
inlinestatic |
Static version: Returns the sum of all components without check for integer overflow.
Definition at line 572 of file mlIntegerVector.h.
void ml::TVector< TVectorBase >::copy | ( | const MLint | num, |
ComponentType *const | arr ) const |
Copy the first num elements from internal array into arr starting with array[0] to arr[0] to array[num-1] to arr[num-1], respectively.
All other components are left unchanged. arr must have at least num entries and at most NumberOfDimensions elements are copied.
Definition at line 673 of file mlIntegerVector.h.
References ML_CHECK_THROW.
|
static |
Static version: Returns the component wise division of the vector a by vector b with rounding up.
Division by zero caused by zero components of b must be avoided by caller.
Definition at line 730 of file mlIntegerVector.h.
References ML_CHECK_THROW.
|
inline |
Returns the component wise division of the vector this by vector b with rounding up.
Division by zero caused by zero components of b must be avoided by caller.
Definition at line 529 of file mlIntegerVector.h.
|
inlinestatic |
Static version: Returns the scalar product of vectors a and b without check for integer overflow.
Definition at line 584 of file mlIntegerVector.h.
|
inline |
Returns the scalar product of vectors this and b. There is no check for integer overflow.
Definition at line 546 of file mlIntegerVector.h.
|
inline |
Sets the components which are equal to threshold to fillVal.
Definition at line 613 of file mlIntegerVector.h.
|
inline |
Sets the components which are greater than threshold to fillVal.
Definition at line 607 of file mlIntegerVector.h.
|
inline |
Sets the components which are smaller than threshold to fillVal.
Definition at line 595 of file mlIntegerVector.h.
MLint ml::TVector< TVectorBase >::getExtDimension | ( | ) | const |
Returns the index to the highest vector component which is not 1 which is useful to get the real dimensional extent of an image.
Definition at line 715 of file mlIntegerVector.h.
|
inline |
Returns the maximum component value.
Definition at line 455 of file mlIntegerVector.h.
|
inline |
Searches the maximum component and returns the index of its first occurrence.
Definition at line 444 of file mlIntegerVector.h.
|
inline |
Returns the minimum component value.
Definition at line 472 of file mlIntegerVector.h.
|
inline |
Searches the minimum component and returns the index of its first occurrence.
Definition at line 461 of file mlIntegerVector.h.
TVector< TVectorBase > ml::TVector< TVectorBase >::getStrides | ( | const ComponentType | offset = 1 | ) | const |
Interprets the vector as image extension and returns a stride vector.
The smallest stride (the x stride) is set to offset, i.e. an image voxel is assumed to have size = offset. So stride[0] = offset, stride[1] = offset*array[0], stride[2] = offset*array[0]*array[1], ..., etc.
Definition at line 685 of file mlIntegerVector.h.
Referenced by ml::TSubImage< DATATYPE >::copySubImageReorderColorPlanesToInterleaved(), ml::SubImage::setBox(), ml::SubImage::setBox(), and ml::SubImage::setExtent().
TVector< TVectorBase > ml::TVector< TVectorBase >::getVectorPosition | ( | ComponentType | offsetPos | ) | const |
Interprets the vector as a stride vector of an image and returns the offset position offsetPos from the image origin to the coordinate specified by the vector.
For offsetPos, an image with extents given by *this and the return value rv then holds:
)
Definition at line 699 of file mlIntegerVector.h.
References ML_CHECK_THROW.
Referenced by ml::TSubImage< DATATYPE >::convertPointerToSubImagePosition().
|
inline |
Returns whether any component is negative.
Definition at line 496 of file mlIntegerVector.h.
|
inline |
Inequality operator: Returns whether any component differs from its corresponding component of b.
Definition at line 295 of file mlIntegerVector.h.
|
inline |
Performs a binary "And" of all components with an integer.
Definition at line 365 of file mlIntegerVector.h.
|
inline |
Performs a binary "And" of all components with the corresponding components of another Vector.
Definition at line 330 of file mlIntegerVector.h.
|
inline |
Performs a binary "And" of all components with an integer.
Definition at line 381 of file mlIntegerVector.h.
|
inline |
Performs a binary "And" of all components with the corresponding components of another Vector.
Definition at line 346 of file mlIntegerVector.h.
|
inline |
Multiplies all components with scalar b.
Definition at line 265 of file mlIntegerVector.h.
|
inline |
Calculates and returns the multiplication of each component of this with its corresponding component from b.
Definition at line 240 of file mlIntegerVector.h.
|
inline |
Multiplies each component with its corresponding components from b.
Definition at line 245 of file mlIntegerVector.h.
|
inline |
Calculates and returns the addition of each component of *this with scalar b.
Definition at line 251 of file mlIntegerVector.h.
|
inline |
Add the corresponding component from b to each component.
Definition at line 218 of file mlIntegerVector.h.
|
inline |
Adds the corresponding component from b to each component.
Definition at line 223 of file mlIntegerVector.h.
|
inline |
Performs an unary "-" on each vector component.
Definition at line 424 of file mlIntegerVector.h.
|
inline |
Subtracts the scalar b from all components.
Definition at line 258 of file mlIntegerVector.h.
|
inline |
Calculates and returns *this-b.
Definition at line 229 of file mlIntegerVector.h.
|
inline |
Subtracts the corresponding component from b from each component.
Definition at line 234 of file mlIntegerVector.h.
|
inline |
Calculates and returns the division of each component of *this by its corresponding component from b.
Definition at line 272 of file mlIntegerVector.h.
|
inline |
Divides each component by its corresponding component from b.
Definition at line 277 of file mlIntegerVector.h.
References ML_CHECK_THROW.
|
inline |
"Smaller" comparison operator, return whether the 'smaller' relation is valid for all components.
Definition at line 301 of file mlIntegerVector.h.
|
inline |
Performs a binary left shift "<<" on each vector component.
Definition at line 400 of file mlIntegerVector.h.
|
inline |
Performs a binary left shift unary "<<=" on each vector component.
Definition at line 411 of file mlIntegerVector.h.
|
inline |
"Smaller Or Equal" comparison operator, return whether the 'smaller or equal' relation is valid for all components.
Definition at line 308 of file mlIntegerVector.h.
|
inline |
Definition at line 150 of file mlIntegerVector.h.
|
inline |
Equality operator: Returns whether each component of a is equal to its corresponding component of b.
Definition at line 287 of file mlIntegerVector.h.
|
inline |
"Greater" comparison operator, return whether the 'greater' relation is valid for all components.
Definition at line 315 of file mlIntegerVector.h.
|
inline |
"Greater or Equal" comparison operator, return whether the 'greater or equal' relation is valid for all components.
Definition at line 322 of file mlIntegerVector.h.
|
inline |
Performs a binary right shift ">>" on each vector component.
Definition at line 400 of file mlIntegerVector.h.
|
inline |
Performs a binary right shift unary ">>=" on each vector component.
Definition at line 411 of file mlIntegerVector.h.
|
inline |
Indexing operator permits read and write access to array[0], ..., array[NumberOfDimensions-1] via indexes 0,1, ..., NumberOfDimensions-1, respectively.
The caller must guarantee that i is within [0,...,NumberOfDimensions-1].
Definition at line 441 of file mlIntegerVector.h.
|
inline |
Constant indexing operator permits read access to array[0], ..., array[NumberOfDimensions-1] via indexes 0,1, ..., NumberOfDimensions-1, respectively.
The caller must guarantee that i is within [0,...,NumberOfDimensions-1].
Definition at line 435 of file mlIntegerVector.h.
|
inline |
Performs a binary "Xor" of all components with an integer.
Definition at line 375 of file mlIntegerVector.h.
|
inline |
Performs a binary "Xor" of all components with the corresponding components of another Vector.
Definition at line 340 of file mlIntegerVector.h.
|
inline |
Performs a binary "Xor" of all components with an integer.
Definition at line 393 of file mlIntegerVector.h.
|
inline |
Performs a binary "Xor" of all components with the corresponding components of another Vector.
Definition at line 358 of file mlIntegerVector.h.
|
inline |
Performs a binary "Or" of all components with an integer.
Definition at line 370 of file mlIntegerVector.h.
|
inline |
Performs a binary "Or" of all components with the corresponding components of another Vector.
Definition at line 335 of file mlIntegerVector.h.
|
inline |
Performs a binary "Or" of all components with an integer.
Definition at line 387 of file mlIntegerVector.h.
|
inline |
Performs a binary "Or" of all components with the corresponding components of another Vector.
Definition at line 352 of file mlIntegerVector.h.
std::string ml::TVector< TVectorBase >::print | ( | const std::string & | openStr = "", |
const std::string & | sepStr = " ", | ||
const std::string & | termStr = "", | ||
const MLint16 | numDigits = -1 ) const |
Returns the string openStr + v.array[0] + sepStr + ... + v.array[NumberOfDimensions-2] + sepStr + v.array[NumberOfDimensions-1] + termStr.
numDigits is the number of digits to be used as print parameter. If numDigits is <=0 then no space specification is used.
Definition at line 792 of file mlIntegerVector.h.
|
inline |
Returns whether product of all components is in range of integer type.
Definition at line 510 of file mlIntegerVector.h.
|
inline |
Sets all components to v or - if v is not specified - to 0.
Definition at line 199 of file mlIntegerVector.h.
|
inline |
Like assignment operator.
Definition at line 205 of file mlIntegerVector.h.