Main Page   Groups   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members   Concepts
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes

itk::CovariantVector< T, NVectorDimension > Class Template Reference
[Geometry Representation ObjectsData Representation Objects]

A templated class holding a n-Dimensional covariant vector. More...

#include <itkCovariantVector.h>

Inheritance diagram for itk::CovariantVector< T, NVectorDimension >:
Inheritance graph
[legend]
Collaboration diagram for itk::CovariantVector< T, NVectorDimension >:
Collaboration graph
[legend]

List of all members.

Public Types

typedef FixedArray< T,
NVectorDimension > 
BaseArray
typedef ValueType CArray [VLength]
typedef const ValueTypeconst_pointer
typedef const ValueTypeconst_reference
typedef const ValueTypeConstIterator
typedef Self CovariantVectorType
typedef ValueTypeIterator
typedef ValueTypepointer
typedef NumericTraits
< ValueType >::RealType 
RealValueType
typedef ValueTypereference
typedef CovariantVector Self
typedef unsigned int SizeType
typedef FixedArray< T,
NVectorDimension > 
Superclass
typedef T ValueType

Public Member Functions

 CovariantVector ()
 CovariantVector (const ValueType &r)
vnl_vector_ref< T > Get_vnl_vector (void)
vnl_vector< T > Get_vnl_vector (void) const
RealValueType GetNorm (void) const
RealValueType GetSquaredNorm (void) const
vnl_vector_ref< T > GetVnlVector (void)
vnl_vector< T > GetVnlVector (void) const
void Normalize (void)
ValueType operator* (const Self &vec) const
ValueType operator* (const Vector< T, NVectorDimension > &vec) const
Self operator+ (const Self &vec) const
const Selfoperator+= (const Self &vec)
Self operator- (const Self &vec) const
Self operator- () const
const Selfoperator-= (const Self &vec)
void Set_vnl_vector (const vnl_vector< T > &)
void SetVnlVector (const vnl_vector< T > &)

template<class TVectorValueType >
 CovariantVector (const CovariantVector< TVectorValueType, NVectorDimension > &r)
 CovariantVector (const ValueType r[Dimension])

template<class Tt >
Selfoperator= (const Tt &v)

CovariantVectoroperator= (const Self &r)
CovariantVectoroperator= (const ValueType r[NVectorDimension])

template<class Tt >
const Selfoperator*= (const Tt &value)

template<class Tt >
const Selfoperator/= (const Tt &value)

Self operator* (const ValueType &val) const

template<class Tt >
Self operator/ (const Tt &val) const

template<typename TCoordRepB >
void CastFrom (const CovariantVector< TCoordRepB, NVectorDimension > &pa)

bool operator== (const FixedArray &r) const
bool operator!= (const FixedArray &r) const

reference operator[] (short index)
const_reference operator[] (short index) const
reference operator[] (unsigned short index)
const_reference operator[] (unsigned short index) const
reference operator[] (int index)
const_reference operator[] (int index) const
reference operator[] (unsigned int index)
const_reference operator[] (unsigned int index) const
reference operator[] (long index)
const_reference operator[] (long index) const
reference operator[] (unsigned long index)
const_reference operator[] (unsigned long index) const

void SetElement (unsigned short index, const_reference value)
const_reference GetElement (unsigned short index) const

ValueTypeGetDataPointer ()
const ValueTypeGetDataPointer () const

Iterator Begin ()
ConstIterator Begin () const
Iterator End ()
ConstIterator End () const
ReverseIterator rBegin ()
ConstReverseIterator rBegin () const
ReverseIterator rEnd ()
ConstReverseIterator rEnd () const
SizeType Size () const
void Fill (const ValueType &)

Static Public Member Functions

static FixedArray Filled (const ValueType &)
static unsigned int GetCovariantVectorDimension ()
static unsigned int GetNumberOfComponents ()

Static Public Attributes

static const unsigned int Dimension = NVectorDimension
static const unsigned int Length

Detailed Description

template<class T, unsigned int NVectorDimension = 3>
class itk::CovariantVector< T, NVectorDimension >

A templated class holding a n-Dimensional covariant vector.

