TonalityISOTS20065

class ansys.sound.core.psychoacoustics.TonalityISOTS20065(signal=None, window_length=3.0, overlap=0.0)

Computes ISO/TS 20065:2022 tonality.

This class is used to compute the tonality (mean audibility) of a signal according to the ISO/TS 20065:2022 standard.

Class instantiation takes the following parameters.

Parameters:

signal: Field, default: None

Signal in Pa on which to calculate the tonality.

window_length: float, default: 3.0

Length, in s, of each slice of the signal used to calculate an average spectrum.

overlap: float, default: 0.0

Overlap, in %, between two successive slices of the signal.

For more information about the parameters, please refer to the Ansys Sound SAS user guide.

Methods

TonalityISOTS20065.convert_fields_container_to_np_array(fc)	Convert a DPF fields container to a NumPy array.
TonalityISOTS20065.get_decisive_audibility_over_time()	Get the ISO/TS 20065 decisive audibility DLj, in dB over time.
TonalityISOTS20065.get_decisive_frequency_over_time()	Get the ISO/TS 20065 decisive frequency, in Hz over time.
TonalityISOTS20065.get_mean_audibility()	Get the ISO/TS 20065 tonality (mean audibility DL), in dB.
TonalityISOTS20065.get_output()	Get the ISO/TS 20065 tonality data, in a tuple containing data of various types.
TonalityISOTS20065.get_output_as_nparray()	Get the ISO/TS 20065 tonality data, in a tuple of NumPy arrays.
TonalityISOTS20065.get_spectrum_details(...)	Get the spectrum data for a specific spectrum.
TonalityISOTS20065.get_spectrum_number()	Get the number of spectra.
TonalityISOTS20065.get_time_scale()	Get the ISO/TS 20065 time scale, in s.
TonalityISOTS20065.get_tone_details(...)	Get the tone data, for a specific spectrum.
TonalityISOTS20065.get_tone_number(...)	Get the number of tones for a specific spectrum.
TonalityISOTS20065.get_uncertainty()	Get the ISO/TS 20065 uncertainty, in dB.
TonalityISOTS20065.get_uncertainty_over_time()	Get the ISO/TS 20065 decisive audibility uncertainty, in dB over time.
TonalityISOTS20065.plot()	Plot the ISO/TS 20065's decisive audibility and frequency over time.
TonalityISOTS20065.process()	Compute the ISO/TS 20065 tonality.

Attributes

TonalityISOTS20065.overlap	Overlap, in %, between two consecutive slices of the signal.
TonalityISOTS20065.signal	Input signal in Pa.
TonalityISOTS20065.window_length	Length, in s, of a slice of the signal used to compute each spectrum.