1=head1 NAME
2
3hugin_stacker - stack overlapping images to a single image
4
5=head1 SYNOPSIS
6
7B<hugin_stacker> [options] --mode=STRING images
8
9=head1 DESCRIPTION
10
11B<hugin_stacker> acts on a stack of overlapping images and produces a combined image
12and/or a set of masked output images.
13
14B<hugin_stacker> is useful for e.g.
15
16=over
17
18=item * automatic tourist removal (not only tourists, also other moving
19objects ;-))
20
21=item * noise reduction
22
23=item * visualize movement
24
25=item * multiplicity
26
27=back
28
29=head1 OPTIONS
30
31=over
32
33=item B<--mode>
34
35Select stack mode:
36
37=over
38
39=item B<min|minimum|darkest>
40
41Select the darkest pixel.
42
43=item B<max|maximum|brightest>
44
45Select the brightest pixel.
46
47=item B<avg|average|mean>
48
49Calculate the mean for each position.
50
51=item B<median>
52
53Calculate the median for each position.
54
55=item B<winsor>
56
57Calculate the Winsor trimmed mean for each position.
58The parameter can be set with B<--winsor-trim=NUMBER> (default: 0.2).
59
60=item B<sigma>
61
62Calculate the sigma clipped mean for each position.
63Fine-tune with B<--max-sigma=NUMBER> (default: 2)
64and B<--max-iterations=NUMBER> (default: 5).
65
66=back
67
68=back
69
70=head2 Further parameters
71
72=over
73
74=item B<--output=FILE>
75
76Set the filename for the output file (if not given final.tif is used).
77
78=item B<--compression=value>
79
80Set the compression of the output files.
81For jpeg files use values between 0 and 100.
82For tiff files valid values are: PACKBITS, DEFLATE, LZW.
83
84=item B<--bigtiff>
85
86Write output in BigTIFF format (only with TIFF output).
87
88=back
89
90=head2 Mask input images
91
92=over
93
94=item B<--mask-input>
95
96Beside the stacked output hugin_stacker can also mask the
97input images (available only for stacking modes median|winsor|clip). This mode
98is activated with --mask-input. In this case the stacked image is first
99calculated. Then each pixel in each image is checked: if the value of this
100pixel differs more then mask sigma * standard deviation from the mean/median,
101this pixel is made visible. If it is in the mentioned range the pixel is masked
102out.
103
104=item B<--mask-sigma=NUMBER>
105
106sets the sigma parameter for --mask-input. Default is 2.
107
108=item B<--mask-suffix=STRING>
109
110Output a separate mask image for each input image named I<inputfilenameSTRING>.
111Default value is "_mask".
112
113=item B<--multi-layer-output>
114
115Output a layered TIFF with the name specified
116with B<--output>. The file contains the averaged image as layer 0 and all input images
117as additional layers with the mask as described above.
118
119=back
120
121=head1 AUTHORS
122
123POD-format documentation converted from L<https://wiki.panotools.org/Hugin_stacker> by
124Andreas Metzler
125