A proxy for reading and writing values into an HDF5 file. More...

#include <HdfProxy.h>

Inheritance diagram for eml2::HdfProxy:

Public Member Functions
	HdfProxy (gsoap_resqml2_0_1::eml20__DataObjectReference *partialObject)

	HdfProxy (const common::DataObjectReference &dor)
	Constructor. More...

virtual	~HdfProxy ()

void	open () override

bool	isOpened () const final

void	close () final

common::AbstractObject::hdfDatatypeEnum	getHdfDatatypeInDataset (const std::string &groupName) final

int	getHdfDatatypeClassInDataset (const std::string &datasetName) final

void	writeItemizedListOfList (const std::string &groupName, const std::string &name, hdf5_hid_t cumulativeLengthDatatype, const void cumulativeLength, unsigned long long cumulativeLengthSize, hdf5_hid_t elementsDatatype, const void elements, unsigned long long elementsSize) final

unsigned int	getDimensionCount (const std::string &datasetName) final

std::vector< unsigned long long >	getElementCountPerDimension (const std::string &datasetName) final

signed long long	getElementCount (const std::string &datasetName) final

void	setCompressionLevel (unsigned int newCompressionLevel) final

void	writeArrayNdOfFloatValues (const std::string &groupName, const std::string &name, const float floatValues, const unsigned long long numValuesInEachDimension, unsigned int numDimensions) final

void	writeArrayNdOfDoubleValues (const std::string &groupName, const std::string &name, const double dblValues, const unsigned long long numValuesInEachDimension, unsigned int numDimensions) final

void	writeArrayNdOfCharValues (const std::string &groupName, const std::string &name, const char intValues, const unsigned long long numValuesInEachDimension, unsigned int numDimensions) final

void	writeArrayNdOfIntValues (const std::string &groupName, const std::string &name, const int intValues, const unsigned long long numValuesInEachDimension, unsigned int numDimensions) final

void	writeArrayNdOfInt64Values (const std::string &groupName, const std::string &name, const int64_t values, const unsigned long long numValuesInEachDimension, unsigned int numDimensions) final

void	writeArrayNdOfUInt64Values (const std::string &groupName, const std::string &name, const uint64_t values, const unsigned long long numValuesInEachDimension, unsigned int numDimensions) final

void	writeArrayNd (const std::string &groupName, const std::string &name, hdf5_hid_t datatype, const void values, const unsigned long long numValuesInEachDimension, unsigned int numDimensions) final

void	createArrayNd (const std::string &groupName, const std::string &name, hdf5_hid_t datatype, const unsigned long long *numValuesInEachDimension, unsigned int numDimensions) final

void	writeArrayNdSlab (const std::string &groupName, const std::string &name, hdf5_hid_t datatype, const void values, const unsigned long long numValuesInEachDimension, const unsigned long long *offsetValuesInEachDimension, unsigned int numDimensions) final

void	writeGroupAttributes (const std::string &groupName, const std::vector< std::string > &attributeNames, const std::vector< std::string > &values) final

void	writeGroupAttribute (const std::string &groupName, const std::string &attributeName, const std::vector< std::string > &values) final

void	writeGroupAttributes (const std::string &groupName, const std::vector< std::string > &attributeNames, const std::vector< double > &values) final

void	writeGroupAttributes (const std::string &groupName, const std::vector< std::string > &attributeNames, const std::vector< int > &values) final

void	writeDatasetAttributes (const std::string &datasetName, const std::vector< std::string > &attributeNames, const std::vector< std::string > &values) final

void	writeDatasetAttribute (const std::string &datasetName, const std::string &attributeName, const std::vector< std::string > &values) final

void	writeDatasetAttributes (const std::string &datasetName, const std::vector< std::string > &attributeNames, const std::vector< double > &values) final

void	writeDatasetAttributes (const std::string &datasetName, const std::vector< std::string > &attributeNames, const std::vector< int > &values) final

std::string	readStringAttribute (const std::string &obj_name, const std::string &attr_name) const final

std::vector< std::string >	readStringArrayAttribute (const std::string &obj_name, const std::string &attr_name) const final

double	readDoubleAttribute (const std::string &obj_name, const std::string &attr_name) const final

int64_t	readLongAttribute (const std::string &obj_name, const std::string &attr_name) const final

void	readArrayNdOfDoubleValues (const std::string &datasetName, double *values) final

void	readArrayNdOfDoubleValues (const std::string &datasetName, double values, unsigned long long const numValuesInEachDimension, unsigned long long const *offsetInEachDimension, unsigned int numDimensions) final

void	readArrayNdOfDoubleValues (const std::string &datasetName, double values, unsigned long long const blockCountPerDimension, unsigned long long const offsetInEachDimension, unsigned long long const strideInEachDimension, unsigned long long const *blockSizeInEachDimension, unsigned int numDimensions) final

