Skip to main content

Token Estimator

From September 1, 2025, the Treble SDK token model will now be based on specific simulation attributes. You may use the simulation estimator to get an initial estimate of the simulation cost associated with a desired set-up. Device renders done in a post-processing step also have a marginal token cost associated with them, which may be explored in the device rendering calculator.

Simulation cost estimator

1,500 Hz
45 m³
1 m
0.4 s

1
0
1

5
2
0.104 Tokens

Parameters in the token calculator

  • Solver Type
    • DG: a simulation using only the wave-based solvers, where the wave-equation is directly solved through a discretized with DG-FEM method.
    • GA: a simulation using only the geometrical acoustics solvers, where sound propagation is estimated using methods analogous to optical ray tracing. Most valid in the high-frequency range.
    • Hybrid: a simulation using the DG solver to model sound propagation below a given transition frequency, and the GA solver above it.
  • Transition Frequency: the frequency at which the solver switches from the DG method to the GA method in a hybrid simulation. For DG-only simulations, it defines the upper frequency limit.
  • Volume: the internal volume of the model used in the simulation.
  • Smallest geometrical feature: the smallest feature in the simulated model, which influences meshing and sets a limit on the element size used in the DG solver. More details can be found in our mesh section.
  • Geometrical complexity: the complexity tier assigned to a geometry in a GA simulation. It depends primarily on the number of planes within the model and the bounding-box volume (the volume of the minimal 3D box enclosing the geometry from the origin to the furthest point in each axis).
  • Impulse length: the time duration of the impulse response calculated by the solver.
  • Number of sources: the number of sound sources in the simulation. Sound propagation is computed separately for each source, so multiple sources increase the computationl cost proportionally.
  • Number of receivers: Receivers can be defined as mono or spatial, but this estimator does not distinguihs between them. In practice, mono receivers add a neglible cost, while spatial receivers scale in cost with ambsonics order.

Device rendering cost estimator

You can render in devices and microphone arrays as a post-processing step in the SDK. Doing so is associated with a small fee. The calculator below can be used to determine the cost. See more about our advanced post-processing capabilities under device modeling.

1
5
2
0.00188 Tokens

FAQ

What does low, medium and high complexity mean for a GA simulation?

The GA complexity can fall in to three categories, which determines the cost of the simulation. The complexity is computed based on the number of planes/objects in the room, the IR length, the ISM order and the volume of the space. Generally speaking, an empty or minimally furnished shoebox room will be low-complexity; a fully furnished room will be medium-complexity, and a fully furnished apartment or concert hall with many curved surfaces will be high-complexity.

My estimated cost from the online calculator does not match the cost in the SDK, why is that?

The online calculator gives a general estimate based on the inputs provided, but the real computational cost is determined within the SDK from the uploaded and processed model. This implicates the geometrical complexity, but more significantly, the volumetric mesh used in the DG solver. As this mesh is not available to the online calculator, discrepancies may arise between the estimator and the final cost.

To verify the computational cost of the simulation within the SDK, you can calculate the token cost after creating a Simulation using a SimulationDefinition.

# your desired simulation configuration
simulation_definition = treble.SimulationDefinition(
name='My simulation name',
model = room,
material_assignment = material_assignment,
source_list = source_list,
receiver_list = receiver_list,
ir_length = 2,
crossover_frequency=720,
simulation_type = treble.SimulationType.hybrid
)

# add it to the project
simulation = project.add_simulation(simulation_definition)
# delay further steps until the mesh has been generated
simulation.wait_for_estimate()

# display the token cost
dd.display(simulation.estimate())