dspl(3)

NAME
dspl - Khoros image/signal processing library (dspl).

SYNOPSIS

See the man(3) document for the routine that you are interested in. All programs that belong to this library begin with the characters ld.

DESCRIPTION

The dspl library is a collection if 1D signal processing functions that are available with Khoros. They are called by main() programs that perform error checking via internal Khoros functions to insure that legal viff structures are passed in. Error checking internal to the dspl functions is to prevent erroneous results or core dumps. Where possible, the dspl functions should do internal error checking for things like overflow or divide by zero etc, because these errors occur as part of the data manipulation.

The functions that are part of the dspl library should be capable of handling both real and complex data. Unless it is explicitly documented otherwise, complex data is assumed to be in a rectangular (as opposed to polar) format.

A process direction argument is typically found in a call to a dspl function. This argument indicates the orientation of the data in the viff structure. The DSP_BAND definition used here indicates that when multiple signals exist in the input image, each signal can be found on its own data band. The DSP_VECTOR definition used here indicates that when multiple signals exist in the input image, each signal has a single data point on each band. The first band (0), has the first element, the second band has the second element, and so forth. These definitions can be found in vdefines.h.

Many of the dspl functions have an argument that indicates the type of complex data processing. This argument determines whether complex input data is processed as though it were complex (i.e. complex arithmetic) or processed by separating the real and imaginary components and processing each of them separately as real data. If the second option is chosen, the resulting real data sequences are reassembled into a complex form before exiting.

SEE ALSO
intro(3) vipl(3)

COPYRIGHT
Copyright 1991, University of New Mexico. All rights reserved.