Plan 9 from Bell Labs’s /usr/web/sources/contrib/pac/sys/doc/netpbm/ms/pgmabel.ms

Copyright © 2021 Plan 9 Foundation.
Distributed under the MIT License.
Download the Plan 9 distribution.


.TL
Pgmabel User Manual
.SH 1
pgmabel
.LP
Updated: June 2002
.br
Table Of Contents
.SH 2
NAME
.LP
pgmabel - create cross section using Abel Integration for Deconvolution
.SH 2
SYNOPSIS
.LP
\fBpgmabel\fR
[\fB-help\fR]
[\fB-axis\fR \fIaxis\fR]
[\fB-factor\fR \fIfactor\fR]
[\fB-pixsize\fR \fIpixsize\fR]
[\fB-left\fR | \fB-right\fR]
[\fB-verbose\fR]
[\fIfilespec\fR]
.LP
You can abbreviate any option to its shortest unique prefix.
.SH 2
DESCRIPTION
.LP
.LP
This program is part of Netpbm.
.LP
\fBpgmabel\fR reads as input a PGM image, which it assumes to be an
image of a rotational symmetric transparent object.  The image must have
a vertical symmetry axis.  \fBpgmabel\fR produces as output an image of
a cross-section of the image.
\fBpgmabel\fR does the calculation by performing the Abel Integration
for Deconvolution of an axial-symmetrical image by solving the system
of linear equations.
After integration, \fBpgmabel\fR weights all gray-values of one side
by the surface area of the calculated ring in square pixels divided by
4*\fIfactor\fR multiplied by the size of one pixel (\fIpixsize\fR).
With the \fB-verbose\fR option, \fBpgmabel\fR prints the weighting
factors.
.LP
Where the caculation generates a negative result, the output is black.
.LP
The computation is unstable against periodic structures with size 2 in
the vertical direction.
.SH 2
OPTIONS
.LP
.RS
.IP "\fB-help\fR"
Prints a help message.
.IP "\fB-axis\fR \fIaxis\fR"
Position of the axis of symmetry in the image in pixels from the left
edge of the image.  Default is the center of the image.
.IP "\fB-factor\fR \fIfactor\fR"
User defined factor for enhancement of the output.  Use a \fIfactor\fR
less than 1 for decreasing gary values.  Default is 1.0.
.IP "\fB-pixsize\fR \fIpixsize\fR"
The size of a pixel for getting scale invariant.  Default is 0.1.
.IP "\fB-left\fR"
Calculate only the left side of the image.  You cannot specify both
\fBleft\fR and \fBright\fR.
.IP "\fB-right\fR"
Analogous to \fB-left\fR.
.IP "\fB-verbose\fR"
print information about the calculation.
.RE
.SH 2
EXAMPLE
.LP
.LP
Rotate a PGM image to get an image with a vertical axis of symmetry,
then calculate the cross section:
.DS L
    pnmrotate 90 file.pgm | pgmabel -axis 140 >cross_section.pgm
.DE
.SH 2
SEE ALSO
.LP
\fBpnmrotate\fR,
\fBpgm\fR,
.SH 2
HISTORY
.LP
.LP
This program was added to Netpbm in Release 10.3 (June 2002).
.SH 2
AUTHOR
.LP
.LP
Volker Schmidt (lefti@voyager.boerde.de)
.LP
Copyright (C) 1997-2002 German Aerospace research establishment
.br
\l'5i'
.SH 2
Table Of Contents
.LP
.IP \(bu
NAME
.IP \(bu
SYNOPSIS
.IP \(bu
DESCRIPTION
.IP \(bu
OPTIONS
.IP \(bu
EXAMPLE
.IP \(bu
SEE ALSO
.IP \(bu
HISTORY
.IP \(bu
AUTHOR
.LP

Bell Labs OSI certified Powered by Plan 9

(Return to Plan 9 Home Page)

Copyright © 2021 Plan 9 Foundation. All Rights Reserved.
Comments to webmaster@9p.io.