4.23 sddsconvolve

• 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.

  sddsconvolve signal.sdds impulseResponse.sdds signalResponse.sdds -signalColumns=t,VSignal -responseColumns=t,VImpulse -outputColumns=t,VOutput

• synopsis:

  sddsconvolve signal-file response-file output [-pipe[=in][,out]] -signalColumns=indepColumn,dataName -responseColumns=indepColumn,dataName -outputColumns=indepColumn,dataName [-deconvolve [-noiseFraction=value] | -correlate]

• 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.
• author: M. Borland, ANL/APS.