Skip to main content

Quick start guide

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

1. Navigating the projects overview

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

Treble home screen

Select the classroom from the list of recent spaces.

2. Creating a simulation

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

Editor

To set up a new simulation you can either select ‘Create simulation’ in the side panel on the right, or click the New button, visible in the application header, and choose ’Simulation’ from the list that appears.

Create simulation

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.

Simulation name

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.

tip

You can assign materials to multiple surfaces at once by holding down ‘Ctrl’ or ‘Shift’ on your keyboard.

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

Material library

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 ’Walls’ layer. Select the ’Gypsum’ tag and select the “13 mm Gypsum/Plaster board on frame, 100 mm mineral wool behind” material. You can also use the search bar to find it.

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

Material assigned

The wall has now been assigned a material. A default scattering coefficient of 0.15 has also been assigned. The default scattering values should cover a broad range of applications but we recommend to evaluate and adjust them on a case by case basis as explained here.

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

  • Tables > Wood
  • Chairs > Upholstered seating
  • Windows > Double 2-3 mm glass, 10 mm air gap
  • Bookshelf > Wood panel with air space behind
  • Ceiling > Rockwool 40 mm, 115 kg/m3
  • Floor > Linoleum or vinyl on concrete
  • Whiteboard > 5% absorption
  • Shelves > Wood

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

  • Tables > 0.5
  • Chairs > 0.6
  • Windows > 0.2
  • Bookshelf > 0.5
  • Ceiling > 0.15
  • Floor > 0.15
  • Whiteboard > 0.15
  • Shelves > 0.5

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

Material setup

tip

The ’RT estimates’ tab in the bottom right shows 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.

RT estimates

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.

Editor - Adding a source

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

Editor - Source added

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

Then 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

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.

Editor - Adding a surface receiver

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

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

Editor - Surface receiver settings

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.

Editor - Surface receiver added

tip

To quickly cover a whole surface with a receiver grid you can create a surface receiver that extends beyond the boundary of the room. Treble will automatically discard the receivers outside the geometry.

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.

Editor - Simulation settings

Select Default and click on “Run”. A popup will show information about the key properties of the simulation:

Editor - Simulation run popup

Click ’Start’ when you’re ready to run the simulation.

note

After starting the simulation, you can safely minimize 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”.

Editor - A running simulation

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

Editor - Simulation run finished

6. Results and analysis

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

Result buttons

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

Results view

By selecting the ’Report view’ button at the top (highlighted in green below), you can see more plot results displayed in a larger format.

Results view - Report view

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 or for summed sources. To average across receiver select the receiver tab at the bottom, turn the multiselect toggle on and check the ’select all checkbox’. For this simulation we only have a single source so source summing is not enabled.

Results view - Averaged results

note

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.

Results view - Surface receiver view

note

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

Results view - Surface receiver legend

In the ‘Forced modal analysis’ section of the ‘Surface receivers view’ you can analyze the spatial distribution of the wave based frequency response.

Results view - Forced modal analysis

7. Auralizer

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

Results view - Auralizer button

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

Auralizer

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.

Auralizer - First person view

Click the “Add sounds” button under Source 1

Auralizer - Add sounds

This will open our sound library.

Auralizer - Sound library

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.

note

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

Auralizer - Share link

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.