CovariantVector is a templated class that holds a single vector (i.e., an array of values). CovariantVector can be used as the data type held at each pixel in an Image or at each vertex of an Mesh. The template parameter T can be any data type that behaves like a primitive (or atomic) data type (int, short, float, complex). The NVectorDimension defines the number of components in the vector array.

CovariantVector is not a dynamically extendible array like std::vector. It is intended to be used like a mathematical vector.

If you wish a simpler pixel types, you can use Scalar, which represents a single data value at a pixel. There is also the more complex type ScalarCovariantVector, which supports (for a given pixel) a single scalar value plus an array of vector values. (The scalar and vectors can be of different data type.)

CovariantVector is the type that should be used for representing normals to surfaces and gradients of functions. AffineTransform transform covariant vectors different than vectors.

See also:
Image
Mesh
Point
Vector
Matrix
Examples:

DataRepresentation/Mesh/PointSetWithCovariantVectors.cxx.

Definition at line 64 of file itkCovariantVector.h.


Member Typedef Documentation

template<class T, unsigned int NVectorDimension = 3>
typedef FixedArray<T, NVectorDimension> itk::CovariantVector< T, NVectorDimension >::BaseArray

The Array type from which this CovariantVector is derived.

Definition at line 84 of file itkCovariantVector.h.

typedef ValueType itk::FixedArray< T , VLength >::CArray[VLength] [inherited]

A type representing the C-array version of this FixedArray.

Definition at line 77 of file itkFixedArray.h.

typedef const ValueType* itk::FixedArray< T , VLength >::const_pointer [inherited]

A const pointer to the ValueType.

Definition at line 129 of file itkFixedArray.h.

typedef const ValueType& itk::FixedArray< T , VLength >::const_reference [inherited]

A const reference to the ValueType.

Definition at line 135 of file itkFixedArray.h.

typedef const ValueType* itk::FixedArray< T , VLength >::ConstIterator [inherited]

A const iterator through the array.

Definition at line 83 of file itkFixedArray.h.

template<class T, unsigned int NVectorDimension = 3>
typedef Self itk::CovariantVector< T, NVectorDimension >::CovariantVectorType

I am a covariant vector.

Definition at line 81 of file itkCovariantVector.h.

typedef ValueType* itk::FixedArray< T , VLength >::Iterator [inherited]

An iterator through the array.

Definition at line 80 of file itkFixedArray.h.

typedef ValueType* itk::FixedArray< T , VLength >::pointer [inherited]

A pointer to the ValueType.

Definition at line 126 of file itkFixedArray.h.

template<class T, unsigned int NVectorDimension = 3>
typedef NumericTraits< ValueType >::RealType itk::CovariantVector< T, NVectorDimension >::RealValueType

Definition at line 75 of file itkCovariantVector.h.

typedef ValueType& itk::FixedArray< T , VLength >::reference [inherited]

A reference to the ValueType.

Definition at line 132 of file itkFixedArray.h.

template<class T, unsigned int NVectorDimension = 3>
typedef CovariantVector itk::CovariantVector< T, NVectorDimension >::Self

Standard class typedefs.

Definition at line 69 of file itkCovariantVector.h.

typedef unsigned int itk::FixedArray< T , VLength >::SizeType [inherited]

Definition at line 137 of file itkFixedArray.h.

template<class T, unsigned int NVectorDimension = 3>
typedef FixedArray<T,NVectorDimension> itk::CovariantVector< T, NVectorDimension >::Superclass

Definition at line 70 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
typedef T itk::CovariantVector< T, NVectorDimension >::ValueType

ValueType can be used to declare a variable that is the same type as a data element held in an CovariantVector.

Reimplemented from itk::FixedArray< T, NVectorDimension >.

Definition at line 74 of file itkCovariantVector.h.


Constructor & Destructor Documentation

template<class T, unsigned int NVectorDimension = 3>
itk::CovariantVector< T, NVectorDimension >::CovariantVector (  )  [inline]

Default constructor and copy constructors.

