Skip to main content

Helper tools to handle H5 files

Project description


This package provides basic utilities allowing the comparison of hdf5 type files. This includes the computation of standard statistics on data arrays such as the mean, min, max, median and standard deviation. An interactive mode is enabled through the use of nobvisual ( Scatter plot comparative capability is enabled through seaborn and matplotlib.


Installation using Pypi:

> pip install h5cross


Use the CLI for a basic terminal usage.

   ---------------    H5CROSS  --------------------

  You are now using the Command line interface of h5cross a Python3 helper
  to explore and compare hdf5 files, created at CERFACS

  This is a python package currently installed in your python environement.

  --help  Show this message and exit.

  convert   Conversion to hdf5 of certain file formats.
  diff      Compare the content of two hdf5 files and view interactively...
  dump      Write the content of an hdf5 file into a YAML file.
  scatter   Scatter plot comparison of two hdf5 files.
  stats     Compute statistics of arrays from hdf5 file.
  tree      Print the content of an hdf5 file in terminal.
  view      Show the content of an hdf5 file interactively with nobvisual.


Console file structure visualization

The command >h5cross tree prints the structure of an HDF5 file in the console.


Statistical information of file

The command >h5cross stats computes the mean, min, max, median and standard deviation of every data set for a given HDF5 file. It is then output into the console (can be optionally deactivated). The result can be optionally saved in a YAML format (.yml). A pretty table output is set to default and can be optionally be deactivated in which case a tree output is given. In a pretty table, the full nested path is shown but can be deactivated.




Save file structure

The command >h5cross dump outputs the structure of an HDF5 file in a YAML format (.yml).

View file structure

The command >h5cross view allows an interactive view of the structure of an HDF5 file. It relies on the nobvisual package designed for the visualisation of nested objects. A temporary .yml file is generated to allow the interactive use.


Compare file structures

The command >h5cross diff compares the structure of two HDF5 files. Similarily to >h5cross view it relies on the nobvisual package. It is optionally possible to add the statistical information of both files in this representation.


Compare field data

The command >h5cross scatter allows the scatter plot comparison of selected data fields from two HDF5 files. If the data array lengths of each file differ an histogram representation will be given instead. A minimum requirement is the matplotlib package. By default it uses the seaborn package if available but this setting can be optionally deactivated. The density colormap requires the scipy package, if not available a single color will be used.




Converting file types to HDF5 file

It is possible to convert certain file formats to HDF5 with >h5cross convert . Currently supported: nek5000, pvtu, vtu, vtk.


h5cross is a service created in the EXCELLERAT Center Of Excellence and is continued as part of the COEC Center Of Excellence. Both projects are funded by the European community. logo logo

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

h5cross-0.2.4.tar.gz (26.0 kB view hashes)

Uploaded Source

Built Distribution

h5cross-0.2.4-py3-none-any.whl (26.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page