Acoustic Research Tool (ART) Files

*******************************************************************************************************************************

The executable "Setup_ART_V0.10_TAP_V2.5_Build.007.exe" installs TAP and ART along with documentation and programming examples.

The new start menu group TAP will contain shortcuts to ART-Demo, a sample GUI application demonstrating basic frequency domain models, and AcousticCircuit which allows to calculate Input Impedance of more sophisticated circuits including tone holes and bent ducts using multi modal transmission line modeling. The TAP start menu group also contains a link to a folder with programming examples in C, Pascal and Python, which are installed if the "Examples" installer option is checked. TAPGUI is a GUI for all sorts of command line tools and shell scripts. 

The source code of AcousticCircuit and ART-Demo, provided as Delphi/Lazarus Pascal examples, demonstrates how Windows application programs can access functionality provided by the ART library. It can be taken as a starting point for writing much more complete and sophisticated acoustic simulation programs in Delphi/Lazarus or in any other programming language. AcousticCircuit contains a simple graphical editor for composing sophisticated circuits from basic building blocks. The context menu of any of these building blocks contains a command to calculate the local impedance at its input. Acoustic circuits and bore profiles can be saved and reloaded. Several different examples are provided.

Time domain simulation capabilities of the ART-library are demonstrated by means of several Python examples. The scripts have been tested with Python 2.7.3. Plot output requires the Python packages NumPy and MathPlotLib. The package also needs msvcr100.dll and msvcp100.dll both being part of the VisualStudio_2010 redistributable. Using default options of the ART installer will install everything required to run and develop the Python example scripts. Time domain examples include sound generation of a clarinet with vibrating reed, sound generation of a trumpet with vibrating lips, non-linear wave steepening in a cylindrical tube and examples of how to solve differential equations by means of a Finite Difference scheme, sound propagation in a conical and in an exponential horn and more.  

The installer adds the command "DOS Prompt Here" when a folder is right-clicked in the explorer (Windows 7: hold <shift> while right-clicking). This opens a command shell (cmd.exe) for this folder. In this command shell the Path-variable will contain the TAP installation folder and filename-auto-completion by pressing the TAB key will be enabled. In order to make the new value for the Path-variable effective, a reboot (actually a re-login) is sometimes required.  

This installer has been tested on Win2k, WinXP, Win7 and Win8. Please report installation problems to kausel(at)mdw.ac.at

*******************************************************************************************************************************

Release Notes:

Build.007:     Added NonLinearFrenchHorn examples presented at SMAC 2013
Build.006:     Added TimeDomain Simulator with Python examples
Build.005:     Frequency Domain Simulator with Delphi examples

*******************************************************************************************************************************

Testing the installation:
=========================


The command line

    art -cyl -freq 10 1000 5 1

should simulate a straight tube and analyse its input impedance for resonance frequencies.



The command line

    art -con 200 1 10 -freq 10 1000 5 | plot -sig 3 -xcol 1 -ycol 2 

should plot the impedance curve of a cone with 200cm length, 1cm entry radius and 10cm radius of the open mouth between 10Hz and 1000Hz at 5Hz increments. The output stream of the art command contains 3 columns, the frequency, the magnitude and the phase of the input impedance. The plot command is instructed about the 3 columns and it takes the first as x and the second as y.


The command lines

    art -?

and

    plot -?

will show many more options of the two involved TAP modules. The TAP reference manual documents all available modules and their usage. The strength of the TAP package is that powerful scripts can be written which are able to analyse folders and folder trees with thousands of data files without any user interaction.

*******************************************************************************************************************************