vtkArrayExtents Class Reference

#include <vtkArrayExtents.h>

List of all members.


Detailed Description

Stores the number of dimensions and valid coordinate ranges along each dimension for vtkArray.

vtkArrayExtents describes the number of dimensions and coordinate ranges along each dimension of an N-way collection of values. It is used to retrieve and update the extents of a vtkArray object.

Conceptually, vtkArrayExtents is a collection of vtkArrayRange objects, one per dimension, that store the half-open range of valid coordinates (the "extent") for that dimension. Because each extent is stored as a range rather than a size, you can: create arrays that use one-based coordinates for consistency with mathematics and tools such as MATLAB; easily represent arbitrary subsets of an array; and easily store and manipulate distributed arrays using "global" coordinates.

Convenience constructors are provided for creating extents along one, two, and three dimensions. For higher dimensions, you can:

Use the static Uniform() factory method to create extents that have the same size along an arbitrary number of dimensions.

Use the default constructor and the Append() method to "grow" your extents to the correct number of dimensions.

Use the default constructuor, SetDimensions() and operator[] to assign a size along each dimension.

See also:
vtkArray, vtkArrayRange, vtkArrayCoordinates
Thanks:
Developed by Timothy M. Shead (tshead@sandia.gov) at Sandia National Laboratories.
Examples:
vtkArrayExtents (Examples)
Tests:
vtkArrayExtents (Tests)

Definition at line 72 of file vtkArrayExtents.h.


Public Types

typedef
vtkArrayCoordinates::DimensionT 
DimensionT
typedef
vtkArrayCoordinates::CoordinateT 
CoordinateT
typedef vtkTypeUInt64 SizeT

Public Member Functions

 vtkArrayExtents ()
void Append (const vtkArrayRange &extent)
DimensionT GetDimensions () const
SizeT GetSize () const
void SetDimensions (DimensionT dimensions)
vtkArrayRangeoperator[] (DimensionT i)
const vtkArrayRangeoperator[] (DimensionT i) const
bool operator== (const vtkArrayExtents &rhs) const
bool operator!= (const vtkArrayExtents &rhs) const
bool ZeroBased () const
bool SameShape (const vtkArrayExtents &rhs) const
void GetLeftToRightCoordinatesN (SizeT n, vtkArrayCoordinates &coordinates) const
void GetRightToLeftCoordinatesN (SizeT n, vtkArrayCoordinates &coordinates) const
bool Contains (const vtkArrayExtents &extents) const
bool Contains (const vtkArrayCoordinates &coordinates) const
 vtkArrayExtents (const CoordinateT i)
 vtkArrayExtents (const vtkArrayRange &i)
 vtkArrayExtents (const CoordinateT i, const CoordinateT j)
 vtkArrayExtents (const vtkArrayRange &i, const vtkArrayRange &j)
 vtkArrayExtents (const CoordinateT i, const CoordinateT j, const CoordinateT k)
 vtkArrayExtents (const vtkArrayRange &i, const vtkArrayRange &j, const vtkArrayRange &k)

Static Public Member Functions

static const vtkArrayExtents Uniform (DimensionT n, CoordinateT m)

Friends

VTK_COMMON_EXPORT friend ostream & operator<< (ostream &stream, const vtkArrayExtents &rhs)

Member Typedef Documentation

Definition at line 75 of file vtkArrayExtents.h.

Definition at line 76 of file vtkArrayExtents.h.

typedef vtkTypeUInt64 vtkArrayExtents::SizeT

Definition at line 77 of file vtkArrayExtents.h.


Constructor & Destructor Documentation

vtkArrayExtents::vtkArrayExtents (  ) 

Create zero-dimensional extents.

vtkArrayExtents::vtkArrayExtents ( const CoordinateT  i  )  [explicit]

Create zero-based one-dimensional extents. This constructor is shorthand for vtkArrayExtents(vtkArrayRange(0, i)).

vtkArrayExtents::vtkArrayExtents ( const vtkArrayRange i  )  [explicit]

Create zero-based one-dimensional extents. This constructor is shorthand for vtkArrayExtents(vtkArrayRange(0, i)).

vtkArrayExtents::vtkArrayExtents ( const CoordinateT  i,
const CoordinateT  j 
)

Create zero-based two-dimensional extents. This constructor is shorthand for vtkArrayExtents(vtkArrayRange(0, i), vtkArrayRange(0, j)).

vtkArrayExtents::vtkArrayExtents ( const vtkArrayRange i,
const vtkArrayRange j 
)

