XMLH5StorageManager

class XMLH5StorageManager(*args)

Storage manager that drives XML/H5 files.

This class allows one to read and write objects from a XML/H5 files pair. The XML part saves the metadata while the H5 binary file save the sample data.

Parameters:
fileNamestr

Name of the file containing the study. Will also specify the name of the h5 file, which will be created next to the XML file.

compressionLevelint, optional

Compression level of the resulting XML and H5 files, in the range 0,…,9 (0=no compression, 9=best compression). The compression is only available if the XML and HDF5 libraries have been compiled with zlib support. The default value is given by ‘XMLStorageManager-DefaultCompressionLevel’ in ResourceMap.

See also

StorageManager

Methods

finalize(*args)

Do some administrative tasks after saving/reloading.

getClassName()

Accessor to the object's name.

getDefaultStudyVersion()

Return the version of the study that the manager can read/write.

getFileName()

Get the name of the file containing the study.

getStudy()

Get the study bound to the manager.

getStudyVersion()

Get the study version.

initialize(*args)

Do some administrative tasks before saving/reloading.

isSavedObject(id)

Tell if an object is already saved.

load(study)

Reload the whole study from the medium.

markObjectAsSaved(id)

Tell that an object is saved.

read()

Read and create the internal representation.

save(obj, label[, fromStudy])

Save the object onto the medium.

setFileName(fileName)

Set the name of the file containing the study.

setStudy(p_study)

Set the study bound to the manager.

setStudyVersion(version)

Set the study version.

write()

Write the internal representation.

__init__(*args)
finalize(*args)

Do some administrative tasks after saving/reloading.

Available usages:

finalize(ot.SaveAction())

finalize(ot.LoadAction())

getClassName()

Accessor to the object’s name.

Returns:
class_namestr

The object class name (object.__class__.__name__).

getDefaultStudyVersion()

Return the version of the study that the manager can read/write.

Returns:
versionpositive int

Version of the study that the manager can read/write.

getFileName()

Get the name of the file containing the study.

Returns:
fileNamestr

Name of the file containing the study.

getStudy()

Get the study bound to the manager.

Returns:
studyStudy

Study bound to the manager.

getStudyVersion()

Get the study version.

Returns:
versionpositive int

Study version.

initialize(*args)

Do some administrative tasks before saving/reloading.

Available usages:

initialize(ot.SaveAction())

initialize(ot.LoadAction())

isSavedObject(id)

Tell if an object is already saved.

Returns:
isSavedbool

True if an object is already saved.

load(study)

Reload the whole study from the medium.

Parameters:
studyStudy

The study to reload objects from.

markObjectAsSaved(id)

Tell that an object is saved.

Parameters:
Idint

Internal identifier of the object.

read()

Read and create the internal representation.

save(obj, label, fromStudy=False)

Save the object onto the medium.

Parameters:
objectPersistentObject

Object to be saved.

labelstr

Name associate with the object to be saved.

fromStudybool, optional

Flag telling if the object was explicitly put in the study or not. By default, it is equal to False.

setFileName(fileName)

Set the name of the file containing the study.

Parameters:
fileNamestr

Name of the file containing the study.

setStudy(p_study)

Set the study bound to the manager.

Parameters:
studyStudy

Study bound to the manager.

setStudyVersion(version)

Set the study version.

Parameters:
versionpositive int

Study version.

write()

Write the internal representation.

Examples using the class

Save/load a study

Save/load a study