HDF5

class openpnm.io.HDF5

Bases: openpnm.io.GenericIO.GenericIO

The HDF5 (Hierarchical Data Format) file is good for high-peformance, long term data storage

classmethod export_data(network=None, phases=[], element=['pore', 'throat'], filename='', interleave=True, flatten=False, categorize_by=[])

Creates an HDF5 file containing data from the specified objects, and categorized according to the given arguments.

Parameters

• network (OpenPNM Network Object) – The network containing the desired data

• phases (list of OpenPNM Phase Objects (optional, default is none)) – A list of phase objects whose data are to be included

• element (string or list of strings) – An indication of whether ‘pore’ and/or ‘throat’ data are desired. The default is both.

• interleave (boolean (default is True)) – When True (default) the data from all Geometry objects (and Physics objects if phases are given) is interleaved into a single array and stored as a network property (or Phase property for Physics data). When False, the data for each object are stored under their own dictionary key, the structuring of which depends on the value of the flatten argument.

• flatten (boolean (default is True)) – When True, all objects are accessible from the top level of the dictionary. When False objects are nested under their parent object. If interleave is True this argument is ignored.

• categorize_by (string or list of strings) –

  Indicates how the dictionaries should be organized. The list can contain any, all or none of the following strings:

  ’objects’ : If specified the dictionary keys will be stored under a general level corresponding to their type (e.g. ‘network/net_01/pore.all’). If interleave is True then only the only categories are network and phase, since geometry and physics data get stored under their respective network and phase.

  ’data’ : If specified the data arrays are additionally categorized by label and property to separate boolean from numeric data.

  ’elements’ : If specified the data arrays are additionally categorized by pore and throat, meaning that the propnames are no longer prepended by a ‘pore.’ or ‘throat.’

classmethod to_hdf5(*args, **kwargs)

This method is being deprecated. Use export_data instead.