% @(#)testb1ccd.hlq	19.1 (ESO-SDAG) 02/25/03 14:16:56
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1994 European Southern Observatory
%.IDENT      testb1ccd.hlq
%.AUTHOR     RHW, SDAG/ESO
%.KEYWORDS   MIDAS, ccd package, bias, testing
%.PURPOSE    On-line help file for the command: TESTB1/CCD
%.VERSION    940620 RHW created
%.VERSION    950210 RHW txt output eliminated; printed info reduced
%---------------------------------------------------------------------
\se
SECTION./CCD
\es\co
TESTB1/CCD                                                      20-Jun-1994 RHW
\oc\su
TEST1/CCD in_cat [out_id] [meth] [option]
	Combine bias frames stored in a catalogue and display it
\us\pu
Purpose:    
	Combine bias frames stored in a catalogue and display it
\up\sy
Syntax:     
	TESTB1/CCD in_cat [out_id] [meth] [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 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
        option =  Option to enable overwriting of existing combined bias frame.
                  Default is `N' (i.e. no overwrite). 
\ap\no
Note:
        This command is the first or a series of test commands on bias frames:
        B1 to B5. The complete test is executed by the command TESTBA/CCD.
\\
        To avoid unnecessary computations the command checks for the presence 
        of the combined bias. If the overwrite option `Y' is used the 
        existing combined bias output frame will be overwritten.
\\
        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;\\
\\
        Keywords BIASMEAN, BIASSIGM are filled with the mean bias and its 
        standard deviation.
\po\see
See also:   
        TESTBA/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
        TESTB1/CCD bs_cat.cat BS median
        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. 
\xe \sxe