Create zero-based two-dimensional extents. This constructor is shorthand for vtkArrayExtents(vtkArrayRange(0, i), vtkArrayRange(0, j)).

vtkArrayExtents::vtkArrayExtents ( const CoordinateT  i,
const CoordinateT  j,
const CoordinateT  k 
)

Create zero-based three-dimensional extents. This constructor is shorthand for vtkArrayExtents(vtkArrayRange(0, i), vtkArrayRange(0, j), vtkArrayRange(0, k)).

vtkArrayExtents::vtkArrayExtents ( const vtkArrayRange i,
const vtkArrayRange j,
const vtkArrayRange k 
)

Create zero-based three-dimensional extents. This constructor is shorthand for vtkArrayExtents(vtkArrayRange(0, i), vtkArrayRange(0, j), vtkArrayRange(0, k)).


Member Function Documentation

static const vtkArrayExtents vtkArrayExtents::Uniform ( DimensionT  n,
CoordinateT  m 
) [static]

Create n-dimensional extents with extent [0, m) along each dimension. This is useful for creating e.g: a square matrix.

void vtkArrayExtents::Append ( const vtkArrayRange extent  ) 

Grow the number of dimensions by one, specifying the extent of the new dimension.

DimensionT vtkArrayExtents::GetDimensions (  )  const

Return the current number of dimensions.

SizeT vtkArrayExtents::GetSize (  )  const

Return the number of values that *could* be stored using the current extents. This is equal to the product of the size of the extent along each dimension.

void vtkArrayExtents::SetDimensions ( DimensionT  dimensions  ) 

Set the current number of dimensions. Note that this method resets the extent along each dimension to an empty range, so you must assign each dimension's extent explicitly using operator[] after calling SetDimensions().

vtkArrayRange& vtkArrayExtents::operator[] ( DimensionT  i  ) 

Accesses the extent of the i-th dimension.

const vtkArrayRange& vtkArrayExtents::operator[] ( DimensionT  i  )  const

Accesses the extent of the i-th dimension.

bool vtkArrayExtents::operator== ( const vtkArrayExtents rhs  )  const

Equality comparison

bool vtkArrayExtents::operator!= ( const vtkArrayExtents rhs  )  const

Inequality comparison

bool vtkArrayExtents::ZeroBased (  )  const

Returns true iff every range in the current extents is zero-based. This is useful as a precondition test for legacy filters/operations that predate the switch to range-based extents and assume that all extents are zero-based. In general, new code should be written to work with arbitrary range extents, so won't need to perform this check.

bool vtkArrayExtents::SameShape ( const vtkArrayExtents rhs  )  const

Returns true iff the given extents have the same number of dimensions and size along each dimension. Note that the ranges along each dimension may have different values, so long as their sizes match.

void vtkArrayExtents::GetLeftToRightCoordinatesN ( SizeT  n,
vtkArrayCoordinates coordinates 
) const

Returns coordinates that reference the n-th value in the extents, where n is in the range [0, GetSize()). The returned coordinates will be ordered so that the left-most indices vary fastest. This is equivalent to column-major ordering for matrices, and corresponds to the order in which consecutive array values would be stored in languages such as Fortran, MATLAB, Octave, and R.

void vtkArrayExtents::GetRightToLeftCoordinatesN ( SizeT  n,
vtkArrayCoordinates coordinates 
) const

Returns coordinates that reference the n-th value in the extents, where n is in the range [0, GetSize()). The returned coordinates will be ordered so that the right-most indices vary fastest. This is equivalent to row-major ordering for matrices, and corresponds to the order in which consecutive array values would be stored in languages including C and C++.

bool vtkArrayExtents::Contains ( const vtkArrayExtents extents  )  const

Returns true if the given extents are a non-overlapping subset of the current extents. Returns false if any of the given extents fall outside the current extents, or there is a mismatch in the number of dimensions.

bool vtkArrayExtents::Contains ( const vtkArrayCoordinates coordinates  )  const

Returns true if the given array coordinates are completely contained by the current extents (i.e. extent begin <= coordinate and coordinate < extent end along every dimension). Returns false if the array coordinates are outside the current extents, or contain a different number of dimensions.


Friends And Related Function Documentation

VTK_COMMON_EXPORT friend ostream& operator<< ( ostream &  stream,
const vtkArrayExtents rhs 
) [friend]


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

Generated on Wed Aug 24 11:28:53 2011 for VTK by  doxygen 1.5.6