Debian Codegraph @

upstream/debian-unstable/man1/pgmabel.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pgmabel User Manual" 1 "June 2002" "netpbm documentation"
7
8 .SH NAME
9 pgmabel - create cross section using Abel Integration for Deconvolution
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpgmabel\fP
15 [\fB-help\fP]
16 [\fB-axis\fP \fIaxis\fP]
17 [\fB-factor\fP \fIfactor\fP]
18 [\fB-pixsize\fP \fIpixsize\fP]
19 [\fB-left\fP | \fB-right\fP]
20 [\fB-verbose\fP]
21 [\fIfilespec\fP]
22
23 .UN description
24 .SH DESCRIPTION
25 .PP
26 This program is part of
27 .BR "Netpbm" (1)\c
28 \&.
29 .PP
30 \fBpgmabel\fP reads as input a PGM image, which it assumes to be an
31 image of a rotational symmetric transparent object. The image must have
32 a vertical symmetry axis. \fBpgmabel\fP produces as output an image of
33 a cross-section of the image.
34
35 \fBpgmabel\fP does the calculation by performing the Abel Integration
36 for Deconvolution of an axial-symmetrical image by solving the system
37 of linear equations.
38
39 After integration, \fBpgmabel\fP weights all gray-values of one side
40 by the surface area of the calculated ring in square pixels divided by
41 4*\fIfactor\fP multiplied by the size of one pixel (\fIpixsize\fP).
42 With the \fB-verbose\fP option, \fBpgmabel\fP prints the weighting
43 factors.
44 .PP
45 Where the calculation generates a negative result, the output is black.
46 .PP
47 The computation is unstable against periodic structures with size 2 in
48 the vertical direction.
49
50 .UN options
51 .SH OPTIONS
52 .PP
53 In addition to the options common to all programs based on libnetpbm
54 (most notably \fB-quiet\fP, see
55 .UR index.html#commonoptions
56 Common Options
57 .UE
58 \&), \fBpgmabel\fP recognizes the following
59 command line options:
60 .PP
61 You can abbreviate any option to its shortest unique prefix.
62
63
64
65 .TP
66 \fB-help\fP
67 Prints a help message.
68
69 .TP
70 \fB-axis\fP \fIaxis\fP
71 Position of the axis of symmetry in the image in pixels from the left
72 edge of the image. Default is the center of the image.
73
74 .TP
75 \fB-factor\fP \fIfactor\fP
76 User defined factor for enhancement of the output. Use a \fIfactor\fP
77 less than 1 for decreasing gary values. Default is 1.0.
78
79 .TP
80 \fB-pixsize\fP \fIpixsize\fP
81 The size of a pixel for getting scale invariant. Default is 0.1.
82
83 .TP
84 \fB-left\fP
85 Calculate only the left side of the image. You cannot specify both
86 \fBleft\fP and \fBright\fP.
87
88 .TP
89 \fB-right\fP
90 Analogous to \fB-left\fP.
91
92 .TP
93 \fB-verbose\fP
94 print information about the calculation.
95
96
97
98 .UN example
99 .SH EXAMPLE
100 .PP
101 Rotate a PGM image to get an image with a vertical axis of symmetry,
102 then calculate the cross section:
103
104 .nf
105 pnmrotate 90 file.pgm | pgmabel -axis 140 >cross_section.pgm
106
107 .fi
108
109 .UN seealso
110 .SH SEE ALSO
111 .BR "pnmrotate" (1)\c
112 \&,
113 .BR "pgm" (1)\c
114 \&,
115
116 .UN history
117 .SH HISTORY
118 .PP
119 This program was added to Netpbm in Release 10.3 (June 2002).
120
121 .UN author
122 .SH AUTHOR
123 .PP
124 Volker Schmidt ([email protected])
125 .PP
126 Copyright (C) 1997-2002 German Aerospace research establishment
127 .SH DOCUMENT SOURCE
128 This manual page was generated by the Netpbm tool 'makeman' from HTML
129 source. The master documentation is at
130 .IP
131 .B http://netpbm.sourceforge.net/doc/pgmabel.html
132 .PP