Definition at line 113 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
itk::CovariantVector< T, NVectorDimension >::CovariantVector ( const ValueType r  ) 
template<class T, unsigned int NVectorDimension = 3>
template<class TVectorValueType >
itk::CovariantVector< T, NVectorDimension >::CovariantVector ( const CovariantVector< TVectorValueType, NVectorDimension > &  r  )  [inline]

Pass-through constructor for the Array base class. Implicit casting is performed to initialize constructor from any another one of datatype.

Definition at line 119 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
itk::CovariantVector< T, NVectorDimension >::CovariantVector ( const ValueType  r[Dimension]  )  [inline]

Pass-through constructor for the Array base class. Implicit casting is performed to initialize constructor from any another one of datatype.

Definition at line 121 of file itkCovariantVector.h.


Member Function Documentation

Iterator itk::FixedArray< T , VLength >::Begin ( void   )  [inherited]

Get various iterators to the array.

ConstIterator itk::FixedArray< T , VLength >::Begin ( void   )  const [inherited]

Get various iterators to the array.

template<class T, unsigned int NVectorDimension = 3>
template<typename TCoordRepB >
void itk::CovariantVector< T, NVectorDimension >::CastFrom ( const CovariantVector< TCoordRepB, NVectorDimension > &  pa  )  [inline]

Copy from another CovariantVector with a different representation type. Casting is done with C-Like rules

Definition at line 227 of file itkCovariantVector.h.

Iterator itk::FixedArray< T , VLength >::End ( void   )  [inherited]

Get various iterators to the array.

ConstIterator itk::FixedArray< T , VLength >::End ( void   )  const [inherited]

Get various iterators to the array.

void itk::FixedArray< T , VLength >::Fill ( const ValueType  )  [inherited]

Get various iterators to the array.

static FixedArray itk::FixedArray< T , VLength >::Filled ( const ValueType  )  [static, inherited]
template<class T, unsigned int NVectorDimension = 3>
vnl_vector<T> itk::CovariantVector< T, NVectorDimension >::Get_vnl_vector ( void   )  const

Get a vnl_vector with a copy of the internal memory block.

Deprecated:
Use GetVnlVector() instead.
template<class T, unsigned int NVectorDimension = 3>
vnl_vector_ref<T> itk::CovariantVector< T, NVectorDimension >::Get_vnl_vector ( void   ) 

Get a vnl_vector_ref referencing the same memory block.

Deprecated:
Use GetVnlVector() instead.
template<class T, unsigned int NVectorDimension = 3>
static unsigned int itk::CovariantVector< T, NVectorDimension >::GetCovariantVectorDimension (  )  [inline, static]

Get the dimension (size) of the vector.

Definition at line 87 of file itkCovariantVector.h.

ValueType* itk::FixedArray< T , VLength >::GetDataPointer (  )  [inline, inherited]

Return a pointer to the data.

Definition at line 222 of file itkFixedArray.h.

Referenced by itk::MetaArrayWriter::SetInput().

const ValueType* itk::FixedArray< T , VLength >::GetDataPointer (  )  const [inline, inherited]

Return a pointer to the data.

Definition at line 223 of file itkFixedArray.h.

const_reference itk::FixedArray< T , VLength >::GetElement ( unsigned short  index  )  const [inline, inherited]

Set/Get element methods are more convenient in wrapping languages

Definition at line 218 of file itkFixedArray.h.

template<class T, unsigned int NVectorDimension = 3>
RealValueType itk::CovariantVector< T, NVectorDimension >::GetNorm ( void   )  const

Returns the Euclidean Norm of the vector

template<class T, unsigned int NVectorDimension = 3>
static unsigned int itk::CovariantVector< T, NVectorDimension >::GetNumberOfComponents (  )  [inline, static]

Returns the number of components in this vector type

Definition at line 216 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
RealValueType itk::CovariantVector< T, NVectorDimension >::GetSquaredNorm ( void   )  const

Returns vector's Squared Euclidean Norm

template<class T, unsigned int NVectorDimension = 3>
vnl_vector<T> itk::CovariantVector< T, NVectorDimension >::GetVnlVector ( void   )  const

Get a vnl_vector with a copy of the internal memory block.

