tomwalters@0: .TH AUDIM 1 "1 September 1993" tomwalters@0: tomwalters@0: .SH NAME tomwalters@0: audim \- Auditory images. tomwalters@0: tomwalters@0: .SH SYNTAX tomwalters@0: audim [options] [file] tomwalters@0: tomwalters@0: .SH DESCRIPTION tomwalters@0: tomwalters@0: This program provides tomwalters@0: methods of constructing time-varying auditory images from the output of the tomwalters@0: cochlear model which are alternatives to the gensai (stabilized auditory tomwalters@0: image) program. Correlograms (ie. row-wise autocorrelation) and row-wise tomwalters@0: Fourier transform are provided. tomwalters@0: tomwalters@0: The program reads an AIM tomwalters@0: header and the output from the genbmm (basilar membrane motion) or gennap tomwalters@0: (neural activity pattern) programs. This is divided into contiguous tomwalters@0: time frames and written on the stdout with an appropriate header as if output tomwalters@0: from the gensai program. This enables genbmm or gennap output to be divided into time tomwalters@0: frames and replayed as a time-varying cartoon by gensai using the "useprevious" option. tomwalters@0: tomwalters@0: Additional processing to each frame is optionally available to compute tomwalters@0: alternative forms of auditory image according to the "image" option. tomwalters@0: tomwalters@0: .SH OPTIONS tomwalters@0: tomwalters@0: The options "start" and "length" specify the size of the input. tomwalters@0: The options "width" and "frstep" specify the frames which are output. tomwalters@0: The input is divided into frames according to the width option and the tomwalters@0: frstep option. tomwalters@0: tomwalters@0: Special option values are: tomwalters@0: tomwalters@0: .nf tomwalters@0: length=max Read all the input from the given start to its end. tomwalters@0: width=max Output framewidth is set equal to the given input tomwalters@0: length, and if this is also "max", then the tomwalters@0: framewidth is the remainder of the input. tomwalters@0: frames=1-max Select the 1st to the last frame inclusively. tomwalters@0: frame=4 Select the 4th frame only. tomwalters@0: tomwalters@0: image=off Divide the input into frames for replay as a cartoon. tomwalters@0: image=acgram Compute correlogram of each frame. tomwalters@0: image=ftgram Compute power spectrum of each channel of each frame. tomwalters@0: image=phgram Compute phase spectrum of each channel of each frame. tomwalters@0: .fi tomwalters@0: tomwalters@0: Most options in the input header are copied to the output header. tomwalters@0: This enables options which are needed for the eventual display tomwalters@0: to pass straight through. Some options are set so that they can override tomwalters@0: the input header. For example, the display option is set on to enable tomwalters@0: display even when input has display=off. The animate option can be set on tomwalters@0: even when the input has animate=off. tomwalters@0: Parts of the header are changed for the new sai format: tomwalters@0: (frames, frameshift, framewidth, frameheight, framebytes). tomwalters@0: tomwalters@0: Certain display parameters have different default values for different tomwalters@0: applications. The gensai display parameters should be set to the appropriate tomwalters@0: values, in order to plot the cartoon on the same scale. For example: tomwalters@0: when the source application is gennap, set gensai top=1000, tomwalters@0: when the source application is genbmm, set gensai bottom=-100. tomwalters@0: tomwalters@0: tomwalters@0: .SH EXAMPLES tomwalters@0: tomwalters@0: .nf tomwalters@0: tomwalters@0: 1. To convert gennap output to multiple animated frames: tomwalters@0: tomwalters@0: gennap len=16ms display=off output=stdout file | \ tomwalters@0: audim image=off width=8ms frstep=0.2ms anim=on > file.sai tomwalters@0: gensai useprev=on file -(for landscape plot) tomwalters@0: genspl useprev=on pensize=2 file -(for spiral plot) tomwalters@0: tomwalters@0: (Note: spirals look better in a square box, so you might use options: tomwalters@0: dencf=1 width=500 height=500 ) tomwalters@0: tomwalters@0: 2. An animated normalized correlogram from gennap output: tomwalters@0: tomwalters@0: gennap len=64ms output=stdout display=off file | \ tomwalters@0: audim norm=on anim=on > file.sai tomwalters@0: gensai useprev=on top=1000 file -(for landscape plot) tomwalters@0: genspl useprev=on top=1000 pensize=2 file -(for spiral plot) tomwalters@0: tomwalters@0: .fi tomwalters@0: tomwalters@0: .SH "SEE ALSO" tomwalters@0: tomwalters@0: acgram ftgram edframe naptosai tomwalters@0: tomwalters@0: .SH COPYRIGHT tomwalters@0: .LP tomwalters@0: Copyright (c) Applied Psychology Unit, Medical Research Council, 1995 tomwalters@0: .LP tomwalters@0: Permission to use, copy, modify, and distribute this software without fee tomwalters@0: is hereby granted for research purposes, provided that this copyright tomwalters@0: notice appears in all copies and in all supporting documentation, and that tomwalters@0: the software is not redistributed for any fee (except for a nominal tomwalters@0: shipping charge). Anyone wanting to incorporate all or part of this tomwalters@0: software in a commercial product must obtain a license from the Medical tomwalters@0: Research Council. tomwalters@0: .LP tomwalters@0: The MRC makes no representations about the suitability of this tomwalters@0: software for any purpose. It is provided "as is" without express or tomwalters@0: implied warranty. tomwalters@0: .LP tomwalters@0: THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING tomwalters@0: ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL tomwalters@0: THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES tomwalters@0: OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, tomwalters@0: WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, tomwalters@0: ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS tomwalters@0: SOFTWARE. tomwalters@0: