Home       Trees       Indices       Help   
The Wind Instrument Acoustic Toolkit
Package wiat :: Package TM :: Module Waveguides :: Class ToneHole
[hide private]
[frames] | no frames]

Class ToneHole

source code

This class implements the transmission matrix of tone holes References:

  1. J. Dalmont et al., "Experimental Determination of the Equivalent Circuit of an Open Side Hole: Linear and Non Linear Behaviour," Acta Acustica united with Acustica, vol. 88, pp. 567-575, 2002.
  2. D.H. Keefe, "Theory of the single woodwind tonehole," J. Acoust. Soc. Am., vol. 72, pp. 676-687, 1982.
  3. D.H. Keefe, "Experiments on the single woodwind tonehole," J. Acoust. Soc. Am., vol. 72, pp. 688-699, 1982.
  4. van Walstijn, M., & Campbell, M. (2003). "Discrete-time modeling of woodwind instrument bores using wave variables," J. Acoust. Soc. Am., vol. 113(1), 575-585.
  5. Nederveen, C. J. (1998). "Acoustical Aspects of Woodwind Instruments.", revised edition. 147 pages. Northern Illinois University Press.
Instance Methods [hide private]
 
__init__(self, d, t, p, d_pad=0.0, h_pad=0.0)
Initialization of a tonehole data structure		 source code
 
__str__(self) source code
 
relocate(self, new_p)
Change the position of the tonehole.		 source code
 
resize(self, new_d)
Change the diameter of the tonehole.		 source code
 
get_position(self) source code
 
delta(self, a)
Ratio of tone hole radius to body radius a: body radius		 source code
 
area(self)
Cross sectional area of the tonehole		 source code
 
InnerLengthCorrection(self, delta)
equation 4 from [1]		 source code
 
MatchingVolumeLengthCorrection(self, delta)
correction for matching volume, valid for cylindical bores ([1] eq.		 source code
 
RadiationLengthCorrection(self)
from [5]		 source code
 
PadLengthCorrection(self)
Nederveen (1998) eq.		 source code
 
OpenShuntImpedance(self, f, a, T)
formulation with losses, etc.		 source code
 
ClosedShuntImpedance(self, f, a, T)
impedance of a closed tone hole		 source code
 
SeriesLengthCorrection(self, delta)
inertance		 source code
 
SeriesImpedance(self, f, a, T)
Series impedance of the tone hole		 source code
 
TM(self, f, a, T, state=0)
Transmission matrix of the tone hole		 source code
Method Details [hide private]

__init__(self, d, t, p, d_pad=0.0, h_pad=0.0)
(Constructor)

source code 

Initialization of a tonehole data structure

Parameters:
  • d - diameter of the tonehole
  • t - height of the tonehole (minimum)
  • p - position of the center of the tonehole with respect to the beginning of the instrument.

relocate(self, new_p)

source code 

Change the position of the tonehole.

Parameters:
  • new_p - new position of the center of the tonehole with respect to the beginning of the instrument.

resize(self, new_d)

source code 

Change the diameter of the tonehole.

Parameters:
  • new_d - new diameter of the tonehole

delta(self, a)

source code 

Ratio of tone hole radius to body radius a: body radius

The tone hole radius was set at initialization

MatchingVolumeLengthCorrection(self, delta)

source code 

correction for matching volume, valid for cylindical bores ([1] eq. 6)

PadLengthCorrection(self)

source code 

Nederveen (1998) eq. 38.6

OpenShuntImpedance(self, f, a, T)

source code 

formulation with losses, etc. reference [1]

SeriesLengthCorrection(self, delta)

source code 

inertance

see ref [1] eq. 2, 3 and 4

TM(self, f, a, T, state=0)

source code 

Transmission matrix of the tone hole

f: frequency array a: radius of the bore at tonehole location p T: temperature state: open or closed


   Home       Trees       Indices       Help   
The Wind Instrument Acoustic Toolkit
Generated by Epydoc 3.0.1 on Wed Jun 18 14:33:29 2008 http://epydoc.sourceforge.net