cartodata  5.1.2
carto::Volume< T > Class Template Reference

N-D Volume main class. More...

#include <cartodata/volume/volumebase.h>

Inheritance diagram for carto::Volume< T >:
Collaboration diagram for carto::Volume< T >:

Classes

class  Position4Di
 

Public Types

enum  { DIM_MAX = 8 }
 The most "basic" (and fastest) iterators: they go from the first voxel linerarly in memory, not taking care of offsets when in a Volume view. More...
 
typedef std::vector< int > Position
 
typedef T datatype
 Access to T type. More...
 
typedef blitz::Array< T, Volume< T >::DIM_MAX >::iterator iterator
 
typedef blitz::Array< T, Volume< T >::DIM_MAX >::const_iterator const_iterator
 
- Public Types inherited from carto::RCObject
typedef int RefCounterType
 

Public Member Functions

 Volume (int sizeX=1, int sizeY=1, int sizeZ=1, int sizeT=1, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation. More...
 
 Volume (const Position4Di &size, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation: Position4Di version. More...
 
 Volume (int sizeX, int sizeY, int sizeZ, int sizeT, int bordersize, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation Same as the above constructor, but allows to specify a border size. More...
 
 Volume (const Position4Di &size, int bordersize, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation: Position4Di version Same as the above constructor, but allows to specify a border size. More...
 
 Volume (int sizeX, int sizeY, int sizeZ, int sizeT, const Position4Di &border, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation Same as the above constructor, but allows to specify a border size in each dimension. More...
 
 Volume (const Position4Di &size, const Position4Di &border, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation: Position4Di version Same as the above constructor, but allows to specify a border size in each dimension. More...
 
 Volume (const std::vector< int > &size, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation: std::vector version Same as the above constructor, but allows to specify a border size in each dimension. More...
 
 Volume (const std::vector< int > &size, const std::vector< int > &border, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocated=true)
 Volume construction and allocation: std::vector version Same as the above constructor, but allows to specify a border size in each dimension. More...
 
 Volume (int sizeX, int sizeY, int sizeZ, int sizeT, T *buffer, const std::vector< size_t > *strides=0)
 This constructor builds a Volume on an already allocated buffer. More...
 
 Volume (const Position4Di &size, T *buffer, const std::vector< size_t > *strides=0)
 Position4Di version This constructor builds a Volume on an already allocated buffer. More...
 
 Volume (const std::vector< int > &size, T *buffer, const std::vector< size_t > *strides=0)
 
 Volume (rc_ptr< Volume< T > > other, const Position4Di &pos=Position4Di(0, 0, 0, 0), const Position4Di &size=Position4Di(-1, -1, -1, -1), const AllocatorContext &allocContext=AllocatorContext())
 This is the volume view constructor. More...
 
 Volume (rc_ptr< Volume< T > > other, const Position &pos, const Position &size=Position(), const AllocatorContext &allocContext=AllocatorContext())
 This is the volume view constructor. More...
 
 Volume (rc_ptr< Volume< T > > other, const Position &pos, const Position &size, T *buffer, const std::vector< size_t > &strides)
 This "very special" constructor should not be used in regular programs. More...
 
 Volume (const Volume< T > &other)
 Copy constructor The copy constructors actually duplicates data buffers. More...
 
virtual ~Volume ()
 
Volume< T > & operator= (const Volume< T > &other)
 
iterator begin ()
 Iterators returned here are the most "basic" (and fastest) iterators: they go from the first voxel linerarly in memory, not taking care of offsets when in a Volume view. More...
 
iterator end ()
 
const_iterator begin () const
 
const_iterator end () const
 
const T & operator() (long x, long y=0, long z=0, long t=0) const
 Warning: this operator is not virtual, so may not have the expected result on inherited classes (see old VolumeView) More...
 
T & operator() (long x, long y=0, long z=0, long t=0)
 
const T & at (long x, long y=0, long z=0, long t=0) const
 
T & at (long x, long y=0, long z=0, long t=0)
 
const T & operator() (const Position4Di &position) const
 
T & operator() (const Position4Di &position)
 
const T & at (const Position4Di &position) const
 
T & at (const Position4Di &position)
 
const T & at (const std::vector< int > &) const
 
T & at (const std::vector< int > &)
 
const T & operator() (const std::vector< int > &position) const
 
T & operator() (const std::vector< int > &position)
 
const T & at (const blitz::TinyVector< int, 1 > &) const
 
T & at (const blitz::TinyVector< int, 1 > &)
 
const T & at (const blitz::TinyVector< int, 2 > &) const
 
T & at (const blitz::TinyVector< int, 2 > &)
 
const T & at (const blitz::TinyVector< int, 3 > &) const
 
T & at (const blitz::TinyVector< int, 3 > &)
 
const T & at (const blitz::TinyVector< int, 4 > &) const
 
T & at (const blitz::TinyVector< int, 4 > &)
 
const T & at (const blitz::TinyVector< int, Volume< T >::DIM_MAX > &) const
 
T & at (const blitz::TinyVector< int, Volume< T >::DIM_MAX > &)
 
blitz::Array< T, Volume< T >::DIM_MAXat (const blitz::RectDomain< Volume< T >::DIM_MAX > &subdomain) const
 
blitz::Array< T, Volume< T >::DIM_MAXat (const blitz::StridedDomain< Volume< T >::DIM_MAX > &subdomain) const
 
blitz::Array< T, Volume< T >::DIM_MAXat (const blitz::Range &r0) const
 
blitz::Array< T, Volume< T >::DIM_MAXat (const blitz::Range &r0, const blitz::Range &r1) const
 
blitz::Array< T, Volume< T >::DIM_MAXat (const blitz::Range &r0, const blitz::Range &r1, const blitz::Range &r2) const
 
blitz::Array< T, Volume< T >::DIM_MAXat (const blitz::Range &r0, const blitz::Range &r1, const blitz::Range &r2, const blitz::Range &r3) const
 
const T & at (long x1, long x2, long x3, long x4, long x5, long x6=0, long x7=0, long x8=0) const
 
T & at (long x1, long x2, long x3, long x4, long x5, long x6=0, long x7=0, long x8=0)
 
const T & operator() (long x1, long x2, long x3, long x4, long x5, long x6=0, long x7=0, long x8=0) const
 
T & operator() (long x1, long x2, long x3, long x4, long x5, long x6=0, long x7=0, long x8=0)
 
virtual void initialize ()
 Initializes header info. More...
 
const AllocatorContext & allocatorContext () const
 returns volume's AllocatorContext More...
 
void allocate ()
 This function is only useful in the particular context of an unallocated Volume, when the constructor has been used with the allocated flag to false. More...
 
virtual void reallocate (int sizeX=1, int sizeY=1, int sizeZ=1, int sizeT=1, bool keepcontents=false, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocate=true, const std::vector< size_t > *strides=0)
 allows resizing and changing allocator More...
 
virtual void reallocate (const Position4Di &size, bool keepcontents=false, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocate=true, const std::vector< size_t > *strides=0)
 
virtual void reallocate (const std::vector< int > &size, bool keepcontents=false, const AllocatorContext &allocatorContext=AllocatorContext(), bool allocate=true, const std::vector< size_t > *strides=0)
 
Volume< T > copy () const
 Create a volume of same dimension and copy the data. More...
 
template<typename OUTP >
Volume< OUTP > copy () const
 
Volume< T > deepcopy () const
 Copy the full data structure. More...
 
template<typename OUTP >
Volume< OUTP > deepcopy () const
 
Volume< T > copyStructure () const
 Copy the full data structure without copying the actual data. More...
 
template<typename OUTP >
Volume< OUTP > copyStructure () const
 Copy the full data structure without copying the actual data. More...
 
void copySubVolume (const Volume< T > &source, const std::vector< int > &pos=std::vector< int >())
 Copy voxels values from another volume. More...
 
void copySubVolume (const rc_ptr< Volume< T > > &source, const std::vector< int > &pos=std::vector< int >())
 Copy voxels values from another volume pos is the position into the destination (this) volume, and defaults to 0. More...
 
template<typename OUTP >
 operator Volume< OUTP > () const
 Cast to Volume of different datatype. More...
 
int getLevelsCount () const
 Get levels count in volume hierarchy from the current volume to the topmost volume. More...
 
int refLevel (const int level) const
 Transform a level index to a valid level index in the volume hierarchy. More...
 
rc_ptr< Volume< T > > refVolume () const
 Get parent volume. More...
 
rc_ptr< Volume< T > > refVolumeAtLevel (const int level) const
 Get parent volume at a specified level in volume hierarchy. More...
 
void setRefVolume (const rc_ptr< Volume< T > > &refvol)
 Set parent volume. More...
 
const PositionposInRefVolume () const
 Get position in parent volume. More...
 
Position posInRefVolumeAtLevel (const int level) const
 Get position relatively to parent volume at specified level. More...
 
void setPosInRefVolume (const Position4Di &pos)
 Set position in parent volume. More...
 
void setPosInRefVolume (const Position &pos)
 
std::vector< int > getBorders () const
 Get borders for the volume. More...
 
std::vector< size_t > getStrides () const
 Get strides for the volume. More...
 
 operator bool () const
 Implicit cast to bool returns all() More...
 
bool all () const
 True if all values compare to true. More...
 
bool any () const
 True if at least one value compares to true. More...
 
min () const
 
max () const
 
DataTypeTraits< T >::LongType sum () const
 To avoid overflow, the biggest possible type (intmax_t, uintmax_t, double...) is used for computation and returned. More...
 
void fill (const T &value)
 Fills the volume with a given value. More...
 
void fillBorder (const T &value)
 Fill border with a constant value. More...
 
Volume< T > & operator= (const T &value)
 Copy operator. More...
 
- Public Member Functions inherited from carto::VolumeProxy< T >
 VolumeProxy (int sizeX=1, int sizeY=1, int sizeZ=1, int sizeT=1)
 
 VolumeProxy (const std::vector< int > &size)
 
 VolumeProxy (const VolumeProxy< T > &other)
 
virtual ~VolumeProxy ()
 
int getSizeX () const
 
int getSizeY () const
 
int getSizeZ () const
 
int getSizeT () const
 
std::vector< int > getSize () const
 get the 4 dimensions in a vector More...
 
std::vector< float > getVoxelSize () const
 get the voxel size from the header, with 4 values defaulting to 1.mm if not present More...
 
void setVoxelSize (float vx, float vy=1., float vz=1., float vt=1.)
 
void setVoxelSize (const std::vector< float > &vs)
 
VolumeProxy< T > & operator= (const VolumeProxy< T > &other)
 
virtual void copyHeaderFrom (const PropertySet &other)
 copy properties from other to this, avoiding forbidden properties like size. More...
 
virtual void copyHeaderFrom (const Object &other)
 
- Public Member Functions inherited from carto::Headered
 Headered ()
 
 Headered (const Headered &other)
 
virtual ~Headered ()
 
Headeredoperator= (const Headered &other)
 
const PropertySetheader () const
 
PropertySetheader ()
 
void addPropertyFilter (const rc_ptr< PropertyFilter > &propertyFilter)
 
bool hasPropertyFilter (const std::string &propertyFilterName) const
 
bool connect (const std::string &propertyFilterName, const PropertyFilter::Slot &slot)
 
bool disconnect (const std::string &propertyFilterName, const PropertyFilter::Slot &slot)
 
std::set< rc_ptr< PropertyFilter > > getPropertyFilters (const std::string &propertyName) const
 
void delay ()
 
void flush ()
 
void blockSignals (bool)
 
bool signalsBlocked () const
 
std::string uuid ()
 
bool copyUuid (const PropertySet &)
 
bool copyUuid (const Headered &)
 
- Public Member Functions inherited from carto::RCObject
 RCObject ()
 
 RCObject (const RCObject &)
 
RCObjectoperator= (const RCObject &)
 
virtual ~RCObject ()
 
- Public Member Functions inherited from carto::Observer
virtual ~Observer ()
 

Protected Member Functions

void allocate (int oldSizeX, int oldSizeY, int oldSizeZ, int oldSizeT, bool allocate, const AllocatorContext &allocatorContext, const std::vector< size_t > *strides=0)
 
void allocate (const std::vector< int > &oldSize, bool allocate, const AllocatorContext &allocatorContext, const std::vector< size_t > *strides=0)
 
void slotSizeChanged (const PropertyFilter &propertyFilter)
 
void updateItemsBuffer ()
 
void constructBorders (const Position &bordersize, const AllocatorContext &allocatorContext, bool allocated)
 
- Protected Member Functions inherited from carto::Observer
 Observer ()
 

Protected Attributes

AllocatedVector< T > _items
 
blitz::Array< T, Volume< T >::DIM_MAX_blitz
 
rc_ptr< Volume< T > > _refvol
 
std::vector< int > _pos
 
- Protected Attributes inherited from carto::VolumeProxy< T >
std::vector< int > _size
 

Detailed Description

template<typename T>
class carto::Volume< T >

N-D Volume main class.

Since 2013 release (version 4.4), Volume and VolumeView are merged into a singleclass. Every Volume can be a view into an other volume. If it is not, its parent volume is NULL. This allows to deal the same way with classic volumes, volumes with borders or partially read volumes.

Volumes should generally be used via reference-counting pointers (rc_ptr): there is a (slightly) specialized rc_ptr for Volume subclasses: VolumeRef.

Since 2016 release (version 4.5), comparison and arithmetic operators are specialized and shipped in volume.h. They can be used as long as the same operation between contained types is well defined. Several helper method (member and non member) are also included.

In version 4.6 Volume has extended support from 4D to N-D, still limited to a fixed max number of dimensions at compilation time (normally set to 8).

See also
Volumes concept philosophy

Iterating on volumes is described in Iterating over volumes

To use Volume classes on "standard" types (numeric types, on which the Volume class has already been compiled in the libraries), just include <cartodata/volume/volume.h>. If you need to use them on other non-standard types (if you get a link error about missing symbols), you will need to recompile the Volume template class on these types: in this case you should include <cartodata/volume/volume_d.h> and force the compilation:

template class carto::Volume<MyType>;
N-D Volume main class.
Definition: volumebase.h:119

This should be done only once (in one source file) for each type.

Definition at line 118 of file volumebase.h.

Member Typedef Documentation

◆ const_iterator

template<typename T >
typedef blitz::Array<T,Volume<T>::DIM_MAX>::const_iterator carto::Volume< T >::const_iterator

Definition at line 142 of file volumebase.h.

◆ datatype

template<typename T >
typedef T carto::Volume< T >::datatype

Access to T type.

Definition at line 132 of file volumebase.h.

◆ iterator

template<typename T >
typedef blitz::Array<T,Volume<T>::DIM_MAX>::iterator carto::Volume< T >::iterator

Definition at line 141 of file volumebase.h.

◆ Position

template<typename T >
typedef std::vector<int> carto::Volume< T >::Position

Definition at line 129 of file volumebase.h.

Member Enumeration Documentation

◆ anonymous enum

template<typename T >
anonymous enum

The most "basic" (and fastest) iterators: they go from the first voxel linerarly in memory, not taking care of offsets when in a Volume view.

Taking care of splitting loops line-by-line is the responsability of programmers using such

Enumerator
DIM_MAX 

Definition at line 140 of file volumebase.h.

Constructor & Destructor Documentation

◆ Volume() [1/15]

template<typename T >
carto::Volume< T >::Volume ( int  sizeX = 1,
int  sizeY = 1,
int  sizeZ = 1,
int  sizeT = 1,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation.

Parameters
sizeXnumber of voxels
sizeYnumber of voxels
sizeZnumber of voxels
sizeTnumber of voxels
allocatorContextinformation about how to allocate the volume: it can be a bit complex to do really optimal things, but the default value (default constructor of AllocatorContext) is OK in most cases.
allocatednormally left to true, it can exceptionnally be set to false for "virtual" volumes that must not be actually allocated but are only sources for a view Volume.

Definition at line 71 of file volumebase_d.h.

References carto::Volume< T >::allocate(), and carto::Volume< T >::allocatorContext().

◆ Volume() [2/15]

template<typename T >
carto::Volume< T >::Volume ( const Position4Di size,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation: Position4Di version.

Parameters
sizenumber of voxels in each dimension
allocatorContextinformation about how to allocate the volume: it can be a bit complex to do really optimal things, but the default value (default constructor of AllocatorContext) is OK in most cases.
allocatednormally left to true, it can exceptionnally be set to false for "virtual" volumes that must not be actually allocated but are only sources for a view Volume.

Definition at line 82 of file volumebase_d.h.

References carto::Volume< T >::allocate(), and carto::Volume< T >::allocatorContext().

◆ Volume() [3/15]

template<typename T >
carto::Volume< T >::Volume ( int  sizeX,
int  sizeY,
int  sizeZ,
int  sizeT,
int  bordersize,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation Same as the above constructor, but allows to specify a border size.

Border is handled as a larger volume, with a view in it. The current volume is this view.

Definition at line 181 of file volumebase_d.h.

References carto::Volume< T >::_pos, carto::Volume< T >::allocatorContext(), and carto::Volume< T >::constructBorders().

◆ Volume() [4/15]

template<typename T >
carto::Volume< T >::Volume ( const Position4Di size,
int  bordersize,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation: Position4Di version Same as the above constructor, but allows to specify a border size.

Border is handled as a larger volume, with a view in it. The current volume is this view.

Definition at line 200 of file volumebase_d.h.

References carto::Volume< T >::_pos, carto::Volume< T >::allocatorContext(), and carto::Volume< T >::constructBorders().

◆ Volume() [5/15]

template<typename T >
carto::Volume< T >::Volume ( int  sizeX,
int  sizeY,
int  sizeZ,
int  sizeT,
const Position4Di border,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation Same as the above constructor, but allows to specify a border size in each dimension.

Definition at line 152 of file volumebase_d.h.

References carto::Volume< T >::allocatorContext(), carto::Volume< T >::constructBorders(), and carto::Volume< T >::Position4Di::toVector().

◆ Volume() [6/15]

template<typename T >
carto::Volume< T >::Volume ( const Position4Di size,
const Position4Di border,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation: Position4Di version Same as the above constructor, but allows to specify a border size in each dimension.

Definition at line 165 of file volumebase_d.h.

References carto::Volume< T >::allocatorContext(), carto::Volume< T >::constructBorders(), and carto::Volume< T >::Position4Di::toVector().

◆ Volume() [7/15]

template<typename T >
carto::Volume< T >::Volume ( const std::vector< int > &  size,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation: std::vector version Same as the above constructor, but allows to specify a border size in each dimension.

Definition at line 222 of file volumebase_d.h.

References carto::Volume< T >::allocate(), and carto::Volume< T >::allocatorContext().

◆ Volume() [8/15]

template<typename T >
carto::Volume< T >::Volume ( const std::vector< int > &  size,
const std::vector< int > &  border,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocated = true 
)
explicit

Volume construction and allocation: std::vector version Same as the above constructor, but allows to specify a border size in each dimension.

Definition at line 234 of file volumebase_d.h.

References carto::Volume< T >::_pos, carto::Volume< T >::allocatorContext(), and carto::Volume< T >::constructBorders().

◆ Volume() [9/15]

template<typename T >
carto::Volume< T >::Volume ( int  sizeX,
int  sizeY,
int  sizeZ,
int  sizeT,
T *  buffer,
const std::vector< size_t > *  strides = 0 
)

This constructor builds a Volume on an already allocated buffer.

The Volume is not owner of the underlying data.

Definition at line 252 of file volumebase_d.h.

References carto::Volume< T >::allocate(), and carto::Volume< T >::allocatorContext().

◆ Volume() [10/15]

template<typename T >
carto::Volume< T >::Volume ( const Position4Di size,
T *  buffer,
const std::vector< size_t > *  strides = 0 
)

Position4Di version This constructor builds a Volume on an already allocated buffer.

The Volume is not owner of the underlying data.

Definition at line 263 of file volumebase_d.h.

References carto::Volume< T >::allocate(), and carto::Volume< T >::allocatorContext().

◆ Volume() [11/15]

template<typename T >
carto::Volume< T >::Volume ( const std::vector< int > &  size,
T *  buffer,
const std::vector< size_t > *  strides = 0 
)

◆ Volume() [12/15]

template<typename T >
carto::Volume< T >::Volume ( rc_ptr< Volume< T > >  other,
const Position4Di pos = Position4Di( 0, 0, 0, 0 ),
const Position4Di size = Position4Di( -1, -1, -1, -1 ),
const AllocatorContext &  allocContext = AllocatorContext() 
)
inline

This is the volume view constructor.

Beware not to mix it up with the copy constructor ( it takes a pointer to volume instead of a volume ) If parent volume is allocated, view points to its data and doesn't own it. Else, it allocates size and owns it.

Definition at line 294 of file volumebase_d.h.

References carto::Volume< T >::_blitz, carto::Volume< T >::_items, carto::Volume< T >::allocate(), carto::VolumeProxy< T >::getSize(), carto::Headered::header(), carto::PropertySet::setProperty(), carto::Volume< T >::Position4Di::size(), and carto::Volume< T >::Position4Di::toVector().

◆ Volume() [13/15]

template<typename T >
carto::Volume< T >::Volume ( rc_ptr< Volume< T > >  other,
const Position pos,
const Position size = Position(),
const AllocatorContext &  allocContext = AllocatorContext() 
)
inline

This is the volume view constructor.

Beware not to mix it up with the copy constructor ( it takes a pointer to volume instead of a volume ) If parent volume is allocated, view points to its data and doesn't own it. Else, it allocates size and owns it.

Definition at line 372 of file volumebase_d.h.

References carto::Volume< T >::_blitz, carto::Volume< T >::_items, carto::Volume< T >::allocate(), carto::VolumeProxy< T >::getSize(), carto::Headered::header(), and carto::PropertySet::setProperty().

◆ Volume() [14/15]

template<typename T >
carto::Volume< T >::Volume ( rc_ptr< Volume< T > >  other,
const Position pos,
const Position size,
T *  buffer,
const std::vector< size_t > &  strides 
)

This "very special" constructor should not be used in regular programs.

It is meant for the IO system to map file views into memory views.

Definition at line 446 of file volumebase_d.h.

References carto::Volume< T >::allocate(), and carto::Volume< T >::allocatorContext().

◆ Volume() [15/15]

template<typename T >
carto::Volume< T >::Volume ( const Volume< T > &  other)

Copy constructor The copy constructors actually duplicates data buffers.

In the case of a volume view, the underlying volume is also duplicated, so the new volume will be a view in a new duplicate bigger volume.

Definition at line 462 of file volumebase_d.h.

References carto::Volume< T >::_blitz, carto::Volume< T >::_items, carto::Volume< T >::_refvol, carto::Volume< T >::allocate(), carto::Volume< T >::allocatorContext(), carto::rc_ptr< class >::get(), and carto::Volume< T >::posInRefVolume().

◆ ~Volume()

template<typename T >
carto::Volume< T >::~Volume
virtual

Definition at line 512 of file volumebase_d.h.

Member Function Documentation

◆ all()

template<typename T >
bool carto::Volume< T >::all
inline

True if all values compare to true.

Definition at line 143 of file volumebase_d_operators.h.

References carto::volumebaseinternal::select_has_bool_conversion< T, has_bool_conversion >::all().

◆ allocate() [1/3]

template<typename T >
void carto::Volume< T >::allocate

This function is only useful in the particular context of an unallocated Volume, when the constructor has been used with the allocated flag to false.

Calling allocate() afterwards will actually allocate the memory. Otherwise it will do nothing.

Definition at line 1101 of file volumebase_d.h.

Referenced by carto::Volume< T >::allocate(), and carto::Volume< T >::Volume().

◆ allocate() [2/3]

template<typename T >
void carto::Volume< T >::allocate ( const std::vector< int > &  oldSize,
bool  allocate,
const AllocatorContext &  allocatorContext,
const std::vector< size_t > *  strides = 0 
)
protected

Definition at line 898 of file volumebase_d.h.

References carto::min(), carto::volumeutil::minSize(), and carto::toString().

◆ allocate() [3/3]

template<typename T >
void carto::Volume< T >::allocate ( int  oldSizeX,
int  oldSizeY,
int  oldSizeZ,
int  oldSizeT,
bool  allocate,
const AllocatorContext &  allocatorContext,
const std::vector< size_t > *  strides = 0 
)
protected

Definition at line 880 of file volumebase_d.h.

References carto::Volume< T >::allocate().

◆ allocatorContext()

◆ any()

template<typename T >
bool carto::Volume< T >::any
inline

True if at least one value compares to true.

Definition at line 150 of file volumebase_d_operators.h.

References carto::volumebaseinternal::select_has_bool_conversion< T, has_bool_conversion >::any().

◆ at() [1/24]

template<typename T >
blitz::Array< T, Volume< T >::DIM_MAX > carto::Volume< T >::at ( const blitz::Range &  r0) const
inline

Definition at line 540 of file volumebase_d_inline.h.

◆ at() [2/24]

template<typename T >
blitz::Array< T, Volume< T >::DIM_MAX > carto::Volume< T >::at ( const blitz::Range &  r0,
const blitz::Range &  r1 
) const
inline

Definition at line 547 of file volumebase_d_inline.h.

◆ at() [3/24]

template<typename T >
blitz::Array< T, Volume< T >::DIM_MAX > carto::Volume< T >::at ( const blitz::Range &  r0,
const blitz::Range &  r1,
const blitz::Range &  r2 
) const
inline

Definition at line 554 of file volumebase_d_inline.h.

◆ at() [4/24]

template<typename T >
blitz::Array< T, Volume< T >::DIM_MAX > carto::Volume< T >::at ( const blitz::Range &  r0,
const blitz::Range &  r1,
const blitz::Range &  r2,
const blitz::Range &  r3 
) const
inline

Definition at line 562 of file volumebase_d_inline.h.

◆ at() [5/24]

template<typename T >
blitz::Array< T, Volume< T >::DIM_MAX > carto::Volume< T >::at ( const blitz::RectDomain< Volume< T >::DIM_MAX > &  subdomain) const
inline

Definition at line 526 of file volumebase_d_inline.h.

◆ at() [6/24]

template<typename T >
blitz::Array< T, Volume< T >::DIM_MAX > carto::Volume< T >::at ( const blitz::StridedDomain< Volume< T >::DIM_MAX > &  subdomain) const
inline

Definition at line 533 of file volumebase_d_inline.h.

◆ at() [7/24]

template<typename T >
T & carto::Volume< T >::at ( const blitz::TinyVector< int, 1 > &  index)
inline

Definition at line 471 of file volumebase_d_inline.h.

◆ at() [8/24]

template<typename T >
const T & carto::Volume< T >::at ( const blitz::TinyVector< int, 1 > &  index) const
inline

Definition at line 465 of file volumebase_d_inline.h.

◆ at() [9/24]

template<typename T >
T & carto::Volume< T >::at ( const blitz::TinyVector< int, 2 > &  index)
inline

Definition at line 483 of file volumebase_d_inline.h.

◆ at() [10/24]

template<typename T >
const T & carto::Volume< T >::at ( const blitz::TinyVector< int, 2 > &  index) const
inline

Definition at line 477 of file volumebase_d_inline.h.

◆ at() [11/24]

template<typename T >
T & carto::Volume< T >::at ( const blitz::TinyVector< int, 3 > &  index)
inline

Definition at line 495 of file volumebase_d_inline.h.

◆ at() [12/24]

template<typename T >
const T & carto::Volume< T >::at ( const blitz::TinyVector< int, 3 > &  index) const
inline

Definition at line 489 of file volumebase_d_inline.h.

◆ at() [13/24]

template<typename T >
T & carto::Volume< T >::at ( const blitz::TinyVector< int, 4 > &  index)
inline

Definition at line 507 of file volumebase_d_inline.h.

◆ at() [14/24]

template<typename T >
const T & carto::Volume< T >::at ( const blitz::TinyVector< int, 4 > &  index) const
inline

Definition at line 501 of file volumebase_d_inline.h.

◆ at() [15/24]

template<typename T >
T & carto::Volume< T >::at ( const blitz::TinyVector< int, Volume< T >::DIM_MAX > &  index)
inline

Definition at line 519 of file volumebase_d_inline.h.

◆ at() [16/24]

template<typename T >
const T & carto::Volume< T >::at ( const blitz::TinyVector< int, Volume< T >::DIM_MAX > &  index) const
inline

Definition at line 513 of file volumebase_d_inline.h.

◆ at() [17/24]

template<typename T >
T & carto::Volume< T >::at ( const Position4Di position)
inline

Definition at line 134 of file volumebase_d_inline.h.

◆ at() [18/24]

template<typename T >
const T & carto::Volume< T >::at ( const Position4Di position) const
inline

Definition at line 118 of file volumebase_d_inline.h.

◆ at() [19/24]

template<typename T >
T & carto::Volume< T >::at ( const std::vector< int > &  index)
inline

Definition at line 301 of file volumebase_d_inline.h.

◆ at() [20/24]

template<typename T >
const T & carto::Volume< T >::at ( const std::vector< int > &  index) const
inline

Definition at line 149 of file volumebase_d_inline.h.

◆ at() [21/24]

template<typename T >
T & carto::Volume< T >::at ( long  x,
long  y = 0,
long  z = 0,
long  t = 0 
)
inline

Definition at line 76 of file volumebase_d_inline.h.

◆ at() [22/24]

◆ at() [23/24]

template<typename T >
T & carto::Volume< T >::at ( long  x1,
long  x2,
long  x3,
long  x4,
long  x5,
long  x6 = 0,
long  x7 = 0,
long  x8 = 0 
)
inline

Definition at line 587 of file volumebase_d_inline.h.

◆ at() [24/24]

template<typename T >
const T & carto::Volume< T >::at ( long  x1,
long  x2,
long  x3,
long  x4,
long  x5,
long  x6 = 0,
long  x7 = 0,
long  x8 = 0 
) const
inline

Definition at line 570 of file volumebase_d_inline.h.

◆ begin() [1/2]

template<typename T >
Volume< T >::iterator carto::Volume< T >::begin

Iterators returned here are the most "basic" (and fastest) iterators: they go from the first voxel linerarly in memory, not taking care of offsets when in a Volume view.

Taking care of splitting loops line-by-line is the responsability of programmers using such iterators.

Definition at line 819 of file volumebase_d.h.

◆ begin() [2/2]

template<typename T >
Volume< T >::const_iterator carto::Volume< T >::begin

Definition at line 837 of file volumebase_d.h.

◆ constructBorders()

template<typename T >
void carto::Volume< T >::constructBorders ( const Position bordersize,
const AllocatorContext &  allocatorContext,
bool  allocated 
)
protected

Definition at line 100 of file volumebase_d.h.

Referenced by carto::Volume< T >::Volume().

◆ copy() [1/2]

template<typename T >
Volume< OUTP > carto::Volume< T >::copy
inline

Create a volume of same dimension and copy the data.

This method does not deal with the underlying view structures, so borders or parent volumes are not copied or transfered.

Definition at line 298 of file volumebase_d_operators.h.

◆ copy() [2/2]

template<typename T >
template<typename OUTP >
Volume<OUTP> carto::Volume< T >::copy ( ) const

◆ copyStructure() [1/2]

template<typename T >
Volume< OUTP > carto::Volume< T >::copyStructure
inline

Copy the full data structure without copying the actual data.

Definition at line 328 of file volumebase_d_operators.h.

◆ copyStructure() [2/2]

template<typename T >
template<typename OUTP >
Volume<OUTP> carto::Volume< T >::copyStructure ( ) const

Copy the full data structure without copying the actual data.

◆ copySubVolume() [1/2]

template<typename T >
void carto::Volume< T >::copySubVolume ( const rc_ptr< Volume< T > > &  source,
const std::vector< int > &  pos = std::vector<int>() 
)

Copy voxels values from another volume pos is the position into the destination (this) volume, and defaults to 0.

Contrarily to the = operator, the destination (this) volume is not reallocated or reshaped, and its header is left unchanged.

Definition at line 812 of file volumebase_d.h.

◆ copySubVolume() [2/2]

template<typename T >
void carto::Volume< T >::copySubVolume ( const Volume< T > &  source,
const std::vector< int > &  pos = std::vector<int>() 
)

Copy voxels values from another volume.

pos is the position into the destination (this) volume, and defaults to 0. Contrarily to the = operator, the destination (this) volume is not reallocated or reshaped, and its header is left unchanged.

Definition at line 779 of file volumebase_d.h.

References carto::Volume< T >::at(), carto::NDIterator_base::ended(), carto::VolumeProxy< T >::getSize(), carto::Volume< T >::getStrides(), carto::const_line_NDIterator< class >::inc_line_ptr(), carto::line_NDIterator< class >::inc_line_ptr(), carto::line_NDIterator< class >::line_length(), and carto::min().

◆ deepcopy() [1/2]

template<typename T >
Volume< OUTP > carto::Volume< T >::deepcopy
inline

Copy the full data structure.

This is similar to what the copy constructor does.

Definition at line 313 of file volumebase_d_operators.h.

Referenced by carto::operator++(), and carto::operator--().

◆ deepcopy() [2/2]

template<typename T >
template<typename OUTP >
Volume<OUTP> carto::Volume< T >::deepcopy ( ) const

◆ end() [1/2]

template<typename T >
Volume< T >::iterator carto::Volume< T >::end

Definition at line 828 of file volumebase_d.h.

◆ end() [2/2]

template<typename T >
Volume< T >::const_iterator carto::Volume< T >::end

Definition at line 846 of file volumebase_d.h.

◆ fill()

template<typename T >
void carto::Volume< T >::fill ( const T &  value)
inline

Fills the volume with a given value.

Definition at line 191 of file volumebase_d_operators.h.

References carto::volumeutil::selfApply().

◆ fillBorder()

template<typename T >
void carto::Volume< T >::fillBorder ( const T &  value)
inline

Fill border with a constant value.

Fill borders with a constant value.

More precisely, fill the surrounding of the volume view in the reference volume (if any) using the given value.

Definition at line 207 of file volumebase_d_operators.h.

◆ getBorders()

template<typename T >
std::vector< int > carto::Volume< T >::getBorders
inline

Get borders for the volume.

A volume that can have borders is a volume
that references another volume. It can be understood as a view in the reference volume.

Returns
std::vector<uint16_t> that contains the borders availables for the volume. vector[0]: low border in x direction vector[1]: high border in x direction vector[2]: low border in y direction vector[3]: high border in y direction vector[4]: low border in z direction vector[5]: high border in z direction vector[6]: low border in t direction vector[7]: high border in t direction

Definition at line 707 of file volumebase_d.h.

References carto::VolumeProxy< T >::_size.

Referenced by carto::matrix_product(), carto::setBorders(), carto::setMinBorders(), and carto::transpose().

◆ getLevelsCount()

template<typename T >
int carto::Volume< T >::getLevelsCount
inline

Get levels count in volume hierarchy from the current volume to the topmost volume.

Definition at line 540 of file volumebase_d.h.

References carto::const_ref< class >::isNull().

◆ getStrides()

template<typename T >
std::vector< size_t > carto::Volume< T >::getStrides
inline

Get strides for the volume.

Strides contain the number of voxels for
each dimension including.

Returns
std::vector<uint16_t> that contains the borders availables for the volume. vector[0]: number of voxels for the 0 dimension. Value is always 1 as no border is defined around each voxel. vector[1]: number of voxels for the 1st dimension, i.e. in a line including its borders. vector[2]: number of voxels for the 2nde dimension, i.e. in a slice including its borders. vector[3]: number of voxels for the 3rd dimension, i.e. in a volume including its borders.

Definition at line 726 of file volumebase_d.h.

Referenced by carto::VolumeUtil< T >::accumulate(), carto::volumeutil::accumulate(), carto::volumeutil::applyTowards(), carto::Volume< T >::copySubVolume(), soma::VolumeUtilIO< T >::readPartial(), and carto::transpose().

◆ initialize()

template<typename T >
void carto::Volume< T >::initialize
virtual

Initializes header info.

Reimplemented from carto::Headered.

Definition at line 855 of file volumebase_d.h.

References carto::Headered::addPropertyFilter(), carto::Headered::connect(), and carto::Headered::initialize().

◆ max()

template<typename T >
T carto::Volume< T >::max
inline

◆ min()

template<typename T >
T carto::Volume< T >::min
inline

◆ operator bool()

template<typename T >
carto::Volume< T >::operator bool
inline

◆ operator Volume< OUTP >()

template<typename T >
template<typename OUTP >
carto::Volume< T >::operator Volume< OUTP >
inline

Cast to Volume of different datatype.

Definition at line 344 of file volumebase_d_operators.h.

◆ operator()() [1/8]

template<typename T >
T & carto::Volume< T >::operator() ( const Position4Di position)
inline

Definition at line 142 of file volumebase_d_inline.h.

◆ operator()() [2/8]

template<typename T >
const T & carto::Volume< T >::operator() ( const Position4Di position) const
inline

Definition at line 126 of file volumebase_d_inline.h.

◆ operator()() [3/8]

template<typename T >
T & carto::Volume< T >::operator() ( const std::vector< int > &  position)
inline

Definition at line 459 of file volumebase_d_inline.h.

◆ operator()() [4/8]

template<typename T >
const T & carto::Volume< T >::operator() ( const std::vector< int > &  position) const
inline

Definition at line 452 of file volumebase_d_inline.h.

◆ operator()() [5/8]

template<typename T >
T & carto::Volume< T >::operator() ( long  x,
long  y = 0,
long  z = 0,
long  t = 0 
)
inline

Definition at line 110 of file volumebase_d_inline.h.

◆ operator()() [6/8]

template<typename T >
const T & carto::Volume< T >::operator() ( long  x,
long  y = 0,
long  z = 0,
long  t = 0 
) const
inline

Warning: this operator is not virtual, so may not have the expected result on inherited classes (see old VolumeView)

Definition at line 68 of file volumebase_d_inline.h.

◆ operator()() [7/8]

template<typename T >
T & carto::Volume< T >::operator() ( long  x1,
long  x2,
long  x3,
long  x4,
long  x5,
long  x6 = 0,
long  x7 = 0,
long  x8 = 0 
)
inline

Definition at line 597 of file volumebase_d_inline.h.

◆ operator()() [8/8]

template<typename T >
const T & carto::Volume< T >::operator() ( long  x1,
long  x2,
long  x3,
long  x4,
long  x5,
long  x6 = 0,
long  x7 = 0,
long  x8 = 0 
) const
inline

Definition at line 579 of file volumebase_d_inline.h.

◆ operator=() [1/2]

template<typename T >
Volume< T > & carto::Volume< T >::operator= ( const T &  value)
inline

Copy operator.

Care should be taken regarding the behavior of the copy operator: depending on the allocation mode of the copied volume, and whether it is a view into another volume, different behaviors will be achieved:

  • if "value" is a "regular" volume, then a full copy is performed: if "this" is modified later, "value" will not be changed.
  • if "value" is a view into a larger volume (its volumeRef() is not null, and its own data buffer is not actually allocated), then the copied object, "this", will be another view into the same volume, thus resulting in a shallow copy. If "this" is modified later, both "value " and the reference volume from which the view is taken, will be modified.

Definition at line 198 of file volumebase_d_operators.h.

◆ operator=() [2/2]

◆ posInRefVolume()

template<typename T >
const Volume< T >::Position & carto::Volume< T >::posInRefVolume
inline

◆ posInRefVolumeAtLevel()

template<typename T >
Volume< T >::Position carto::Volume< T >::posInRefVolumeAtLevel ( const int  level) const
inline

Get position relatively to parent volume at specified level.

Definition at line 585 of file volumebase_d.h.

References carto::const_ref< class >::isNull().

◆ reallocate() [1/3]

template<typename T >
void carto::Volume< T >::reallocate ( const Position4Di size,
bool  keepcontents = false,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocate = true,
const std::vector< size_t > *  strides = 0 
)
virtual

Definition at line 1192 of file volumebase_d.h.

◆ reallocate() [2/3]

template<typename T >
void carto::Volume< T >::reallocate ( const std::vector< int > &  size,
bool  keepcontents = false,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocate = true,
const std::vector< size_t > *  strides = 0 
)
virtual

◆ reallocate() [3/3]

template<typename T >
void carto::Volume< T >::reallocate ( int  sizeX = 1,
int  sizeY = 1,
int  sizeZ = 1,
int  sizeT = 1,
bool  keepcontents = false,
const AllocatorContext &  allocatorContext = AllocatorContext(),
bool  allocate = true,
const std::vector< size_t > *  strides = 0 
)
virtual

allows resizing and changing allocator

Definition at line 1165 of file volumebase_d.h.

Referenced by carto::setBorders(), carto::setMinBorders(), and carto::Creator< Volume< T > >::setup().

◆ refLevel()

template<typename T >
int carto::Volume< T >::refLevel ( const int  level) const
inline

Transform a level index to a valid level index in the volume hierarchy.

The current volume has level 0, parent volume as level 1, ... Level can also be a negative index from topmost volume. -1 is topmost volume, -2 is the the child volume below topmost volume.

Definition at line 552 of file volumebase_d.h.

References carto::toString().

◆ refVolume()

template<typename T >
rc_ptr< Volume< T > > carto::Volume< T >::refVolume
inline

Get parent volume.

Note
refVolume() returns a rc_ptr<Volume> and not a VolumeRef. Because arithmetic operators are only defined for Volume and VolumeRef objects, this result must be converted to a VolumeRef to be used in arithmetic operations.

Definition at line 527 of file volumebase_d.h.

Referenced by carto::copyStructure(), carto::deepcopy(), soma::VolumeFormatReader< T >::read(), and soma::VolumeFormatWriter< T >::write().

◆ refVolumeAtLevel()

template<typename T >
rc_ptr< Volume< T > > carto::Volume< T >::refVolumeAtLevel ( const int  level) const
inline

Get parent volume at a specified level in volume hierarchy.

Note
refVolumeAtLevel() returns a rc_ptr<Volume> and not a VolumeRef. Because arithmetic operators are only defined for Volume and VolumeRef objects, this result must be converted to a VolumeRef to be used in arithmetic operations.

Definition at line 570 of file volumebase_d.h.

References carto::const_ref< class >::isNull().

◆ setPosInRefVolume() [1/2]

template<typename T >
void carto::Volume< T >::setPosInRefVolume ( const Position pos)
inline

Definition at line 688 of file volumebase_d.h.

◆ setPosInRefVolume() [2/2]

template<typename T >
void carto::Volume< T >::setPosInRefVolume ( const Position4Di pos)
inline

Set position in parent volume.

Definition at line 677 of file volumebase_d.h.

References carto::Volume< T >::Position4Di::toVector().

Referenced by carto::copyStructure(), carto::deepcopy(), carto::setBorders(), and carto::setMinBorders().

◆ setRefVolume()

template<typename T >
void carto::Volume< T >::setRefVolume ( const rc_ptr< Volume< T > > &  refvol)
inline

Set parent volume.

Definition at line 699 of file volumebase_d.h.

Referenced by carto::copyStructure(), carto::deepcopy(), carto::setBorders(), and carto::setMinBorders().

◆ slotSizeChanged()

template<typename T >
void carto::Volume< T >::slotSizeChanged ( const PropertyFilter propertyFilter)
protected

◆ sum()

template<typename T >
DataTypeTraits< T >::LongType carto::Volume< T >::sum
inline

To avoid overflow, the biggest possible type (intmax_t, uintmax_t, double...) is used for computation and returned.

Definition at line 178 of file volumebase_d_operators.h.

References carto::volumebaseinternal::select_is_scalar< T, is_scalar >::sum().

◆ updateItemsBuffer()

template<typename T >
void carto::Volume< T >::updateItemsBuffer
inlineprotected

Definition at line 606 of file volumebase_d.h.

Member Data Documentation

◆ _blitz

template<typename T >
blitz::Array<T, Volume<T>::DIM_MAX> carto::Volume< T >::_blitz
protected

Definition at line 533 of file volumebase.h.

Referenced by carto::Volume< T >::operator=(), and carto::Volume< T >::Volume().

◆ _items

template<typename T >
AllocatedVector<T> carto::Volume< T >::_items
protected

Definition at line 532 of file volumebase.h.

Referenced by carto::Volume< T >::operator=(), and carto::Volume< T >::Volume().

◆ _pos

template<typename T >
std::vector<int> carto::Volume< T >::_pos
protected

Definition at line 535 of file volumebase.h.

Referenced by carto::Volume< T >::operator=(), and carto::Volume< T >::Volume().

◆ _refvol

template<typename T >
rc_ptr<Volume<T> > carto::Volume< T >::_refvol
protected

Definition at line 534 of file volumebase.h.

Referenced by carto::Volume< T >::operator=(), and carto::Volume< T >::Volume().


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