% @(#)averagaver.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:16 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      averagaver.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, AVERAGE/AVERAGE
%.PURPOSE    On-line help file for the command: AVERAGE/AVERAGE
%.VERSION    1.0  19-JUL-1990 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./AVER
\es\co
AVERAGE/AVERAGE						19-JUL-1990  KB
\oc\su
AVERAGE/AVERAGE [in_specs] [out_specs] [out_opt] [draw_flag]
	compute average over subimage
\us\pu
Purpose: 
          Compute simple average of all pixels in a subimage.
\up\sy
Syntax:
          AVERAGE/AVERAGE [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/MEDIAN, 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/AVE
           Use cursor to define subimages and display start- and end-coord of
           subimage and average value on terminal only.
\xe\ex
          (2) AVERAGE/AVE CURSOR VALUES
           As (1)  but write data to the beginning of real descriptor VALUES of
           displayed image.
\xe\ex
          (3) AVERAGE/AVE CURSOR values A N
           As (2)  but append data to the end of real descriptor values and do
           not draw the borders of the subimages into the overlay plane.
\xe\ex
          (4) AVERAGE/AVE CURSOR values,:MEAN
           As (1) but store data into table values.tbl (this will be created by
           MIDAS), result value will be stored into column labeled :MEAN.
\xe\ex
          (5) AVERAGE/AVE CURSOR values,:MEAN C
           As (4) but store also center coordinates into columns labeled :XCEN
           and :YCEN.
\xe\ex
          (6) AVERAGE/AVE 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/AVE ccd001,flats values
           As (2) but input from table as in (6).
\xe\ex
          (8) AVERAGE/AVE ccd001,flats :MEAN
           As (7) but store result into column :MEAN of table flats.tbl.
\xe \sxe