% @(#)computhist.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:21 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      computhist.hlq
%.AUTHOR     JDP, IPG/ESO
%.KEYWORDS   MIDAS, help files, COMPUTE/HISTOGRAM
%.PURPOSE    On-line help file for the command: COMPUTE/HISTOGRAM
%.VERSION    1.0  16-AUG-1984 : Creation, JDP
%----------------------------------------------------------------
\se
SECTION./HIST
\es\co
COMPUTE/HISTOGRAM					16-AUG-1984 JDP
\oc\su
COMPUTE/HISTOGRAM result = table col [bin [min [max]]]
	table-to-image or table-to-table histogram transformation
\us\pu
Purpose:
              Compute histogram of a table column. The result can be
              produced as a new frame or as a new table with two columns.
              In the first case, the sampling step is the bin size, and
              the starting coordinate is the center of the first bin.
              In the second case, a table with two columns is created
              where column \#1 has the same label as the input column
              and contains the center of the bin. The column \#2 is
              labelled :FREQUENCY and contains the frequency in the bin.
\up\sub
Subject:      Statistics, table
\bus\sy
Syntax:
              COMPUTE/HISTOGRAM output = table column [bin [min [max]]]
\ys\pa
              output  = name of one dimensional output frame with histogram.
                        The qualifier /TABLE is used to specify the tabular
                        format. If the output has the qualifier /TABLE,
                        name of table to contain histogram.
\ap\pa
              table   = input table.
\ap\pa
              column  = input column specification.
\ap\pa
              bin     = optional bin size. (Default depends on actual range
                        of date
\ap\pa
              min max = define, optionally, the range of the histogram.
                        (Defaults are min. and max.  values of column
                        specified)
\ap\no
Note:   
              1) The optional parameters 'min' and 'max' are the lower limit
              of the first bin and the upper limit of the last bin, resp.,
              while the values quoted as sampling positions for the output
              image or included in the first column for tabular output are
              the center of the bins.

              2) Image-to-image or image-to-table histogram transformations
              are performed by the application procedure @a histogram (see
              HELP/APPLIC histogram).
\on\see
See also:     
              STATISTICS/TABLE, HELP/APPLIC histogram 
\ees\exs
Examples:
\ex
              COMPUTE/HISTOGRAM hist = mytable :VALUE
              Output histogram into image hist.bdf
\xe\ex
              COMPUTE/HISTOGRAM hist/TAB = mytable :VALUE 
              Output histogram into two columns of table hist.tbl .
\xe \sxe