Difference between revisions of "Hugin stacker"

From PanoTools.org Wiki
Jump to navigation Jump to search
(Added use case)
(→‎Mask input images: Improved description)
 
Line 25: Line 25:
  
 
== Mask input images ==
 
== Mask input images ==
Beside the stacked output hugin_stacker can also mask the input images (available only for stacking modes median|winsor|clip). This mode is activated with <tt>--mask-input</tt>. In this case the stacked images is first calculated. Then each pixel is each pixel is checked: if the value of this pixel differs more then mask sigma * standard deviation from the mean/median, this pixel is made visible. If it is in the mentioned range the pixel is masked out.
+
Beside the stacked output hugin_stacker can also mask the input images (available only for stacking modes median|winsor|clip). This mode is activated with <tt>--mask-input</tt>. In this case the stacked image is calculated first. Then each pixel in each image is checked: if the value of this pixel differs more then mask sigma * standard deviation from the mean/median, this pixel is made visible. If it is in the mentioned range the pixel is masked out.
  
 
The sigma parameter for this step can be changed with <tt>--mask-sigma=NUMBER</tt> (default is 2).
 
The sigma parameter for this step can be changed with <tt>--mask-sigma=NUMBER</tt> (default is 2).
  
You can output a single image for each input image. Set the suffix with <tt>--mask-suffix=STRING</tt> (default is <tt>_mask</tt>).
+
You can output a separate mask image for each input image. Set the suffix with <tt>--mask-suffix=STRING</tt> (default is <tt>_mask</tt>).
Or with the option <tt>--multi-layer-output</tt> you can output a layered TIFF with the name specified with <tt>--output</tt>. The file contains the averaged images as layer 0 and all input images as additional layers with the mask as described above.
+
Or with the option <tt>--multi-layer-output</tt> you can output a layered TIFF with the name specified with <tt>--output</tt>. The file contains the averaged image as layer 0 and all input images as additional layers with the mask as described above.
  
  
 
[[Category:Software:Hugin]]
 
[[Category:Software:Hugin]]

Latest revision as of 19:06, 7 January 2020

hugin_stacker stacks overlapping images to a single image.

The general usage is

 hugin_stacker [options] --mode=STRING images

There are several stack modes (switch --mode) available:

  • min|minimum|darkest: Select the darkest pixel
  • max|maximum|brightest: Select the brightest pixel
  • avg|average|mean: Calculate the mean for each position
  • median: Calculate the median for each position
  • winsor: Calculate the Winsor trimmed mean for each position. The parameter can be set with --winsor-trim=NUMBER (default: 0.2)
  • sigma: Calculate the sigma clipped mean for each position. Fine-tune with --max-sigma=NUMBER (default: 2) and --max-iterations=NUMBER (default: 5)

This is useful for e.g.

  • automatic tourist removal (not only tourists, also other moving objects ;-))
  • noise reduction
  • visualize movement
  • multiplicity

Further parameters

  • --output=FILE: Set the filename for the output file (if not given final.tif is used).
  • --compression=value: Set the compression of the output files
    • For jpeg files use values between 0 and 100
    • For tiff files valid values are: PACKBITS, DEFLATE, LZW

Mask input images

Beside the stacked output hugin_stacker can also mask the input images (available only for stacking modes median|winsor|clip). This mode is activated with --mask-input. In this case the stacked image is calculated first. Then each pixel in each image is checked: if the value of this pixel differs more then mask sigma * standard deviation from the mean/median, this pixel is made visible. If it is in the mentioned range the pixel is masked out.

The sigma parameter for this step can be changed with --mask-sigma=NUMBER (default is 2).

You can output a separate mask image for each input image. Set the suffix with --mask-suffix=STRING (default is _mask). Or with the option --multi-layer-output you can output a layered TIFF with the name specified with --output. The file contains the averaged image as layer 0 and all input images as additional layers with the mask as described above.