source: src/spectral/tss.h @ 1a8ce10

feature/cnnfeature/crepefix/ffmpeg5
Last change on this file since 1a8ce10 was 6f42c16, checked in by Paul Brossier <piem@piem.org>, 9 years ago

src/: change c header identifiers (see #35)

  • Property mode set to 100644
File size: 2.6 KB
RevLine 
[96fb8ad]1/*
[b235c0e]2  Copyright (C) 2003-2013 Paul Brossier <piem@aubio.org>
[e6a78ea]3
4  This file is part of aubio.
5
6  aubio is free software: you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation, either version 3 of the License, or
9  (at your option) any later version.
10
11  aubio is distributed in the hope that it will be useful,
12  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  GNU General Public License for more details.
15
16  You should have received a copy of the GNU General Public License
17  along with aubio.  If not, see <http://www.gnu.org/licenses/>.
18
[96fb8ad]19*/
20
[2a04c2c]21/** \file
22
23  Transient / Steady-state Separation (TSS)
24
25  This file implement a Transient / Steady-state Separation (TSS) as described
26  in:
27
28  Christopher Duxbury, Mike E. Davies, and Mark B. Sandler. Separation of
29  transient information in musical audio using multiresolution analysis
30  techniques. In Proceedings of the Digital Audio Effects Conference, DAFx-01,
[f1b6aad]31  pages 1--5, Limerick, Ireland, 2001.
32
33  Available at http://www.csis.ul.ie/dafx01/proceedings/papers/duxbury.pdf
[2a04c2c]34
[8a5c8ba]35  \example spectral/test-tss.c
36
[2a04c2c]37*/
[96fb8ad]38
[6f42c16]39#ifndef AUBIO_TSS_H
40#define AUBIO_TSS_H
[96fb8ad]41
42#ifdef __cplusplus
43extern "C" {
44#endif
45
[f1b6aad]46/** Transient / Steady-state Separation object */
[96fb8ad]47typedef struct _aubio_tss_t aubio_tss_t;
48
[2a04c2c]49/** create tss object
50
[3ac7cb0]51  \param buf_size buffer size
52  \param hop_size step size
[2a04c2c]53
54*/
[d95ff38]55aubio_tss_t *new_aubio_tss (uint_t buf_size, uint_t hop_size);
[f1b6aad]56
[2a04c2c]57/** delete tss object
58
[f1b6aad]59  \param o tss object as returned by new_aubio_tss()
60
61*/
62void del_aubio_tss (aubio_tss_t * o);
63
64/** split input into transient and steady states components
[a82cedc]65
[f1b6aad]66  \param o tss object as returned by new_aubio_tss()
67  \param input input spectral frame
68  \param trans output transient components
69  \param stead output steady state components
[2a04c2c]70
71*/
[feb694b]72void aubio_tss_do (aubio_tss_t * o, const cvec_t * input, cvec_t * trans,
[f1b6aad]73    cvec_t * stead);
[96fb8ad]74
[a82cedc]75/** set transient / steady state separation threshold
76
[f1b6aad]77  \param o tss object as returned by new_aubio_tss()
[2a04c2c]78  \param thrs new threshold value
79
80*/
[f1b6aad]81uint_t aubio_tss_set_threshold (aubio_tss_t * o, smpl_t thrs);
82
83/** set parameter a, defaults to 3
[a82cedc]84
[f1b6aad]85  \param o tss object as returned by new_aubio_tss()
86  \param alpha new value for alpha parameter
87
88*/
89uint_t aubio_tss_set_alpha (aubio_tss_t * o, smpl_t alpha);
90
91/** set parameter b, defaults to 3
[a82cedc]92
[f1b6aad]93  \param o tss object as returned by new_aubio_tss()
94  \param beta new value for beta parameter
[102b732]95
[2a04c2c]96*/
[f1b6aad]97uint_t aubio_tss_set_beta (aubio_tss_t * o, smpl_t beta);
[96fb8ad]98
99#ifdef __cplusplus
100}
101#endif
102
[6f42c16]103#endif /* AUBIO_TSS_H */
Note: See TracBrowser for help on using the repository browser.