% @(#)integraper.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:11:28 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      integraper.hlq
%.AUTHOR     Ch. Ounnas, IPG/ESO
%.KEYWORDS   MIDAS, help files, INTEGRATE/APERTURE
%.PURPOSE    On-line help file for the command: INTEGRATE/APERTURE
%.VERSION    1.0  ??????: ChO Creation, 
%.VERSION    2.0  900801: RHW completely rewritten
%----------------------------------------------------------------
\se
SECTION./APER
\es\co
INTEGRATE/APERTURE                                              01-AUG-1990 RHW
\oc\su
INTEGRATE/APERTURE [in_specs] [out_tab] [radius]
	integrate the flux within an aperature
\us\pu
Purpose:    
            Compute integrated flux inside an aperture with a certain radius
\up\sy
Syntax:     
            INTEGRATE/APERTURE [in_specs] [out_tab] [radius]
\ys\pa
            in_specs = input specifications. Can be CURSOR, if the subimages 
                       are interactively chosen via the cursor rectangle, or 
                       frame, table if the subimages are defined in a table in
                       the columns labelled :X_COORD, :Y_COORD. In the case no 
                       image display/window is needed. Default is CURSOR.
\ap\pa
            out_tab  = output table if you want to store the results in a table
                       The table will contain: x, y, radius, no of pixels, 
                       flux, background and magnitude in the columns :X_COORD, 
                       :Y_COORD, :RADIUS, :NPIX, :FLUX, :BGSB and :MAG.
                       Default no output table is created.
\ap\pa
            radius   = value in user unit to define the radius size of the 
                       aperture. This value can be defined for both input
                       specifications. By default no radius is defined. This
                       can only be used if the interactive mode is selected.
\ap\no
Note:       
            The command does not compute the background level. If descriptor
            'BACKGROUND' exists the value of this descriptor is taken into 
            account. In case the descriptor is non-existing the background is 
            assumed to be 0.
\\
            The flux of the objects after sky background must be positive. 
            If not the command will fail and will output zeros. I
\\     
            The cursor operation depends on the image display in use. 
            Consult Appendix D in the MIDAS Users Guide Volume A.
\on\exs
Examples:
\ex
            INTEGRATE/APERTURE
            Use cursor to define subimages and display the results
            on the terminal only
\xe\ex
            INTEGRATE/APERTURE CURSOR VALUES
            as above but write also the results in the table VALUES
\xe\ex
            INTEGRATE/APERTURE CURSOR VALUES R
            as above but set the radius of the aperture to R
\xe\ex
            INTEGRATE/APERTURE CCD001,SOURCES ? R
            use columns :X_COORD and :Y_COORD of table SOURCES (created by
            GET/CURSOR for example) to define the centers of the apertures
            compute the flux in the image CCD001 and just display results.
            NOTE : No display being used, the radius R is needed.
\xe\ex
            INTEGRATE/APERTURE CCD001,SOURCES VALUES R
            as above but the results are stored also in the table VALUES
\xe \sxe