Acoustic Research Tool (ART) Files

You can use ART as a command line tool or make your own applications using the programming interface. We recommend you download the complete documentation (ARTv0_9doc.pdf or .chm) or read it on http://artool.sf.net 

Here you can download the command line tool and the DLL if you do not want to compile it on your own. Please check the documentation and sample applications' source code to learn how to use the DLL.

Folder Contents - Overview
**************************

 * TAP-Installer.zip 

       An installer for TAP and the Delphi executables. Also comes with documentation.


 * DelphiSampleAppsExe.zip

       The executables of the Delphi sample applications


 * ART_exe_v0_9.zip

       The ART command line tool


 * ART_dll_v0_9.zip

       The ART dll


 * ReadMe.txt

       This file 


 * ins-spec.txt

       Specification of instrument files (used for the command line tool)


 * trumpet.ins

       A sample instrument file


 * TAP-Win32-V2.5.zip 

       The Toolbox for analysis and prototyping (executable and documentation). The ART command line tool is best used with parts of this toolbox. Again: check the documentation for details (http://artool.sf.net)



Below you'll find a quick guide on how to use ART as a command line tool:

"Manual" Setup of ART and TAP (ie. without using the installer) 
***************************************************************

  1. Installation

    * Extract zipped archive to a local folder (e.g. "C:\TAP").
    * DoubleClick "C:\TAP\command completion (HKCU-NT shell).reg" to turn on filename completion with TAB-key
    * RightClick/Install "C:\TAP\DOSHERE.INF" to enter a "DOS Prompt Here" command to your explorer's folder context menu
    * Use Settings/ControlPanel/System/Extended/Environment Variables/ to prepend "C:\TAP;" to the system variable named "Path" (it might now be necessary to logoff and logon again to make your changes effective)


  2. Verify the Installation

    * Open a command shell using the explorer's context menu of some (empty) folder.
    * enter "path" at the command prompt to see whether "C:\TAP" is the first entry in your path system variable.
    * enter "stim | envsort | plot" to check whether everything is working. A GNUPlot window with a sinewave should open.



Running the simulator
*********************

The following command will simulate the input impedance of a straight tube of 100 cm length and 0.5 cm radius and send the frequency and magnitude columns of the resulting binary stream to the plot program. The programme will simulate the tube at equally spaced frequencies between 50 Hz and 1000 Hz with 5 Hz increment and won't read the input stream.

    art -freq 50 1000 5 -cyl 100 0.5 | plot -sig 3 -xcol 1 -ycol 2 -nam ImpMag -xu [Hz] -yu [acOhm] -tit "Tube 1m" 

To do the same and see a numerical table with three columns (f, mag, arg) instead of plotting the binary stream, type:

    art -freq 50 1000 5 -cyl 100 0.5 | bin2flo -columns 3 -nocount 

To do the same but calculate resonant frequencies and magnitudes instead of generating a binary plot stream:

    art -freq 50 1000 5 1 -cyl 100 0.5

To simulate a complete trumpet described in an instrument file, type:

    art -freq 50 1000 5 -list trumpet.ins | plot -sig 3 -xcol 1 -ycol 2 -nam ImpMag -xu Hz -yu Ohm -tit "Trumpet"



Instrument file format
**********************

The programme defines its instruments in a top-down, object-oriented approach. The .ins file-format likewise represents instruments in this manner. An instrument consists of a list of elements describing its geometry, each of which has parameters specifying the exact dimensions.

  1. Element types

    0 - bore discontinuity (input radius, output radius, T, L, H, CO2)
    1 - cylinder (length, radius, T, L, H, CO2)
    2 - cone section (length, input radius, output radius, T, L, H, CO2)
    3 - Bessel horn section (length, input radius, output radius, flare coefficient, T, L, H, CO2)
    4 - list element (filename)
    5 - cylindrical bend (length, radius, bend radius, T, L, H, CO2)
    6 - conical bend (length, input radius, output radius, bend radius, T, L, H, CO2)
    7 - termination element (type of termination [can be 0=reflecting or 1=Zorumski], T, L, H, CO2)
    8 - branch element (calculation model, number of holes, T, L, H, CO2)

   where

    T...temperature in degree centigrade (default is 21°C)
    L...loss factor (default is 1)
    H...air humidity in percent
    CO2...carbon dioxide content of air in ppm
    The unit of length is cm.

  2. Format specification

A .ins file is a list of element types followed by relevant parameters separated by commas. Whitespace is permitted, but parameters must be on the same line as the element type. Any lines starting with a semi-colon ; are ignored as comments. Comments may not be placed on the same line as commands. Lines may not begin (or consist solely of) whitespace. The first non-commented line of the file defines the name of the instrument.
Example file

    Test Instrument
    ; - this is a comment
    1, 10.0, 1.5
    ; ^ this is a cylinder, length 10cm, radius 1.5cm
    ;
    2, 20.0, 1.5, 2.0
    ; ^ this is a cone, length 20cm, radius 1.5..2.0cm
    ;
    4, filename.ins 
    ; ^ this loads a list element and appends it.



Learning more about ART and TAP
*******************************

    * enter "art -?" for a complete list of options
    * type one of the following commands to learn more about other parts of TAP:

        bin2flo -?
        plot -?
        stim -?

    * Read the TAP reference manual (part of Executables/Win32/TAP-Win32-V2.5.zip)
    * Check out the documentation on http://artool.sf.net