aboutsummaryrefslogtreecommitdiff
path: root/xtract/xtract_vector.h
diff options
context:
space:
mode:
authorJamie Bullock <jamie@postlude.co.uk>2007-12-24 13:21:13 +0000
committerJamie Bullock <jamie@postlude.co.uk>2007-12-24 13:21:13 +0000
commit6abcb447777c3ab48bdbe720fc3d84d3e8841317 (patch)
tree01e0930c51bc1c5cf43aeed186f196e095378fe1 /xtract/xtract_vector.h
parent672302aadaba97f3e5df256e3d358cb2411ab3ed (diff)
downloadLibXtract-6abcb447777c3ab48bdbe720fc3d84d3e8841317.tar.gz
LibXtract-6abcb447777c3ab48bdbe720fc3d84d3e8841317.tar.bz2
LibXtract-6abcb447777c3ab48bdbe720fc3d84d3e8841317.zip
- Fixes to descriptors.c where no break statement was given for certain cases is switch conditionals
- Added LPC and LPCC extraction functions. LPC implements Durbin method as described in Rabiner and Juang and implemented in Dr. Dobbs 1994 edition by Jutta Degener
Diffstat (limited to 'xtract/xtract_vector.h')
-rw-r--r--xtract/xtract_vector.h29
1 files changed, 29 insertions, 0 deletions
diff --git a/xtract/xtract_vector.h b/xtract/xtract_vector.h
index e67ae6d..7effac0 100644
--- a/xtract/xtract_vector.h
+++ b/xtract/xtract_vector.h
@@ -126,6 +126,35 @@ int xtract_peak_spectrum(const float *data, const int N, const void *argv, float
*/
int xtract_harmonic_spectrum(const float *data, const int N, const void *argv, float *result);
+/** \brief Extract Linear Predictive Coding Coefficients
+ *
+ * Based on algorithm in Rabiner and Juang as implemented by Jutta Degener in Dr. Dobb's Journal December, 1994.
+ *
+ * Returns N-1 reflection (PARCOR) coefficients and N-1 LPC coefficients via *result
+ *
+ * \param *data: N autocorrelation values e.g the data pointed to by *result from xtract_autocorrelation()
+ * \param N: the number of autocorrelation values to be considered
+ * \param *argv: a pointer to NULL
+ * \param *result: a pointer to an array containing N-1 reflection coefficients and N-1 LPC coefficients.
+ *
+ * An array of size 2 * (N - 1) must be allocated, and *result must point to its first element.
+ */
+int xtract_lpc(const float *data, const int N, const void *argv, float *result);
+
+/** \brief Extract Linear Predictive Coding Cepstral Coefficients
+ *
+ * \param *data: a pointer to the first element in an array of LPC coeffiecients e.g. a pointer to the second half of the array pointed to by *result from xtract_lpc()
+ * \param N: the number of LPC coefficients to be considered
+ * \param *argv: a pointer to a float representing the order of the result vector. This must be a whole number. According to Rabiner and Juang the ratio between the number (p) of LPC coefficients and the order (Q) of the LPC cepstrum is given by Q ~ (3/2)p where Q > p.
+ * \param *result: a pointer to an array containing the resultant LPCC.
+ *
+ * An array of size Q, where Q is given by argv[0] must be allocated, and *result must point to its first element.
+ *
+ */
+int xtract_lpcc(const float *data, const int N, const void *argv, float *result);
+
+
+
/** @} */
#ifdef __cplusplus