Sound Pressure (SPL) Mapper for Acoustical Room Analysis
Branch: master
Clone or download
Latest commit 22f0a56 Feb 9, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples . Jan 18, 2017
lib . Dec 29, 2016
release Beta release of version 0.1 Feb 7, 2017
resources . Feb 7, 2017
src Beta release of version 0.1 Feb 7, 2017
.DS_Store . Jan 26, 2017
.classpath . Dec 29, 2016
.gitignore . Jan 18, 2017
.project . Dec 29, 2016
README.md . Feb 9, 2017
build.xml . Jan 26, 2017

README.md

RoomMap

Sound Pressure (SPL) Mapper for analysis of the distribution of low frequency sound pressure levels across a room.

RM2

This application is used to evaluate field measurements made with the free software REW (Room EQ Wizard, download from here), in order to gain a better overview about the distribution of sound pressure levels in a room at low frequencies. While doing acoustical room treatments, this can help identifying the locations in a room where a specific frequency is building up significantly, for example.

The program is especially useful when analyzing rooms which are not rectangular or non-symmetric. Modal behaviour can not be calculated properly for such rooms, but this program can deliver a good overview of the room's low frequency distribution.

Currently, the application is released in beta state. It is fully functional, but there are some minor cosmetic flaws, as well as the release packages for some platforms are not ready yet. If there are any bugs etc., please inform me and i will take care of them.

Version History

  • Version 0.1 (07.02.2017): Initial release in beta state.

Installation / Requirements

The program is fully implemented in Java, the minimum version requirement is Java 1.8. A complex installation is not necessary.

Mac OS

For Mac OS X users (minimum tested version is 10.8 Mountain Lion), there is a DMG package ready for download. Just copy the contained application to your programs folder or wherever you want. However, OS X users can also manually start the JAR package from the console similar as described for Windows/Linux users, if the DMG should not work.

Windows

Currently there is no installer or EXE file for Windows users (yet), but as for all Java applications, you can just download the JAR package RoomMap.jar and run it manually from the command line. If you need advice on this, see this documentation under 'JAR Files as Applications' and this video (randomly picked) to see how to run a java program from the Windows command line. The application has been tested successfully with Windows 7 and 8.1.

Linux

The application has not been tested with Linux yet, but just running the JAR file with the correct Java JRE >= JRE 1.8 should work well as the program does not access any complicated resources of the system.

Eclipse

If you want to build the application by yourself: It has been developed on Mac OS 10.8 using Eclipse Luna (4.4.1). The complete project is contained in this repository.

Procedure of Measurement

After launching, the program asks you to select some files. These files have to be created with REW (Room EQ Wizard, download from here) first, which is an open-source, free Java program to make acoustical room measurements with a measurement microphone. If you don't have experience with REW already, there is plenty of information and tutorials around the web about this.

Optionally, you can first download the examples provided with RoomMap (folder examples), which can give you a hint how things work. Comments on these examples follow later in this document.

Proceed as follows:

  • In your room, mark a grid of (for example) 1 meter distance on the floor with some tape. Start in one corner (preferably the one behind the left speaker at the bottom), which will be your 0 0 0 point, and work from there until the whole room is "rasterized".

    markings

    Because we will analyze low frequencies mainly, accuracy is not too critical here, +/- 5cm is enough, compared to the wavelengths we have in lower bass regions below say 200 Hz.

    Also, if your room has a non-rectangular shape like an attic for example, this is no problem at all.

  • At each of these points, make measurements with REW at heights of (for example) 0m (floor), 1m, 2m and so on. This way you have "quantized" your room with measurements.

    To start the individual measurements, you can use VNC to remote control your computer from a smartphone or tablet. While pointing the mic at the measurement points in the room, always moving back to the PC can be cumbersome. With VNC, you can see your desktop from any mobile device and make the 2 necessary clicks to start the next measurement from there directly. By this method, the process is not taking too long if done effectively: For example, an attic room (used for creating the RoomMap examples) with size of about 4,5m x 8m took only about 3 hours for measuring, producing 264 files of 264 measuring points altogether.

    Parameters of REW are not critical, a short sweep of 128k will be enough, also it does not make sense to measure up to high frequencies. The Shannon/Nyquist sampling theorem applies here. If doing the grid with 1m distances, the maximum accurate frequency will be around 2m in wavelength, which corresponds to a maximum accurate frequency of about 170 Hz. However, the program will only visualize data which is within these accuracy borders anyway, but be aware of this.

  • For each measurement, write the coordinates in REW's description fields like this:

    REW1

    The syntax is: X Y Z In words: X coordinate (width) in meters, followed by space, then Y (length) in meters, then space again, then Z (height) in meters. You can also use non-integer values, in this case, use the dot (.) as the decimal separator (commas will not work). Examples: if 0 0 0 would be our starting point in the lower left corner in front of the listening position in an average control room, 0.5 0 0 would be half a meter towards the right from that corner, and 3 0 1 would be 3 meters to the right and 1 upwards from the floor, seen from the corner, you get it.

    It is also allowed (and intended) to do additional measurements between the grid in areas where more accuracy is wanted, for example behind the speakers. In this case, just specify the coordinates as mentioned above, the interpolation of the program can handle this nicely.

  • Export the measurements from REW as text files. This is done in the menu:

    REW2

    REW then creates one file per measurement, which contains the SPL for given frequencies. The file name will contain the coordinates as entered before in REW.

  • Launch the RoomMap program, browse to the folder where you stored the REW export files, and select all of them. Then hit "Open". The program will soon show you a first SPL map of your room :)

    RM1

    Here for example, the first axial room mode (and the only one because this is no rectangular room) of about 40 Hz distributes like expected: Between front and back walls.

