Skip to main content

Quick start guide

Welcome to this tutorial in which we will guide you through runnig a simple simulation and getting results, using the Treble Acoustic Simulation Suite web app.

1. Navigating the projects overview

To open Treble, go to app.treble.tech. There, you’ll be presented with the home page. On the home page you see all of your projects and spaces. An example project is pre-loaded by default, featuring four pre-configured spaces to explore.

For the purposes of this tutorial, please select the ’Classroom’ space located in the top left corner.

alt text

You are now in the space overview. This interface allows you to select and manage models within the space. Given that this example space features only one model design of this classroom, proceed by selecting the ’Initial design’ model.

Enter the space by clicking the ’Open’ button.

alt text

2. Creating a simulation

Your are now in the Editor, where you can create and run simulations.

alt text

To set up a new simulation click new and choose ’Simulation’ from the popup that appears.

alt text

Choose a name for the simulation in the ’Simulation name’ field. You can also add your own description and notes in the ’Simulation description’ field.

alt text

3. Material assignment

The first step in creating a simulation is to assign materials and material properties to all surfaces in the model. To assign materials, select the relevant layer or surface in the list of layers on the right.

note

To run a simulation, all surfaces in the model need to be assigned materials.

Start by clicking the ’unassigned’ input for the ’Bookshelf’ layer. The selected surfaces get highlighted in the model and the material library appears.

alt text

To easily search within the material library, you can use the search bar at the top, or filter materials using the tags.

Firstly, let’s assign a material to the ’Bookshelf’ layer. Select the ’Wood’ tag and select the “Wood panel with air space behind” material. You can also use the search bar to find it.

Click on ’Assign’ to assign the material to the bookshelf.

alt text

The bookshelf has now been assigned the material ’Wood panel with air space behind’. A default scattering coefficient will be assigned, but we recommend that you adjust your scattering coefficients according to the values in the table below:

MaterialsScattering coefficient
Audience area0.6 – 0.8
Furniture0.4 – 0.7
Exposed bricks0.3 – 0.4
Rough unpainted concrete0.15 – 0.25
Smooth surfaces0.1 - 0.15

You can now use the same process for the other layers, and put 0.5 scatter for the ’Bookshelf’ layer.

For this tutorial we recommend assigning the following materials on each layer:

  • Chairs > Upholstered seating
  • Walls > 13 mm Gypsum/Plaster board on frame, 100 mm mineral wool behind
  • Tables > Wood
  • Floor > Linoleum or vinyl on concrete
  • Windows > Double 2-3 mm glass, 10 mm air gap
  • Ceiling > Acoustic ceiling (rockwool), 20 mm, 100 kg/m3, suspended 200 mm

For the scattering coefficients on this specific model, we recommend the following scatter values:

  • Chairs > 0.6
  • Walls > 0.15
  • Tables > 0.5
  • Floor > 0.15
  • Windows > 0.15
  • Ceiling > 0.15

After assigning all the materials and their properties, your material setup should look like this:

alt text

tip

By selecting the ’RT estimates’ tab on the right you can see the estimated reverberation time in the room based on Sabine’s equation. The equation assumes a completely diffused sound field and doesn’t account for the location of absorbers or diffusers. It’s therefore mainly meant for reference to help you dial in your simulation setup before you run a more thorough simulation.

alt text

4. Setting up sources and receivers

You are now ready to set up the sound sources and receivers in the room. Click on the Sources / Receivers tab.

To define a new sound source, click on the ’+’ icon next to ’Sources’. An omnidirectional source will be created by default.

alt text

You can either position a source by dragging it along the dimensional axis or by defining precise coordinates. For this tutorial, you can place a source at the following coordinates:

  • X: 5.5 – Y: 2.5 – Z:1.5

alt text

The process of placing a receiver is the same as placing a source.

Click on the “+” icon to the right of ’Point Receivers’ and place a receiver at the following coordinates:

  • X: 10 – Y: 5 – Z:1.5

