ipm generate IPM vector (or polar image) from Cartesian image
-usage
displays shortform usage string.
-growth_protection
<retrys>
causes the system to retry an
sbrk(2)
call up to
retrys
times. This option permits the program to wait until the core that it requires
is available rather than simply exiting if
sbrk(2)
fails.
-version
displays program version number.
-slots
displays short form
pups(7)
library dependencies.
-slotinfo
displays long form
pups(7)
library dependencies.
-argf
argument_file
tells the filter to take its command line arguments from the specified
argument_file.
The data format of the argument file is:
# ... optional comment line ...
-argflag [1]
argument_parameter [1,1]
argument_parameter [1,2]
argument_parameter [1,n]
# ... optional comment line ...
-argflag [2]
argument_parameter [1,1]
argument_parameter [1,2]
argument_parameter [1,n]
-nice
cardinal
determimes the
niceness
at which the filter is scheduled. In keeping with all UNIX user processes, nice
must be a cardinal between 0 and 20. The default niceness for
ipm(1)
is 4.
-usage
displays program shortform usage.
-version
displays program version number.
-noprogress
tells
ipm(1)
not to output information for the
progress(1)
sdir
sensetive directory
specifies the sensetive directory containing raw imagery to be pre-processed.
-rat
tells
ipm(1)
to weight the value of bins in polar thumbnail space as the square root of their distance from
the fovea.
-theta_bins
bins
specifies the number of angular bins in the output polar image or IPM
vector. Default to 32.
-radius_bins
bins
specifices the number of radius bins in the output polar image or IPM.
Defaults to 32.
-origin
x_origin, y_origin
specifies the co-ordinate about which the (virtual) polar image is generated.
Defaults to the central pixel of the input image.
-write_polar_image
tells
ipm(1)
to produce a polar image (as opposed to an IPM vector).
Default action is produce an IPM vector. Defaults to FALSE (default output from
ipm(1)
is a IPM vector).
-maxrad
radius
specifies the maximum
radius
(from the origin co-ordinates). Pixels which lie within this radius contribute to the
output polar image or IPM vector. Those outside do not. The maximum radius parameter
is a hint. The program will silently enforces a Procrustes algorithm which ensures the
radius parameter does not result in attempts to grab brightness from outside the image
area.
-gipm
specifies that a gray level (as opposed to RGB) image is to be generated.
-oname
oname, envelope_size
specifies the name of the overlay (PolyROI) which is to be used when processing input imagery.
The
envelope_size
parameter specifies the size of the (internal) envelope function generated by
ipm(1)
and defaults to 50.
-lifetime
lifetime of TIFF images
specifies the lifetime of the output TIFF.Defaults to 60 seconds.
-input
TIFF RGB image
specifies name of image to be processed from command line. This directive and
-sdir
are mutually exlusive.
-output
specifies name of image to be generated from command line. This directive and
-sdir
are mutually exlusive.
-prefunc
script name
specifies pre-processing function applied to raw input image
prior
to generation of polar thumbnail. Default action is to look for an
executable shell script
histoeq
in the current working directory (which should perform a histogram
equalisation) and run that. If the executable
shell script
script name
is specified,
ipm(1)
runs the script on the image
it is transformed to a polar basis. The shell script must take the input image (to be
processed) as dummy argument $1 and put the processed image in dummy argument $2.
ipm(1)
takes care of writing the image to be processed and reading back the result. A typical
script making use of the
ImageMagik
convert(1)
utility is shown below:
#-----------------------------------------------------------------------------------
#e Script which uses the ImageMagik convert utility to histogram equalize an
# image.
#
# $1 is input image (to be transformed)
# $2 is output image (which has been transformed)
#
# (C) M.A. O'Neill, Digital Vision, 2003
#-----------------------------------------------------------------------------------
convert -equalize $1 $2
exit 0
If the script
script name
cannot be found, an appropriate error is logged to
standard error.
-postfunc
script name
specifies post-processing function applied to raw input image
after
to generation of polar thumbnail. Default is action is to look for an
exectable shell script
histoeq
in the current working directory (which should perform a histogram
equalisation) and run that. If the executable
shell script
script name
is specified,
ipm(1)
runs the script on the image
it is transformed to a polar basis. The shell script must take the input image (to be
processed) as dummy argument $1 and put the processed image in dummy argument $2.
ipm(1)
takes care of writing the image to be processed and reading back the result. A typical
script making use of the
ImageMagik
convert(1)
utility is shown below:
#-----------------------------------------------------------------------------------
# Script which uses the ImageMagik convert utility to histogram equalize an
# image.
#
# $1 is input image (to be transformed)
# $2 is output image (which has been transformed)
#
# (C) M.A. O'Neill, Digital Vision, 2003
#-----------------------------------------------------------------------------------
convert -equalize $1 $2
exit 0
If the script
script name
cannot be found, an appropriate error is logged to
standard error.
-wavelet
tells
ipm(1)
to apply a fast compact 4-component compact 2D wavelet transform to polar thumbnail. If specified, the wavelet
transform is applied
after
the
postfunc
(if any was specified). This option is only valid with
default (builtin)
post-processing enabled
prefunc
specifies (pre NPT) image processing (shell) script name.
postfunc
specifies (post NPT) image processing (shell) script name.
rat
activates or deactivates radial attenuation.
wavelet
attaches a wavelet transform (which may be dynamic) which processes data
after
postfunc
has been applied.
envelope
specifies number of control points in (internal) representation of overlay function.
lifetime
sets lifetime of ouput IPM/polar thumbnail in seconds.
status
displays status information about current
ipm(1)
process.
oname
specifies the name of the overlay to be used
deactivate
deactivates this instance of
ipm(1)
reactivate
reactivats this instance of
ipm(1)
instate
sets computational input state flag.
outstate
sets computational output state flag.
ipm
do an immediate pose normalisation of (PSRP) specified input image.
output
set type of output image (e.g. polar thumbnail, gray level IPM etc.).
rbins
set number of radius bins.
tbins
set number of angular (theta) bins.
maxrad
set (maximum) foveation radius.
origin
set origin co-ordinates (for Cartesian to polar transformation).
IPM_NOPROGRESS
do not generate status information for
progress(1)
IPM_PREFUNC
script name
specifies executable shell script run
before
image is converted to a NPT.
IPM_POSTFUNC
script name
specifies executable shell script run
after
image is converted to a NPT.
IPM_LIFETIME
lifetime
specifies the lifetime for output imagery (in seconds).
IPM_RAT
switches on radial attenuation.
IPM_APPLY_WAVELET
tells
ipm(1)
to apply (2D) wavelet transform to postfunc data.
IPM_INSTATE
instate tag
sets computational input state tag.
IPM_OUTSTATE
outstate tag
sets computational output state tag.
IPM_SDIR
sensetive directory name
sets the sensetive directory.
IPM_OVERLAY
overlay_file, overlay name
sets name of overlay to be used (and name of file from which it is read).
IPM_POLAR
tells
ipm(1)
to output polar thumbnail.
IPM_GREY_LVL_IPM
tells
ipm(1)
to produce grey level output.
IPM_MAXRAD
maxrad
sets (maximum) foveation radius (in pixels).
IPM_THETA_BINS
sets number of angular bins in polar thumbnail.
IPM_RADIUS_BINS
sets number of radial bins in polar thumbnail.
IPM_ORIGIN
x_orgin, y_origin
sets origin co-ordinates for Cartesian-polar transform.