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

#include <HDF5DataSet.h>

Inheritance diagram for casacore::HDF5DataSet:

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 IPosition &	shape () const
	Get the shape. More...

const IPosition &	tileShape () 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 String &	getName () 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...

HDF5DataSet &	operator= (const HDF5DataSet &that)
	Assignment cannot be used. More...

Private Attributes
HDF5HidDataSpace	itsDSid

HDF5HidProperty	itsPLid

HDF5HidProperty	itsDaplid

IPosition	itsShape

IPosition	itsTileShape

HDF5DataType	itsDataType

const HDF5Object *	itsParent

Detailed Description

A class representing an HDF5 data set.

Intended use:

Public interface

Review Status

Test programs:: tHDF5DataSet

Prerequisite

HDF5 system

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:

casa/casacore/casa/HDF5/HDF5DataSet.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Intended use:

Review Status

Prerequisite

Synopsis

Motivation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation