% @(#)fixpixccd.hlq	17.1.1.1 (ESO-SDAG) 01/25/02 17:48:53
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1993 European Southern Observatory
%.IDENT      fixpixccd.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, ccd package, FIXPIX/CCD
%.PURPOSE    On-line help file for the command: FIX/CCD
%.VERSION    930329 RHW created
%---------------------------------------------------------------------
\se
SECTION./CCD
\es\co
FIXPIX/CCD                                                      31-Mar-1993 RHW
\oc\su
FIXPIX/CCD [in_fram] [out_fram] [fix_table] [fix_meth]
	Do a correction of bad pixels in the input frame
\us\pu
Purpose:    
	Do a correction of bad pixels in the input frame
\up\sy
Syntax:     
	FIXPIX/CCD [in_fram] [out_fram] [fix_table] [fix_meth]
\ys\pa
	in_fram =  input frame to be corrected; default is the name stored in
                   the keyword CCD_IN.
\ap\pa
	out_fram = output frame after correction has been applied; no default.
                   the name stored in the keyword CCD_OUT.
\ap\pa                 
	fix_table= MIDAS table containing the bad pixels. The format of the 
                   table is dependent of which correction option is used. It 
                   should contain the following columns with the coordinate 
                   information (in world coordinate units):\\
                   for option `A' columns :XSTART, :YSTART, :XEND and :YEND;\\
                   for option `P' columns :XSTART, :YSTART, :XEND and :YEND;\\
                   for option `C' column :X\\ 
                   for option `R' column :Y\\
                   The default table name is the one stored in the CCD keyword 
                   FX_TABLE.
\ap\pa
        fix_meth = method to be applied for fixing the bad pixels. The option 
                   is derectly related withg the MIDAS coomand that will be
                   used for the correction. Possible choises are:\\    
                   `AREA':   for applying the command MODIFY/AREA;\\
                   `PIXEL':  for applying the command MODIFY/PIXEL.\\
                   `COLUMN': for applying the command MODIFY/COLUMN;\\
                   `ROW':    for applying the command MODIFY/ROW;\\
                   The default option is the one stored in the CCD keyword 
                   FX_METH.
\ap\no
Note:   
        A number of additional parameters values are needed if order to make
        the correction succesful. These additional parameters are obtained 
        from the CCD keyword structure; the number and their meaning depend 
        on the option (method) that will be used. Below follows the possible 
        options, the corresponding MODIFY commands used, the parameters needed
        and the keywords where the parameters are expected to be stored 
        (using SET/CCD)\\
        method `A' (MODIFY/AREA): parameter `degree';          FX_FPAR(1)\\ 
                                  parameter `constant'=0;      no keyword;\\
        method `P' (MODIFY/PIX):  parameter `arfacts';         FX_FACT\\
                                  parameter `xdeg,ydeg,niter'; FX_FPAR\\
                                  parameter `noise';           FX_NOISE.\\
        method `C' (MODIFY/COL):  parameter `col_type'=V;      no keyword;\\
        method `R' (MODIFY/ROW):  parameter `row_type'=V;      no keyword;\\

        The command will not try to correct the input frame if that has already
        been done. After the command has finished the descriptor CCDSTAT in 
        the output frame is updated to indicated that the bad pixel correction
        has been applied.\\

        A bad pixel table can, if not provided with the instrument setting, 
        can be created by the command GET/CURSOR, using the cursor option for 
        one or two cursors.\\
\on\see
See also:   
	MODIFY/AREA, MODIFY/COLUMN, MODIFY/ROW, MODIFY/PIXELS,\\ 
        GET/CURSOR, SET/CCD, SHOW/CCD, LOAD/CCD, REDUCE/CCD
\ees\exs
Examples:
\ex
	FIXPIX/CCD amsterdam rotterdam P groningen
	Fix the bad pxiels in the ccd frame amsterdam using the command
        MODIFY/PIXELS and the input bad pixel table groningen. The output
        frame will be rotterdam.
\xe \sxe