NAME

linebias -- Fit and subtract an average line bias

USAGE

linebias 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 image pixel type will real regardless of the input image 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 lines? If no then the bias lines 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?

logfile = ""

Name of a log file. If no file name is given then no log file is kept.

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 line 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 columns is fit to the average bias line. This function is subtracted from each image line 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 line. The interactive fitting is done using the interactive curve fitting routine (see icfit). Before each image is processed a prompt of the form "linebias 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 1 to 800 and lines 801 to 832. To subtract the bias and remove the bias region:

	cl> linebias.bias = "[*, 801:832]"
	cl> linebias.trim = "[*, 1:800]"
	cl> linebias ccd* ccd*
	linebias ccd001 (yes)? yes
	linebias ccd002 (yes)?
	linebias 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

LINEBIAS V2.10.3

The output pixel type is now real instead of preserving the pixel type of the input image.

SEE ALSO

icfit