DOKK / manpages / debian 12 / fitsh / ficombine.1.en
FICOMBINE(1) User Commands FICOMBINE(1)

ficombine - combining (most frequently, averaging) a set of images

ficombine [options] <input images> [-o|--output <output>]

The purpose of this program is to combine the input images (with the same sizes) to a single image. This combination refers to a kind of "averaging" for the images, however, other modes are also available.

Gives general summary about the command line options.
Gives a detailed list of command line options.
Gives a detailed list of command line options in Mediawiki format.
Gives some version information about the program.
The name of the output file (omitting or specifing '-' yields the output to be written to stdout).
Incude or exclude the command line of the invoking `ficombine` call. By default, the command line is added into the FITS headers (FI_HSTRY) but if there are enormous amount of input files, one can use --no-history to omit the respective lengthy keywords.
Output pixel data format specification.
Standard FITS output bitpix value.
Input mask file to co-add to output image.

Use the specified mode to combine images.
Ignore (i.e. mask) pixels with negative values.
Use logical "or" combination between masks.
Use logical "and" combination between masks.

The mean value of the pixels.
The median value of the pixels.
The minimum value of the pixels.
The maximum value of the pixels.
Median value after rejecting outliers.
Mean value after rejecting outliers.
Number of iterations to reject outliers.
Outlier limit (lower, upper, both) in standard deviation. Note that setting sigma to some value is equivalent to setting 'lower' and 'upper' to the same value simultaneously.
Truncated mean.
Winsorized mean.
Reject the 'lowest' and 'highest' count of points when computing truncated or winsorized mean. Setting 'discard' to some value is equivalent to setting 'lowest' and 'highest' to this value simultaneously.
Sum of the pixel values.
Sum for the squarers of the pixel values.
Pixel scatter (standard deviation).
Use logical "or" combination between masks.
Use logical "and" combination between masks.
Ignore (i.e. mask) pixels with negative values.
Ignore (i.e. mask) pixels with a zero value.
Ignore (i.e. mask) pixels with positive values.

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>

January 2021 ficombine 0.9.4 (2021.01.24)