LeakyIntegration: Leaky Integration
In m-vidal/eaR: Perception-Based Auditory and Music Analysis
View source: R/LeakyIntegration.R
LeakyIntegration R Documentation
Leaky Integration
Description
An echo can be defined as a leaky integration with a given half decay time. At each moment in time, a leaky integrator adds the incoming signal value to an attenuated version of the previously calculated value to form the newly calculated value. The half decay time specifies the time it takes for an impulse signal to reach half its original value.
This function takes an image as input and gives the leaky integrated image as output. Let us suppose that we have a periodicity pitch image P=(P_{ij})_{n\times m}. With a null factor of enlargement, the new echoed image is calculated as
\tilde{P}_{i1}=P_{i1},
\tilde{P}_{i2}=P_{i2}+\tilde{P}_{i1}\cdot2^{-\frac{1}{τ}},
\tilde{P}_{ij}=P_{ij}+\tilde{P}_{i,j-1}\cdot2^{-\frac{1}{τ}} \quad \forall j>2,
where τ denotes the echo in seconds. Leaky integration had been used in Leman (2000) to construct the pitch images of an echoic memory.
Usage
LeakyIntegration(inSignal, inSampleFreq, inHalfDecayTime = 0.1,
inEnlargement = 0)
Arguments
inSignal
input signal (multi-dimensional), each row representing a channel.
inSampleFreq
sample frequency of inSignal (in Hz).
inHalfDecayTime
time (in s) at which an impulse would be reduced to half its value. If empty or not specified, 0.1 is used by default.
inEnlargement
time (in s) to enlarge the input signal. If -1, 2*inHalfDecayTime is used. If empty or not specified, 0 is used by default.
Details
Sample frequency of outLeakyIntegration is the same as inSampleFreq.
Value
An object of matrix class representing the leaky integration of the input signal.
Author(s)
Marc Vidal (R version). Based on the original code from IPEM Toolbox.
References
Leman, M. (2000). An auditory model of the role of short-term memory in probe-tone ratings. Music Perception, 17(4), 481-509.
Examples
## Not run: s <- c(SchumannKurioseGeschichte)
ANIs <- CalcANI(s, 22050)
LIs <- LeakyIntegration (ANIs$AuditoryNerveImage, ANIs$ANIFreq, 0.1, -1)
## End(Not run)
m-vidal/eaR documentation built on Nov. 18, 2022, 3:55 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
View source: R/LeakyIntegration.R
| LeakyIntegration | R Documentation |
Leaky Integration
Description
An echo can be defined as a leaky integration with a given half decay time. At each moment in time, a leaky integrator adds the incoming signal value to an attenuated version of the previously calculated value to form the newly calculated value. The half decay time specifies the time it takes for an impulse signal to reach half its original value.
This function takes an image as input and gives the leaky integrated image as output. Let us suppose that we have a periodicity pitch image P=(P_{ij})_{n\times m}. With a null factor of enlargement, the new echoed image is calculated as
\tilde{P}_{i1}=P_{i1},
\tilde{P}_{i2}=P_{i2}+\tilde{P}_{i1}\cdot2^{-\frac{1}{τ}},
\tilde{P}_{ij}=P_{ij}+\tilde{P}_{i,j-1}\cdot2^{-\frac{1}{τ}} \quad \forall j>2,
where τ denotes the echo in seconds. Leaky integration had been used in Leman (2000) to construct the pitch images of an echoic memory.
Usage
LeakyIntegration(inSignal, inSampleFreq, inHalfDecayTime = 0.1,
inEnlargement = 0)
Arguments
inSignal |
input signal (multi-dimensional), each row representing a channel. |
inSampleFreq |
sample frequency of |
inHalfDecayTime |
time (in s) at which an impulse would be reduced to half its value. If empty or not specified, 0.1 is used by default. |
inEnlargement |
time (in s) to enlarge the input signal. If -1, |
Details
Sample frequency of outLeakyIntegration is the same as inSampleFreq.
Value
An object of matrix class representing the leaky integration of the input signal.
Author(s)
Marc Vidal (R version). Based on the original code from IPEM Toolbox.
References
Leman, M. (2000). An auditory model of the role of short-term memory in probe-tone ratings. Music Perception, 17(4), 481-509.
Examples
## Not run: s <- c(SchumannKurioseGeschichte) ANIs <- CalcANI(s, 22050) LIs <- LeakyIntegration (ANIs$AuditoryNerveImage, ANIs$ANIFreq, 0.1, -1) ## End(Not run)
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.