BeatAgent Class Reference
[Processing]
Entity representing a given {period, phase} hypothesis regarding a train of beat positions paced by the following tempo. A set of initial agents are feeded by the initial hypothesis given by an initial tempo induction stage. Each
BeatAgent is recursively evaluated in real-time, by a given score function (heuristics), around each predicted beat. According to the goodness-of-fit between each agent's prediction and the correspondent local maxima in the observed data (given by the onset detection function calculated by the
Spectral Flux) the agent's current score is incremented or decremented, calling for the creation of new agents (children) when large discrepancies are observed.
More...
#include <BeatAgent.h>
Inherits Marsyas::MarSystem.
Detailed Description
Entity representing a given {period, phase} hypothesis regarding a train of beat positions paced by the following tempo. A set of initial agents are feeded by the initial hypothesis given by an initial tempo induction stage. Each
BeatAgent is recursively evaluated in real-time, by a given score function (heuristics), around each predicted beat. According to the goodness-of-fit between each agent's prediction and the correspondent local maxima in the observed data (given by the onset detection function calculated by the
Spectral Flux) the agent's current score is incremented or decremented, calling for the creation of new agents (children) when large discrepancies are observed.
Input: Onset detection fucntion (uses Spectral Flux). Output Format: [Beat/Eval/None|Tempo|PrevBeat|Inner/Outter|Error|Score]
Controls:
- mrs_string/identity [r] : agent's identity according to its BeatAgent pool (Fanout) index.
- mrs_realvec/agentControl [r] : feedback matrix, retrieved from BeatReferee, containing each BeatAgent's (updated) {period, phase} hypotheses, their lifecycle and timming situation.
- mrs_string/scoreFunc [r] : heuristics which conducts the beat tracking, by causally evaluating the goodness-of-fit between each agent's prediction and the correspondent local maxima in the onset detection function.
- mrs_real/lftOutterMargin [r] : the size of the outer half-window (in % of the IBI) before the predicted beat time.
- mrs_real/rgtOutterMargin [r] : the size of the outer half-window (in % of the IBI) after the predicted beat time.
- mrs_real/innerMargin [r] : inner tolerance window margin size (= half inner window size -> in ticks).
Definition at line 49 of file BeatAgent.h.
The documentation for this class was generated from the following files:
