NAME

       ficonv - obtaining and evaluating convolution transformations

SYNOPSIS

       ficonv [options] [-r <reference>] [-i <input>] [-o <output>]

DESCRIPTION

       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.

OPTIONS

   General 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, --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 <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 <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 <file>
              Name of the file where the coefficients for the kernel bases are stored after  convolution  kernel
              fitting

       -o, -oc, --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.

   Kernel specifications (each separated with a semi-colon,  ;"):"
       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

REPORTING BUGS

       Report bugs to <apal@szofi.net>, see also http://fitsh.net/.

COPYRIGHT

       Copyright © 1996, 2002, 2004-2008, 2010-2015; Pal, Andras <apal@szofi.net>

ficonv 0.4 (0.9.2@2016.09.23)                    September 2016                                        FICONV(1)