## On this page

  

 

 # sound:compute tonality DIN 45681

 Last update: 31.07.2026 

**Version: 0.0.0**

## Description

Compute the tonality of a signal, according to the DIN 45681 standard.

## Inputs

InputNameExpected type(s)Description**Pin 0**   
Requiredinput\_signal[`field`](../../core-concepts/dpf-types.md#field)Input signal in Pa on which to compute the DIN 45681 tonality.**Pin 1**window\_length[`double`](../../core-concepts/dpf-types.md#standard-types)Analysis window length in seconds. Default: 3 s.**Pin 2**overlap[`double`](../../core-concepts/dpf-types.md#standard-types)Percentage of each analysis window that overlaps with the next, in %. Default: 0 %.## Outputs

OutputNameExpected type(s)Description**Pin 0**output\_mean\_difference\_dl[`double`](../../core-concepts/dpf-types.md#standard-types)Tonality (mean difference DL) in dB.**Pin 1**output\_mean\_difference\_uncertainty[`double`](../../core-concepts/dpf-types.md#standard-types)Tonality's uncertainty in dB.**Pin 2**output\_tonal\_adjustment\_kt[`double`](../../core-concepts/dpf-types.md#standard-types)Tonal adjustment (Kt) in dB.**Pin 3**output\_decisive\_difference\_over\_time[`field`](../../core-concepts/dpf-types.md#field)Tonality over time (decisive difference over time DLj) in dB.**Pin 4**output\_decisive\_difference\_uncertainty\_over\_time[`field`](../../core-concepts/dpf-types.md#field)Tonality's uncertainty over time in dB.**Pin 5**output\_decisive\_frequency\_over\_time[`field`](../../core-concepts/dpf-types.md#field)Decisive frequency over time in Hz.**Pin 6**output\_tonal\_adjustment\_over\_time[`field`](../../core-concepts/dpf-types.md#field)Tonal adjustment (Kt) over time in dB.**Pin 7**output\_calculation\_details[`any_collection`](../../core-concepts/dpf-types.md#any-collection)DIN 45681 calculation details. This data container contains a collection of the computation details for each analyzed spectrum.For each spectrum, stored details is organized in fields, where each field corresponds to one of the following output parameters, and provides its values for all detected tones:- **differences**: Decisive difference DLj in dB
- **uncertainties**: Uncertainty in dB
- **frequencies**: Decisive frequency in Hz
- **typesv**: Tone type ('' for individual tones, or '**FG**' for groups of tones)
- **critical\_band\_lower\_limits**: Critical band lower limit, in Hz
- **critical\_band\_upper\_limits**: Critical band upper limit, in Hz
- **mean\_narrowband\_masking\_noise\_levels**: Mean narrow-band masking noise level Ls, in dBA
- **tone\_levels**: Tone level Lt, in dBA
- **masking\_noise\_levels**: Masking noise level Lg, in dBA
- **masking\_indices**: Masking index av, in dB. |

## 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\_tonality\_din45681

**License**: avrxp\_snd\_level1

## Changelog

- Version 0.0.0: Initial release.