Skip to main content

Free field simulations

The free field simulation is a special type of simulation in the treble SDK that can be used to study acoustic properties of devices in anechoic conditions. The simualation uses a dg simulation type, where the source is assigned as boundary_velocity source. The free field simulation type can be accessed through the treble_tsdk.free_field module, where all the main functionality and helpers of the feature can be found. This module is referred to as ff in the following pages.

The free field simulations enable an automated workflow for creating boundary velocity submodel sources, which can be used directly in any other simulation. see Boundary velocity sources.

The workflow of the free field simulation is conceptually similar to that of creating an ordinary simulation, with the following workflow:

  1. Create a free field model through the ff.add_free_field_model() function.
  2. Create a ff.FreeFieldSimulationDefinition() with the properties of the simulations, mainly specifying the sound radiating surfaces in the model and validate the definition.
  3. Add the definition to a project and run the simulation.
  4. Fetch the ff.FreeFieldResultsObject from the simulation using simulation_obj.get_results_object().
  5. Analyse the free field results.
  6. Directly create a BoundaryVelocitySubmodel or a SourceDirectivityObj from the results object to use as sources in ordinary simulations.