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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
#ifndef INCLUDE_PARTIALBUILDER_H
#define INCLUDE_PARTIALBUILDER_H
/*
* This is the Loris C++ Class Library, implementing analysis,
* manipulation, and synthesis of digitized sounds using the Reassigned
* Bandwidth-Enhanced Additive Sound Model.
*
* Loris is Copyright (c) 1999-2010 by Kelly Fitz and Lippold Haken
*
* 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
*
* PartialBuilder.h
*
* Implementation of a class representing a policy for connecting peaks
* extracted from a reassigned time-frequency spectrum to form ridges
* and construct Partials.
*
* This strategy attemps to follow a reference frequency envelope when
* forming Partials, by prewarping all peak frequencies according to the
* (inverse of) frequency reference envelope. At the end of the analysis,
* Partial frequencies need to be un-warped by calling fixPartialFrequencies().
*
* Kelly Fitz, 28 May 2003
* loris@cerlsoundgroup.org
*
* http://www.cerlsoundgroup.org/Loris/
*
*/
#include "Partial.h"
#include "PartialList.h"
#include "PartialPtrs.h"
#include "SpectralPeaks.h"
#include <memory>
// begin namespace
namespace Loris {
class Envelope;
// ---------------------------------------------------------------------------
// class PartialBuilder
//
// A class representing the process of connecting peaks (ridges) on a
// reassigned time-frequency surface to form Partials.
//
class PartialBuilder
{
// --- public interface ---
public:
// constructor
//
// Construct a new builder that constrains Partial frequnecy
// drift by the specified drift value in Hz.
PartialBuilder( double drift );
// constructor
//
// Construct a new builder that constrains Partial frequnecy
// drift by the specified drift value in Hz. The frequency
// warping envelope is applied to the spectral peak frequencies
// and the frequency drift parameter in each frame before peaks
// are linked to eligible Partials. All the Partial frequencies
// need to be un-warped at the ned of the building process, by
// calling finishBuilding().
PartialBuilder( double drift, const Envelope & freqWarpEnv );
// buildPartials
//
// Append spectral peaks, extracted from a reassigned time-frequency
// spectrum, to eligible Partials, where possible. Peaks that cannot
// be used to extend eliglble Partials spawn new Partials.
//
// This is similar to the basic MQ partial formation strategy, except that
// before matching, all frequencies are normalized by the value of the
// warping envelope at the time of the current frame. This means that
// the frequency envelopes of all the Partials are warped, and need to
// be un-normalized by calling finishBuilding at the end of the building
// process.
void buildPartials( Peaks & peaks, double frameTime );
void buildPartials( Peaks & peaks );
// finishBuilding
//
// Un-do the frequency warping performed in buildPartials, and return
// the Partials that were built. After calling finishBuilding, the
// builder is returned to its initial state, and ready to build another
// set of Partials. Partials are returned by appending them to the
// supplied PartialList.
void finishBuilding( PartialList & product );
// getPartials
//
// Return partials
void getPartials( PartialList & product );
Peaks & getPartials();
// maxPartials
//
// Change the maximum number of partials per frame
void maxPartials(int max);
// reset
//
// Reset the current partial list
void reset();
private:
// --- auxiliary member functions ---
double freq_distance( const Partial & partial, const SpectralPeak & pk );
double freq_distance( const SpectralPeak & pk1, const SpectralPeak & pk2 );
bool better_match( const Partial & part, const SpectralPeak & pk1,
const SpectralPeak & pk2 );
bool better_match( const Partial & part1,
const Partial & part2, const SpectralPeak & pk );
bool better_match( const SpectralPeak & pk1, const SpectralPeak & pk2,
const SpectralPeak & pk3 );
int getNextActive(int start);
int getNextInactive(int start);
// --- collected partials ---
PartialList mCollectedPartials; // collect partials here
// --- builder state variables ---
std::vector<bool> mActivePartials;
std::vector<bool> mMatchedPartials;
PartialPtrs mEligiblePartials;
PartialPtrs mNewlyEligible; // keep track of eligible partials here
Peaks mCurrentPartials;
// --- parameters ---
std::auto_ptr< Envelope > mFreqWarping; // reference envelope
double mFreqDrift;
// --- disallow copy and assignment ---
PartialBuilder( const PartialBuilder & );
PartialBuilder& operator=( const PartialBuilder & );
}; // end of class PartialBuilder
} // end of namespace Loris
#endif /* ndef INCLUDE_PARTIALBUILDER_H */
|