Outputs new records appended to a dataset as the dataset grows
h5watch [OPTIONS] OBJECT
h5watchcan be used to watch data that is added to a dataset. The functionality is similar to the Unix user commandtailwith the follow option, which outputs appended data as the file grows.
h5watchcan only be used on chunked datasets with unlimited dimension(s) or a fixed dimension with a maximum dimension setting.
While monitoring a dataset, users need to ensure that data that is being written to the dataset is flushed to the file.
Options and Parameters:
Options: The following optional command-line options can be used withh5watch:
Print a usage message and exit.
Print the version of HDF5 and exit.
Label members of a compound datatyped dataset.
Use a machine-readable output format.
Monitor changes in dimension size of the dataset only.
Set the number of columns toNfor output. A value of 0 sets the number of columns to the maximum (65535). The default width is 80 columns.
Set the polling interval toN(in seconds) when the dataset will be checked for appended data. The default polling interval is 1.
Display data for the fields specified inlist_of_fieldsfor a compound datatype.list_of_fieldcan be specified as follows:
A comma-separated list of field names in a compound data type.
A single field name in a compound data type. This option can be used multiple times to select multiple fields in a compound data type.
Note that “,” is the separator for field names while “.” is the separator for a nested field. The backslash is the escape character; use it to escape character(s) in field names that conflict with the separators used by the tool.
Object:OBJECTis the dataset to be monitored and is specified with the following format:
Each element in this specification ofOBJECTis defined as follows:
The name of the HDF5 file. May be preceded by a path separated by slashes to the specified HDF5 file.
The path within the HDF5 file separated by slashes to the specified dataset
The name of the dataset to be monitored.
An error occurred.
The default use is to include the tool name and the name of the dataset that will be watched. The output will describe any change and will list the changes.
Suppose there is a dataset called dsetA in an HDF5 file called example.h5, and this dataset is a one-dimensional dataset with three records. Afterh5watchis run with a command line ofh5watch example.h5/dsetA, the dimension size in the file is changed from three to five, and data is written to the dataset. The output fromh5watchwould be the following: