% @(#)averagmedi.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:17 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      averagmedi.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, AVERAGE/MEDIAN
%.PURPOSE    On-line help file for the command: AVERAGE/MEDIAN
%.VERSION    1.0  19-JUL-1990 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./MEDI
\es\co
AVERAGE/MEDIAN						19-JUL-1990  KB
\oc\su
AVERAGE/MEDIAN [in_specs] [out_specs] [out_opt] [draw_flag]
	compute average (median value) over subimage
\us\pu
Purpose: 
          Compute average of all pixels in a subimage by calculating the median
          value.
\up\sy
Syntax: 
          AVERAGE/MEDIAN [in_specs] [out_specs] [out_opt] [draw_flag]
\ys\pa
          in_specs = input specifications, 
\\
             (a) CURSOR, if subimages are chosen via the cursor rectangle,
\\
             (b) image,table if subimages are defined in a table in the columns
                 labeled :XSTART, :XEND, :YSTART and :YEND,
\\
             defaulted to CURSOR
\ap\pa
          out_specs = output specifications,
\\
             (c) :label indicating that the result value should be stored in
                 column :label of the table given in in_specs (b)
\\
             (d) table,:label for cursor input (a) only,
\\
             (e) descriptor if the results should be stored in a real descr.
                 of the involved image, data will be stored as xstart, ystart,
                 xend, yend and average value of subimage
\\
             (f) if omitted, to just display values on the terminal
\ap\pa
          out_opt = A, append data to a descriptor, else start at the
             beginning, for (e) only
\\
             = C, store also x-,y-center into columns labeled :XCEN and :YCEN
             of given table, for (c) + (d)
\ap\pa
          draw_flag = Y(es) or N(o) for drawing or not drawing the subimages
             in the overlay plane
\ap\sa
See also:
          AVERAGE/KAPPA, AVERAGE/AVERAGE, AVERAGE/WEIGHTS, AVERAGE/IMAGE,
          AVERAGE/COLUMN, AVERAGE/ROW
\as\no
Note:
          Currently,this command is not implemented for 1-dim frames.
\\
          When using the cursor input option, a cursor rectangle will appear
          on the screen.
\\
          Press ENTER button on the mouse to start calculation on subimage.
          Use the mouse to move cursor window. Use the arrow keys to change 
          the size of the cursor window.
          To exit press the EXIT button on the mouse.
\on\exs
Examples:
\ex
          (1) AVERAGE/MEDIAN
           Use cursor to define subimages and display start- and end-coords
           of subimage and average value on terminal only.
\xe\ex
          (2) AVERAGE/MEDIAN CURSOR VALUES
           As (1)  but write data to the beginning of real descriptor VALUES
           of displayed image.
\xe\ex
          (3) AVERAGE/MEDIAN CURSOR values A
           As (2)  but append data to the end of real descriptor values.
\xe\ex
          (4) AVERAGE/MEDIAN CURSOR values,:MEAN
           As (1) but store data into table `values.tbl' (will be created by
           MIDAS), result value will be stored into column labeled :MEAN.
\xe\ex
          (5) AVERAGE/MEDIAN CURSOR values,:MEAN C
           As (4) but store also center coordinates into columns labeled
           :XCEN and :YCEN.
\xe\ex
          (6) AVERAGE/MEDIAN ccd001,flats
           Use columns :XSTART, :YSTART, :XEND and :YEND of table `flats.tbl'
           to define the subimages of frame `ccd001.bdf', just display results.
\xe\ex
          (7) AVERAGE/MEDIAN ccd001,flats values
           As (2) but input from table as in (6).
\xe\ex
          (8) AVERAGE/MEDIAN ccd001,flats :MEAN
           As (7) but store result into column :MEAN of table `flats.tbl'.
\xe \sxe