## On this page

  

 

 # sound:compute level over time

 Last update: 31.07.2026 

**Version: 0.0.0**

## Description

Compute level over time of a signal, on a decibel (dB) 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-weighting (no frequency weighting, use this setting in case dB SPL)  
\* **1**: A-weighting  
\* **2**: B-weighting  
\* **3**: C-weighting  
  
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.**Pin 4**time\_weighting[`int32`](../../core-concepts/dpf-types.md#standard-types)Time weighting for dB calculation, as described in the IEC-61672 standard.  
  
Supported values are:  
  
\* 0: Slow  
\* **1**: Fast  
\* **2**: Impulse  
\* **3**: Custom  
  
Default: 1 (Fast)**Pin 5**time\_step[`double`](../../core-concepts/dpf-types.md#standard-types)Time step of the level over time calculation, in seconds. Time step is ignored if input time\_weighting is not set to 3 (Custom). Default: 0.025 s.**Pin 6**window\_size[`double`](../../core-concepts/dpf-types.md#standard-types)Window size in seconds, that is, the length of the slice of signal used to calculate the level at each time step. Window size is ignored if input time\_weighting is not set to 3 (Custom). Default value: 1s.**Pin 7**window\_type[`string`](../../core-concepts/dpf-types.md#standard-types)Type of the window applied to the slice of signal used to calculate the level at each time step.  
  
Supported values are:  
  
\* RECTANGULAR  
\* HANN  
\* HAMMING  
\* BLACKMAN  
\* BLACKMANHARRIS  
\* BARTLETT  
  
Default: RECTANGULAR## Outputs

OutputNameExpected type(s)Description**Pin 0**maximum\_level[`double`](../../core-concepts/dpf-types.md#standard-types)Maximum level attained by the level over time curve, in the unit specified according to inputs (dB, dB SPL, dBA, dBB, dBC or RMS).**Pin 1**level\_over\_time[`field`](../../core-concepts/dpf-types.md#field)Level over time, 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\_level\_over\_time

**License**: avrxp\_snd\_level1

## Changelog

- Version 0.0.0: Initial release.