% @(#)testbaccd.hlq 17.1.1.1 (ESO-SDAG) 01/25/02 17:49:45 %++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ %.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