SHAART Acoustic Tools

SHAART Acoustic Tools

Main web page:
GitHub page:

SHAART Acoustic Tools, v 0.7
(April 7, 2020)

(yes, the name is a joke)
About    Features    Downloads    License    Tutorials    Screenshots    Running From Source    Building an Executable    FAQ    Release Notes   




This lightweight audio analysis suite was initially written for educational purposes only over a period of 4 days. (And then improved in bits.) It's amazing how much you can accomplish with minimal knowledge of Python programming!

The name "SHAART" uses the author's initials (S.H.) in homage to the famous "SMAART" set of acoustics analysis tools by Rational Acoustics, Inc. ...That and "SHAART" is just hilarious to say, for other reasons. (Note: "homage" = parody, derivative work = fair use = please don't sue.)



Most of these features are illustrated in the Screenshots section further down this page.




2013 - 2015: This software is both "Open Source" and "Free," released under the Jesus license: "Freely you have received, freely give" (Matthew 10:8). Do as you like. Modify, redistribute, etc.

2015+: GPL 2. See file.








The spectrogram and waterfall plot (below) only show File A:




Note: The following 'Theoretical Steady-Steate Room Response' is pretty fake; it's just a bunch of superimposed parabolae, but without it this pane had a bunch of empty space:< br> modes


The values of absorption coefficients for the Sabine calculator come from the table in Chapter 8 of the Berg & Stork textbook:



The "invSpectro" feature created the file mandrill.wav which has a spectrogram shown below:

And interestingly, if the audio is encoded as an MP3, then re-read and re-written as a WAV, one can see the "lossyness" of the MP3:
One can also apply various audio effects to the sound and see the effect on the image, e.g. echo:



And here's an interesting one: a "leveler" effect:

Running from Source

Running from source:
Create a new Anaconda Python environment and install dependencies, then run...


Building an Executable

First follow the instructions above for running from source. Then we will proceed by using pyinstaller, that will create a new directory called SHAART/source/dist/, in which a successful build will result in the presence of working binary executable.

And (because of conflicts) downgrade setuptools too, via pip:


In order to run from source, you'd already need to have XCode, the command-line tools, and HomeBrew installed. Then in we install and an older versions of a few things to build the app:

...and you'll find in source/dist/.

Linux (Pop!_OS / Ubuntu)

We could re-use the .spec file from the Mac build, but it would give us a whole directory instead of one executable. Instead, run this line:

...And then you can just run the dist/SHAART executable from the command line. (Note: I can't seem to get it to be a "clickable icon" in Nautilus/Gnome. Not sure how to do that.)


Here are the steps taken to build the Window EXE:

  1. Download & Install Windows SDK:

  2. Download & Install Anaconda (64 bit):

  3. Run Anaconda Powershell prompt and install requirements:

  4. Downgrade setuptools to avoid conflicts pyinstaller as per pip install --upgrade 'setuptools<45.0.0'

  5. Run pyinstaller with these arguments:


Changing the GUI

Run QT5's designer or Designer app (good luck finding this on your hard drive, btw; instead you might want to just download QT from the main site). Open ui_shaart.ui as an input file. Change the GUI as you like, save it, and then to generate the .py file, run



Release Notes / Issues


More docs & info

Purpose: SHAART is intended as an in-house solution for teaching PHY2010 ("Physics for Audio Engineering Technology") at Belmont University. Perhaps others will find it useful as well. ...That and the PHY4410 ("Survey of Advanced Physics") students and I have been learing Python this semester to implement our simulations and analysis, so writing this also serves as an instructive exercise in Python programming.

Nomenclature: The name is an acronym using the author's initials (S.H.), along with words like "Acoustic," "Analysis," "Reverberation Time" or "Research Tools" -- as well as, it is hoped, a lighthearted and not-legally-problematic play on words with the name of the industry-standard SMAART audio analysis software made by Rational Acoustics, Inc. (SHAART is in no way affiliated with SMAART or Rational Acoustics, fyi.) ...I mean, "SHAART" is just hilarious to say.

Author: Dr. Scott H. Hawley, Associate Professor of Physics, Belmont University, Nashville TN USA.
Date: April 7, 2020 (original March 24, 2013)

Contact: Improvements, bug reports, inquiries, donations, etc.: scott.hawley@(belmont)

Author: Scott Hawley