1. www.hdfgroup.org The HDF Group 10/17/151 HDF5 Tools Tutorial ICALEPCS 2015

2. www.hdfgroup.org10/17/152 HDF5 Tools Supported by The HDF Group https://www.hdfgroup.org/tools/ GUI-based Browsers HDF Compass (prototype) HDFView HDF5 command-line tools Distributed with the HDF5 library h5dump, h5ls, h5repack, h5diff, h5jam, h5copy, h5debug Distributed as stand-alone tools h5check, converters between HDF4 and HDF5 Supported on variety of platforms ICALEPCS 2015

3. www.hdfgroup.org10/17/153 Aside: UNIX commands can be useful! head View superblock strings View character data (attributes, datasets) View some HDF5 metadata hexdump The last resort to troubleshoot issues ICALEPCS 2015

4. www.hdfgroup.org HDF Compass 10/17/154 https://github.com/HDFGroup/hdf-compass/ Please try it and let us know what do you think! ICALEPCS 2015

5. www.hdfgroup.org10/17/155 HDFView Java-based tool to access HDF4 and HDF5 Used for Viewing and modifying file content Creating data in HDF files Exporting and importing data Getting data to/from Excel Supports features used in the JPSS files User block Supports object and region references ICALEPCS 2015

6. www.hdfgroup.org The HDF Group 10/17/156 HDF5 command-line tools ICALEPCS 2015

7. www.hdfgroup.org10/17/157 HDF5 command-line tools info See HDF5 Reference Manual https://www.hdfgroup.org/HDF5/doc/RM/Tools.ht ml FlagUsed for -V (--version)Printing version of the HDF5 library -h (--help)Displaying online help --enable-error-stackTroubleshooting ICALEPCS 2015

8. www.hdfgroup.org10/17/158 h5dump Displays HDF5 file according Data Description Language (DDL) Human readable and most comprehensive FlagUsed for -H (--header)Suppressing data printing -p (--properties)Displaying properties of the objects, e.g., compression ratio -BPrinting superblock to find user block info -M (--packedbits)Displaying JPSS quality flags -R (--region)Displaying data pointed by region reference -NSearching for the object specified by “name” ICALEPCS 2015

9. www.hdfgroup.org10/17/159 h5ls Provides some internal information, such as objects offsets in the file to pass to h5debug Flag(s)Used for -vVerbose output -gDisplaying information about the group -rListing objects recursively -dPrinting data for the dataset ICALEPCS 2015

10. www.hdfgroup.org10/17/1510 h5jam/h5unjam Adds/removes user block h5unjam -i -o -u ICALEPCS 2015

11. www.hdfgroup.org10/17/1511 h5repack Creates new file with different properties Flag(s)Used for No flagsDeleting non-used space in the file -lChanging storage layout of the datasets in the file -fApplying (or removing) compression ICALEPCS 2015

12. www.hdfgroup.org10/17/1512 h5diff Finds differences in two files Not good at comparing file structures Flag(s)Used for -N (--nan)Disabling NaN detection ---exclude-pathDisabling comparison of specified objects ICALEPCS 2015

13. www.hdfgroup.org10/17/1513 h5diff Finds differences in two files Flag(s)Used for -lChanging storage layout of the datasets in the file -fApplying (or removing) compression ICALEPCS 2015

14. www.hdfgroup.org10/17/1514 h5copy Copies a specified content within an HDF5 file or to a new HDF5 file Easy to extract data to the new HDF5 file Limitation – cannot copy to “/” root group Flag(s)Used for -fControlling “copy” options -f refCoping references and the objects they referenced ICALEPCS 2015

15. www.hdfgroup.org10/17/1515 h5check Uses file specification to checks file format consistency Useful with corrupted files to see if any data can be salvaged ICALEPCS 2015

16. www.hdfgroup.org The HDF Group Thank You! Questions? 1610/17/15 ICALEPCS 2015