sound:compute tonality DIN 45681
Last update: 03.06.2026Version: 0.0.0
Description
Compute the tonality of a signal, according to the DIN 45681 standard.
Inputs
| Input | Name | Expected type(s) | Description |
|---|---|---|---|
| Pin 0 Required |
input_signal | field |
Input signal in Pa on which to compute the DIN 45681 tonality. |
| Pin 1 | window_length | double |
Analysis window length in seconds. Default: 3 s. |
| Pin 2 | overlap | double |
Percentage of each analysis window that overlaps with the next, in %. Default: 0 %. |
Outputs
| Output | Name | Expected type(s) | Description |
|---|---|---|---|
| Pin 0 | output_mean_difference_dl | double |
Tonality (mean difference DL) in dB. |
| Pin 1 | output_mean_difference_uncertainty | double |
Tonality's uncertainty in dB. |
| Pin 2 | output_tonal_adjustment_kt | double |
Tonal adjustment (Kt) in dB. |
| Pin 3 | output_decisive_difference_over_time | field |
Tonality over time (decisive difference over time DLj) in dB. |
| Pin 4 | output_decisive_difference_uncertainty_over_time | field |
Tonality's uncertainty over time in dB. |
| Pin 5 | output_decisive_frequency_over_time | field |
Decisive frequency over time in Hz. |
| Pin 6 | output_tonal_adjustment_over_time | field |
Tonal adjustment (Kt) over time in dB. |
| Pin 7 | output_calculation_details | 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; - 'types': 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
| Name | Expected type(s) | Default value | Description |
|---|---|---|---|
| mutex | bool |
false | If 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.
