casa  5.7.0-16
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | Private Attributes | List of all members
casacore::TSMShape Class Reference

Expanded IPosition for shapes. More...

#include <TSMShape.h>

Public Member Functions

 TSMShape ()
 A zero-length TSMShape. More...
 
 TSMShape (const IPosition &shape)
 Construct from a shape and precalculate some values. More...
 
 TSMShape (const TSMShape &that)
 Copy constructor (copy semantics). More...
 
TSMShapeoperator= (const TSMShape &that)
 Assignment (copy semantics). More...
 
 ~TSMShape ()
 
Int operator() (uInt index) const
 Index into the TSMShape. More...
 
uInt nelements () const
 The number of elements in this TSMShape. More...
 
Bool conform (const TSMShape &other) const
 conform returns true if nelements() == other.nelements(). More...
 
size_t offset (const IPosition &position) const
 Calculate the offset for a given position. More...
 
size_t offset (const IPosition &position, const IPosition &origin) const
 
IPosition position (size_t offset) const
 Calculate the position for a given offset. More...
 
IPosition position (size_t offset, const IPosition &origin) const
 
IPosition offsetIncrement (const IPosition &subShape) const
 Calculate the increments when stepping through an array in a linear way. More...
 
IPosition offsetIncrement (const IPosition &subShape, const IPosition &stride) const
 

Private Attributes

IPosition data_p
 
uInt size_p
 

Detailed Description

Expanded IPosition for shapes.

Intended use:

Internal

Review Status

Reviewed By:
UNKNOWN
Date Reviewed:
before2004/08/25

Prerequisite

Etymology

TSMShape handles the shapes for the Tiled Storage Manager.

Synopsis

TSMShape is an extension of class IPosition to handle shapes. It contains some precalculated values to speed up the calculation of an array offset from an array index (and vice-versa).

Motivation

The Tiled Hypercube Storage Manager is heavily using array shapes and determining offsets from array indices. This class makes these calculations more efficient.

To Do

Definition at line 77 of file TSMShape.h.

Constructor & Destructor Documentation

casacore::TSMShape::TSMShape ( )

A zero-length TSMShape.

casacore::TSMShape::TSMShape ( const IPosition shape)

Construct from a shape and precalculate some values.

casacore::TSMShape::TSMShape ( const TSMShape that)

Copy constructor (copy semantics).

casacore::TSMShape::~TSMShape ( )

Member Function Documentation

Bool casacore::TSMShape::conform ( const TSMShape other) const
inline

conform returns true if nelements() == other.nelements().

Definition at line 174 of file TSMShape.h.

References casacore::IPosition::conform(), and data_p.

uInt casacore::TSMShape::nelements ( ) const
inline

The number of elements in this TSMShape.

Since TSMShape objects use zero-based indexing, the maximum available index is nelements() - 1.

Definition at line 164 of file TSMShape.h.

References size_p.

size_t casacore::TSMShape::offset ( const IPosition position) const

Calculate the offset for a given position.

size_t casacore::TSMShape::offset ( const IPosition position,
const IPosition origin 
) const
IPosition casacore::TSMShape::offsetIncrement ( const IPosition subShape) const

Calculate the increments when stepping through an array in a linear way.

This can be used to update the array offset without recalculating it after each step. For example:

template<class T>
Array<T> someFunc (const Array<T>& array,
const IPosition& subArrayShape,
const IPosition& subArrayStart) const
{
TSMShape TSM (array.shape());
IPosition offsetIncr = TSM.offsetIncrement (subArrayShape);
Array<T> subArray(subArrayShape);
Bool deleteMain;
const T* mainData = array.getStorage (deleteMain);
mainData += TSM.offset (subArrayStart)
Bool deleteSub;
T* subData = subArray.getStorage (deleteSub);
for (uInt i=0; i<subArrayShape(2); i++) {
for (uInt j=0; j<subArrayShape(1); j++) {
for (uInt k=0; k<subArrayShape(0); k++) {
*subData++ = *mainData++;
}
mainData += offsetIncr(1);
}
mainData += offSetIncr(2);
}
}
IPosition casacore::TSMShape::offsetIncrement ( const IPosition subShape,
const IPosition stride 
) const
Int casacore::TSMShape::operator() ( uInt  index) const
inline

Index into the TSMShape.

Indices are zero-based. If the preprocessor symbol AIPS_ARRAY_INDEX_CHECK is defined, "index" will be checked to ensure it is not out of bounds. If this check fails, an AipsError will be thrown.

Definition at line 169 of file TSMShape.h.

References data_p.

TSMShape& casacore::TSMShape::operator= ( const TSMShape that)

Assignment (copy semantics).

"this" and "that" must either be conformant (same size) or "this" must be 0-length, in which case it will resize itself to be the same length as "that".

IPosition casacore::TSMShape::position ( size_t  offset) const

Calculate the position for a given offset.

IPosition casacore::TSMShape::position ( size_t  offset,
const IPosition origin 
) const

Member Data Documentation

IPosition casacore::TSMShape::data_p
private

Definition at line 159 of file TSMShape.h.

Referenced by conform(), and operator()().

uInt casacore::TSMShape::size_p
private

Definition at line 160 of file TSMShape.h.

Referenced by nelements().


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