void	selectArrayNdOfValues (const std::string &datasetName, unsigned long long const blockCountPerDimension, unsigned long long const offsetInEachDimension, unsigned long long const strideInEachDimension, unsigned long long const blockSizeInEachDimension, unsigned int numDimensions, bool newSelection, hdf5_hid_t &dataset, hdf5_hid_t &filespace) final

void	readArrayNdOfDoubleValues (hdf5_hid_t dataset, hdf5_hid_t filespace, void *values, unsigned long long slabSize) final

void	readArrayNdOfFloatValues (const std::string &datasetName, float *values) final

void	readArrayNdOfFloatValues (const std::string &datasetName, float values, unsigned long long const numValuesInEachDimension, unsigned long long const *offsetInEachDimension, unsigned int numDimensions) final

void	readArrayNdOfInt64Values (const std::string &datasetName, int64_t *values) final

void	readArrayNdOfInt64Values (const std::string &datasetName, int64_t values, unsigned long long const numValuesInEachDimension, unsigned long long const *offsetInEachDimension, unsigned int numDimensions) final

void	readArrayNdOfUInt64Values (const std::string &datasetName, uint64_t *values) final

void	readArrayNdOfIntValues (const std::string &datasetName, int *values) final

void	readArrayNdOfIntValues (const std::string &datasetName, int values, unsigned long long const numValuesInEachDimension, unsigned long long const *offsetInEachDimension, unsigned int numDimensions) final

void	readArrayNdOfUIntValues (const std::string &datasetName, unsigned int *values) final

void	readArrayNdOfShortValues (const std::string &datasetName, short *values) final

void	readArrayNdOfUShortValues (const std::string &datasetName, unsigned short *values) final

void	readArrayNdOfCharValues (const std::string &datasetName, char *values) final

void	readArrayNdOfUCharValues (const std::string &datasetName, unsigned char *values) final

std::vector< unsigned long long >	readArrayDimensions (const std::string &datasetName) final

bool	exist (const std::string &absolutePathInHdfFile) const final

bool	isCompressed (const std::string &datasetName) final

Public Member Functions inherited from eml2::AbstractHdfProxy
virtual	~AbstractHdfProxy ()=default

void	setRootPath (const std::string &rootPath)

void	setRelativePath (const std::string &relPath)

void	setOpeningMode (common::DataObjectRepository::openingMode openingMode_)

const std::string &	getRelativePath () const

void	initGsoapProxy (common::DataObjectRepository *repo, const std::string &guid, const std::string &title, unsigned int emlVersion)

Public Member Functions inherited from eml2::EpcExternalPartReference
virtual	~EpcExternalPartReference ()=default

virtual std::string	getXmlTag () const final

Public Member Functions inherited from common::AbstractObject
bool	isPartial () const

virtual bool	isTopLevelElement () const

std::string	getUuid () const

std::string	getTitle () const

std::string	getEditor () const

time_t	getCreation () const

tm	getCreationAsTimeStructure () const

std::string	getOriginator () const

std::string	getDescription () const

time_t	getLastUpdate () const

tm	getLastUpdateAsTimeStructure () const

std::string	getFormat () const

std::string	getDescriptiveKeywords () const

std::string	getVersion () const

void	setTitle (const std::string &title)

void	setEditor (const std::string &editor)

void	setCreation (time_t creation)

void	setCreation (const tm &creation)

void	setOriginator (const std::string &originator)

void	setDescription (const std::string &description)

void	setLastUpdate (time_t lastUpdate)

void	setLastUpdate (const tm &lastUpdate)

void	setDescriptiveKeywords (const std::string &descriptiveKeywords)

void	setVersion (const std::string &version)

void	setMetadata (const std::string &title, const std::string &editor, time_t creation, const std::string &originator, const std::string &description, time_t lastUpdate, const std::string &descriptiveKeywords)

void	serializeIntoStream (std::ostream *stream)

void	setGsoapProxy (gsoap_resqml2_0_1::eml20__AbstractCitedDataObject *gsoapProxy)

void	setGsoapProxy (gsoap_eml2_1::eml21__AbstractObject *gsoapProxy)

gsoap_resqml2_0_1::eml20__AbstractCitedDataObject *	getEml20GsoapProxy () const

gsoap_eml2_1::eml21__AbstractObject *	getEml21GsoapProxy () const

gsoap_eml2_2::eml22__AbstractObject *	getEml22GsoapProxy () const

void	setGsoapProxy (gsoap_eml2_2::eml22__AbstractObject *gsoapProxy)

gsoap_eml2_3::eml23__AbstractObject *	getEml23GsoapProxy () const

void	setGsoapProxy (gsoap_eml2_3::eml23__AbstractObject *gsoapProxy)

soap *	getGsoapContext () const

int	getGsoapType () const

gsoap_resqml2_0_1::eml20__DataObjectReference *	newResqmlReference () const

gsoap_eml2_1::eml21__DataObjectReference *	newEmlReference () const

