Mercurial > hg > aim92
diff man/man1/conv.1 @ 0:5242703e91d3 tip
Initial checkin for AIM92 aimR8.2 (last updated May 1997).
author | tomwalters |
---|---|
date | Fri, 20 May 2011 15:19:45 +0100 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/man1/conv.1 Fri May 20 15:19:45 2011 +0100 @@ -0,0 +1,78 @@ +.TH CONV 1 "1 September 1993" + +.SH NAME +conv \- Convolution. + +.SH SYNTAX +conv [options] signal_file impulse_response_file + +.SH DESCRIPTION +The response of a linear filter to an arbitiary input signal is the +convolution of the signal with the filter's impulse response. +The `impulse_response_file' contains the impulse response which characterises the +filter, and the result of the convolution operation is the response of +that filter to the signal contained in the `signal_file'. + +The `signal_file' must consist of binary 16-bit numbers (ie. shorts). +The `impulse_response_file' must consist of binary floats. +The output signal is the same length as the input signal and is written on +the stdout in binary 16-bit numbers. + +If the `signal_file' consists of an impulse train, then the output should +be a repeated impulse response, ie. should be a repeated version of the +`response_file'. + + + +.SH OPTIONS + +1. length + +The amount of the signal file to convolve in time units (s or ms) or in +samples (no units). Time units are converted to samples using the given +`samplerate' option. The string "max" is recognised as the remainder of +input. + +2. domain + +Select algorithm for convolution. In the time domain ("domain=time") the +discrete convolution formula is applied directly as a local averaging +operation on the input signal with weights obtained by time-reversing and +shifting the impulse response. The impulse response is assumed to be zero +for all time outside the given file. In the frequency domain +("domain=frequency") the FFT of the whole input signal is multiplied by a +frequency response function (the FFT of the impulse response), and +the result inverse FFT'd. + +3. scale + +A scale factor for scaling the output. + + +.SH "SEE ALSO" +options smooth fft acf + +.SH COPYRIGHT +.LP +Copyright (c) Applied Psychology Unit, Medical Research Council, 1995 +.LP +Permission to use, copy, modify, and distribute this software without fee +is hereby granted for research purposes, provided that this copyright +notice appears in all copies and in all supporting documentation, and that +the software is not redistributed for any fee (except for a nominal +shipping charge). Anyone wanting to incorporate all or part of this +software in a commercial product must obtain a license from the Medical +Research Council. +.LP +The MRC makes no representations about the suitability of this +software for any purpose. It is provided "as is" without express or +implied warranty. +.LP +THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING +ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL +THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES +OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, +WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, +ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS +SOFTWARE. +