Flute acoustics: measurement, modelling and design - School of ...

252 APPENDIX B. PROGRAM LISTINGS
/*
Reads the next data point present in the impedance spectra file, and
places this within a window of data points - also shifting the
window to the right by one point and popping the leftmost data
point.
Parameters:
points: the window of data points that the function updates.
allpoints: the vector of all data points.
index: the next point in the allpoints vector to read.
Returns:
1 if successful, 0 otherwise (such as EOF reached).
*/
int numExtrema(Vector points, minmax type);
/*
Calculates the number of local extrema in the given Vector window.
Parameters:
points: the window of data points that the function processes.
type: a minmax type indicating minimum/maximum.
Returns:
The number of local extrema.
*/
double lowest(Vector points);
/*
Evaluates the frequency of the lowest y value among a set of data
points.
Parameters:
points: a Vector of Points
Returns:
A double of the frequency of the lowest y value among points
*/
double highest(Vector points);
/*
Evaluates the frequency of the highest y value among a set of data
points.
Parameters:
points: a Vector of Points
Returns:
A double of the frequency of the highest y value among points
*/
void harmonicity(Vector minv);
/*
Sets the harmonicity variables numharm and meanharmZ
for each Minimum struct in a given minima vector.
Parameters:
minv: the vector of Minimum structs to be updated
*/
Vector harmonics(Vector minv, int pos);
/*
Evaluates the harmonics of a particular Minimum struct in a
given minima vector.
Parameters:
minv: the vector of Minimum structs for a particular data file
pos: the index of the required Mimimum struct in the vector