SubMaap
1.0
By
www.educasound.com
INDEX
1 INTRODUCTION ........................................................................................... 5
2 COMPILER INSTALLATION PROCESS .................................................... 6
2.1 SUBMAPP INSTALLATION PROCESS IN MAC .................................................... 7
2.2 SUBMAPP INSTALATION PROCESS IN WINDOWS 64 BITS............................ 11
3 SUBMAPP 1.0 .............................................................................................. 14
3.1 PREDICTION MAP ................................................................................................... 14
3.2 PREDICTION MAP SIZE .......................................................................................... 15
3.3 SPATIAL RESOLUTION .......................................................................................... 15
3.4 VIEWING ENVIRONMENTS ................................................................................... 16
3.5 SPL RANGE ............................................................................................................... 20
3.6 CAD FUNCTION ....................................................................................................... 20
4 DSP ................................................................................................................ 22
5 MEASURAMENT MICROPHONES .......................................................... 23
5.1 SAVE AND EXPORT MEASUREMENT ................................................................. 24
5.2 IMPORT THE MEASUREMENT TO RiTA ANALYZER....................................... 25
5.3 IMPORT THE MEASUREMENT TO SMAART ANALYZER ............................... 26
2
FIGURES
Figure 2.1: Folder Mac Compiler R2016b (9.1) 64 bits............................................................. 6
Figure 2.2: Compiler installation directory R2016b (9.1) 64 bits. ............................................. 6
Figure 2.3: Password request ..................................................................................................... 7
Figure 2.4: Installing the executable .......................................................................................... 8
Figure 2.5: installation directory ................................................................................................ 8
Figure 2.6: Search for the compiler installation ......................................................................... 9
Figure 2.7: Checking program directories.................................................................................. 9
Figure 2.8: Educasound folder ................................................................................................. 10
Figure 2.9: Educasound / SubMapp folder............................................................................... 10
Figure 2.10: Installing the executable ...................................................................................... 11
Figure 2.11: Installation directory and generation of desktop icon.......................................... 12
Figure 2.12: Checking program directories.............................................................................. 12
Figure 2.13: Program Files folder ............................................................................................ 13
Figure 2.14: Program Files / Educasound folder...................................................................... 13
Figure 2.15: Program Files / Educasound / SubMapp folder ................................................... 13
Figure 2.16: Program Files / Educasound/ SubMapp / Application folder .............................. 13
Figure 3.1: Main screen ............................................................................................................ 14
Figure 3.2: Prediction map ....................................................................................................... 14
Figure 3.3: Coordinates ............................................................................................................ 15
Figure 3.4: Spatial resolution ................................................................................................... 15
Figure 3.5: Viewing environments ........................................................................................... 16
Figure 3.6: Prediction in Surf mode ......................................................................................... 16
Figure 3.7: Prediction in Surf 3 dB mode ................................................................................ 17
Figure 3.8: Prediction in Mesh mode ....................................................................................... 17
Figure 3.9: Prediction in Waterfall mode ................................................................................. 18
Figure 3.10: Prediction in Contour_line mode ......................................................................... 18
Figure 3.11: Prediction in Contour_Surf mode ........................................................................ 19
Figure 3.12: Prediction in FDTD_wave mode ......................................................................... 19
Figure 3.13: Prediction in FDTD_surf mode ........................................................................... 20
Figure 3.14: SPL Range .......................................................................................................... 20
Figure 3.15: Cad function......................................................................................................... 20
Figure 3.16: Graph of the Cad function ................................................................................... 21
Figura 4.1: DSP ........................................................................................................................ 22
Figure 5.1: Measuring Microphones ........................................................................................ 23
Figure 5.2: Measuring microphones position ........................................................................... 23
Figure 5.3: Measuring microphones response.......................................................................... 23
Figure 5.4: Synchronization and export format ....................................................................... 24
Figure 5.5: Synchronized measurements ................................................................................. 24
Figure 5.6: Not optimized system ............................................................................................ 25
Figure 5.7: RiTA Analyzer....................................................................................................... 25
Figure 5.8: Optimized system .................................................................................................. 26
Figure 5.9: Export in csv format .............................................................................................. 26
3
Figure 5.10: Measurements Imported to Smaart ...................................................................... 27
4
1 INTRODUCTION
SubMapp 1.0 is developed in MATLAB® code and, therefore, requires a compiler, as
explained below, for proper operation on computers that do not have the corresponding
license.
SubMapp is a prediction program that allows you to configure and analyze the behavior of
different types of subwoofer arrays. This first version simulates the behavior of a perfectly
omni-directional speaker for all frequencies.
SubMapp also incorporates the Finite Difference Time-Domain (FDTD) technique that
allows, through numerical analysis, to model the behavior and interactions of sound waves
from differential equations.
The software allows to position 4 microphones in the audience area and obtain the transfer
function or impulse response wav or csv format for analysis in the analyzer RiTA or other
analyzers that allow the import of these files.
5
2 COMPILER INSTALLATION PROCESS
In order to be able to run SubMapp it is imperative to install the Mac R2016b (9.1) 64-bit
compiler in advance: https://en.mathworks.com/products/compiler/mcr.html
In the case that the compiler, and only this, is already installed on the computer does not need
to perform the installation again.
Save the MATLAB Runtime installer file to the computer where you are going to run the
application or component.
Once downloaded, you should run the InstallForMacOSX.app application and follow the
installation steps. This process creates a folder in Applications or Program Files called
MATLAB.
Figure 2.1: Folder Mac Compiler R2016b (9.1) 64 bits.
Figure 2.2: Compiler installation directory R2016b (9.1) 64 bits.
6
2.1 SUBMAPP INSTALLATION PROCESS IN MAC
Once the compiler is installed, the SubMapp 1.0 folder should be unzipped. Within this folder
are the following files: Guía de usuario / User guide
1. for_redistribution:files_only folder
2. for_redistribution folder
The SubMapp installation process can be performed in two ways:
1. for_redistribution:files_only: The folder contains the SubMapp executable. Double-
clicking SubMapp runs in about 30 seconds. Every time you want to open the
program, you simply have to access this folder and run it
2. For-redistribution: The folder contains an executable called MyAppInstaller_web.
This option allows to install SubMapp via internet. This process installs the
application in the applications folder from where you can open the program every time
you want to use.
IMPORTANT: The compiler must be installed before installation via web. If the compiler is
not installed SubMapp will install it on the computer and this process can be very slow.
The installation process is as follows:
• Once the MyAppInstaller_web application is run, SubMapp locates if the computer
has the compiler installed and if any Java update is required.
Figure 2.3: Password request
7
• Once this process has been completed, follow the installation instructions
Figure 2.4: Installing the executable
Figure 2.5: installation directory
8
• The program generates a folder called Educasound in Applications, SubMapp is
installed inside
Figure 2.6: Search for the compiler installation
Figure 2.7: Checking program directories
9
• Once the installation process is finished, the Educasound / SubMapp / Application
folder contains the application
Figure 2.8: Educasound folder
Figure 2.9: Educasound / SubMapp folder
10
2.2 SUBMAPP INSTALATION PROCESS IN WINDOWS 64 BITS
Once the compiler is installed, the SubMapp 1.0 folder should be unzipped. Within this folder
are the following files: Guía de usuario / User guide
3. for_redistribution:files_only folder
4. for_redistribution folder
The SubMapp installation process can be performed in two ways:
3. for_redistribution:files_only: The folder contains the SubMapp executable. Double-
clicking SubMapp runs in about 30 seconds. Every time you want to open the
program, you simply have to access this folder and run it
4. For-redistribution: The folder contains an executable called MyAppInstaller_web.
This option allows to install SubMapp via internet. This process installs the
application in the applications folder from where you can open the program every time
you want to use.
IMPORTANT: The compiler must be installed before installation via web. If the compiler is
not installed SubMapp will install it on the computer and this process can be very slow.
The installation process is as follows:
Figure 2.10: Installing the executable
11
• The program generates a folder named Educasound in Program Files where SubMapp
is installed
Figure 2.11: Installation directory and generation of desktop icon
Figure 2.12: Checking program directories
12
Figure 2.13: Program Files folder
Figure 2.14: Program Files / Educasound folder
Figure 2.15: Program Files / Educasound / SubMapp folder
Figure 2.16: Program Files / Educasound/ SubMapp / Application folder
13
3 SUBMAPP 1.0
Figure 3.1: Main screen
3.1 PREDICTION MAP
The prediction map is automatically adjusted to maintain the actual proportions according to
the chosen coordinates.
Figure 3.2: Prediction map
14
3.2 PREDICTION MAP SIZE
Figure 3.3: Coordinates
The Size X and Size Y parameters determine the size of the prediction plane.
The OX and OY parameters determine the origin of the coordinate axis. The OX and OY
parameters can take negative values.
3.3 SPATIAL RESOLUTION
SubMapp allows you to modify the spatial resolution of the prediction. A higher resolution
for large prediction sizes implies a longer processing time. This parameter is determinant in
the time to obtain the response when the FDTD technique is used.
Figure 3.4: Spatial resolution
1. Coarse: Spatial resolution of 0.5 m.
2. Medium: Spatial resolution of 0.25 m.
3. Fine: Spatial resolution of 0.1 m.
15
3.4 VIEWING ENVIRONMENTS
Figure 3.5: Viewing environments
1. Surf: Displays the prediction with a 64-color palette.
Figure 3.6: Prediction in Surf mode
16
2. Surf 3 dB: Displays the prediction with a color change every 3dB
Figure 3.7: Prediction in Surf 3 dB mode
3. Mesh: It allows to see the prediction with the amplitude of the sound pressure in the
plane Z
Figure 3.8: Prediction in Mesh mode
17
4. Waterfall: Similar to the Mesh function, but does not generate the lines of the columns
of the matrices.
Figure 3.9: Prediction in Waterfall mode
5. Contour_line: It generates the lines of equal pressure:
Figure 3.10: Prediction in Contour_line mode
18
6. Contour_Surf: It generates the surface of equal pressure:
Figure 3.11: Prediction in Contour_Surf mode
7. FDTD_wave: It generates the motion and interactions of a sinusoid of the chosen
frequency.
Figure 3.12: Prediction in FDTD_wave mode
19
8. FDTD_surf: It generates the motion and interactions of a complex exponential of the
chosen frequency.
Figure 3.13: Prediction in FDTD_surf mode
3.5 SPL RANGE
Figure 3.14: SPL Range
By default, SubMapp displays the prediction with the maximum SPL level and a range of -42
dB. The values can be manually modified by the user
3.6 CAD FUNCTION
Figure 3.15: Cad function
The Cad function draws a polar pattern with concentric circles each time the distance is
doubled and a resolution of 5 degrees with the coordinate axis at the point (0,0).
The Length parameter determines the diameter of the polar pattern. If the length of the
20
diameter does not match a power of 2 automatically cad will implement the power of 2
nearest.
Figure 3.16: Graph of the Cad function
21
4 DSP
Figura 4.1: DSP
The DSP function allows you to activate and deactivate the speakers, choose the coordinates
of their position, reverse the polarity, modify the gain and apply a delay time.
22
5 MEASURAMENT MICROPHONES
Figure 5.1: Measuring Microphones
SubMapp allows you to use 4 measurement microphones and get the impulse response and
prediction transfer function.
Figure 5.2: Measuring microphones position
If any of the microphones is active, once the SubMapp prediction is performed it shows a
graph with the measurement transfer function
Figure 5.3: Measuring microphones response
23
WARNING: It may be that the graph of the Transfer function is covered by the graph of the
main screen, in that case simply move the main screen to access the graph of the
measurement.
5.1 SAVE AND EXPORT MEASUREMENT
Synchro Export Format
Figure 5.4: Synchronization and export format
The Save function saves the measurement in the format specified.
1. .Wav: Export the impulse response in wav format. This export is designed to work
with the RiTA analyzer
2. .csv: Export the transfer function into a text file in csv format. This export is intended
for use in analyzers that accept this format.
Synchro: This function allows the synchronized measurement to be displayed on the screen.
This function is useful for exporting to analyzers that accept text files.
Figure 5.5: Synchronized measurements
24
5.2 IMPORT THE MEASUREMENT TO RiTA ANALYZER
The memories stored in wav format, can be imported to the RiTA analyzer and produce a
virtual adjustment.
The Load function of the RiTA analyzer allows you to import measurements taken externally.
Figure 5.6: Not optimized system
Figure 5.7: RiTA Analyzer
25
Figure 5.8: Optimized system
5.3 IMPORT THE MEASUREMENT TO SMAART ANALYZER
Smaart allows you to import transfer functions in .csv format. Therefore, if you export in this
format the measurements made in SubMapp, they can be opened to display the transfer
function.
Figure 5.9: Export in csv format
26
Figure 5.10: Measurements Imported to Smaart
27