H5FROMTXT(1) h5utils H5FROMTXT(1)NAMEh5fromtxt - convert text input to an HDF5 file
SYNOPSISh5fromtxt [OPTION]... [HDF5FILE]
DESCRIPTIONh5fromtxt takes a series of numbers from standard input and outputs a
multi-dimensional numeric dataset in an HDF5 file.
HDF5 is a free, portable binary format and supporting library developed
by the National Center for Supercomputing Applications at the Univer‐
sity of Illinois in Urbana-Champaign. A single h5 file can contain
multiple data sets; by default, h5fromtxt creates a dataset called
"data", but this can be changed via the -d option, or by using the syn‐
tax HDF5FILE:DATASET. The -a option can be used to append new datasets
to an existing HDF5 file.
All characters besides the numbers (and associated decimal points,
etcetera) in the input are ignored. By default, the data is assumed to
be a two-dimensional MxN dataset where M is the number of rows (delim‐
ited by newlines) and N is the number of columns. In this case, it is
an error for the number of columns to vary between rows. If M or N is
1 then the data is written as a one-dimensional dataset.
Alternatively, you can specify the dimensions of the data explicitly
via the -n size option, where size is e.g. "2x2x2". In this case, new‐
lines are ignored and the data is taken as an array of the given size
stored in row-major ("C") order (where the last index varies most
quickly as you step through the data). e.g. a 2x2x2 array would be
have the elements listed in the order: (0,0,0), (0,0,1), (0,1,0),
(0,1,1), (1,0,0), (1,0,1), (1,1,0), (1,1,1).
A simple example is:
h5fromtxt foo.h5 <<EOF
1 2 3 4
5 6 7 8
EOF
which reads in a 2x4 space-delimited array from standard input.
OPTIONS-h Display help on the command-line options and usage.
-V Print the version number and copyright info for h5fromtxt.
-v Verbose output.
-a If the HDF5 output file already exists, append the data as a new
dataset rather than overwriting the file (the default behavior).
An existing dataset of the same name within the file is over‐
written, however.
-n size
Instead of trying to infer the dimensions of the array from the
rows and columns of the input, treat the data as a sequence of
numbers in row-major order forming an array of dimensions size.
size is of the form MxNxLx... (with M, N, L being numbers) and
may be of any dimensionality.
-T Transpose the input when it is written, reversing the dimen‐
sions.
-d name
Write to dataset name in the output; otherwise, the output
dataset is called "data" by default. Alternatively, use the
syntax HDF5FILE:DATASET.
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 H5FROMTXT(1)
