NAME

       h5fromtxt - convert text input to an HDF5 file

SYNOPSIS

       h5fromtxt [OPTION]... [HDF5FILE]

DESCRIPTION

       h5fromtxt  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  University  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 syntax 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
       (delimited 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, newlines 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
              overwritten, 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 dimensions.

       -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.