% @(#)testbaccd.hlq	19.1 (ESO-SDAG) 02/25/03 14:16:56
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1994 European Southern Observatory
%.IDENT      testbaccd.hlq
%.AUTHOR     RHW, SDAG/ESO
%.KEYWORDS   MIDAS, ccd package, bias, testing
%.PURPOSE    On-line help file for the command: TESTBA/CCD
%.VERSION    940620 RHW created
%.VERSION    950210 RHW txt output eleiminated; printed info reduced
%---------------------------------------------------------------------
\se
SECTION./CCD
\es\co
TESTBA/CCD                                                      20-Jun-1994 RHW
\oc\su
TESTBA/CCD in_cat [out_id] [meth] [row_ran] [col_ran] [area] [size,fac]
	Do a series of tests of a catalogue of bias frames
\us\pu
Purpose:    
	Do a series of tests of a catalogue of bias frames
\up\sy
Syntax:     
	TESTBA/CCD in_cat [out_id] [meth] [row_ran] [col_ran] [area] [size,fac]
\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 BIAS.
\ap\pa 
        meth    = combining method for creation of the master bias frame.
                  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 cliping method. In case a
                  clipping algoritms is used the CCD keyword BS_CLP will 
                  be read to get the clipping factors.
\ap\pa
        row_ran = Range of rows in the master bias frames to be averaged.
                  Default is all rows.
\ap\pa
        col_ran = Range of columns in the master bias frames to be averaged.
                  Default is all columns.
\ap\pa
        area =    area which the hot pixels will be determined. Reducing the
                  area will increase the speed of the execution. Default is 
                  whole image area.
\ap\pa
        size,fact = size of smoothing box used for median filtering and
                  decimation factor for frame size reduction. Default is 5,16.
                  Median filtering is applied on the master bias frame for 
                  obtaining the hot pixels. The efault size 5 for the 
                  filtering implies a filtering over boxes of 11 by 11 pixels.
\ap\no
Note:
        This command should be the first command to be executed for a 
        complete test of the CCD characteristics, and should be followed by
        the command TESTFA/CCD (test of low count flat fields).\\
\\
        The command will do the following tests on the frame in the input 
        catalogue:\\
        Test B1: Creation of the combined bias frame. The result is loaded 
                 onto the display.
\\
        Test B2: Find the hot pixels. The combined bias frame is median 
                 filtered (using the parameter `fil_siz') and subtracted 
                 from the original. A plot is generated showing the 
                 position of the hot pixels and the affected columns. Hot 
                 pixels will only be searched for within the requested area
                 and above the intensity level of (mean + 0.25*sigma + 5.),
                 where mean is the mean int level, simga is the standard 
                 deviation. 
\\
        Test B3: Inspection of single frames. From the combined bias frame 
                 rows and columns are averaged and plotted.
\\
        Test B4: The last frame in the catalogue is first corrected for 
                 hot pixels and then rebinned. A histogram of this rebinned
                 frame is made.
\\
        Test B5: For each input frame in the catalogue determine the mean 
                 bias and standard deviation after hot pixel correction 
                 (using the hot pixel table determined in test B2), box  
                 averaging and median filtering. The keyword BIASMEAN 
                 and BIASSIGM are filled with the average values for the 
                 mean and sigma.
\\
        To avoid unnecessary computations the command checks for the presence 
        of the combined bias frame and the median filtered hot pixel frame 
        and does not recompute these frames if they are already present. In 
        the case of subtests the command will (re)created these output frames.
\\
        Single tests on the bias frames can be executed using the commands 
        TESTBn/CCD with n = 1,2,3,4 or 5.
\\ 
        For more details about the various combining methods, please refer 
        to the CCD Chapter in Volume B of the ESO-MIDAS Users' Guide.
\on\op
Output: 
        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 bias frame;\\
           `out_id'.ps:         postscript file with an image of the combined 
                                bias frame;\\
           `out_id'_hotpix.tbl: MIDAS table containing the hot pixels;\\
           `out_id'_hotpix.ps:  postscript file with a plot of the hot pixels\\
           `out_id'_avcol.bdf:  MIDAS image containing the column average;\\
           `out_id'_avrow.bdf:  MIDAS image containing the row average;\\
           `out_id'_aver.ps:    postscript file with the plots of the column
                                and row average;\\
           `out_id'_hist.ps:    postscript file with a plot of the histogram;\\
           `out_id'_rebin.bdf:  cleaned and rebinned combined bias frame;\\
           `out_id'_rebin.ps:   postscript file with an image of the above;\\
           `out_id'_mean.tbl:   MIDAS table with the mean and standard 
                                deviation valuesb of the single bias frames.
\\
        The keywords BIASMEAN, BIASSIGM are filled with the mean bias and its 
        standard deviation.
\po\see
See also:   
        TESTBn/CCD, SET/CCD, SHOW/CCD, COMBINE/CCD, AVERAGE/ROW, 
        AVERAGE/COLUMN, FILTER/MEDIAN, Ch. 3 in Vol. 2 of the Users Guide.
\ees\exs
Examples:
\ex
        TESTBA/CCD bs_cat.cat BS median ? 350,500 [@900,@900:@1100,@1100]
        Run the test procedure on the frame in the catalogue bs_cat. Combine
        the frame in a master frame BS using a median filter. All output
        will start with the identifier BS. Do averaging over all rows
        and over the column range from 350 to 500. Use the defaults for 
        median filter box and decimation factor.
\xe \sxe



