## On this page

  

 

 # sound:compute overall level

 Last update: 31.07.2026 

**Version: 0.0.0**

## Description

Compute the overall level of a signal, on a decibel scale or a linear, root-mean-square (RMS) scale. In the case of a dB scale, the actual unit of the returned value will depend on the specified reference value and frequency weighting (Z, A, B, or C).

## Inputs

InputNameExpected type(s)Description**Pin 0**   
Requiredinput\_signal[`field`](../../core-concepts/dpf-types.md#field)Input signal for the level computation.**Pin 1**scale\_unit[`int32`](../../core-concepts/dpf-types.md#standard-types)Expected level scale unit, that is, whether level should be output on a decibel scale, or on a linear, root-mean-square (RMS) scale.  
  
Supported values are:  
  
\* 0: dB  
\* **1**: RMS  
  
Default: 0 (dB)**Pin 2**reference\_value[`double`](../../core-concepts/dpf-types.md#standard-types)Reference value for dB calculation. For example, 2e-5 Pa is the reference value for dB SPL, dBA, dBB, and dBC.  
  
Reference value is ignored if input scale\_unit is set to 1 (RMS).  
If frequency\_weighting is set to either 1 (A), 2 (B), or 3 (C), reference\_value should be 2e-5 Pa. Default: 1.0.**Pin 3**frequency\_weighting[`int32`](../../core-concepts/dpf-types.md#standard-types)Frequency weighting for dB calculation. Frequency weighting is ignored if input scale\_unit is set to 1 (RMS).  
  
Supported values are:  
  
\* 0: Z-weigthing (no frequency weighting, use this setting in case dB SPL)  
\* **1**: A-weigthing  
\* **2**: B-weigthing  
\* **3**: C-weigthing  
  
Default: 0 (Z-weighting)  
  
If frequency\_weighting is set to either 1 (A), 2 (B), or 3 (C), reference\_value should be 2e-5 Pa.## Outputs

OutputNameExpected type(s)Description**Pin 0**output\_level[`double`](../../core-concepts/dpf-types.md#standard-types)Overall level, in a unit that depends on inputs scale\_unit, reference\_value, and frequency\_weighting.## Configurations

NameExpected type(s)Default valueDescription**mutex**[`bool`](../../core-concepts/dpf-types.md#standard-types)falseIf this option is set to true, the shared memory is prevented from being simultaneously accessed by multiple threads.## Scripting

**Category**: sound

**Plugin**: sound

**Scripting name**: None

**Full name**: None

**Internal name**: compute\_overall\_level

**License**: avrxp\_snd\_level1

## Changelog

- Version 0.0.0: Initial release.