HISTOGRAM

From ICE Enterprises
Jump to navigation Jump to search

computes the histogram of input data

 
<IN>    - Input file name
<OUT>   - Output histogram
<START> - Center of bin containing lowest ordinate value 
<END>   - End of range of interest
<DELTA> - Width of each bin
    
Keyword Only Parameters
[BINS]   - (Since 3.1.0) The number of bins to use (overrides <DELTA> 
           as needed)
[CXMODE] - (Since 3.1.0) The format mode when using complex data. Must be in 
           "MAG,PHASE,REAL,IMAG". Default is MAG.
    
HISTOGRAM computes a histogram of the input data whose value falls between
<START> and <END>.  Values outside this range are not counted, and the number
of points that could not be counted is displayed, along with the total number
of points and number of bins. (This output is suppressed when in a macro and 
/VERBOSE is not specified).

(Since 3.1.0) If <START> and <END> are omitted (or set such that 
<END> <= <START>) the <START> and <END> values will be set to match the 
range of values for the input data type.

(Since 3.1.0) If <DELTA> is not set and <BINS> is not set, a default of 
BINS=512 will be used.

If the input is a pipe, a histogram is computed on each transfer length.

Switches:
  /BITS - (Since 3.1.0) Count the bit values (usually used with 'SP' data).
          This implicitly sets START=0, END=1, BINS=2.
  /TL   - Set the transfer length in elements