Operation Tips

Data Visualization

The data visualization is generated by interpolating between the measured points. The view is from top down: You always see the SPL at a fixed height (adjustable with the corresponding slider), as seen from birds eye view. There is no 3d projection (yet). The data points are marked with small dots, accompanied with a 1 meter grid for orientation. Also, as you experiment with the height slider (which adjusts the Z coordinate), the points from which the current layer is interpolated the most, are shown a bit more focused than the others. In the real test examples provided (which have also been used for the screenshots here), you can see for example that the room has a cut out area: Behind the mixer, there is a small closet installed, occupying the left behind quarter of floor space. Also the room is an attic room, and on the front side (where the monitors are) and in some other places, the grid of measuring points has been made smaller to gain more accuracy there.

In general, you first set the frequency you are interested in, and then, with the height slider, you "move" up and down in the room to see the SPL distribution at the corresponding height above the floor. This can be useful to determine where a certain frequency is treated most effectively. For example, pressure based absorbers are best placed in the hottest SPL areas, while velocity based absorbers have to be put at velocity maxima which can be approximated with some experience in acoustics, perhaps also using the "Show wavelength circles" option explained below.

NOTE: In general, the location of velocity maxima is NOT directly correlated to the SPL maxima, as the phase relationship between pressure and velocity can vary from 0 (linear sound wave) to a certain amount of degrees (radial sound wave). See TODO for details on this.

Also, the SPL maps give some hint if a specific low frequency problem is of modal nature (like in the 40 Hz example above), or if it is caused by speaker boundary interferences (SBIR). In the given example, 83 Hz has a severe dip in frequency response. The SPL map for 83 Hz shows that the pressure is mostly building up behind the left speaker (which is running alone for these measurements), so this is most likely caused by SBIR. Putting a wavelength circle at speaker position also verifies that 1/4 wavelength of 83 Hz (ca. 1.1 meters) indicates that the left wall might be the issue:

RM4

On the opposite, in the screenshot farther above, the 40 Hz mode is building up almost as much SPL at front and back wall.

Controls

Sliders

  • Frequency controls the frequency currently displayed.
  • Height adjusts the height in the room which is visualized.
  • Margin is used to set the extra space shown outside the outmost measuring points.
  • Resolution sets the accuracy of the visualization

Options

  • Normalize SPLrange for selected frequency Can be used to extend the color scheme to be fully used for displaying the SPL at the current frequency. This increases contrast, but makes it more difficult to compare between frequencies on the other hand.
  • Show Grid Switches the 1 meter grid on/off.
  • Show wavelength circles If you click anywhere inside the visualization, circles of 1/4, 1/2, 3/4 and 4/4 wavelength are drawn around the clicked point. This can be handy to visualize the wave dimensions against the data.
  • Only show accurate data This does not show data in areas where not enough measuring points exist to do a reasonably accurate approximation of the SPL. This is determined using the sampling theorem. It is recommended to let this switched on.
  • Multithreaded interpolation with X Threads As calculation of the interpolated data is CPU intensive, this job can be distributed among several threads. Use this to speed up frequency and height changes.
  • Precalc. in Background with X Threads Additionally to the last option, changes in frequency can be accelerated by precalculating the interpolator coefficients for all frequencies in advance. To do this, check this option after startup and wait until calculation has finished. Frequency changes are usually much faster after that.

Examples

The examples delivered with RoomMap should help getting started with the program. They are created in an attic room of about 4,5 x 8 meters, while in the back part the room is halfed to host a small bathroom. See the data points in the visualization to get a picture. Also, the room's side walls are completely slanted from the floor up, until they meet at about 3 meters above the floor, this being an attic room, with walls built from double layered drywall, a glass front, and concrete floor with laminate. Provided examples are:

  • realtest1: First room measurements, measured with relatively high noise floor. Anyway, it shows the capabilities of the program pretty good. Left speaker only, located at about 1 / 0 / 1.5 meters in the room (x/y/z), pointing towards the room middle, where the listening position was.

  • simple16: Generated testing example, not really useful, just ignore this

  • simpleCube8: Generated testing example, not really useful, just ignore this

Links

https://www.roomeqwizard.com/

Licensing

This program is licensed as free, open-source software under the GNU Public License (GPLv3).

Dependencies to External Libraries

The following external libraries are used by this program (all included in this repository):

  • CONRAD: A library developed by the Stanford university in cooperation with Friedrich-Alexander Univerity Erlangen/Germany for cone-beam imaging in radiology, which is being used here just for thin plate spline interpolation in three-dimensional space. Only the needed sources are included directly in this project, only altered minimally for compatibility issues. See http://www5.cs.fau.de/conrad/ for details.
  • ij.jar: Dependency of CONRAD
  • Jama-1.0.2.jar: Dependency of CONRAD
  • jpop.0.7.5.jar: Dependency of CONRAD
  • rainbowvis: This is also included as source, and (slightly altered for compatibility) used for generating the rainbow color visualization.