% @(#)integrstar.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:11:29 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      integrstar.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, INTEGRATE/STAR
%.PURPOSE    On-line help file for the command: INTEGRATE/STAR
%.VERSION    1.0  31-JUL-1990 : Creation, RHW
%----------------------------------------------------------------
\se
SECTION./STAR
\es\co
INTEGRATE/STAR                                                  31-JUL-1990 RHW
\oc\su
INTEGRATE/STAR [in_specs] [out_tab] [parameters] [mode]
	computes flux, radius and background of stars previously centered
\us\pu
Purpose:    
            Computes flux, radius and background of stars previously centered
\up\sy
Syntax:     
            INTEGRATE/STAR [in_specs] [out_table] [parameters] [mode]
\ys\pa
            in_specs =   input specifications. Can be CURSOR, if the objects 
                         are interactively chosen with the display cursor, or 
                         frame,table if the objects are defined in a table. In
                         the latter case no image display/window is required.
                         The table should have two columns labeled X_COORD and 
                         Y_COORD. It can be created by the commands GET/GCURSOR
                         and GET/CURSOR. Default input is CURSOR.
\ap\pa
            out_table =  output table if you want to store the results in a 
                         table. The table will contain: x, y, flux, magnitude, 
                         and background in the columns :X_COORD, :Y_COORD, 
                         :FLUX, :BGSB, and :MAG. Default no output table will 
                         be created, and results appear on the screen.
\ap\pa
            parameters = radius,step,ref_magnitude (defaulted to 20,1,0), where
                         radius is the maximum radius in pixels of the aperture;
                         step is the step in pixels between 2 annuli;
                         ref_magnitude is the magnitude of the reference star.
\ap\pa
            mode =       AUTO or INTERACTIVE; only applicable if in_spec is 
                         given frame,table as input. default INTERACTIVE. In 
                         the interactive mode the graphics display/window 
                         should be available.
\ap\no
Note:       The command computes the (stellar) object magnitude according to 
            the following receipe. The algorithm is based on determination 
            of the parameters in a single line through the (stellar) object, 
            not on a two-dimenional approch.\\
\\
            1.  First, the image pixel values are sorted and put in a table, 
            running from low to high values.\\
            2.  From the lowest 4 values in this table a first order average 
            sky background and standard deviation (sigma) is computed;\\
            3.  Then, the algorithm looks for the table value which falls 
            between sky average and average + sigma/2;\\
            4.  Depending where in the table this value is found the average 
            sky value and sigma are adjusted to determine the final values;\\
            5.  The radius of the object is then computed considering only 
            those points above sky average + 6*sigma.\\
\\
            Because the one-dimensional approch results obtained from less
            than 10 pixel values should be considered to be unreliable. In most
            case a error message will be given.
\on\exs
Examples:
\ex
            INTEGR/STAR ? rfotout
	    Compute interactively the fluxes in frame loaded using the image 
            and graphics display. The command will run in INTERACTIVE mode.
\xe\ex
            INTEGR/STAR rfot,rfotpos rfotout 5,1,0 AUTO
            Use columns :X_COORD and :Y_XCOORD of the table rfotpos (e.g. 
            created by GET/CURSOR) to define the centers of the objects for
            which the fluxes are to be computed. The results will be stored in 
            the table rfotout. The command runs in automatic mode and uses 
            non-default values for the radius, step, and reference magnitude.
\xe \sxe