1 | NAME |
---|
2 | aubioonset - a command line tool to extract musical onset times |
---|
3 | |
---|
4 | SYNOPSIS |
---|
5 | |
---|
6 | aubioonset source |
---|
7 | aubioonset [[-i] source] [-o sink] |
---|
8 | [-r rate] [-B win] [-H hop] |
---|
9 | [-O method] [-t thres] |
---|
10 | [-T time-format] |
---|
11 | [-s sil] [-m] [-f] |
---|
12 | [-j] [-v] [-h] |
---|
13 | |
---|
14 | DESCRIPTION |
---|
15 | |
---|
16 | aubioonset attempts to detect onset times, the beginning of discrete sound |
---|
17 | events, in audio signals. |
---|
18 | |
---|
19 | When started with an input source (-i/--input), the detected onset times are |
---|
20 | given on the console, in seconds. |
---|
21 | |
---|
22 | When started without an input source, or with the jack option (-j/--jack), |
---|
23 | aubioonset starts in jack mode. |
---|
24 | |
---|
25 | OPTIONS |
---|
26 | |
---|
27 | This program follows the usual GNU command line syntax, with long options |
---|
28 | starting with two dashes (--). A summary of options is included below. |
---|
29 | |
---|
30 | -i, --input source Run analysis on this audio file. Most uncompressed and |
---|
31 | compressed are supported, depending on how aubio was built. |
---|
32 | |
---|
33 | -o, --output sink Save results in this file. The file will be created on |
---|
34 | the model of the input file. Onset times are marked by a short wood-block |
---|
35 | like sound. |
---|
36 | |
---|
37 | -r, --samplerate rate Fetch the input source, resampled at the given |
---|
38 | sampling rate. The rate should be specified in Hertz as an integer. If 0, |
---|
39 | the sampling rate of the original source will be used. Defaults to 0. |
---|
40 | |
---|
41 | -B, --bufsize win The size of the buffer to analyze, that is the length |
---|
42 | of the window used for spectral and temporal computations. Defaults to 512. |
---|
43 | |
---|
44 | -H, --hopsize hop The number of samples between two consecutive analysis. |
---|
45 | Defaults to 256. |
---|
46 | |
---|
47 | -O, --onset method The onset detection method to use. See ONSET METHODS |
---|
48 | below. Defaults to 'default'. |
---|
49 | |
---|
50 | -t, --onset-threshold thres Set the threshold value for the onset peak |
---|
51 | picking. Values are typically in the range [0.001, 0.900]. Lower threshold |
---|
52 | values imply more onsets detected. Increasing this threshold should reduce |
---|
53 | the number of incorrect detections. Defaults to 0.3. |
---|
54 | |
---|
55 | -s, --silence sil Set the silence threshold, in dB, under which the pitch |
---|
56 | will not be detected. A value of -20.0 would eliminate most onsets but the |
---|
57 | loudest ones. A value of -90.0 would select all onsets. Defaults to -90.0. |
---|
58 | |
---|
59 | -T, --timeformat format Set time format (samples, ms, seconds). Defaults to |
---|
60 | seconds. |
---|
61 | |
---|
62 | -m, --mix-input Mix source signal to the output signal before writing to |
---|
63 | sink. |
---|
64 | |
---|
65 | -f, --force-overwrite Overwrite output file if it already exists. |
---|
66 | |
---|
67 | -j, --jack Use Jack input/output. You will need a Jack connection |
---|
68 | controller to feed aubio some signal and listen to its output. |
---|
69 | |
---|
70 | -h, --help Print a short help message and exit. |
---|
71 | |
---|
72 | -v, --verbose Be verbose. |
---|
73 | |
---|
74 | ONSET METHODS |
---|
75 | |
---|
76 | Available methods are: |
---|
77 | |
---|
78 | default Default distance, currently hfc |
---|
79 | |
---|
80 | Default: 'default' (currently set to hfc) |
---|
81 | |
---|
82 | energy Energy based distance |
---|
83 | |
---|
84 | This function calculates the local energy of the input spectral frame. |
---|
85 | |
---|
86 | hfc High-Frequency content |
---|
87 | |
---|
88 | This method computes the High Frequency Content (HFC) of the input |
---|
89 | spectral frame. The resulting function is efficient at detecting |
---|
90 | percussive onsets. |
---|
91 | |
---|
92 | Paul Masri. Computer modeling of Sound for Transformation and Synthesis of |
---|
93 | Musical Signal. PhD dissertation, University of Bristol, UK, 1996. |
---|
94 | |
---|
95 | complex Complex domain onset detection function |
---|
96 | |
---|
97 | This function uses information both in frequency and in phase to determine |
---|
98 | changes in the spectral content that might correspond to musical onsets. |
---|
99 | It is best suited for complex signals such as polyphonic recordings. |
---|
100 | |
---|
101 | Christopher Duxbury, Mike E. Davies, and Mark B. Sandler. Complex domain |
---|
102 | onset detection for musical signals. In Proceedings of the Digital Audio |
---|
103 | Effects Conference, DAFx-03, pages 90-93, London, UK, 2003. |
---|
104 | |
---|
105 | phase Phase based onset detection function |
---|
106 | |
---|
107 | This function uses information both in frequency and in phase to determine |
---|
108 | changes in the spectral content that might correspond to musical onsets. It |
---|
109 | is best suited for complex signals such as polyphonic recordings. |
---|
110 | |
---|
111 | Juan-Pablo Bello, Mike P. Davies, and Mark B. Sandler. Phase-based note |
---|
112 | onset detection for music signals. In Proceedings of the IEEE International |
---|
113 | Conference on Acoustics Speech and Signal Processing, pages 441444, |
---|
114 | Hong-Kong, 2003. |
---|
115 | |
---|
116 | specdiff Spectral difference onset detection function |
---|
117 | |
---|
118 | Jonhatan Foote and Shingo Uchihashi. The beat spectrum: a new approach to |
---|
119 | rhythm analysis. In IEEE International Conference on Multimedia and Expo |
---|
120 | (ICME 2001), pages 881884, Tokyo, Japan, August 2001. |
---|
121 | |
---|
122 | kl Kulback-Liebler onset detection function |
---|
123 | |
---|
124 | Stephen Hainsworth and Malcom Macleod. Onset detection in music audio |
---|
125 | signals. In Proceedings of the International Computer Music Conference |
---|
126 | (ICMC), Singapore, 2003. |
---|
127 | |
---|
128 | mkl Modified Kulback-Liebler onset detection function |
---|
129 | |
---|
130 | Paul Brossier, ``Automatic annotation of musical audio for interactive |
---|
131 | systems'', Chapter 2, Temporal segmentation, PhD thesis, Centre for |
---|
132 | Digital music, Queen Mary University of London, London, UK, 2006. |
---|
133 | |
---|
134 | specflux Spectral flux |
---|
135 | |
---|
136 | Simon Dixon, Onset Detection Revisited, in ``Proceedings of the 9th |
---|
137 | International Conference on Digital Audio Effects'' (DAFx-06), Montreal, |
---|
138 | Canada, 2006. |
---|
139 | |
---|
140 | SEE ALSO |
---|
141 | |
---|
142 | aubiopitch(1), |
---|
143 | aubiotrack(1), |
---|
144 | aubionotes(1), |
---|
145 | aubioquiet(1), |
---|
146 | aubiomfcc(1), |
---|
147 | and |
---|
148 | aubiocut(1). |
---|
149 | |
---|
150 | AUTHOR |
---|
151 | |
---|
152 | This manual page was written by Paul Brossier <piem@aubio.org>. Permission is |
---|
153 | granted to copy, distribute and/or modify this document under the terms of |
---|
154 | the GNU General Public License as published by the Free Software Foundation, |
---|
155 | either version 3 of the License, or (at your option) any later version. |
---|