## On this page

  

 

 # sound:compute tonality aures

 Last update: 31.07.2026 

**Version: 0.0.0**

## Description

Compute the tonality of a signal, according to the Aures model (W. Aures, 'Procedure for calculating the sensory pleasantness of various sounds', Acustica 59 (2), December 1985, pp. 130-141).

## 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 Aures tonality.**Pin 1**overlap[`double`](../../core-concepts/dpf-types.md#standard-types)Percentage in % of each window that overlaps with the next. Default: 90 %.**Pin 2**account\_w1[`bool`](../../core-concepts/dpf-types.md#standard-types)Enable (True) or disable (False) the bandwidth weighting w1. Default: False.**Pin 3**bw\_weighting\_threshold[`double`](../../core-concepts/dpf-types.md#standard-types)Threshold in dB for the bandwidth weighting w1. The threshold value is ignored if input account\_w1 is set to False. Default value: 3 dB.## Outputs

OutputNameExpected type(s)Description**Pin 0**tonality[`double`](../../core-concepts/dpf-types.md#standard-types)Overall tonality in tonality units (tu).**Pin 1**tonality\_over\_time\_tu[`field`](../../core-concepts/dpf-types.md#field)Tonality over time in tu.**Pin 2**wt\_over\_time[`field`](../../core-concepts/dpf-types.md#field)Tonal component weighting wT over time.The tonal component weighting combines 3 weighting functions related to the bandwidth, the frequency, and the prominence of each detected tone.**Pin 3**wGcr\_over\_time[`field`](../../core-concepts/dpf-types.md#field)Relative loudness weighting wGr over time.The relative loudness weighting accounts for the relative contribution of the tonal loudness to the overall loudness.## 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\_aures

**License**: avrxp\_snd\_level1

## Changelog

- Version 0.0.0: Initial release.