Reading HDF5

Revision as of 01:24, 28 April 2008 by BradWhitlock (talk | contribs) (recategorize)

VisIt can read data from several codes that write their data files to the HDF5 data file format. HDF5 is mainly a smart array storage file format from VisIt's point of view. Complex data structures such as unstructured meshes are often stored in several arrays (coordinates, connectivity, etc.) and the meaning of each array is known to the code that wrote the file. For VisIt to read that file back in, VisIt's plugins must also understand the conventions used to write the HDF5 file so when certain arrays are seen, they can be reassembled into the more complex data structure that they collectively represent. Each of VisIt's HDF5 database reader plugins understands the conventions of a different code that stored its data using HDF5.

Database reader plugin What it stores
Tetrad Unstructured mesh made of tetrahedra
SAMRAI Structured AMR mesh (rectilinear, curvilinear), scalars, materials
Pixie Curvilinear mesh, scalars. Can also read array data and create rectilinear mesh for all arrays in the HDF5 file.
FLASH AMR mesh (rectilinear), scalars
Chombo Structured AMR mesh (rectilinear, curvilinear), scalars, materials
GTC 3D points with scalars
M3D Unstructured mesh, scalars, vectors, tensors
XDMF General HDF5 reader that uses XML file to describe how arrays are assembled into more complex data structures. [In development]

If your HDF5 data looks like any of the above then you can look in the source code for the plugins to determine the structure of the expected HDF5 files. There is currently no sample code for producing HDF5 files that VisIt can read for most of the plugins listed above.

File formats with optional HDF5 storage layer

This section lists some file formats that use HDF5 as a storage layer for a more complex data model that is often hidden by a programming API. These file formats can and do use HDF5 but they should not really be considered HDF5 because their programming API should be used to read the contents of their files.

Database reader plugin What it stores
CGNS Structured, unstructured meshes, scalars, CFD metadata [as of version 1.8.1 it is linked against ADF librarry by default, but HDF5 backend works also]
Silo Structured, unstructured meshes, scalars, vectors, materials, multiple domains.