% @(#)averagtabl.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:50:34 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1992 European Southern Observatory
%.IDENT      averagtabl.hlq
%.AUTHOR     PB, IPG/ESO
%.KEYWORDS   MIDAS, help files, AVERAGE/TABLE
%.PURPOSE    On-line help file for the command: AVERAGE/TABLE
%.VERSION    1.0  17-AUG-1992 : Creation, PB
%----------------------------------------------------------------
\se
SECTION./TABL
\es\co
AVERAGE/TABLE						17-AUG-1992 PB
\oc\su
AVERAGE/TABLE  frame  table  xy_col  outcol  [size]
	Read pixels in a frame at positions defined by a table.
\us\pu
Purpose:    
            The pixel values of the frame are read at positions 
            defined by the columns xy_col in the table. The values
            are written in the column outcol. 
\up\sy
Syntax:     AVERAGE/TABLE  frame  table  xy_col  outcol  [size]
\ys\pa
            frame  =   input image.
\ap\pa
            table  =   table name.
\ap\pa
            xy_col =   name of the columns defining the world
                       coordinates X and Y of the pixels to read.
\ap\pa
            outcol =   name of the column in which the pixel values
                       are written. 
\ap\pa
            size   =   Half-size of the squared area in which the flux
                       is measured. Default is 0.
\ap\no
Note:       Any selection set in the input table will be respected and
            the relevant positions ignored.
\on\exs
Examples:
\ex
            MERGE/ECHELLE extr1 spec1 3. AVERAGE
\xe \sxe