% @(#)testf1ccd.hlq	17.1.1.1 (ESO-SDAG) 01/25/02 17:49:46
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1994 European Southern Observatory
%.IDENT      testf1ccd.hlq
%.AUTHOR     RHW, SDAG/ESO
%.KEYWORDS   MIDAS, ccd package, flat, testing
%.PURPOSE    On-line help file for the command: TESTF1/CCD
%.VERSION    940620 RHW created
%.VERSION    940816 RHW split into single subroutines
%---------------------------------------------------------------------
\se
SECTION./CCD
\es\co
TESTF1/CCD                                                      20-Jun-1994 RHW
\oc\su
TESTF1/CCD in_cat [out_id] [meth] [area] [exp_ran] [option]
	Combine the flat frame in the input catalogue and display
\us\pu
Purpose:    
	Combine the flat frame in the input catalogue and display
\up\sy
Syntax:     
	TESTF1/CCD in_cat [out_id] [meth] [area] [exp_ran] [option]
\ys\pa
        in_cat =  input (with the extension .cat) catalogue of frames to be 
                  combined; no default.
\ap\pa 
        out_id =  output identifier for the output of the test prodedure. 
                  All output (i.e. frames, listings and plots) will start 
                  with this identifier. Default is FLAT.
\ap\pa 
        meth    = combining method for creation of the master low-count-
                  level flat.
                  Possible methods are:
                  sum            - simple sum of all input input images;\\
                  ave(rage)      - combined by averaging;\\
                  median         - combining by medianing each pixel;\\
                  min(reject)    - reject the min value from the average;\\
                  max(reject)    - reject the max value from the average;\\
                  minmax(reject) - reject min and max from the average;\\
                  sig(clip)      - sigma clipping to each pixel;\\
                  avsig(clip)    - sigma clipping with minmax rejection;\\
                  
                  Default is the average sigma clipping method. In case 
                  clipping algoritms are used the keyword FF_CLP will be 
                  read to get the clipping factors.
\ap\pa
        area =    area of the input frames in which the pixels will be 
                  considered. Default is the whole image area.
\ap\pa
        exp_ran = Range of exposure times to be combined into the master 
                  flat field. The exposure time is normally recored in the 
                  descriptor O_TIME(7). Default 0,5 seconds
\ap\pa
        option =  Option to enable overwriting of existing combined flat frame.
                  Default is `N' (i.e. no overwrite). 
\ap\no
Note:
        The command creation of the combined flat frame, using only those flat
        frames in the input catalogue that have exposure times falling within 
        the allowed range. The combined flat is corrected for the bias offset.
        The bias offset is taken from the keyword BIASMEAN filled by the 
        command TESTBA/CCD or TESTB5/CCD. The combined flat is loaded on the 
        display.
\\
        The command will stored the outputs in a number of ascii and 
        postscript files (preceding by the identification string out_id):\\
           `out_id'.bdf:         the combined low count flat;\\
           `out_id'.ps:          postscript file with an image of the combined 
                                 low count flat.
\\
        The command checks for the presence of the combined flat frame and 
        does not recompute the frame if is is already present.
\\
        The full test on the low count flat fields can be executed using the 
        commands TESTFA/CCD.
\\
        For more details about the various combining methods, please refer 
        to the CCD Chapter in Volume B of the ESO-MIDAS Users' Guide.
\on\see
See also:   
        TESTFA/CCD, TESTBA/CCD, SET/CCD, SHOW/CCD, COMBINE/CCD, FILTER/MEDIAN, 
        FIND/PIXEL
\ees\exs
Examples:
\ex
        TESTF1/CCD ff_cat.cat FMASTER median 5,20
        Combine all frames with exposure times between 5 and 20 seconds 
        using the median algorithm. Subtract the bias offset.
\xe \sxe