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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
/* libxtract feature extraction library
*
* Copyright (C) 2006 Jamie Bullock
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
* USA.
*/
/* xtract_scalar.h: declares functions that extract a feature as a vector from an input vector */
#ifndef XTRACT_VECTOR
#define XTRACT_VECTOR
#ifdef __cplusplus
extern "C" {
#endif
/**
* \defgroup vector extraction functions
*
* Defines vectorr extraction functions, and their parameters.
* @{
*/
/** \brief Extract normalized (0-1) frequency domain magnitude spectrum from time domain signal
*
* \param *data: a pointer to the first element in an array of floats representing an audio vector
* \param N: the number of array elements to be considered
* \param *argv: a pointer to NULL
* \param *result: the magnitude spectrum of N values from the array pointed to by *data
*/
int xtract_magnitude_spectrum(float *data, int N, void *argv, float *result);
/** \brief Extract autocorrelation from time domain signal using time-domain autocorrelation technique
*
* \param *data: a pointer to the first element in an array of floats representing an audio vector
* \param N: the number of array elements to be considered
* \param *argv: a pointer to NULL
* \param *result: the autocorrelation of N values from the array pointed to by *data
*/
int xtract_autocorrelation(float *data, int N, void *argv, float *result);
/** \brief Extract autocorrelation from time domain signal using FFT based method
*
* \param *data: a pointer to the first element in an array of floats representing an audio vector
* \param N: the number of array elements to be considered
* \param *argv: a pointer to NULL
* \param *result: the autocorrelation of N values from the array pointed to by *data
*/
int xtract_autocorrelation_fft(float *data, int N, void *argv, float *result);
/** \brief Extract Average Magnitude Difference Function from time domain signal
*
* \param *data: a pointer to the first element in an array of floats
* \param N: the number of array elements to be considered
* \param *argv: a pointer to NULL
* \param *result: the AMDF of N values from the array pointed to by *data
*/
int xtract_amdf(float *data, int N, void *argv, float *result);
/** \brief Extract Average Squared Difference Function from time domain signal
*
* \param *data: a pointer to the first element in an array of floats representing an audio vector
* \param N: the number of array elements to be considered
* \param *argv: a pointer to NULL
* \param *result: the ASDF of N values from the array pointed to by *data
*/
int xtract_asdf(float *data, int N, void *argv, float *result);
/** \brief Extract Mel Frequency Cepstral Coefficients based on a method described by Rabiner
*
* \param *data: a pointer to the first element in an array of floats
* \param N: the number of array elements to be considered
* \param *argv: a pointer to a data structure of type xtract_mel_filter, containing n_filters coefficient tables to make up a mel-spaced filterbank
* \param *result: a pointer to an array containing the resultant MFCC
*
* The data structure pointed to by *argv must be obtained by first calling xtract_init_mfcc
*/
int xtract_mfcc(float *data, int N, void *argv, float *result);
/** \brief Extract Bark band coefficients based on a method
* \param *data: a pointer to the first element in an array of floats representing the magnitude spectrum of an audio vector
* \param N: the number of array elements to be considered
* \param *argv: a pointer to an array of ints representing the limits of each bark band
* \param *result: a pointer to an array containing resultant bark coefficients
*
* The limits array pointed to by *argv must be obtained by first calling xtract_init_bark
*
*/
int xtract_bark_coefficients(float *data, int N, void *argv, float *result);
/** \brief Extract the Discrete Cosine transform of a time domain signal
* \param *data: a pointer to the first element in an array of floats representing an audio vector
* \param N: the number of array elements to be considered
* \param *argv: a pointer to NULL
* \param *result: a pointer to an array containing resultant dct coefficients
*/
int xtract_dct(float *data, int N, void *argv, float *result);
/** \brief Extract the frequency and amplitude of spectral peaks from a of a magnitude spectrum
* \param *data: a pointer to the first element in an array of floats representing the magnitude spectrum of an audio vector
* \param N: the number of array elements to be considered
* \param *argv: a pointer to an array containing peak threshold as percentage below max peak, and sample rate
* \param *result: a pointer to an array of size N, containing N/2 freqs and N/2 amplitudes, amplitudes are on a decibel scale with dbFS = 0
*/
int xtract_peaks(float *data, int N, void *argv, float *result);
/** @} */
#ifdef __cplusplus
}
#endif
#endif
|