HMV(1)                            USER COMMANDS                          HMV(1)

NAME
     hmv - two dimensional array viewer

SYNOPSIS
     hmv [-cs number] [-nd] [-no0] [-grid number] [-c number]
         [-2] [-3] filename [...]

DESCRIPTION
     hmv reads in files of  floating point numbers to be displayed graphically.
     Files should have an integer header of the arrays dimensions and each data
     point should appear on it's own line, row/column order.  Multiple steps of
     data can appear  in a single file,  though each step must be  preceeded by
     the header.

     `hmv' allows point-by-point differencing of any two files at any two steps
     of if they have  the same dimensions.  If hmv is  given two files as argu-
     ments, it assumes you are going to difference the two files,  otherwise it
     displays the raw values of the first file only.

     Min/Max thresholding can be done by pressing 'Set Min/Max' and then choos-
     ing a value on the domain display.  Note that if differencing mode is set,
     use the difference (middle button) to set the threshold.  Pressing either
     'Set' button twice resets it, pressing 'Reset' resets min and max.

     The viewed image can saved to the filename `hmv_output.hmv' by pressing 
     `Save'.  Cells which are thresholded out (either by min/max or -missing)
     are saved as the value defined by the -missing argument, else 0.0.

OPTIONS
     -1   Use a one color (grey scale) color mapping scheme.

     -2   Use a two color mapping scheme (blue through red).  Default

     -3   Use a three color mapping (blue through green through red).

     -c 
	  Allocate `number' colors to draw with.  Default is 32.

     -nd  No differencing of files on startup.

     -cs 
          Size of cell, in pixels.  Default is 4.

     -grid 
          Resolution of grid in `number' of cells.  Default is 1.

     -missing 
          Treat  as  missing data  in the domain.  May be  any floating
          point value lower than the lowest point on the domain.  This value is
          also used as the 'missing' value when saving images.


EXAMPLES
     unix% cat file1
           61  46  [Optional Field Name]
           12.3829
           13.2832
           13.8965
           ...
           16.2843
           61  46  [Optional Field Name]
           13.8392
           ...

     unix% hmv file1
	A single file is shown.

     unix% hmv file*
        All files named file* are loaded, and the first two are differenced
        at step 0.


BUGS
     If only  one file is loaded,  file 2's step slider is  shown to force that
     damn widget to be the right size.

     When hmv starts up or spawns a new window, X does not know the size of the
     window yet and makes a placement frame of size 0x0.

     If only two files  are loaded and they  are of different  sizes,  hmv gets 
     confused and makes it impossible to difference the second set of files.

     Horizontal and vertical flip do not apply to showing values, hence show-
     value buttons are only correct if the display hasn't been flipped.

     Loading any number of files with only one step,  then using LOAD to read a
     set with multiple steps doesn't work because sliders do not exist.
	
     The window name is grammatically incorrect, think of it as a feature since
     it's documented.  Needs a '-no_Her_Majesties_2D_Array_Viewer' argument.

     When differencing files, only File 1's field name is shown.

     On machines where the default fixed font is not fixed (IE: SGI),
     the user must set the X resource:  -xrm ".hmv.*.fontList: fixed"

CHANGES
     The `-no0' flag turned into -missing 

Send  bug reports and  enhancement request  to mogill@rotang.com