Skip to main content

sound:compute tonality ISO/TS 20065

Version: 0.0.0

Description

Computes tonality according to the ISO/TS 20065:2022 standard

Inputs

InputNameExpected type(s)Description
Pin 0
Required
input_signalfieldInput signal in Pa on which to compute the tonality ISO/TS 20065:2022.
Pin 1window_lengthdoubleAnalysis window length in s. Default: 3.
Pin 2overlapdoublePercentage in % of each analysis window that overlaps with the next. Default: 0 %.

Outputs

OutputNameExpected type(s)Description
Pin 0output_mean_audibility_dldoubleTonality (mean audibility DL) in dB.
Pin 1output_mean_audibility_uncertaintydoubleTonality's uncertainty in dB.
Pin 2output_decisive_audibility_over_timefieldTonality over time (decisive audibility over time DLj) in dB.
Pin 3output_decisive_audibility_uncertainty_over_timefieldTonality's uncertainty over time in dB.
Pin 4output_decisive_frequency_over_timefieldDecisive frequency over time in Hz.
Pin 5output_calculation_detailsany_collectionISO/TS 20065:2022 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:
  • audibility: Decisive audibilities 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

NameExpected type(s)Default valueDescription
mutexboolfalseIf 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_isots_20065

License: avrxp_snd_level1

Changelog

  • Version 0.0.0: Initial release.