Table of Contents
- Recommended Reading about HDF5
- Generating an HDF5 Output File from Dakota
- Browsing HDF5 Files in Dakota GUI
- Using HDF5 Files for Graphical Plotting
- Using HDF5 Files in Next-Gen Workflow
In 2018, with the release of version 6.9.0, Dakota began providing HDF5 database files as a supported output format for its data. Historically, all of Dakota's output data was written to plain text formats - tabular data files, console output stream, etc. This meant that parsing Dakota's output data was a manual, sometimes difficult process. On the other hand, HDF5 is a standard for scientific programming data storage, and there are many tools readily available for reading data out of an HDF5 file.
- Visit the HDF Group website for further information on the HDF5 format.
- Learn about the way Dakota organizes its output data into HDF5 format.
- Learn about HDFView, the HDF Group's tool for graphically browsing HDF5 files.
- Learn about h5py, the Pythonic interface to HDF5 format.
Dakota GUI also provides a block recipe to do this for you:
Now, the next time you run Dakota, an h5 file that contains your Dakota data in HDF5 format will be added to your project directory.
All HDF5 files (not just those generated by Dakota) are browseable in the Dakota GUI, thanks to the incorporation of the HDF Group's HDFView tool.
Clicking on the small arrow next to our h5 file will expand it to the first level of data contained within.
The data contained in HDF5 files are primarily composed of groups and datasets which roughly correspond to the idea of folders and files in an operating system:
This is what an average Dakota HDF5 file looks like after expanding a few of the folders. Groups are designated by folder icons, whereas datasets are designated by page icons.
To view the data in an individual dataset, simply double-click it to display the table of data in your editor area.
Attributes about a group or dataset can be viewed using the Settings Editor view (Window > Show View > Settings).
Pro Tip: The Dakota GUI provides an HDF File Viewing perspective that docks the Settings Editor view in the center of your perspective. To activate this perspective, go to "Window > Perspective > Open Perspective > Other" and then select "HDF File Viewing."
Note: Dakota GUI only supports viewing HDF5 files in read-only mode. You cannot use the Dakota GUI to write to an h5 file after it has been created.
HDF5 files are recognized by Chartreuse (Dakota GUI's plotting library) as a source of plottable data.
- Learn about how to extract plotting data from plain HDF5 files.
- Learn about how to extract plotting data from Dakota-generated HDF5 files.
HDF5 files can also be used when building workflows in Next-Gen Workflow.