NAME

bufframe - a shifting AIM output frame buffer.

CONTENTS

Syntax
Description
Options
Examples
Copyright

bufframe [options] [file]

The program reads an AIM header and the output from the genbmm (basilarmembrane motion) or gennap (neural activity pattern) programs. This isdivided into contiguous time frames using the optional arguments and writtenon the stdout with anappropriate header as if output from the gensai program. This enablesgenbmm or gennap output to be divided into time frames and replayed as atime-varying cartoon by gensai using the "useprevious" option.

Certain display parameters have different default values for differentapplications. The gensai display parameters should be set to theappropriate values, in order to plot the cartoon on the same scale. Forexample: when the source application is gennap, set gensai top=1000,when the source application is genbmm, set gensai bottom=-100.

1. width, frstep.

The input is divided into frames according to the width option and thefrstep option. The width option sets the width of the output frames.The frstep option sets the step or shift between successive output frames.With no units, the values of width and frstep are in samples.Both width and frstep may take time units (s or ms), in which case the valuesare converted to samples using the given ‘samplerate’ option.

2. frame.

A range of sequential frames may be selected for output by:

          frame=a[-b]

The upper limit ‘b’ is optional, and when it is missing then the rangeis a single frame, otherwise ‘a’ and ‘b’ are inclusive range limits.The strings "min" and "max" are recognised as extreme limits constrainedby the given width and frstep and the input size,otherwise the values of ‘a’ and ‘b’ are frame numbers: 0,1,2,...

The frame selector may also take time units (s, or ms) to specify frames"closest" to the given time, being the frame number which is thegreatest integer multiple of the framestep (frstep) which does notexceed the given time measured from thestart of the input file.

3. Transpose.

The option flag:

  Transpose=on

causes a matrix transpose (swap rows and columns) of each output frame.When a frame has a height greaterthan it’s width then setting "Transpose=on" may providea preferable display orientation. For example, this enables a very narrow(eg. single column) time-slice to be plotted horizontally, so that atime-slice of filterbank output may be plotted as a spectrum on a horizontalfrequency axis.

4. Header.

The option flag:

      Header=off

causes the header to be suppressed from the output.

5. display, animate.

Most options in the input header are copied to the output header. Thisenables options which are needed for the eventual display to passstraight through. Some options are set so that they can override theinput header. For example, the ‘display’ option is set on to enabledisplay even when input has "display=off". The ‘animate’ option can be seton even when the input has "animate=off".

1. To convert gennap output to multiple animated frames:

gennap len=16ms display=off output=stdout file1 |        bufframe width=8ms frstep=0.2ms anim=on > file2.saigensai useprev=on top=1000 file2             -(for landscape plot)genspl useprev=on top=1000 pensize=2 file2   -(for spiral plot)

2. To view the basilar membrane from a cross section, animating the waves on it.

genbmm mincf=220 maxcf=660 len=8ms output=stdout display=off file1 |        bufframe width=1p frstep=1p Tran=on display=on anim=on > file2.saigensai bott=-100 useprev=on mag=.2 file2
    or:
genbmm mincf=220 maxcf=660 len=32ms output=stdout display=off file1 |        bufframe width=1p frstep=1p Tran=on Header=off > file2x11play -n75 -a500 file2

options edframe

Copyright (c) Applied Psychology Unit, Medical Research Council, 1995

Permission to use, copy, modify, and distribute this software without feeis hereby granted for research purposes, provided that this copyrightnotice appears in all copies and in all supporting documentation, and thatthe software is not redistributed for any fee (except for a nominalshipping charge). Anyone wanting to incorporate all or part of thissoftware in a commercial product must obtain a license from the MedicalResearch Council.

The MRC makes no representations about the suitability of thissoftware for any purpose. It is provided "as is" without express orimplied warranty.

THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDINGALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALLTHE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGESOR 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 THISSOFTWARE.