1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
class:: AnalyseEvents2
summary:: event analyser (BBCut)
related:: Classes/AutoTrack
categories:: UGens>Analysis
Description::
code::
//This file is part of MLfftwUGens. Copyright (C) 2006 Nicholas M.Collins distributed under the terms of the GNU General Public License full notice in file MachineListening.license
//This file is part of The BBCut Library. Copyright (C) 2001 Nick M.Collins distributed under the terms of the GNU General Public License full notice in file BBCutLibrary.help
::
On-the-fly event analyser, based on onset detection/on-the-fly analysis described in my academic papers. Best for percussive events. Recommended that you go via the link::Classes/Segmentation:: (for one-pass) and link::Classes/AnalyseEventsDatabase:: (for on-the-fly) classes in standard usage, don't use this directly.
note::
you will need bbcut2 for further classes and capabilities. This UGen is included in sc3-plugins for cross-platform building.
::
classmethods::
method::ar
argument::in
Audio input to track
argument::bufnum
A buffer within which results of the analysis are place
argument::threshold
A parameter acting as the onset detector threshold, default of 0.34 was determined as the best performing over a database of percussive onset, but you might want to change this to change the sensitivity (though you always increase the risk of false positives or false negatives)
argument::triggerid
A trigger ID number used for communication from the UGen to the Lang to mark that a new event was received. Only passed for on-the-fly analysis.
argument::circular
A flag to note on-the-fly analysis assuming a circular buffer. If you only need a one-pass analysis on a file, you won't use this.
argument::pitch
Can take a .kr pitch detection UGen as input. Will take the median fundamental frequency over a note event from values recorded from this pitch input.
Examples::
No examples are given, to discourage solo use.
|
