casacore
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | Static Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | List of all members
casacore::HDF5DataSet Class Reference

A class representing an HDF5 data set. More...

#include <HDF5DataSet.h>

Inheritance diagram for casacore::HDF5DataSet:
casacore::HDF5Object

Public Member Functions

 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const Bool *)
 Create an HDF5 data set in the given hid (file or group). More...
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const uChar *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const Short *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const Int *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const Int64 *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const Float *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const Double *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const Complex *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const DComplex *)
 
 HDF5DataSet (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape, const HDF5DataType &)
 
 HDF5DataSet (const HDF5Object &, const String &, const Bool *)
 Open an existing HDF5 data set in the given hid (file or group). More...
 
 HDF5DataSet (const HDF5Object &, const String &, const uChar *)
 
 HDF5DataSet (const HDF5Object &, const String &, const Short *)
 
 HDF5DataSet (const HDF5Object &, const String &, const Int *)
 
 HDF5DataSet (const HDF5Object &, const String &, const Int64 *)
 
 HDF5DataSet (const HDF5Object &, const String &, const Float *)
 
 HDF5DataSet (const HDF5Object &, const String &, const Double *)
 
 HDF5DataSet (const HDF5Object &, const String &, const Complex *)
 
 HDF5DataSet (const HDF5Object &, const String &, const DComplex *)
 
 HDF5DataSet (const HDF5Object &, const String &, const HDF5DataType &)
 
virtual ~HDF5DataSet ()
 The destructor closes the HDF5 dataset object. More...
 
virtual void close ()
 Close the hid if valid. More...
 
void setCacheSize (uInt nchunks)
 Set the cache size (in chunks) for the data set. More...
 
const IPositionshape () const
 Get the shape. More...
 
const IPositiontileShape () const
 Get the tile (chunk) shape. More...
 
void get (const Slicer &, ArrayBase &buf, Bool resize=False)
 Get a section of data into the array. More...
 
void get (const Slicer &, void *buf)
 Get a section of data. More...
 
void put (const Slicer &, const ArrayBase &buf)
 Put a section of data. More...
 
void put (const Slicer &, const void *buf)
 Put a section of data. More...
 
void extend (const IPosition &shape)
 Extend the dataset if an axis in the new shape is larger. More...
 
- Public Member Functions inherited from casacore::HDF5Object
 HDF5Object ()
 Default constructor sets to invalid hid. More...
 
virtual ~HDF5Object ()
 The destructor in a derived class should close the hid appropriately. More...
 
bool isValid () const
 Is it a valid hid? More...
 
hid_t getHid () const
 Get the hid. More...
 
 operator hid_t () const
 Convert automatically to hid_t. More...
 
void setName (const String &name)
 Get or set the name. More...
 
const StringgetName () const
 

Static Public Member Functions

static DataType getDataType (hid_t, const String &name)
 Get the data type for the data set with the given name. More...
 
- Static Public Member Functions inherited from casacore::HDF5Object
static Bool hasHDF5Support ()
 Check if there is HDF5 support compiled in. More...
 
static void throwNoHDF5 ()
 If no HDF5, throw an exception that HDF5 is not supported. More...
 

Protected Member Functions

void create (const HDF5Object &, const String &, const IPosition &shape, const IPosition &tileShape)
 Create the data set. More...
 
void open (const HDF5Object &, const String &)
 Open the data set and check if the external data type matches. More...
 
void closeDataSet ()
 Close the dataset (but not other hids). More...
 
- Protected Member Functions inherited from casacore::HDF5Object
void setHid (hid_t hid)
 Set the hid. More...
 
void clearHid ()
 Clear the hid (set to invalid). More...
 

Private Member Functions

 HDF5DataSet (const HDF5DataSet &that)
 Copy constructor cannot be used. More...
 
HDF5DataSetoperator= (const HDF5DataSet &that)
 Assignment cannot be used. More...
 

Private Attributes

HDF5HidDataSpace itsDSid
 
HDF5HidProperty itsPLid
 
HDF5HidProperty itsDaplid
 
IPosition itsShape
 
IPosition itsTileShape
 
HDF5DataType itsDataType
 
const HDF5ObjectitsParent
 

Detailed Description

A class representing an HDF5 data set.

Intended use:

Public interface

Review Status

Test programs:
tHDF5DataSet

Prerequisite

Synopsis

This class wraps the HDF5 functions to create and open a data set. It is meant to be used in class HDF5Lattice, but can be used in itself as well. A dataset of any HDF5DataType (including compound types) can be created. For a limited number of data types special constructors exist which create the appropriate HDF5DataType themselves.
A data set can be created extendible by defining the appropriate axis with length 0, whereafter the extend function can be used to extend the data set. The data can be stored in a tiled (chunked) way by specifying the tile shape when creating it.
When opening an existing data set, it is checked if the given data type matches the data set's data type. For a compound data type, it only checks if its size matches; it does not check if the fields match.
It is possible to read or write a section of the data set by using an appropriate Slicer object. Note that the Slicer object must be fully filled; it does not infer missing info from the array shape.

