description:sddsconvolve performs discrete Fourier convolution/deconvolution/correlation of
signals in two files. It assumes that spacing of points is the same in both input files.
example:
Compute the result of a signal applied to a system with a known impulse response.
files:
The meaning of the files depends on whether the -deconvolve or -correlate
options are given.
If neither option is given, then
signal-file is the file containing the signal that is imposed on the system,
response-file is the impulse response of the system, and
output is the computed response of the system to the signal.
If -deconvolve is given, then signal-file is the response of the
system to the signal, response-file is the impulse response of the system, and
output is the computed signal imposed on the system.
If -correlate is given, then signal-file and response-file contain
two equivalent signals, while output contains the computed Fourier correlation;
physically, this tells over what time scale the two functions have correlated values.
switches:
-pipe=[input][,output] -- The standard SDDS Toolkit pipe option.
-signalColumns=indepColumn,dataName -- Specifies the
names of the data columns from signal-file (the first data file).
-responseColumns=indepColumn,dataName -- Specifies the
names of the data columns from response-file (the second data file).
-outputColumns=indepColumn,dataName -- Specifies the
desired names of the result in the file output.
-deconvolve -- Specifies deconvolution instead of convolution.
-noiseFraction=value -- Specifies the amount of noise to
allow in the deconvolution to prevent division by zero, as a fraction of the
maximum power in the impulse response function.
-correlate -- Specifies correlation instead of convolution.