The click on the “+” icon again and place additional receivers at the following coordinates:

  • X: 3 – Y: 1.5 – Z:1.5
  • X: 12 – Y: 4 – Z:1.5
  • X: 7.5 – Y: 1 – Z:1.5

We will now place a surface receiver in the model to get a visual interpretation of the distribution of parameters within a room. To do that select the ’Surface receivers’ tab and click on the “+” icon.

Within the Surface Receivers tab, you can now edit the properties of the receiver grid. The X, Y and Z properties allow you to define the location of the center point of the grid.

alt text

For this tutorial, set the location of the center point of the grid to

  • X: 7 – Y: 3.5 – Z:1.5

alt text

The rotation fields allow you to change the rotation and pitch angle of the grid. For this tutorial, a flat grid will be created, and these settings can remain unchanged.

You can now adjust the length and width of the grid. Set the grid length to 14 m and the width to 7 m to fill out the whole classroom.

alt text

The slider below enables you to set the dimensions [length and width] of each individual square grid element. For this tutorial, you can leave them unchanged at 1 m.

5. Simulation settings

The last step before running a simulation is to set your simulation settings. Click on the the Settings tab. Within the settings tab you can select between the following:

  • Survey: Quick simulation using only the geometrical solver
  • Default: The highly accurate wave-solver is used up to an automatically estimated frequency. Above that frequency the geometrical solver is used. This is the recommended setting when starting with Treble and will be used for this tutorial.
  • Advanced: Allows the user to customize the transition frequency between the wave solver and the geometrical solver. It also allows for changing the number of rays the geometrical solver sends out, amongst other advanced features.

alt text

Select Default and click on “Estimate simulation” to get an estimation of the overall simulation time:

alt text

After getting the time estimation click on ’Run’ at the bottom of the side panel.

A popup will show more information about the key properties of the simulation. Press ’Start’ when you’re ready to run the simulation.

alt text

tip

After starting the simulation, you can safely exit the “Simulation run” popup window and work within Treble as normal while the calculations take place in the cloud. You can stop a simulation at any point by clicking on “Cancel”.

alt text

Once the simulation is finished you can press “Ok” in the ’Simulation run’ window if you still have it open.

alt text

6. Results and analysis

You are now ready to view the results of your simulation. Head to the results view in the bottom right.

alt text

Within the results view you can see the results of the different calculation parameters.

alt text

On the right, you can see the position of the sources (green) and receivers (blue). By pressing the ’model view’ button at the top (highlighted in green below), you can see more plot results displayed in a larger format.

alt text

We encourage you to try out all of our different features within the results view. The bar graphs on the left show all the calculated acoustic parameters that Treble offers.

The plots on the right show the simulated impulse response, energy decay curve and frequency response. You can see the calculation results averaged over multiple receivers. To do that select the receivers tab at the bottom, turn the multiselect toggle on and check the ’select all checkbox’.

alt text

tip

You can also compare different simulations by adding a new simulation that has been run to the results graph using the plus icon at the bottom.

You can also see the surface receiver view by selecting ’surface receivers view’ at the top.

alt text

tip

You can edit the min. and max. values of the axis to directly compare the surface receiver results of different simulations.

alt text

7. Auralizer

The final step of this tutorial is to listen to your results in the auralizer. Click on “Auralizer” in the bottom right.

alt text

Within the auralizer view you can select individual receivers to hear the acoustics of the room at various locations.

alt text

Start by selecting Receiver 1. You will then be able to look around the model at the location of the chosen receiver in a first-person view.

alt text

Click the “Add sounds” button under Source 1

alt text

This will open our sound library.

alt text

Select any sound you’re interested in hearing and click on “Load” in the bottom right corner. We encourage you to try out different sounds and soundscapes. To play a sound click the play button under the model view on the left, to hear the original anechoic recording of the sound signal you can hover over the ’Bypass IR’ icon next to the play icon.

tip

You can also share auralizations with anyone by creating a shareable link which can be sent via email or through a custom url link.

alt text

Congratulations! You’ve now finished your first acoustic simulation in Treble. If you are ready to dig deeper into Treble, you can checkout our next guide on how to import your models into Treble.