gsoap_eml2_2::eml22__DataObjectReference *	newEml22Reference () const

gsoap_eml2_3::eml23__DataObjectReference *	newEml23Reference () const

gsoap_resqml2_0_1::resqml20__ContactElementReference *	newContactElementReference2_0_1 () const

gsoap_eml2_3::resqml22__ContactElement *	newContactElementReference2_2 () const

common::DataObjectRepository *	getRepository () const

virtual std::string	getXmlNamespace () const =0

virtual std::string	getXmlNamespaceVersion () const

virtual std::string	getContentType () const

virtual std::string	getQualifiedType () const

virtual std::string	getPartNameInEpcDocument () const

std::string	serializeIntoString ()

void	addAlias (const std::string &authority, const std::string &title)

unsigned int	getAliasCount () const

std::string	getAliasAuthorityAtIndex (unsigned int index) const

std::string	getAliasTitleAtIndex (unsigned int index) const

std::vector< eml2::Activity * >	getActivitySet () const

unsigned int	getActivityCount () const

eml2::Activity *	getActivity (unsigned int index) const

void	pushBackExtraMetadata (const std::string &key, const std::string &value)

std::unordered_map< std::string, std::string >	getExtraMetadataSet () const

std::vector< std::string >	getExtraMetadata (const std::string &key) const

unsigned int	getExtraMetadataCount () const

std::string	getExtraMetadataKeyAtIndex (unsigned int index) const

std::string	getExtraMetadataStringValueAtIndex (unsigned int index) const

Additional Inherited Members
Public Types inherited from common::AbstractObject
enum	hdfDatatypeEnum { UNKNOWN = 0 , DOUBLE = 1 , FLOAT = 2 , LONG_64 = 3 , ULONG_64 = 4 , INT = 5 , UINT = 6 , SHORT = 7 , USHORT = 8 , CHAR = 9 , UCHAR = 10 }

Static Public Member Functions inherited from common::AbstractObject
static void	setFormat (const std::string &vendor, const std::string &applicationName, const std::string &applicationVersionNumber)

Static Public Attributes inherited from eml2::EpcExternalPartReference
static const char *	XML_TAG

Detailed Description

A proxy for reading and writing values into an HDF5 file.

Constructor & Destructor Documentation

◆ HdfProxy() [1/2]

eml2::HdfProxy::HdfProxy ( gsoap_resqml2_0_1::eml20__DataObjectReference * partialObject )

inline

Constructor. Only to be used in partial transfer context

Parameters

[in] partialObject If non-null, the partial object.

◆ HdfProxy() [2/2]

eml2::HdfProxy::HdfProxy ( const common::DataObjectReference & dor )

inline

Constructor.

Parameters

dor The dor.

◆ ~HdfProxy()

virtual eml2::HdfProxy::~HdfProxy ( )

inlinevirtual

Destructor. Closes the hdf file.

Reimplemented in eml2_3::HdfProxy, and eml2_0::HdfProxy.

Member Function Documentation

◆ close()

void eml2::HdfProxy::close ( )

finalvirtual

Closes the HDF5 file

Implements eml2::AbstractHdfProxy.

◆ createArrayNd()

