Content-type: text/html Manpage of NPRAW

NPRAW

Section: User Commands (1)
Updated: 14th August 1999
Index Return to Main Contents
 

NAME

NPRAW - General purpose image distortion.

 

SYNOPSIS

npraw ! -grid warp_rows warp_cols ! -extent ox oy sx sy ! | !-gridfile grid file name [ -wait ] ! [ -s output_rows output_cols ][ -grab ]]! -input_image image name !! -grid_image_size rows cols ![ -no_date white | black ] input_image < warp_description > output_image

 

DESCRIPTION

npraw(1) inputs data describing the mapping (warping) of a regular grid G in the output image to a distorted grid G' in the input image. npraw(1) effectively inverts this warping to produce the (corrected) output image from the (distorted) input image. Byte or float images can be processed.

 

OPTIONS

-verbose tells the user what is happening. Log output goes to stdout

-usage prints a usage list and then exits

-slots displays the pups(3) library dependencies in short format for this program and then exits.

-slotinfo displays the pups(3) library dependencies in long format for this program and then exits.

-version prints the current version number for this program and then exists.

-argf <argument_file> reads the command tail from the argument file. The data format for this file is:


optional comment ...
-argflag <parameter list>

# ... Optional comment ...
-argflag <parameter list>

-nice <nice level> sets the scheduling level for the program. As this is an interactive display program, <nice level> defaults to 4.

-growth_protection retrys causes the system to retry an sbrk(2) 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.

-input_image image name specifies the name of the image which is to be warped.

-grid warp_rows warp_cols specifies the dimensions of the grid describing the warp. This option and the -gridfile option are mutually exclusive.

-output_size output_rows output_cols specifies the size of the output image (defaults to size of input image). The regular grid G coincides with this image area.

-grab disables bilinear interpolation. The nearest grid point is sampled instead (zero if outside image).

-gridfile grid file name reads in a gridfile which specifies the diemsions of the warp grid, and in addition the extent of the DTM which is to be used to warp the image into a map projection. The -gridfile and -grid options are mutually exclusive.

-wait tells npraw(1) to wait until grid file name is created. This option is used by the gti(1) harness to ensure the orthoimage pipeline functions irrespective of which filter in that pipeline is scheduled to run first. This option is only recognised if -gridfile is also specified.

-extent ox oy sx sy species the extent of DTM used to warp the input image. Note that the origin is in the bottom left hand corner of the DTM. This option and the -gridfile option are mutaully exclusive.

-no_data white | black specifies the "no data" e.g. background value for the orthoimage. It may be either black (in which case the orthoimage is generated in a black background) or white (in which case the orthoimage is generated in a white background). Defaults to white.

-grid_image_extent rows cols specifies the extent of the warp grid in image spece. This is use to compute the scaling factors which must be applied to map the warp grid into the input image. For example, if we are processing any SPOT PA derived image product the rows and cols parameters must be set to 6000 (the nominal size of SPOT PA imagery).

 

INPUT

The warp description consists of warp_rows*warp_cols row and column co-ordinate pairs locating the points of G' in the input image. Points should be given in row-major order. (The position of the points of G in the output image is implicitly determined by the output image size.)

 

BUGS

Won't work if the camera model fails to transform some points as the grid will be incomplete. Not very fast. Currently only does a single frame at once.

 

FEATURES

Stores only the co-ordinates of points in G' internally; the input image is randomly accessed and the output image built up sequentially on disk. Nice simple approach which works.

SH SIGNALS SIGUSR2 is used to support PSRP event handling

 

PSRP INTERACTIVITY

Supports interactive querying while running using Process Status Request Protocol [PSRP], see psrp(1).

 

LIBRARIES

npraw(1) uses the PUPS libraries, see pups(3)

 

COPYRIGHT

(C) Digital Vision, Didcot.


 

PROGRAMMERS

T Day
Cadence Corporation, Mass. USA,
M.A. O'Neill
Digital Vision, Didcot.

 

SEE ALSO

spot1m(1), fnxyz(1), psrp(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
INPUT
BUGS
FEATURES
PSRP INTERACTIVITY
LIBRARIES
COPYRIGHT
PROGRAMMERS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 10:23:07 GMT, May 07, 2001