LYON2011 - Cascade of asymmetric resonators with fast-acting compression (CARFAC) model

Usage:

[CF, decim_naps, naps, BM, ohc, agc] = lyon2011(input_waves,CF);

Input parameters:

`input_waves`	input_waves is a column vector if there's just one audio channel; more generally, it has a row per time sample, a column per audio channel. The input_waves are assumed to be sampled at the same rate as the CARFAC model is designed for. A resampling may be needed before calling this.
`CF`	The CF struct holds the CARFAC design and state.

Output parameters:

`CF`	The CF struct holds the CARFAC design and state; if you want to break the input up into segments, you need to use the updated CF to keep the state between segments.
`decim_naps`	decim_naps is like naps but time-decimated by the int CF.seglen (defaults to about 20 ms long).
`naps`	naps (neural activity patterns) has a row per time sample, a column per filterbank channel, and a layer per audio channel if n_ears > 1.
`BM`	BM is basilar membrane motion (filter outputs before detection).
`ohc`	optional extra output for diagnosing internals.
`agc`	optional extra outputs for diagnosing internals.
`ihc_potential`	optional extra output for the IHC potential equivalent.

Description:

LYON2011 runs the CARFAC model. That is, it filters a 1 or more channel sound input to make one or more neural activity patterns (naps). This file is part of an implementation of Lyon's cochlear model: "Cascade of Asymmetric Resonators with Fast-Acting Compression"

License

This model is licensed under the Apache License Version 2.0. Further usage details are provided in the in the AMT directory "licences".

References:

R. F. Lyon. Cascades of two-pole–two-zero asymmetric resonators are good models of peripheral auditory function. J. Acoust. Soc. Am., 130(6), 2011. [ http ]