Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
H5FROMTXT(1)			    h5utils			  H5FROMTXT(1)

       h5fromtxt - convert text	input to an HDF5 file

       h5fromtxt [OPTION]... [HDF5FILE]

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

       which reads in a	2x4 space-delimited array from standard	input.

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

       -d name
	      Write  to	 dataset  name	in  the	 output; otherwise, the	output
	      dataset is called	"data" by  default.   Alternatively,  use  the
	      syntax HDF5FILE:DATASET.

       Send bug	reports	to S. G. Johnson,

       Written	by Steven G. Johnson.  Copyright (c) 2005 by the Massachusetts
       Institute of Technology.

h5utils				 March 9, 2002			  H5FROMTXT(1)


Want to link to this manual page? Use this URL:

home | help