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

APPENDIX B. PROGRAM LISTINGS 308
UnitCell createUnitCell(Hole hole, Vector bore);
/*
Creates a new UnitCell.
Parameters:
hole: the tone hole
bore: the bore section downstream of the hole (optional)
Returns:
a new UnitCell with the given parameters
*/
Woodwind createWoodwind(Head head, Vector cells, double flange);
/*
Creates a new Woodwind.
Parameters:
head: the Head of the woodwind
cells: a vector of unit cells
flange: the termination condition at the end of the instrument
Returns:
a new Woodwind with the given parameters
*/
void setAirProperties(Woodwind w, double t_0, double t_amb,
double t_grad, double humid, double x_CO2);
/*
Sets the speed of sound and density of air along the instrument.
Parameters:
w: the instrument
t_0: the temperature at x = 0 (embouchure hole) in deg C
t_amb: the ambient temperature (deg C)
t_grad: the temperature gradient (deg C / m)
humid: the relative humidity (between 0 and 1)
x_CO2: the molar fraction of carbon dioxide
*/
void discretiseWoodwind(Woodwind w, double maxLength);
/*
Cuts up instrument so that no segment is longer than maxLength.
Parameters:
w: the instrument
maxLength: the maximum segment length
*/
void discretiseBore(Vector bore, double maxLength);
/*
Cuts up a bore so that no segment is longer than maxLength.
Parameters:
w: the instrument
maxLength: the maximum segment length
*/
int setFingering(Woodwind w, char* holestring);
/*
Sets the woodwind fingering to the given string.
Parameters:
w: the instrument
holestring: a string of 'X's and 'O's representing the fingering
Returns:
1 if the operation was sucessful