summaryrefslogtreecommitdiffstats
path: root/libraries/aubio/man/aubiomfcc.1
blob: e8f21ea7f052eb843bbe357895a6eb7686a9eaf1 (plain)
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
.\" Text automatically generated by txt2man
.TH AUBIOMFCC 1 "22 July 2023" "aubio 0.4.9" "aubio User's manual"
.SH NAME
\fBaubiomfcc \fP- a command line tool to compute Mel-Frequency Cepstrum Coefficients
\fB
.SH SYNOPSIS
.nf
.fam C

\fBaubiomfcc\fP \fIsource\fP
\fBaubiomfcc\fP [[\fB-i\fP] \fIsource\fP]
          [\fB-r\fP \fIrate\fP] [\fB-B\fP \fIwin\fP] [\fB-H\fP \fIhop\fP]
          [\fB-T\fP \fItime-format\fP]
          [\fB-v\fP] [\fB-h\fP]

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION

\fBaubiomfcc\fP compute the Mel-Frequency Cepstrum Coefficients (MFCC).
.PP
MFCCs are coefficients that make up for the mel-frequency spectrum, a
representation of the short-term power spectrum of a sound. By default, 13
coefficients are computed using 40 filters.
.PP
When started with an input \fIsource\fP (\fB-i\fP/\fB--input\fP), the coefficients are given on
the console, prefixed by their timestamps in seconds.
.SH OPTIONS

This program follows the usual GNU command line syntax, with long options
starting with two dashes (--). A summary of options is included below.
.TP
.B
\fB-i\fP, \fB--input\fP \fIsource\fP
Run analysis on this audio file. Most uncompressed and
compressed are supported, depending on how aubio was built.
.TP
.B
\fB-r\fP, \fB--samplerate\fP \fIrate\fP
Fetch the input \fIsource\fP, resampled at the given
sampling \fIrate\fP. The \fIrate\fP should be specified in Hertz as an integer. If 0,
the sampling \fIrate\fP of the original \fIsource\fP will be used. Defaults to 0.
.TP
.B
\fB-B\fP, \fB--bufsize\fP \fIwin\fP
The size of the buffer to analyze, that is the length
of the window used for spectral and temporal computations. Defaults to 512.
.TP
.B
\fB-H\fP, \fB--hopsize\fP \fIhop\fP
The number of samples between two consecutive analysis.
Defaults to 256.
.TP
.B
\fB-T\fP, \fB--timeformat\fP format
Set time format (samples, ms, seconds). Defaults to
seconds.
.TP
.B
\fB-h\fP, \fB--help\fP
Print a short help message and exit.
.TP
.B
\fB-v\fP, \fB--verbose\fP
Be verbose.
.SH REFERENCES

Using the default parameters, the filter coefficients will be computed
according to Malcolm Slaney's Auditory Toolbox, available at the following
url:
.PP
https://engineering.purdue.edu/~malcolm/interval/1998-010/ (see file mfcc.m)
.SH SEE ALSO

\fBaubioonset\fP(1),
\fBaubiopitch\fP(1),
\fBaubiotrack\fP(1),
\fBaubionotes\fP(1),
\fBaubioquiet\fP(1),
and
\fBaubiocut\fP(1).
.SH AUTHOR

This manual page was written by Paul Brossier <piem@aubio.org>. Permission is
granted to copy, distribute and/or modify this document under the terms of
the GNU General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.