void eml2::HdfProxy::createArrayNd	(	const std::string &	groupName,
		const std::string &	name,
		hdf5_hid_t	datatype,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Creates an nd array of a specific datatype into the HDF5 file by means of a single dataset. Values are not yet written to this array

Parameters

groupName	The name of the group where to create the nd array of specific datatype values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not exist.
datatype	The specific datatype of the nd array values.
numValuesInEachDimension	Number of values in each dimension of the nd array. They are ordered from fastest index to slowest index.
numDimensions	The number of the dimensions (n) of the nd array to create.

Implements eml2::AbstractHdfProxy.

◆ exist()

bool eml2::HdfProxy::exist ( const std::string & absolutePathInHdfFile ) const

finalvirtual

Checks whether an absolute path exists in the HDF5 file

Parameters

absolutePathInHdfFile An absolute path in the HDF5 file.

Returns: True if the absolute path exists, else false.

Implements eml2::AbstractHdfProxy.

◆ getDimensionCount()

unsigned int eml2::HdfProxy::getDimensionCount ( const std::string & datasetName )

finalvirtual

Gets the number of dimensions in an HDF5 dataset of the proxy.

Parameters

datasetName The absolute name (not relative to a group) of the dataset we want to get the number of dimensions.

Returns: The number of dimensions of the dataset if successful, otherwise returns a negative value.

Implements eml2::AbstractHdfProxy.

◆ getElementCount()

signed long long eml2::HdfProxy::getElementCount ( const std::string & datasetName )

finalvirtual

Gets the number of elements in an HDF5 dataset of the proxy. The number of elements is got from all dimensions.

Parameters

datasetName The absolute name (not relative to a group) of the dataset we want to get the number of elements.

Returns: The number of elements of the dataset if successful, otherwise returns a negative value.

Implements eml2::AbstractHdfProxy.

◆ getElementCountPerDimension()

std::vector<unsigned long long> eml2::HdfProxy::getElementCountPerDimension ( const std::string & datasetName )

finalvirtual

Get the number of elements in each dimension in an HDF dataset of the proxy.

Parameters

datasetName The absolute name of the dataset we want to get the number of elements.

Implements eml2::AbstractHdfProxy.

◆ getHdfDatatypeClassInDataset()

int eml2::HdfProxy::getHdfDatatypeClassInDataset ( const std::string & datasetName )

finalvirtual

Gets the datatype class (H5T_INTEGER, H5T_FLOAT, H5T_STRING, etc.) of a dataset

Parameters

datasetName Name of the dataset.

Returns: The HDF5 datatype class identifier if successful, otherwise H5T_NO_CLASS (-1).

Implements eml2::AbstractHdfProxy.

◆ getHdfDatatypeInDataset()

common::AbstractObject::hdfDatatypeEnum eml2::HdfProxy::getHdfDatatypeInDataset ( const std::string & datasetName )

finalvirtual

Gets the native datatype of a dataset

Parameters

datasetName Name of the dataset.

Returns: The native HDF5 datatype identifier of the dataset if successful, otherwise returns a negative value.

Implements eml2::AbstractHdfProxy.

◆ isCompressed()

bool eml2::HdfProxy::isCompressed ( const std::string & datasetName )

finalvirtual

Checks whether a dataset is compressed or not

Exceptions

invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

datasetName Name of the dataset.

Returns: True if compressed, false if not.

Implements eml2::AbstractHdfProxy.

◆ isOpened()

bool eml2::HdfProxy::isOpened ( ) const

inlinefinalvirtual

Checks if the HDF5 file is open or not

Returns: True if opened, false if not.

Implements eml2::AbstractHdfProxy.

◆ open()

void eml2::HdfProxy::open ( )

overridevirtual

Opens the HDF5 file for reading and writing. The read and write rights are determined by the EPC document configuration

Implements eml2::AbstractHdfProxy.

Reimplemented in eml2_0::HdfProxyROS3.

◆ readArrayDimensions()

std::vector<unsigned long long> eml2::HdfProxy::readArrayDimensions ( const std::string & datasetName )

finalvirtual

Reads the dimensions size of an nd array stored in a specific dataset

Parameters

datasetName The absolute name of the nd array dataset.

Returns: A vector of dimensions size.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfCharValues()

void eml2::HdfProxy::readArrayNdOfCharValues	(	const std::string &	datasetName,
		char *	values
	)

finalvirtual

Reads an nd array of char values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of char values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfDoubleValues() [1/4]

void eml2::HdfProxy::readArrayNdOfDoubleValues	(	const std::string &	datasetName,
		double *	values
	)

finalvirtual

Reads an nd array of double values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of double values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfDoubleValues() [2/4]

void eml2::HdfProxy::readArrayNdOfDoubleValues	(	const std::string &	datasetName,
		double *	values,
		unsigned long long const *	blockCountPerDimension,
		unsigned long long const *	offsetInEachDimension,
		unsigned long long const *	strideInEachDimension,
		unsigned long long const *	blockSizeInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Finds the nd array of double values associated with datasetName and reads from it

Exceptions

invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

	datasetName	The name of the nd array dataset.
[out]	values	1d array of double values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.
	blockCountPerDimension	Number of blocks to select from the dataspace, in each dimension. They are ordered from fastest index to slowest index.
	offsetInEachDimension	Offset values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	strideInEachDimension	Number of elements to move from one block to another in each dimension. They are ordered from fastest index to slowest index.
	blockSizeInEachDimension	Size of selected blocks in each dimension. They are ordered from fastest index to slowest index.
	numDimensions	The number of the dimensions (n) of the nd array to read.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfDoubleValues() [3/4]

void eml2::HdfProxy::readArrayNdOfDoubleValues	(	const std::string &	datasetName,
		double *	values,
		unsigned long long const *	numValuesInEachDimension,
		unsigned long long const *	offsetInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Finds the nd array of double values associated with datasetName and reads from it

Exceptions

std::invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

	datasetName	The name of the nd array dataset.
[out]	values	1d array of double values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.
	numValuesInEachDimension	Number of values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	offsetInEachDimension	Offset values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	numDimensions	The number of the dimensions (n) of the nd array to read.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfDoubleValues() [4/4]

void eml2::HdfProxy::readArrayNdOfDoubleValues	(	hdf5_hid_t	dataset,
		hdf5_hid_t	filespace,
		void *	values,
		unsigned long long	slabSize
	)

finalvirtual

Considering a given nd array dataset, reads the double values corresponding to an existing selected region.

Exceptions

invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

	dataset	ID of the dataset to read from.
	filespace	ID of the selected region.
[out]	values	1d array of double values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.
	slabSize	Number of values to read.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfFloatValues() [1/2]

void eml2::HdfProxy::readArrayNdOfFloatValues	(	const std::string &	datasetName,
		float *	values
	)

finalvirtual

Reads an nd array of float values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of float values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfFloatValues() [2/2]

void eml2::HdfProxy::readArrayNdOfFloatValues	(	const std::string &	datasetName,
		float *	values,
		unsigned long long const *	numValuesInEachDimension,
		unsigned long long const *	offsetInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Finds the nd array of float values associated with datasetName and reads from it

Exceptions

invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

	datasetName	The name of the nd array dataset.
[out]	values	1d array of float values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.
	numValuesInEachDimension	Number of values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	offsetInEachDimension	Offset values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	numDimensions	The number of the dimensions (n) of the nd array to read.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfInt64Values() [1/2]

void eml2::HdfProxy::readArrayNdOfInt64Values	(	const std::string &	datasetName,
		int64_t *	values
	)

finalvirtual

Reads an nd array of long values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of long values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfInt64Values() [2/2]

void eml2::HdfProxy::readArrayNdOfInt64Values	(	const std::string &	datasetName,
		int64_t *	values,
		unsigned long long const *	numValuesInEachDimension,
		unsigned long long const *	offsetInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Finds the nd array of long values associated with datasetName and reads from it

Exceptions

invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

	datasetName	The name of the nd array dataset.
[out]	values	1d array of long values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.
	numValuesInEachDimension	Number of values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	offsetInEachDimension	Offset values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	numDimensions	The number of the dimensions (n) of the nd array to read.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfIntValues() [1/2]

void eml2::HdfProxy::readArrayNdOfIntValues	(	const std::string &	datasetName,
		int *	values
	)

finalvirtual

Reads an nd array of int values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of int values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfIntValues() [2/2]

void eml2::HdfProxy::readArrayNdOfIntValues	(	const std::string &	datasetName,
		int *	values,
		unsigned long long const *	numValuesInEachDimension,
		unsigned long long const *	offsetInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Finds the nd array of int values associated with datasetName and reads from it

Exceptions

std::invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

	datasetName	The name of the nd array dataset.
[out]	values	1d array of int values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.
	numValuesInEachDimension	Number of values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	offsetInEachDimension	Offset values in each dimension of the nd array to read. They are ordered from fastest index to slowest index.
	numDimensions	The number of the dimensions (n) of the nd array to read.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfShortValues()

void eml2::HdfProxy::readArrayNdOfShortValues	(	const std::string &	datasetName,
		short *	values
	)

finalvirtual

Reads an nd array of short values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of short values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfUCharValues()

void eml2::HdfProxy::readArrayNdOfUCharValues	(	const std::string &	datasetName,
		unsigned char *	values
	)

finalvirtual

Reads an nd array of unsigned char values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of unsigned char values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfUInt64Values()

void eml2::HdfProxy::readArrayNdOfUInt64Values	(	const std::string &	datasetName,
		uint64_t *	values
	)

finalvirtual

Reads an nd array of unsigned long values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of unsigned long values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfUIntValues()

void eml2::HdfProxy::readArrayNdOfUIntValues	(	const std::string &	datasetName,
		unsigned int *	values
	)

finalvirtual

Reads an nd array of unsigned int values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of unsigned int values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readArrayNdOfUShortValues()

void eml2::HdfProxy::readArrayNdOfUShortValues	(	const std::string &	datasetName,
		unsigned short *	values
	)

finalvirtual

Reads an nd array of unsigned short values stored in a specific dataset

Exceptions

std::invalid_argument If the nd array dataset cannot be opened or read.

Parameters

	datasetName	The absolute name of the nd array dataset.
[out]	values	1d array of unsigned short values ordered firstly by fastest direction. The values must be pre-allocated and won't be freed by this method.

Implements eml2::AbstractHdfProxy.

◆ readDoubleAttribute()

double eml2::HdfProxy::readDoubleAttribute	(	const std::string &	obj_name,
		const std::string &	attr_name
	)		const

finalvirtual

Reads a double which is stored as an HDF5 attribute in a file, group or dataset

Exceptions

std::invalid_argument If the HDF5 file is not opened or if the attribute cannot be read.

Parameters

obj_name	use "." if the attribute to read is on the file otherwise the full path of the group or dataset.
attr_name	Name of the attribute.

Returns: The attribute value.

Implements eml2::AbstractHdfProxy.

◆ readLongAttribute()

int64_t eml2::HdfProxy::readLongAttribute	(	const std::string &	obj_name,
		const std::string &	attr_name
	)		const

finalvirtual

Reads a long which is stored as an HDF5 attribute in a file, group or dataset

Exceptions

std::invalid_argument If the HDF5 file is not opened or if the attribute cannot be read.

Parameters

obj_name	use '.' if the attribute to read is on the file otherwise the full path of the group or dataset.
attr_name	Name of the attribute.

Returns: The attribute value.

Implements eml2::AbstractHdfProxy.

◆ readStringArrayAttribute()

std::vector<std::string> eml2::HdfProxy::readStringArrayAttribute	(	const std::string &	obj_name,
		const std::string &	attr_name
	)		const

finalvirtual

Reads string values which are stored as an HDF5 attribute in a file, group or dataset

Exceptions

std::invalid_argument If the HDF5 file is not opened or if the attribute cannot be read.

Parameters

obj_name	Use "." if the attribute to read is on the HDF5 file otherwise the full path of the group or dataset.
attr_name	Name of the attribute.

Returns: The vector of attribute values.

Implements eml2::AbstractHdfProxy.

◆ readStringAttribute()

std::string eml2::HdfProxy::readStringAttribute	(	const std::string &	obj_name,
		const std::string &	attr_name
	)		const

finalvirtual

Reads a string which is stored as an HDF5 attribute in a file, group or dataset

Exceptions

std::invalid_argument If the HDF5 file is not opened or if the attribute cannot be read.

Parameters

obj_name	Use "." if the attribute to read is on the HDF5 file otherwise the full path of the group or dataset.
attr_name	Name of the attribute.

Returns: The attribute value.

Implements eml2::AbstractHdfProxy.

◆ selectArrayNdOfValues()

void eml2::HdfProxy::selectArrayNdOfValues	(	const std::string &	datasetName,
		unsigned long long const *	blockCountPerDimension,
		unsigned long long const *	offsetInEachDimension,
		unsigned long long const *	strideInEachDimension,
		unsigned long long const *	blockSizeInEachDimension,
		unsigned int	numDimensions,
		bool	newSelection,
		hdf5_hid_t &	dataset,
		hdf5_hid_t &	filespace
	)

finalvirtual

Considering a given nd array dataset, this method selects an hyperslab region to add to an existing selected region or to add to a new selected region. The dataset is not closed within this method.

Exceptions

invalid_argument Thrown when an invalid argument error condition occurs.

Parameters

	datasetName	The name of the nd array dataset.
	blockCountPerDimension	Number of blocks to select from the dataspace, in each dimension. They are ordered from fastest index to slowest index.
	offsetInEachDimension	Offset values in each dimension of the array to read. They are ordered from fastest index to slowest index.
	strideInEachDimension	Number of elements to move from one block to another in each dimension. They are ordered from fastest index to slowest index.
	blockSizeInEachDimension	Size of selected blocks in each dimension. They are ordered from fastest index to slowest index.
	numDimensions	The number of the dimensions (n) of the nd array to read.
	newSelection	true if creating a new selected region else false.
[in,out]	dataset	Input dataset ID if adding a new hyperslab region to an existing selected region, output dataset ID if creating a new selected region.
[in,out]	filespace	Input selected region ID if adding a new hyperslab region to an existing selected region, output selected region ID if creating a new selected region.

Implements eml2::AbstractHdfProxy.

◆ setCompressionLevel()

void eml2::HdfProxy::setCompressionLevel ( unsigned int newCompressionLevel )

inlinefinalvirtual

Sets the new compression level which will be used for all data to be written

Parameters

newCompressionLevel The new compression level in range [0..9]. Lower compression levels are faster but result in less compression.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNd()

void eml2::HdfProxy::writeArrayNd	(	const std::string &	groupName,
		const std::string &	name,
		hdf5_hid_t	datatype,
		const void *	values,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Writes an nd array of a specific datatype into the HDF5 file by means of a single dataset

Parameters

groupName	The name of the group where to create the nd array of specific datatype values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not already exist.
datatype	The specific datatype of the values to write.
values	1d array of specific datatype values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of the dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNdOfCharValues()

void eml2::HdfProxy::writeArrayNdOfCharValues	(	const std::string &	groupName,
		const std::string &	name,
		const char *	intValues,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Writes an nd array of char values into the HDF5 file by means of a single dataset

Parameters

groupName	The name of the group where to create the nd array of int values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not already exist.
intValues	1d array of char values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of the dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNdOfDoubleValues()

void eml2::HdfProxy::writeArrayNdOfDoubleValues	(	const std::string &	groupName,
		const std::string &	name,
		const double *	dblValues,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Writes an nd array of double values into the HDF5 file by means of a single dataset

Parameters

groupName	The name of the group where to create the nd array of double values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not already exist.
dblValues	1d array of double values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNdOfFloatValues()

void eml2::HdfProxy::writeArrayNdOfFloatValues	(	const std::string &	groupName,
		const std::string &	name,
		const float *	floatValues,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Writes an nd array of float values into the HDF5 file by means of a single dataset

Parameters

groupName	The name of the group where to create the nd array of float values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not already exist.
floatValues	1d array of float values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNdOfInt64Values()

void eml2::HdfProxy::writeArrayNdOfInt64Values	(	const std::string &	groupName,
		const std::string &	name,
		const int64_t *	values,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Writes an nd array of integer 64 values into the HDF5 file by means of a single dataset

Parameters

groupName	The name of the group where to create the nd array of gSOAP unsigned long 64 values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not already exist.
values	1d array of integer 64 values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of the dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNdOfIntValues()

void eml2::HdfProxy::writeArrayNdOfIntValues	(	const std::string &	groupName,
		const std::string &	name,
		const int *	intValues,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Writes an nd array of int values into the HDF5 file by means of a single dataset

Parameters

groupName	The name of the group where to create the nd array of int values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not already exist.
intValues	1d array of int values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of the dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNdOfUInt64Values()

void eml2::HdfProxy::writeArrayNdOfUInt64Values	(	const std::string &	groupName,
		const std::string &	name,
		const uint64_t *	values,
		const unsigned long long *	numValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Writes an nd array of unsigned integer 64 values into the HDF5 file by means of a single dataset

Parameters

groupName	The name of the group where to create the nd array of gSOAP unsigned long 64 values. This name must not contain '/' character and must be directly contained in RESQML group.
name	The name of the nd array HDF5 dataset. It must not already exist.
values	1d array of unsigned integer 64 values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of the dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeArrayNdSlab()

void eml2::HdfProxy::writeArrayNdSlab	(	const std::string &	groupName,
		const std::string &	name,
		hdf5_hid_t	datatype,
		const void *	values,
		const unsigned long long *	numValuesInEachDimension,
		const unsigned long long *	offsetValuesInEachDimension,
		unsigned int	numDimensions
	)

finalvirtual

Finds the nd array associated with groupName and name and writes into it

Parameters

groupName	The name of the group associated with the nd array.
name	The name of the nd array dataset.
datatype	The datatype of the nd array values.
values	1d array of datatype values ordered firstly by fastest direction.
numValuesInEachDimension	Number of values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
offsetValuesInEachDimension	Offset values in each dimension of the nd array to write. They are ordered from fastest index to slowest index.
numDimensions	The number of the dimensions (n) of the nd array to write.

Implements eml2::AbstractHdfProxy.

◆ writeDatasetAttribute()

void eml2::HdfProxy::writeDatasetAttribute	(	const std::string &	datasetName,
		const std::string &	attributeName,
		const std::vector< std::string > &	values
	)

finalvirtual

Writes a single attribute into a dataset which contain an array of strings values

Parameters

datasetName	Name of the dataset.
attributeName	Name of the attribute.
values	Vector of string values.

Implements eml2::AbstractHdfProxy.

◆ writeDatasetAttributes() [1/3]

void eml2::HdfProxy::writeDatasetAttributes	(	const std::string &	datasetName,
		const std::vector< std::string > &	attributeNames,
		const std::vector< double > &	values
	)

finalvirtual

Writes some double attributes into a dataset

Exceptions

std::invalid_argument Attributes names and double values vector do not have the same size.

Parameters

datasetName	Name of the dataset.
attributeNames	Vector of attributes names.
values	Vector of double values.

Implements eml2::AbstractHdfProxy.

◆ writeDatasetAttributes() [2/3]

void eml2::HdfProxy::writeDatasetAttributes	(	const std::string &	datasetName,
		const std::vector< std::string > &	attributeNames,
		const std::vector< int > &	values
	)

finalvirtual

Writes some int attributes into a dataset

Exceptions

std::invalid_argument Attributes names and int values vector do not have the same size.

Parameters

datasetName	Name of the dataset.
attributeNames	Vector of attributes names.
values	Vector of int values.

Implements eml2::AbstractHdfProxy.

◆ writeDatasetAttributes() [3/3]

void eml2::HdfProxy::writeDatasetAttributes	(	const std::string &	datasetName,
		const std::vector< std::string > &	attributeNames,
		const std::vector< std::string > &	values
	)

finalvirtual

Writes some string attributes into a dataset

Exceptions

std::invalid_argument Attributes names and string values vector do not have the same size.

Parameters

datasetName	Name of the dataset.
attributeNames	Vector of attributes names.
values	Vector of string values.

Implements eml2::AbstractHdfProxy.

◆ writeGroupAttribute()

void eml2::HdfProxy::writeGroupAttribute	(	const std::string &	groupName,
		const std::string &	attributeName,
		const std::vector< std::string > &	values
	)

finalvirtual

Writes a single attribute into a group which contains an array of string values

Parameters

groupName	Name of the group.
attributeName	Name of the attribute.
values	Vector of string values.

Implements eml2::AbstractHdfProxy.

◆ writeGroupAttributes() [1/3]

void eml2::HdfProxy::writeGroupAttributes	(	const std::string &	groupName,
		const std::vector< std::string > &	attributeNames,
		const std::vector< double > &	values
	)

finalvirtual

Writes some double attributes into a group

Exceptions

std::invalid_argument Attributes names and double values vector do not have the same size.

Parameters

groupName	Name of the group.
attributeNames	Vector of attributes names.
values	Vector of double values.

Implements eml2::AbstractHdfProxy.

◆ writeGroupAttributes() [2/3]

void eml2::HdfProxy::writeGroupAttributes	(	const std::string &	groupName,
		const std::vector< std::string > &	attributeNames,
		const std::vector< int > &	values
	)

finalvirtual

Writes some int attributes into a group

Exceptions

std::invalid_argument Attributes names and int values vector do not have the same size.

Parameters

groupName	Name of the group.
attributeNames	Vector of attributes names.
values	Vector of int values.

Implements eml2::AbstractHdfProxy.

◆ writeGroupAttributes() [3/3]

void eml2::HdfProxy::writeGroupAttributes	(	const std::string &	groupName,
		const std::vector< std::string > &	attributeNames,
		const std::vector< std::string > &	values
	)

finalvirtual

Writes some string attributes into a group

Exceptions

std::invalid_argument Attributes names and string values vector do not have the same size.

Parameters

groupName	Name of the group.
attributeNames	Vector of attributes names.
values	Vector of string values.

Implements eml2::AbstractHdfProxy.

◆ writeItemizedListOfList()

void eml2::HdfProxy::writeItemizedListOfList	(	const std::string &	groupName,
		const std::string &	name,
		hdf5_hid_t	cumulativeLengthDatatype,
		const void *	cumulativeLength,
		unsigned long long	cumulativeLengthSize,
		hdf5_hid_t	elementsDatatype,
		const void *	elements,
		unsigned long long	elementsSize
	)

finalvirtual

Writes an itemized list of lists into the HDF5 file by means of a single group containing two datasets: one for the elements and one for the cumulative lengths of the lists of elements.

Parameters

groupName	The name of the group where to create the itemized list of lists. This name must not contain '/' character and must be directly contained in the RESQML group.
name	The name of the itemized list of lists HDF5 group.
cumulativeLengthDatatype	The datatype of the cumulative lengths dataset to write.
cumulativeLength	1d array of positive integers containing for each list the sum of all the previous lists lengths including the current one.
cumulativeLengthSize	Size of the cumulative lengths array.
elementsDatatype	The datatype of the elements to write.
elements	1d array of elements containing the aggregation of individual lists contents.
elementsSize	Size of the elements array.

Implements eml2::AbstractHdfProxy.

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

C:/Users/philippe/dev/fesapiEnv/fesapi-2.0.0.0/src/eml2/HdfProxy.h

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ HdfProxy() [1/2]

◆ HdfProxy() [2/2]

◆ ~HdfProxy()

Member Function Documentation

◆ close()

◆ createArrayNd()

◆ exist()

◆ getDimensionCount()

◆ getElementCount()

◆ getElementCountPerDimension()

◆ getHdfDatatypeClassInDataset()

◆ getHdfDatatypeInDataset()

◆ isCompressed()

◆ isOpened()

◆ open()

◆ readArrayDimensions()

◆ readArrayNdOfCharValues()

◆ readArrayNdOfDoubleValues() [1/4]

◆ readArrayNdOfDoubleValues() [2/4]

◆ readArrayNdOfDoubleValues() [3/4]

◆ readArrayNdOfDoubleValues() [4/4]

◆ readArrayNdOfFloatValues() [1/2]

◆ readArrayNdOfFloatValues() [2/2]

◆ readArrayNdOfInt64Values() [1/2]

◆ readArrayNdOfInt64Values() [2/2]

◆ readArrayNdOfIntValues() [1/2]

◆ readArrayNdOfIntValues() [2/2]

◆ readArrayNdOfShortValues()

◆ readArrayNdOfUCharValues()

◆ readArrayNdOfUInt64Values()

◆ readArrayNdOfUIntValues()

◆ readArrayNdOfUShortValues()

◆ readDoubleAttribute()

◆ readLongAttribute()

◆ readStringArrayAttribute()

◆ readStringAttribute()

◆ selectArrayNdOfValues()

◆ setCompressionLevel()

◆ writeArrayNd()

◆ writeArrayNdOfCharValues()

◆ writeArrayNdOfDoubleValues()

◆ writeArrayNdOfFloatValues()

◆ writeArrayNdOfInt64Values()

◆ writeArrayNdOfIntValues()

◆ writeArrayNdOfUInt64Values()

◆ writeArrayNdSlab()

◆ writeDatasetAttribute()

◆ writeDatasetAttributes() [1/3]

◆ writeDatasetAttributes() [2/3]

◆ writeDatasetAttributes() [3/3]

◆ writeGroupAttribute()

◆ writeGroupAttributes() [1/3]

◆ writeGroupAttributes() [2/3]

◆ writeGroupAttributes() [3/3]

◆ writeItemizedListOfList()