% @(#)testt1ccd.hlq	17.1.1.1 (ESO-SDAG) 01/25/02 17:49:46
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1994 European Southern Observatory
%.IDENT      testt1ccd.hlq
%.AUTHOR     RHW, SDAG/ESO
%.KEYWORDS   MIDAS, ccd package, linearity, CCD testing
%.PURPOSE    On-line help file for the command: TESTT1/CCD
%.VERSION    940620 RHW created
%.VERSION    940817 RHW Split in single procedures
%---------------------------------------------------------------------
\se
SECTION./CCD
\es\co
TESTT1/CCD                                                      14-Jul-1994 RHW
\oc\su
TESTT1/CCD in_cat [out_id] [area] [option]
	Display the linearity and transfer curves of pairs of flat frames.
\us\pu
Purpose:    
	Display the linearity and transfer curves of pairs of flat frames.
\up\sy
Syntax:     
	TESTT1/CCD in_cat [out_id] [area] [option]
\ys\pa
        in_cat =  input (with the extension .cat) catalogue of frames to be 
                  combined. The catalogues in assumed to contain a number of
                  pairs of frames with equal exposure times. The pairs should
                  be obtained at various exposure times. Therefore, there 
                  should be an even number (> 0) of entries in the catalogue.
                  The first frames in each set will belong to the group
                  "frames 1"; the second frames to group "frames 2".\\
                  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 TRANS.
\ap\pa
        area =    area of the input frame in which the data should be taken 
                  for the median and variance determinations. Default is whole
                  image area.
\ap\pa  
        option =  Option to enable overwriting of existing combined bias frame.
                  Default is `N' (i.e. no overwrite). 
\ap\no
Note:
        This command requires a value for the mean bias level in the keyword 
        BIASMEAN to be filled and hence should be executed after the command 
        TESTBA/CCD or TESTB5/CCD. If no value or the value zero is found no 
        bias offset will be subtracted.
\\
        The command will creation of the transfer/linearity table.\\
        The table will contain 5 columns: column 1 for the exposure time of 
        the first of each sets (frames 1) (label :Exp_tim1); column 2 the 
        exposure time of the second frames (frames 2) (:Exp_tim2); column 3 
        the median pixel intensities over the selected frame sections in 
        frames 1 (:Med_cnt1); column 4 the median pixel intensities over the 
        selected area in frames 2 (:Med_cnt2) ; column 5 the variance of the 
        difference of the frames 1 and 2 (:Variance). 
\\
        To avoid unnecessary computations the command checks for the presence 
        of the linearity table and will not created a new one if it is present,
        provided the option switch in `N'.
\\
        The full linearity and transfer test is done by the command TESTTA/CCD.
\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'.tbl        MIDAS table containing exposure times, median
                               counts rates, etc, used for the analysis.
           `out_id'_table.txt: table listing;\\
           `out_id'_lin1.ps:   postscript plot with lin. tests using all 
                               data;\\
\po\see
See also:   
        TESTTn/CCD, TESTBA/CCD, SET/CCD, SHOW/CCD
\ees\exs
Examples:
\ex
        TESTT1/CCD efosc.cat TRANS [@900,@900:@1100,@1100]
        Run the complete test procedure on frames in the catalogue efosc.cat. 
        Create a table with all frames include and sort the table according
        to increasing exposure time. Then plot the exposure sequence, the 
        linearity and the transfer curves.
\xe \sxe