Note that Casacore arrays are in Fortran order, while HDF5 uses C order. Therefore array axes are reversed, thus axes in shapes, slicers, etc.

Motivation

It was overkill to use the HDF5 C++ interface. Instead little wrappers have been written. HDF5DataSet can be embedded in a shared pointer making it possible to share an HDF5 data set amongst various HDF5Lattice objects and close (i.e. destruct) the HDF5 data set object when needed.

Definition at line 92 of file HDF5DataSet.h.

Constructor & Destructor Documentation

casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const Bool  
)

Create an HDF5 data set in the given hid (file or group).

It gets the given name, shape (also tile shape), and data type.

casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const uChar  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const Short  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const Int  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const Int64  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const Float  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const Double  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const Complex *   
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const DComplex *   
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape,
const HDF5DataType  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const Bool  
)

Open an existing HDF5 data set in the given hid (file or group).

It checks if the internal type matches the given type.

casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const uChar  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const Short  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const Int  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const Int64  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const Float  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const Double  
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const Complex *   
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const DComplex *   
)
casacore::HDF5DataSet::HDF5DataSet ( const HDF5Object ,
const String ,
const HDF5DataType  
)
virtual casacore::HDF5DataSet::~HDF5DataSet ( )
virtual

The destructor closes the HDF5 dataset object.

casacore::HDF5DataSet::HDF5DataSet ( const HDF5DataSet that)
private

Copy constructor cannot be used.

Member Function Documentation

virtual void casacore::HDF5DataSet::close ( )
virtual

Close the hid if valid.

Implements casacore::HDF5Object.

void casacore::HDF5DataSet::closeDataSet ( )
protected

Close the dataset (but not other hids).

void casacore::HDF5DataSet::create ( const HDF5Object ,
const String ,
const IPosition shape,
const IPosition tileShape 
)
protected

Create the data set.

void casacore::HDF5DataSet::extend ( const IPosition shape)

Extend the dataset if an axis in the new shape is larger.

void casacore::HDF5DataSet::get ( const Slicer ,
ArrayBase buf,
Bool  resize = False 
)

Get a section of data into the array.

The array is resized if its shape does not match the slicer's shape. This is only possible if the array is empty or if resize=True. It is not checked if the data type of array and HDF5DataSet match.

void casacore::HDF5DataSet::get ( const Slicer ,
void *  buf 
)

Get a section of data.

The buffer must be large enough to hold the section.

static DataType casacore::HDF5DataSet::getDataType ( hid_t  ,
const String name 
)
static

Get the data type for the data set with the given name.

void casacore::HDF5DataSet::open ( const HDF5Object ,
const String  
)
protected

Open the data set and check if the external data type matches.

HDF5DataSet& casacore::HDF5DataSet::operator= ( const HDF5DataSet that)
private

Assignment cannot be used.

void casacore::HDF5DataSet::put ( const Slicer ,
const ArrayBase buf 
)

Put a section of data.

The shape of the array and slicer must match. It is not checked if the data type of array and HDF5DataSet match.

void casacore::HDF5DataSet::put ( const Slicer ,
const void *  buf 
)

Put a section of data.

The buffer must be large enough to hold the section.

void casacore::HDF5DataSet::setCacheSize ( uInt  nchunks)

Set the cache size (in chunks) for the data set.

It needs to close and reopen the DataSet to take effect.

const IPosition& casacore::HDF5DataSet::shape ( ) const
inline

Get the shape.

Definition at line 149 of file HDF5DataSet.h.

References itsShape.

const IPosition& casacore::HDF5DataSet::tileShape ( ) const
inline

Get the tile (chunk) shape.

Definition at line 153 of file HDF5DataSet.h.

References itsTileShape.

Member Data Documentation

HDF5HidProperty casacore::HDF5DataSet::itsDaplid
private

Definition at line 197 of file HDF5DataSet.h.

HDF5DataType casacore::HDF5DataSet::itsDataType
private

Definition at line 200 of file HDF5DataSet.h.

HDF5HidDataSpace casacore::HDF5DataSet::itsDSid
private

Definition at line 195 of file HDF5DataSet.h.

const HDF5Object* casacore::HDF5DataSet::itsParent
private

Definition at line 201 of file HDF5DataSet.h.

HDF5HidProperty casacore::HDF5DataSet::itsPLid
private

Definition at line 196 of file HDF5DataSet.h.

IPosition casacore::HDF5DataSet::itsShape
private

Definition at line 198 of file HDF5DataSet.h.

Referenced by shape().

IPosition casacore::HDF5DataSet::itsTileShape
private

Definition at line 199 of file HDF5DataSet.h.

Referenced by tileShape().


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