h5totxt(1) [debian man page]
H5TOTXT(1) h5utils H5TOTXT(1) NAME
h5totxt - generate comma-delimited text from 2d slices of HDF5 files SYNOPSIS
h5totxt [OPTION]... [HDF5FILE]... DESCRIPTION
h5totxt is a utility to generate comma-delimited text (and similar formats) from one-, two-, or more-dimensional slices of numeric datasets in HDF5 files. This way, the data can easily be imported into spreadsheets and similar programs for analysis and visualization. HDF5 is a free, portable binary format and supporting library developed by the National Center for Supercomputing Applications at the Uni- versity of Illinois in Urbana-Champaign. A single h5 file can contain multiple data sets; by default, h5totxt takes the first dataset, but this can be changed via the -d option, or by using the syntax HDF5FILE:DATASET. By default, the entire dataset is dumped to the output. in row-major order. For 3d datasets, this corresponds to a sequence of yz slices, in order of increasing x, separated by blank lines. If -T is specified, outputs in the transposed (column-major) order instead Often, however, you want only a one- or two-dimensional slice of multi-dimensional data. To do this, you specify coordinates in one or more slice dimensions, via the -xyzt options. The most basic usage is something like 'h5totxt foo.h5', which will output comma-delimited text to stdout from the data in foo.h5. OPTIONS
-h Display help on the command-line options and usage. -V Print the version number and copyright info for h5totxt. -v Verbose output. -o file Send text output to file rather than to stdout (the default). -s sep Use the string sep to separate columns of the output rather than a comma (the default). -x ix, -y iy, -z iz, -t it This tells h5totxt to use a particular slice of a multi-dimensional dataset. e.g. -x causes a yz plane (of a 3d dataset) to be used, at an x index of ix (where the indices run from zero to one less than the maximum index in that direction). Here, x/y/z cor- respond to the first/second/third dimensions of the HDF5 dataset. The -t option specifies a slice in the last dimension, whichever that might be. See also the -0 option to shift the origin of the x/y/z slice coordinates to the dataset center. -0 Shift the origin of the x/y/z slice coordinates to the dataset center, so that e.g. -0 -x 0 (or more compactly -0x0) returns the central x plane of the dataset instead of the edge x plane. (-t coordinates are not affected.) -T Transpose the data (interchange the dimension ordering). By default, no transposition is done. -. numdigits Output numdigits digits after the decimal point (defaults to 16). -d name Use dataset name from the input files; otherwise, the first dataset from each file is used. Alternatively, use the syntax HDF5FILE:DATASET, which allows you to specify a different dataset for each file. You can use the h5ls command (included with hdf5) to find the names of datasets within a file. BUGS
Send bug reports to S. G. Johnson, stevenj@alum.mit.edu. AUTHORS
Written by Steven G. Johnson. Copyright (c) 2005 by the Massachusetts Institute of Technology. h5utils March 9, 2002 H5TOTXT(1)
Check Out this Related Man Page
H5PERF_SERIAL:(1) User Commands H5PERF_SERIAL:(1) NAME
h5perf_serial: - Measures HDF5 serial performance. DESCRIPTION
h5perf_serial: Version 1.8.7 usage: h5perf_serial [OPTIONS] OPTIONS -h Print an usage message and exit -A AL Which APIs to test [default: all of them] -c SL Selects chunked storage and defines chunks dimensions and sizes [default: Off] -e SL Dimensions and sizes of dataset [default: 100,200] -i N Number of iterations to perform [default: 1] -r NL Dimension access order (see below for description) [default: 1,2] -t Selects extendable dimensions for HDF5 dataset [default: Off] -v VFD Selects file driver for HDF5 access [default: sec2] -w Perform write tests, not the read tests [default: Off] -x SL Dimensions and sizes of the transfer buffer [default: 10,20] N - is an integer > 0. S - is a size specifier, an integer > 0 followed by a size indicator: K - Kilobyte (1024) M - Megabyte (1048576) G - Gigabyte (1073741824) Example: '37M' is 37 megabytes or 38797312 bytes AL - is an API list. Valid values are: hdf5 - HDF5 posix - POSIX Example: -A posix,hdf5 NL - is list of integers (N) separated by commas. Example: 1,2,3 SL - is list of size specifiers (S) separated by commas. Example: 2K,2K,3K The example defines an object (dataset, tranfer buffer) with three dimensions. Be aware that as the number of dimensions increases, the the total size of the object increases exponentially. VFD - is an HDF5 file driver specifier. Valid values are: sec2, stdio, core, split, multi, family, direct Dimension access order: Data access starts at the cardinal origin of the dataset using the transfer buffer. The next access occurs on a dataset region next to the previous one. For a multidimensional dataset, there are several directions as to where to proceed. This can be specified in the dimension access order. For example, -r 1,2 states that the tool should traverse dimension 1 first, and then dimension 2. Environment variables: HDF5_NOCLEANUP Do not remove data files if set [default remove] HDF5_PREFIX Data file prefix usage: h5perf_serial [OPTIONS] OPTIONS -h Print an usage message and exit -A AL Which APIs to test [default: all of them] -c SL Selects chunked storage and defines chunks dimensions and sizes [default: Off] -e SL Dimensions and sizes of dataset [default: 100,200] -i N Number of iterations to perform [default: 1] -r NL Dimension access order (see below for description) [default: 1,2] -t Selects extendable dimensions for HDF5 dataset [default: Off] -v VFD Selects file driver for HDF5 access [default: sec2] -w Perform write tests, not the read tests [default: Off] -x SL Dimensions and sizes of the transfer buffer [default: 10,20] N - is an integer > 0. S - is a size specifier, an integer > 0 followed by a size indicator: K - Kilobyte (1024) M - Megabyte (1048576) G - Gigabyte (1073741824) Example: '37M' is 37 megabytes or 38797312 bytes AL - is an API list. Valid values are: hdf5 - HDF5 posix - POSIX Example: -A posix,hdf5 NL - is list of integers (N) separated by commas. Example: 1,2,3 SL - is list of size specifiers (S) separated by commas. Example: 2K,2K,3K The example defines an object (dataset, tranfer buffer) with three dimensions. Be aware that as the number of dimensions increases, the the total size of the object increases exponentially. VFD - is an HDF5 file driver specifier. Valid values are: sec2, stdio, core, split, multi, family, direct Dimension access order: Data access starts at the cardinal origin of the dataset using the transfer buffer. The next access occurs on a dataset region next to the previous one. For a multidimensional dataset, there are several directions as to where to proceed. This can be specified in the dimension access order. For example, -r 1,2 states that the tool should traverse dimension 1 first, and then dimension 2. Environment variables: HDF5_NOCLEANUP Do not remove data files if set [default remove] HDF5_PREFIX Data file prefix SEE ALSO
The full documentation for h5perf_serial: is maintained as a Texinfo manual. If the info and h5perf_serial: programs are properly installed at your site, the command info h5perf_serial: should give you access to the complete manual. h5perf_serial: Version 1.8.7 August 2011 H5PERF_SERIAL:(1)