diff options
Diffstat (limited to 'doc/html/Utilities.html')
-rw-r--r-- | doc/html/Utilities.html | 120 |
1 files changed, 120 insertions, 0 deletions
diff --git a/doc/html/Utilities.html b/doc/html/Utilities.html new file mode 100644 index 0000000..e901176 --- /dev/null +++ b/doc/html/Utilities.html @@ -0,0 +1,120 @@ +<html> + <head> + <TITLE>IEEEIO Utilities</TITLE> + </head> + <body bgcolor="#F0F0F0"> + <!--<h1>Utilities</h1> + <table><tr> + <td><img src="Images/info.gif"></td> + <td><h1>Utilities</h1></td> + </tr></table> + <hr> --> + <h1>Utilities</h1> + <hr> + + <a name="convert2native"><h2>convert2native</h2></a> + Converts an IEEEIO file to the native byte-ordering so that reading can + occur as efficiently as possible. The <i>-byteswap</i> 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.<P> + + <b>usage</b><br> + <code>convert2native [-byteswap] infile outfile</code> + <DL> + <DT><b>infile</b> + <DD>The file to read for translation + <DT><b>oufile</b> + <DD>The file to write to. It will be truncated before it is written to + so don't attempt to write to the input file. + <DT><b>-byteswap</b> + <DD>Forces byte swapping to the opposite of native byte ordering. The + default is to convert to native byte ordering. + </DL> + + <hr> + <a name="ioconvert"><h2>ioconvert</h2></a> + A more general utility than <b>convert2native</b>; <b>ioconvert</b> + 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. <b>convert2native</b> only exists for people + who want the byte-swapping capability but don't wish to compile the full + HDF libraries.<p> + + <b>ioconvert</b> senses the filetype by the extension you use for the filename. + <i>.ieee</i> and <i>.raw</i> are interpreted as IEEEIO files and + <i>.hdf</i> is interpreted as an HDF file.<p> + + <b>usage</b><br> + <code>ioconvert [-byteswap] infile{.hdf|.ieee|.raw} + outfile{.hdf|.ieee|.raw}</code> + <DL> + <DT><b>infile</b> + <DD>The file to read for translation + <DT><b>oufile</b> + <DD>The file to write to. It will be truncated before it is written to + so don't attempt to write to the input file. + <DT><b>-byteswap</b> + <DD>Forces byte swapping to the opposite of native byte ordering. The + default is to convert to native byte ordering. + </DL> + + <hr> + <a name="ioinfo"><h2>ioinfo</h2></a> + 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.<p> + + <b>usage</b><br> + <code>ioinfo datafile [-showdata | -hidedata] + [-showanndata | -hideanndata] [-showanninfo | -hideanninfo] + [-showattdata | -hideattdata] [-showattinfo | -hideattinfo] + </code> + <DL> + <DT><b>datafile</b> + <DD>The file you wish to examine + <DT><b>-showdata</b> or <b>-data</b> + <DD>Shows the first 10 elements of each dataset. + <DT><b>-hidedata</b> [<i>default</i>] + <DD>Does not show the data, but shows all information about the + datsets like the datatype and the dimensions etc... + + <DT><b>-showannotationinfo</b> or <b>-showanninfo</b> + <DD>Shows information about the length of each annotation + bound to a dataset. Otherwise + only the number of annotations is shown for each dataset. + <DT><b>-hideannotationinfo</b> or <b>-hideanninfo</b> [<i>default</i>] + <DD>Only the number of annotations is shown for each dataset. + + <DT><b>-showannotationdata</b> or <b>-showanndata</b> + <DD>Shows the first 10 characters of each annotation. + <DT><b>-hideannotationdata</b> or <b>-hideanndata</b> [<i>default</i>] + <DD>None of the contents of the annotations are printed. + + <DT><b>-showattributeinfo</b> or <b>-showattinfo</b> + <DD>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. + <DT><b>-hideattributeinfo</b> or <b>-hideattinfo</b> [<i>default</i>] + <DD>Only the number of attributes is shown for each dataset. + + <DT><b>-showattributedata</b> or <b>-showattdata</b> + <DD>Shows the first 10 elements of data stored in an attribute. + <DT><b>-hideattributedata</b> or <b>-hideattdata</b> [<i>default</i>] + <DD>None of the contents of the attribute is printed (except + information if requested). + </DL> + + + <hr> + <address><a href="mailto:jshalf@suttung.aei-potsdam.mpg.de">John Shalf</a></address> + <!-- Created: Mon Apr 7 12:52:52 MDT 1997 --> + <!-- hhmts start --> +Last modified: Tue Apr 8 19:01:45 MDT +<!-- hhmts end --> + </body> +</html> |