[ VIGRA Homepage | Function Index | Class Index | Namespaces | File List | Main Page ]
![]() |
MultiArrayView | ![]() |
Base class for, and view to, vigra::MultiArray. More...
#include <vigra/multi_array.hxx>
This class implements the interface of both MultiArray and MultiArrayView. By default, MultiArrayViews are tagged as unstrided. If necessary, strided arrays are constructed automatically by calls to a variant of the bind...() function.
If you want to apply an algorithm requiring an image to a MultiArrayView
of appropriate (2-dimensional) shape, you can create a vigra::BasicImageView that acts as a wrapper with the necessary interface -- see Wrap aref vigra::MultiArrayView in.
The template parameter are as follows
N: the array dimension T: the type of the array elements C: a tag determining whether the array's inner dimension is strided or not. An array is unstrided if the array elements occupy consecutive memory location, strided if there is an offset in between (e.g. when a view is created that skips every other array element). The compiler can generate faster code for unstrided arrays. Possible values: UnstridedArrayTag (default), StridedArrayTag
#include <vigra/multi_array.hxx>
Namespace: vigra
typedef const value_type* const_pointer |
const pointer type
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef const value_type& const_reference |
const reference type (result of operator[] const)
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef vigra::detail::MultiIteratorChooser< C>::template Traverser<actual_dimension, T, T const &, T const *>::type const_traverser |
const traverser (MultiIterator) type
Reimplemented in MultiArray, NumpyArray, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef MultiArrayShape<actual_dimension>::type difference_type |
difference type (used for multi-dimensional offsets and indices)
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef MultiArrayIndex difference_type_1 |
difference and index type for a single dimension
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef MultiArray<N, T> matrix_type |
the matrix type associated with this array.
Reimplemented in Matrix, MultiArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef value_type* pointer |
pointer type
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef value_type& reference |
reference type (result of operator[])
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef difference_type size_type |
size type
Reimplemented in MultiArray, NumpyArray, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef vigra::detail::MultiIteratorChooser< C>::template Traverser<actual_dimension, T, T &, T *>::type traverser |
traverser (MultiIterator) type
Reimplemented in MultiArray, NumpyArray, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef T value_type |
the array's value type
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
typedef MultiArrayView<N, T, C> view_type |
the view type associated with this array.
Reimplemented in Matrix, MultiArray, NumpyArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
enum ActualDimension |
the array's actual dimensionality. This ensures that MultiArrayView can also be used for scalars (that is, when N == 0
). Calculated as:
actual_dimension = (N==0) ? 1 : N
MultiArrayView | ( | ) |
MultiArrayView | ( | const difference_type & | shape, | |
pointer | ptr | |||
) |
construct from shape and pointer
MultiArrayView | ( | const difference_type & | shape, | |
const difference_type & | stride, | |||
pointer | ptr | |||
) |
Construct from shape, strides (offset of a sample to the next) for every dimension, and pointer. (Note that strides are not given in bytes, but in offsets of the respective pointer type.)
MultiArrayView< N-1, T, typename detail::MaybeStrided< M >::type > bind | ( | difference_type_1 | d | ) | const |
bind dimension M to index d. this reduces the dimensionality of the image to max { 1, N-1 }.
Usage:
// create a 3D array of size 40x30x20 typedef MultiArray<3, double>::difference_type Shape; MultiArray<3, double> array3(Shape(40, 30, 20)); // get a 2D array by fixing index 1 to 12 MultiArrayView <2, double> array2 = array3.bind<1>(12); // get a 2D array by fixing index 0 to 23 MultiArrayView <2, double, StridedArrayTag> array2a = array3.bind<0>(23);
MultiArrayView< N-1, T, StridedArrayTag > bindAt | ( | difference_type_1 | m, | |
difference_type_1 | d | |||
) | const |
bind dimension m to index d. this reduces the dimensionality of the image to max { 1, N-1 }.
Usage:
// create a 3D array of size 40x30x20 typedef MultiArray<3, double>::difference_type Shape; MultiArray<3, double> array3(Shape(40, 30, 20)); // get a 2D array by fixing index 2 to 15 MultiArrayView <2, double, StridedArrayTag> array2 = array3.bindAt(2, 15);
MultiArrayView< N-1, T, StridedArrayTag > bindInner | ( | difference_type_1 | d | ) | const |
bind the innermost dimension to a certain index. this reduces the dimensionality of the image to max { 1, N-1 }.
Usage:
// create a 3D array of size 40x30x20 typedef MultiArray<3, double>::difference_type Shape; MultiArray<3, double> array3(Shape(40, 30, 20)); // get a 2D array by fixing the innermost index (i.e. index 0) to 23 MultiArrayView <2, double, StridedArrayTag> array2 = array3.bindInner(23);
MultiArrayView< N-M, T, StridedArrayTag > bindInner | ( | const TinyVector< MultiArrayIndex, M > & | d | ) | const |
bind the M innermost dimensions to certain indices. this reduces the dimensionality of the image to max { 1, N-M }.
Usage:
// create a 3D array of size 40x30x20 typedef MultiArray<3, double>::difference_type Shape; MultiArray<3, double> array3(Shape(40, 30, 20)); // get a 1D array by fixing index 0 to 12, and index 1 to 10 MultiArrayView <1, double, StridedArrayTag> array1 = array3.bindInner(TinyVector<int, 2>(12, 10));
MultiArrayView< N-1, T, C > bindOuter | ( | difference_type_1 | d | ) | const |
bind the outmost dimension to a certain index. this reduces the dimensionality of the image to max { 1, N-1 }.
Usage:
// create a 3D array of size 40x30x20 typedef MultiArray<3, double>::difference_type Shape; MultiArray<3, double> array3(Shape(40, 30, 20)); // get a 2D array by fixing the outermost index (i.e. index 2) to 12 MultiArrayView <2, double> array2 = array3.bindOuter(12);
MultiArrayView< N-M, T, C > bindOuter | ( | const TinyVector< MultiArrayIndex, M > & | d | ) | const |
bind the M outmost dimensions to certain indices. this reduces the dimensionality of the image to max { 1, N-M }.
Usage:
// create a 3D array of size 40x30x20 typedef MultiArray<3, double>::difference_type Shape; MultiArray<3, double> array3(Shape(40, 30, 20)); // get a 1D array by fixing index 1 to 12, and index 2 to 10 MultiArrayView <1, double> array1 = array3.bindOuter(TinyVector<int, 2>(12, 10));
difference_type_1 coordinateToScanOrderIndex | ( | const difference_type & | d | ) | const |
convert coordinate to scan-order index.
template<class U, class CN> | |||||
void copy | ( | const MultiArrayView< N, U, CN > & | rhs | ) |
Copy the data of the right-hand array (array shapes must match).
void copy | ( | const MultiArrayView< N, T, C > & | rhs | ) |
Copy the data of the right-hand array (array shapes must match).
pointer data | ( | ) | const |
return the pointer to the image data
difference_type_1 elementCount | ( | ) | const |
number of the elements in the array.
Reimplemented in Matrix, and Matrix< T >.
bool hasData | ( | ) | const |
returns true iff this view refers to valid data, i.e. data() is not a NULL pointer. (this is false after default construction.)
MultiArrayView& init | ( | const U & | init | ) |
Init with a constant.
Reimplemented in Matrix, MultiArray, Matrix< T >, MultiArray< 2, T, ALLOC >, MultiArray< 2, Int32 >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
MultiArrayView< N+1, T, C > insertSingletonDimension | ( | difference_type_1 | i | ) | const |
Add a singleton dimension (dimension of legth 1).
Singleton dimensions don't change the size of the data, but introduce a new index that can only take the value 0. This is mainly useful for the 'reduce mode' of transformMultiArray() and combineTwoMultiArrays(), because these functions require the source and destination arrays to have the same number of dimensions.
The range of i must be 0 <= i <= N
. The new dimension will become the i'th index, and the old indices from i upwards will shift one place to the right.
Usage:
Suppose we want have a 2D array and want to create a 1D array that contains the row average of the first array.
typedef MultiArrayShape<2>::type Shape2; MultiArray<2, double> original(Shape2(40, 30)); typedef MultiArrayShape<1>::type Shape1; MultiArray<1, double> rowAverages(Shape1(30)); // temporarily add a singleton dimension to the destination array transformMultiArray(srcMultiArrayRange(original), destMultiArrayRange(rowAverages.insertSingletonDimension(0)), FindAverage<double>());
bool isInside | ( | difference_type const & | p | ) | const |
check whether the given point is in the array range.
NormTraits< MultiArrayView< N, T, C > >::NormType norm | ( | int | type = 2 , |
|
bool | useSquaredNorm = true | |||
) | const |
Compute various norms of the array. The norm is determined by parameter type:
squaredNorm()
when useSquaredNorm is true
,
Parameter useSquaredNorm has no effect when type != 2. Defaults: compute L2 norm as square root of squaredNorm()
.
template<class U, class C1> | |||||
bool operator!= | ( | MultiArrayView< N, U, C1 > const & | rhs | ) | const |
check whether two arrays are not elementwise equal. Also true when the two arrays have different shapes.
const_reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y, | |||
difference_type_1 | z, | |||
difference_type_1 | u, | |||
difference_type_1 | v | |||
) | const |
5D const array access. Use only if N == 5.
const_reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y, | |||
difference_type_1 | z, | |||
difference_type_1 | u | |||
) | const |
4D const array access. Use only if N == 4.
const_reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y, | |||
difference_type_1 | z | |||
) | const |
3D const array access. Use only if N == 3.
const_reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y | |||
) | const |
2D const array access. Use only if N == 2.
const_reference operator() | ( | difference_type_1 | x | ) | const |
1D const array access. Use only if N == 1.
reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y, | |||
difference_type_1 | z, | |||
difference_type_1 | u, | |||
difference_type_1 | v | |||
) |
5D array access. Use only if N == 5.
reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y, | |||
difference_type_1 | z, | |||
difference_type_1 | u | |||
) |
4D array access. Use only if N == 4.
reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y, | |||
difference_type_1 | z | |||
) |
3D array access. Use only if N == 3.
reference operator() | ( | difference_type_1 | x, | |
difference_type_1 | y | |||
) |
2D array access. Use only if N == 2.
reference operator() | ( | difference_type_1 | x | ) |
1D array access. Use only if N == 1.
MultiArrayView& operator*= | ( | T const & | rhs | ) |
Multiply-assignment of a scalar.
Reimplemented in MultiArray, MultiArray< 2, T, ALLOC >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
MultiArrayView& operator*= | ( | MultiArrayView< N, U, C1 > const & | rhs | ) |
Multiply-assignment of a compatible MultiArrayView. Fails with PreconditionViolation
exception when the shapes do not match.
MultiArrayView& operator+= | ( | T const & | rhs | ) |
Add-assignment of a scalar.
Reimplemented in MultiArray, MultiArray< 2, T, ALLOC >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
MultiArrayView& operator+= | ( | MultiArrayView< N, U, C1 > const & | rhs | ) |
Add-assignment of a compatible MultiArrayView. Fails with PreconditionViolation
exception when the shapes do not match.
MultiArrayView& operator-= | ( | T const & | rhs | ) |
Subtract-assignment of a scalar.
Reimplemented in MultiArray, MultiArray< 2, T, ALLOC >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
MultiArrayView& operator-= | ( | MultiArrayView< N, U, C1 > const & | rhs | ) |
Subtract-assignment of a compatible MultiArrayView. Fails with PreconditionViolation
exception when the shapes do not match.
MultiArrayView& operator/= | ( | T const & | rhs | ) |
Divide-assignment of a scalar.
Reimplemented in MultiArray, MultiArray< 2, T, ALLOC >, MultiArray< 2, int >, MultiArray< 2, double >, MultiArray< 2, T, std::allocator< T > >, and MultiArray< 2, T >.
MultiArrayView& operator/= | ( | MultiArrayView< N, U, C1 > const & | rhs | ) |
Divide-assignment of a compatible MultiArrayView. Fails with PreconditionViolation
exception when the shapes do not match.
MultiArrayView& operator= | ( | MultiArrayView< N, U, C1 > const & | rhs | ) |
Assignment of a differently typed MultiArrayView. Fails with PreconditionViolation
exception when the shapes do not match.
MultiArrayView< N, T, C > & operator= | ( | MultiArrayView< N, T, C > const & | rhs | ) |
Assignment. There are 3 cases:
MultiArrayView
does not point to valid data (e.g. after default construction), it becomes a copy of rhs. PreconditionViolation
exception is thrown. template<class U, class C1> | |||||
bool operator== | ( | MultiArrayView< N, U, C1 > const & | rhs | ) | const |
check whether two arrays are elementwise equal.
const_reference operator[] | ( | difference_type_1 | d | ) | const |
array access in scan-order sense. Mostly useful to support standard indexing for 1-dimensional multi-arrays, but works for any N. Use scanOrderIndexToCoordinate() and coordinateToScanOrderIndex() for conversion between indices and coordinates.
reference operator[] | ( | difference_type_1 | d | ) |
array access in scan-order sense. Mostly useful to support standard indexing for 1-dimensional multi-arrays, but works for any N. Use scanOrderIndexToCoordinate() and coordinateToScanOrderIndex() for conversion between indices and coordinates.
MultiArrayView<N-M, T, StridedArrayTag> operator[] | ( | const TinyVector< MultiArrayIndex, M > & | d | ) | const |
equvalent to bindInner(), when M < N.
const_reference operator[] | ( | const difference_type & | d | ) | const |
array access.
reference operator[] | ( | const difference_type & | d | ) |
array access.
MultiArrayView< N, T, StridedArrayTag > permuteDimensions | ( | const difference_type & | s | ) | const |
permute the dimensions of the array. The function exchanges the meaning of the dimensions without copying the data. In case of a 2-dimensional array, this is simply array transposition. In higher dimensions, there are more possibilities.
Usage:
typedef MultiArray<2, double>::difference_type Shape; MultiArray<2, double> array(10, 20); MultiArray<2, double, StridedArrayTag> transposed = array.permuteDimensions(Shape(1,0)); for(int i=0; i<array.shape(0), ++i) for(int j=0; j<array.shape(1); ++j) assert(array(i, j) == transposed(j, i));
MultiArrayView< N, T, StridedArrayTag > permuteStridesAscending | ( | ) | const |
Permute the dimensions of the array so that the strides are in ascending order. Determines the appropriate permutation and then calls permuteDimensions().
MultiArrayView< N, T, StridedArrayTag > permuteStridesDescending | ( | ) | const |
Permute the dimensions of the array so that the strides are in descending order. Determines the appropriate permutation and then calls permuteDimensions().
difference_type scanOrderIndexToCoordinate | ( | difference_type_1 | d | ) | const |
convert scan-order index to coordinate.
difference_type_1 shape | ( | difference_type_1 | n | ) | const |
return the array's shape at a certain dimension (same as size(n)
).
const difference_type& shape | ( | ) | const |
return the array's shape.
difference_type_1 size | ( | difference_type_1 | n | ) | const |
return the array's size at a certain dimension.
difference_type_1 size | ( | ) | const |
number of the elements in the array. Same as elementCount()
. Mostly useful to support the std::vector interface.
NormTraits<MultiArrayView>::SquaredNormType squaredNorm | ( | ) | const |
Compute the squared Euclidean norm of the array (sum of squares of the array elements).
Reimplemented in Matrix, and Matrix< T >.
difference_type_1 stride | ( | int | n | ) | const |
return the array's stride at a certain dimension.
const difference_type& stride | ( | ) | const |
return the array's stride for every dimension.
MultiArrayView<N, T, StridedArrayTag> stridearray | ( | const difference_type & | s | ) | const |
apply an additional striding to the image, thereby reducing the shape of the array. for example, multiplying the stride of dimension one by three turns an appropriately layed out (interleaved) rgb image into a single band image.
MultiArrayView< N, T, C >::difference_type strideOrdering | ( | difference_type | strides | ) | [static] |
Compute the ordering of the given strides. The result is describes the current permutation of the axes relative to the standard ascending stride order.
difference_type strideOrdering | ( | ) | const |
Compute the ordering of the strides in this array. The result is describes the current permutation of the axes relative to the standard ascending stride order.
MultiArrayView subarray | ( | const difference_type & | p, | |
const difference_type & | q | |||
) | const |
create a rectangular subarray that spans between the points p and q, where p is in the subarray, q not.
Usage:
// create a 3D array of size 40x30x20 typedef MultiArray<3, double>::difference_type Shape; MultiArray<3, double> array3(Shape(40, 30, 20)); // get a subarray set is smaller by one element at all sides MultiArrayView <3, double> subarray = array3.subarray(Shape(1,1,1), Shape(39, 29, 19));
template<class T2, class C2> | |||||
void swapData | ( | MultiArrayView< N, T2, C2 > | rhs | ) |
swap the data between two MultiArrayView objects.
The shapes of the two array must match.
void swapData | ( | MultiArrayView< N, T, C > | rhs | ) |
swap the data between two MultiArrayView objects.
The shapes of the two array must match.
MultiArrayView<N, T, StridedArrayTag> transpose | ( | ) | const |
Transpose an array. If N==2, this implements the usual matrix transposition. For N > 2, it reverses the order of the indices.
Usage:
typedef MultiArray<2, double>::difference_type Shape; MultiArray<2, double> array(10, 20); MultiArray<2, double, StridedArrayTag> transposed = array.transpose(); for(int i=0; i<array.shape(0), ++i) for(int j=0; j<array.shape(1); ++j) assert(array(i, j) == transposed(j, i));
Reimplemented in Matrix, and Matrix< T >.
const_traverser traverser_begin | ( | ) | const |
returns the N-dimensional MultiIterator pointing to the const first element in every dimension.
traverser traverser_begin | ( | ) |
returns the N-dimensional MultiIterator pointing to the first element in every dimension.
const_traverser traverser_end | ( | ) | const |
returns the N-dimensional const MultiIterator pointing beyond the last element in dimension N, and to the first element in every other dimension.
traverser traverser_end | ( | ) |
returns the N-dimensional MultiIterator pointing beyond the last element in dimension N, and to the first element in every other dimension.
difference_type m_shape [protected] |
the shape of the image pointed to is stored here.
difference_type m_stride [protected] |
the strides (offset of a sample to the next) for every dimension are stored here.
© Ullrich Köthe (ullrich.koethe@iwr.uni-heidelberg.de) |
html generated using doxygen and Python
|