File: hugin_stacker.pod

package info (click to toggle)
hugin 2024.0.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 32,568 kB
  • sloc: cpp: 127,783; ansic: 6,263; python: 1,156; perl: 701; xml: 150; sh: 64; makefile: 29
file content (124 lines) | stat: -rwxr-xr-x 2,711 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
=head1 NAME

hugin_stacker - stack overlapping images to a single image

=head1 SYNOPSIS

B<hugin_stacker> [options] --mode=STRING images

=head1 DESCRIPTION

B<hugin_stacker> acts on a stack of overlapping images and produces a combined image
and/or a set of masked output images.

B<hugin_stacker> is useful for e.g.

=over

=item * automatic tourist removal (not only tourists, also other moving
objects ;-))

=item * noise reduction

=item * visualize movement

=item * multiplicity

=back

=head1 OPTIONS

=over

=item B<--mode>

Select stack mode:

=over

=item B<min|minimum|darkest>

Select the darkest pixel.

=item B<max|maximum|brightest>

Select the brightest pixel.

=item B<avg|average|mean>

Calculate the mean for each position.

=item B<median>

Calculate the median for each position.

=item B<winsor>

Calculate the Winsor trimmed mean for each position.
The parameter can be set with B<--winsor-trim=NUMBER> (default: 0.2).

=item B<sigma>

Calculate the sigma clipped mean for each position.
Fine-tune with B<--max-sigma=NUMBER> (default: 2)
and B<--max-iterations=NUMBER> (default: 5).

=back

=back

=head2 Further parameters

=over

=item B<--output=FILE>

Set the filename for the output file (if not given final.tif is used).

=item B<--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.

=item B<--bigtiff>

Write output in BigTIFF format (only with TIFF output).

=back

=head2 Mask input images

=over

=item B<--mask-input>

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 first
calculated. 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.

=item B<--mask-sigma=NUMBER>

sets the sigma parameter for --mask-input. Default is 2.

=item B<--mask-suffix=STRING>

Output a separate mask image for each input image named I<inputfilenameSTRING>.
Default value is "_mask".

=item B<--multi-layer-output>

Output a layered TIFF with the name specified
with B<--output>. The file contains the averaged image as layer 0 and all input images
as additional layers with the mask as described above.

=back

=head1 AUTHORS

POD-format documentation converted from L<https://wiki.panotools.org/Hugin_stacker> by
Andreas Metzler