% @(#)testf2ccd.hlq	17.1.1.1 (ESO-SDAG) 01/25/02 17:49:46
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1994 European Southern Observatory
%.IDENT      testf2ccd.hlq
%.AUTHOR     RHW, SDAG/ESO
%.KEYWORDS   MIDAS, ccd package, flat, testing
%.PURPOSE    On-line help file for the command: TESTF2/CCD
%.VERSION    940620 RHW created
%.VERSION    940816 RHW split into single subroutines
%---------------------------------------------------------------------
\se
SECTION./CCD
\es\co
TESTF2/CCD                                                      20-Jun-1994 RHW
\oc\su
TESTF2/CCD in_frm [out_id] [area] [thresh] [option]
	Find the cold pixels in the combined low count flat.
\us\pu
Purpose:    
	Find the cold pixels in the combined low count flat.
\up\sy
Syntax:     
	TESTFA/CCD in_frm [out_id] [area] [thesh] [option]
\ys\pa
        in_frm =  input low count flat field, possibly created using the 
                  command TESTF1/CCD. 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
        area =    area of the input frames in which the pixels will be 
                  considered. Default is the whole image area.
\ap\pa
        thresh  = fraction of the median count rate in the master flat 
                  frame below which intensities are considered to be 
                  generated from cold pixels on the detector. Default is 0.20.
\ap\pa
        option =  Option to enable overwriting the existing median filtering 
                  input frame. Default is `N' (i.e. no overwrite). 
\ap\no
Note:
        The command will list all pixels in the stacked master flat frame that
        show values less than thresh times the median counts in the frame.
        Only pixels within the area contained in `area' are considered and 
        repetitions of cold pixels in the increasing y coordinate are not 
        listed. 
\\
        The command will stored the outputs in a number of ascii and 
        postscript files (preceding by the identification string out_id):\\
           `out_id'_coldpix.tbl: MIDAS table containing the cold pixels;\\
           `out_id'_coldpix.txt: a ascii tablke containing the cold pixels.\\
\\
        The full test on the low count flat field is done by the command 
        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, SET/CCD, SHOW/CCD, FILTER/MEDIAN, FIND/PIXEL
\ees\exs
Examples:
\ex
        TESTF2/CCD FMASTER FMASTER ? 0.20 Y
        Find all cold pixels with less than 20 percent of the median pixel 
        value in the combine flat. Is the input frame was already median 
        filtered overwrite the filtered frame and create a new one.
\xe \sxe