Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

h5fromh4(1) [debian man page]

H5FROMH4(1)							      h5utils							       H5FROMH4(1)

NAME

       h5fromh4 - convert HDF4 scientific datasets to an HDF5 file

SYNOPSIS

       h5fromh4 [OPTION]... [HDF4FILE]...

DESCRIPTION

       h5fromh4  takes one or more files in HDF4 format and outputs files in HDF5 format containing the datasets from the HDF4 files.  (Currently,
       only a single dataset per HDF4 file is converted.)

       HDF4 and HDF5 are free, portable binary formats and supporting libraries 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, h5fromh4 creates a dataset called "data", but this can be changed via the -d
       option, or by using the syntax HDF5FILE:DATASET with the -o option.  The -a option can be used to append new datasets to an  existing  HDF5
       file.   If the -o option is used and multiple HDF4 files are specified, all the HDF4 datasets are output into that HDF5 file with the input
       filenames (minus the ".hdf" suffix) used as the dataset names.

       The most basic usage is something like 'h5fromh4 foo.hdf', which will output a file foo.h5 containing the scientific dataset from foo.hdf.

OPTIONS

       -h     Display help on the command-line options and usage.

       -V     Print the version number and copyright info for h5fromh4.

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

       -o file
	      Send  HDF5 output to file rather than to the input filename with .hdf replaced with .h5 (the default).  If multiple input files were
	      specified, this causes all input datasets to be stored in file (rather than in separate files), with the input filenames (minus  the
	      .hdf suffix) as the dataset names.

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

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						       H5FROMH4(1)

Check Out this Related Man Page

h5jam(1)						      General Commands Manual							  h5jam(1)

NAME

       h5jam - Add a user block to a HDF5 file

SYNOPSIS

       h5jam -u user_block -i in_file.h5 [-o out_file.h5] [--clobber]

DESCRIPTION

       h5jam  concatenates  a  user_block  file  and an HDF5 file to create an HDF5 file with a user block. The user block can be either binary or
       text. The output file is padded so that the HDF5 header begins on byte 512, 1024, etc.. (See the HDF5 File Format.)

       If out_file.h5 is given, a new file is created with the user_block followed by the contents of in_file.h5.   In	this  case,  infile.h5	is
       unchanged.

       If out_file.h5 is not specified, the user_block is added to in_file.h5.

       If  in_file.h5  already	has  a	user  block,  the contents of user_block will be added to the end of the existing user block, and the file
       shifted to the next boundary. If --clobber is set, any existing user block will be overwritten.

EXAMPLE USAGE

       Create new file, newfile.h5, with the text in file mytext.txt as the user block for the HDF5 file file.h5.

	    h5jam -u mytext.txt -i file.h5 -o newfile.h5

       Add text in file mytext.txt to front of HDF5 dataset, file.h5.

	    h5jam -u mytext.txt -i file.h5

       Overwrite the user block (if any) in file.h5 with the contents of mytext.txt.

	    h5jam -u mytext.txt -i file.h5 --clobber

RETURN VALUE

       h5jam returns the size of the output file, or -1 if an error occurs.

CAVEATS

       This tool copies all the data (sequentially) in the file(s) to new offsets. For a large file, this copy will take a long time.

       The most efficient way to create a user block is to create the file with a user block (see H5Pset_user_block), and  write  the  user  block
       data into that space from a program.

       The  user block is completely opaque to the HDF5 library and to the h5jam and h5unjam tools.  The user block is simply read or written as a
       string of bytes, which could be text or any kind of binary data.  It is up to the user to know what the contents of the	user  block  means
       and how to process it.

       When the user block is extracted, all the data is written to the output, including any padding or unwritten data.

       This tool moves the HDF5 file through byte copies, i.e., it does not read or interpret the HDF5 objects.

SEE ALSO

       h5dump(1), h5ls(1), h5diff(1), h5import(1), gif2h5(1), h52gif(1), h5perf(1), h5unjam(1).

																	  h5jam(1)
Man Page