colbias: Fit and subtract an average column bias
Package: bias
Usage
colbias input output
Parameters
- input
- Images to be bias subtracted. The images may not contain image sections.
- output
- Output bias subtracted images. An output images may be the same as its matching input image. The output pixel type will be real regardless of the input pixel type.
- bias = "[]"
- Bias section appended to the input image to define the bias region. The default section or an empty string will use the full image.
- trim = "[]"
- Trim section appended to the input image to define the region to be bias subtracted and output. The default section or an empty string will use the full image.
- median = no
- Take the median of the bias columns? If no then the bias columns are averaged.
- function = "spline3"
- The function fit to the average bias line. The functions are "legendre", "chebyshev", "spline1", or "spline3". Abbreviations are allowed.
- order
- The order (number of terms or number of spline pieces) in the function.
- low_reject = 3.0
- The low sigma rejection factor.
- high_reject = 3.0
- The high sigma rejection factor.
- niterate = 1
- The maximum number of rejection iterations.
- interactive = yes
- Fit the average bias line interactively?
- logfiles = ""
- List of log files. If no file name is given then no log file is kept.
- graphics = "stdgraph"
- Graphics output device for interactive graphics.
- cursor = ""
- Graphics cursor input
Description
For each input image in the input image list an average or median bias column is determined from the bias region. The bias region is defined by the bias section applied to the input image. A function of the image lines is fit to the average bias column. This function is subtracted from each image column in the trim region. The trim region is defined by the trim section applied to the input image. The bias subtracted and trimmed image is output to the output image. The input and output images may not contain sections and the number of images in each list must be the same.
If the interactive flag is set then the user may interactively examine and fit the average bias column. The interactive fitting is done using the interactive curve fitting routine (see icfit). Before each image is processed a prompt of the form "colbias image (yes)? " is given. A response of yes allows interactive fitting for the specified image while a response of no uses the last defined fitting parameters. The default value is accepted with a carriage return. The possible responses are "yes", "no", "YES", or "NO". The capitalized responses permanently set the response to yes or no and the prompt is not issued again for the remaining images. Thus, a response of NO processes the remaining images non-interactively while a response of YES processes the remaining image interactively without prompting.
Examples
The bias region for a set of images occupies columns 801 to 832 and lines 1 to 800. To subtract the bias and remove the bias region:
cl> colbias.bias = "[801:832,*]"
cl> colbias.trim = "[1:800,*]"
cl> colbias ccd* ccd*
colbias ccd001 (yes)? yes
colbias ccd002 (yes)?
colbias ccd003 (no)? NO
The first two lines set the bias and trim parameters. These parameters could be temporarily set on the command line but generally these parameters are only changed when new instruments are used. The first image is interactively fit and the fitting order is change to 2. The second image is examined and the fit found to be acceptable. All remaining image are then fit non-interactively using the same fitting parameters.
Revisions
- COLBIAS V2.10.3
- The output pixel type is now real instead of preserving the pixel type of the input image.
See also
icfit