ficonv - obtaining and evaluating convolution transformations
ficonv [options] [-r <reference>]
[-i <input>] [-o <output>]
The purpose of this program is twofold. First, using a reference
and input FITS image, the program tries to figure out the best-fit
convolution kernel which transforms the reference image to the input image.
The convolution kernel solution is saved as a separate, human-readable file.
Second, using an existing such kernel solution file, `ficonv` convolves the
reference image and optionally co-adds an additional image to the result.
The program figures out the desired mode (i.e. whether to fit a convolution
kernel or use an existing kernel solution to convolve an image) from the
presence or lack of the command line options.
- -h, --help
- Gives general summary about the command line options.
- --long-help,
--help-long
- Gives a detailed list of command line options.
- --wiki-help,
--help-wiki, --mediawiki-help,
--help-mediawiki
- Gives a detailed list of command line options in Mediawiki format.
- --version,
--version-short, --short-version
- Gives some version information about the program.
- -r, --reference,
--input-reference <image file>
- Name of the reference FITS image file.
- -i, --input <image
file>
- Name of the input FITS image file (required only for kernel fitting).
- -k, --kernel,
--kernels <kernel set>
- List of kernel bases used for fitting convolution kernel.See also
"Kernel specifications" below for the format of this <kernel
set> argument.
- --input-kernel-list
<file>
- Name of the file containing kernel bases. The kernel bases in this file
should have no associated coefficients if convolution fitting is done,
otherwise the kernel basis file must contain the convolution
coefficients
- --output-kernel-list
<file>
- Name of the file where the coefficients for the kernel bases are stored
after convolution kernel fitting
- -o, --output,
--output-convolved <image file>
- Name of the output file which is the reference image convolved with the
kernel solution (which can either be a previously fitted and now read from
a file or the result of the current fit)
- --output-subtracted
<image file>
- The difference between the input image and the convolved reference
image.
- -a, --add-to <image
file>
- This optionally specified file is added to the convolved image
- -M, --input-mask
<fits>
- Input mask file to co-add to output image mask.
- -n, --iterations
<iterations>
- Use an iterative fit with the rejection of the outlier pixels.The maximum
number of iterations should be specified with this command line
argument
- -s, --rejection-level
<sigma>
- Rejection level in standard deviation units.
- i/<spatial
order>
- identity kernel (a.k.a. "flux term") with the specified order of
polynomial spatial variations
- b/<spatial
order>
- constant offset kernel (a.k.a. "background term") with the
specified order of polynomial spatial variations
- d=<size>/<spatial
order>
- discrete kernel with the half-size of <size> and the specified order
of polynomial spatial variations
- g=<size>,<sigma>,<order>/<spatial
order>
- Gaussian kernel with the half-size of <size>, standard deviation of
<sigma> and Hermite basis order of <order>, with the specified
order of polynomial spatial variations
Report bugs to <apal@szofi.net>, see also
https://fitsh.net/.
Copyright © 1996, 2002, 2004-2008, 2010-2016, 2018-2020;
Pal, Andras <apal@szofi.net>