template<class T, unsigned int NVectorDimension = 3>
vnl_vector_ref<T> itk::CovariantVector< T, NVectorDimension >::GetVnlVector ( void   ) 

Get a vnl_vector_ref referencing the same memory block.

template<class T, unsigned int NVectorDimension = 3>
void itk::CovariantVector< T, NVectorDimension >::Normalize ( void   ) 

Divides the covariant vector componets by the norm

bool itk::FixedArray< T , VLength >::operator!= ( const FixedArray< T, NVectorDimension > &  r  )  const [inline, inherited]

Operators == and != are used to compare whether two arrays are equal. Note that arrays are equal when the number of components (size) is the same, and each component value is equal.

Definition at line 194 of file itkFixedArray.h.

template<class T, unsigned int NVectorDimension = 3>
ValueType itk::CovariantVector< T, NVectorDimension >::operator* ( const Self vec  )  const

CovariantVector operator*. Performs the inner product of two covariant vectors.

Warning:
This is equivalent to the scalar product only if the reference system has orthogonal axis and equal scales.
template<class T, unsigned int NVectorDimension = 3>
ValueType itk::CovariantVector< T, NVectorDimension >::operator* ( const Vector< T, NVectorDimension > &  vec  )  const

operator*. Performs the scalar product with a vector (contravariant). This scalar product is invariant under affine transformations

template<class T, unsigned int NVectorDimension = 3>
Self itk::CovariantVector< T, NVectorDimension >::operator* ( const ValueType val  )  const [inline]

Scalar operator*. Scale the elements of a vector by a scalar. Return a new vector.

Definition at line 188 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
template<class Tt >
const Self& itk::CovariantVector< T, NVectorDimension >::operator*= ( const Tt &  value  )  [inline]

Scalar operator*=. Scales elements by a scalar.

Definition at line 139 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
Self itk::CovariantVector< T, NVectorDimension >::operator+ ( const Self vec  )  const

CovariantVector addition. Add two vectors. Return a new vector.

template<class T, unsigned int NVectorDimension = 3>
const Self& itk::CovariantVector< T, NVectorDimension >::operator+= ( const Self vec  ) 

CovariantVector operator+=. Adds a vectors to the current vector.

template<class T, unsigned int NVectorDimension = 3>
Self itk::CovariantVector< T, NVectorDimension >::operator- ( const Self vec  )  const

CovariantVector subtraction. Subtract two vectors. Return a new vector.

template<class T, unsigned int NVectorDimension = 3>
Self itk::CovariantVector< T, NVectorDimension >::operator- (  )  const

CovariantVector negation. Negate all the elements of a vector. Return a new vector

template<class T, unsigned int NVectorDimension = 3>
const Self& itk::CovariantVector< T, NVectorDimension >::operator-= ( const Self vec  ) 

CovariantVector operator-=. Subtracts a vector from a current vector.

template<class T, unsigned int NVectorDimension = 3>
template<class Tt >
Self itk::CovariantVector< T, NVectorDimension >::operator/ ( const Tt &  val  )  const [inline]

Scalar operator/. Scale (divide) the elements of a vector by a scalar. Return a new vector.

Definition at line 201 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
template<class Tt >
const Self& itk::CovariantVector< T, NVectorDimension >::operator/= ( const Tt &  value  )  [inline]

Scalar operator/=. Scales (divides) elements by a scalar.

Definition at line 150 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
template<class Tt >
Self& itk::CovariantVector< T, NVectorDimension >::operator= ( const Tt &  v  )  [inline]

Assignment operator with implicit casting from another data type

Definition at line 126 of file itkCovariantVector.h.

template<class T, unsigned int NVectorDimension = 3>
CovariantVector& itk::CovariantVector< T, NVectorDimension >::operator= ( const Self r  ) 

Pass-through assignment operator for the Array base class.

template<class T, unsigned int NVectorDimension = 3>
CovariantVector& itk::CovariantVector< T, NVectorDimension >::operator= ( const ValueType  r[NVectorDimension]  ) 

Pass-through assignment operator for the Array base class.

bool itk::FixedArray< T , VLength >::operator== ( const FixedArray< T, NVectorDimension > &  r  )  const [inherited]

