Utilities
convert2native
Converts an IEEEIO file to the native byte-ordering so that reading can
occur as efficiently as possible. The -byteswap flag causes the
utility to do the opposite (switch to non-native byte ordering). Please
note that ieeeio does not have any problem reading files of any
byte-order, however, byteswapping does exact a performance penalty on
any system. So converting to native byte order improves performance.
usage
convert2native [-byteswap] infile outfile
- infile
- The file to read for translation
- oufile
- The file to write to. It will be truncated before it is written to
so don't attempt to write to the input file.
- -byteswap
- Forces byte swapping to the opposite of native byte ordering. The
default is to convert to native byte ordering.
ioconvert
A more general utility than convert2native; ioconvert
converts a file from source format (IEEEIO or HDF) to any allowable
destination format (currently only IEEEIO or HDF). It can also perform
byteswapping to convert to native or the opposite of native format. The
default is native format. convert2native only exists for people
who want the byte-swapping capability but don't wish to compile the full
HDF libraries.
ioconvert senses the filetype by the extension you use for the filename.
.ieee and .raw are interpreted as IEEEIO files and
.hdf is interpreted as an HDF file.
usage
ioconvert [-byteswap] infile{.hdf|.ieee|.raw}
outfile{.hdf|.ieee|.raw}
- infile
- The file to read for translation
- oufile
- The file to write to. It will be truncated before it is written to
so don't attempt to write to the input file.
- -byteswap
- Forces byte swapping to the opposite of native byte ordering. The
default is to convert to native byte ordering.
ioinfo
Prints out a variety of diagnostic information about IEEEIO and HDF
datafiles. A variety of flags are used to control the amount and the
type of information printed. By default, only information about the
datasets (rank, dimensions and datatype) as well as the number
of attachments will be printed.
usage
ioinfo datafile [-showdata | -hidedata]
[-showanndata | -hideanndata] [-showanninfo | -hideanninfo]
[-showattdata | -hideattdata] [-showattinfo | -hideattinfo]
- datafile
- The file you wish to examine
- -showdata or -data
- Shows the first 10 elements of each dataset.
- -hidedata [default]
- Does not show the data, but shows all information about the
datsets like the datatype and the dimensions etc...
- -showannotationinfo or -showanninfo
- Shows information about the length of each annotation
bound to a dataset. Otherwise
only the number of annotations is shown for each dataset.
- -hideannotationinfo or -hideanninfo [default]
- Only the number of annotations is shown for each dataset.
- -showannotationdata or -showanndata
- Shows the first 10 characters of each annotation.
- -hideannotationdata or -hideanndata [default]
- None of the contents of the annotations are printed.
- -showattributeinfo or -showattinfo
- Shows information about the name, length and datatype of the
attributes for each attribute attached to a dataset. Otherwise
only the number of attributes is shown for each dataset.
- -hideattributeinfo or -hideattinfo [default]
- Only the number of attributes is shown for each dataset.
- -showattributedata or -showattdata
- Shows the first 10 elements of data stored in an attribute.
- -hideattributedata or -hideattdata [default]
- None of the contents of the attribute is printed (except
information if requested).
John Shalf
Last modified: Tue Apr 8 19:01:45 MDT