Operators == and != are used to compare whether two arrays are equal. Note that arrays are equal when the number of components (size) is the same, and each component value is equal.

Referenced by itk::Vector< CoordRepType, itkGetStaticConstMacro(SpaceDimension)>::operator==().

reference itk::FixedArray< T , VLength >::operator[] ( unsigned int  index  )  [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 207 of file itkFixedArray.h.

const_reference itk::FixedArray< T , VLength >::operator[] ( unsigned short  index  )  const [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 204 of file itkFixedArray.h.

reference itk::FixedArray< T , VLength >::operator[] ( int  index  )  [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 205 of file itkFixedArray.h.

const_reference itk::FixedArray< T , VLength >::operator[] ( unsigned int  index  )  const [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 208 of file itkFixedArray.h.

const_reference itk::FixedArray< T , VLength >::operator[] ( long  index  )  const [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 210 of file itkFixedArray.h.

const_reference itk::FixedArray< T , VLength >::operator[] ( int  index  )  const [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 206 of file itkFixedArray.h.

const_reference itk::FixedArray< T , VLength >::operator[] ( short  index  )  const [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 202 of file itkFixedArray.h.

reference itk::FixedArray< T , VLength >::operator[] ( unsigned short  index  )  [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 203 of file itkFixedArray.h.

const_reference itk::FixedArray< T , VLength >::operator[] ( unsigned long  index  )  const [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 212 of file itkFixedArray.h.

reference itk::FixedArray< T , VLength >::operator[] ( long  index  )  [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 209 of file itkFixedArray.h.

reference itk::FixedArray< T , VLength >::operator[] ( unsigned long  index  )  [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 211 of file itkFixedArray.h.

reference itk::FixedArray< T , VLength >::operator[] ( short  index  )  [inline, inherited]

Allow the FixedArray to be indexed normally. No bounds checking is done. The separate versions are a work-around for an integer conversion bug in Visual C++.

Definition at line 201 of file itkFixedArray.h.

Referenced by itk::Vector< CoordRepType, itkGetStaticConstMacro(SpaceDimension)>::SetNthComponent().

ReverseIterator itk::FixedArray< T , VLength >::rBegin (  )  [inherited]

Get various iterators to the array.

ConstReverseIterator itk::FixedArray< T , VLength >::rBegin (  )  const [inherited]

Get various iterators to the array.

ReverseIterator itk::FixedArray< T , VLength >::rEnd (  )  [inherited]

Get various iterators to the array.

ConstReverseIterator itk::FixedArray< T , VLength >::rEnd (  )  const [inherited]

Get various iterators to the array.

template<class T, unsigned int NVectorDimension = 3>
void itk::CovariantVector< T, NVectorDimension >::Set_vnl_vector ( const vnl_vector< T > &   ) 

Set a vnl_vector_ref referencing the same memory block.

Deprecated:
Use SetVnlVector() instead.
void itk::FixedArray< T , VLength >::SetElement ( unsigned short  index,
const_reference  value 
) [inline, inherited]

Set/Get element methods are more convenient in wrapping languages

Definition at line 216 of file itkFixedArray.h.

template<class T, unsigned int NVectorDimension = 3>
void itk::CovariantVector< T, NVectorDimension >::SetVnlVector ( const vnl_vector< T > &   ) 

Set a vnl_vector_ref referencing the same memory block.

SizeType itk::FixedArray< T , VLength >::Size ( void   )  const [inherited]

Get various iterators to the array.


Member Data Documentation

template<class T, unsigned int NVectorDimension = 3>
const unsigned int itk::CovariantVector< T, NVectorDimension >::Dimension = NVectorDimension [static]

Dimension of the Space

Reimplemented from itk::FixedArray< T, NVectorDimension >.

Definition at line 78 of file itkCovariantVector.h.

const unsigned int itk::FixedArray< T , VLength >::Length [static, inherited]

Length constant

Definition at line 68 of file itkFixedArray.h.


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

Generated at Mon Jul 12 2010 21:47:55 for ITK by doxygen 1.7.1 written by Dimitri van Heesch, © 1997-2000