TonalityISO1996_2

class ansys.sound.core.psychoacoustics.TonalityISO1996_2(signal=None, noise_pause_threshold=1.0, effective_analysis_bandwidth=5.0, noise_bandwidth_ratio=0.75)

Computes the tonality according to the standard ISO 1996-2:2007, annex C.

This class is used to compute the tonal audibility and tonal adjustment of a signal according to the annex C of the ISO 1996-2:2007 standard.

Class instantiation takes the following parameters.

Parameters:

signal: Field, default: None

Signal in Pa on which to calculate the tonality.

noise_pause_threshold: float, default: 1.0

Noise pause detection threshold (“level excess”) in dB.

effective_analysis_bandwidth: float, default: 5.0

Effective analysis bandwidth in Hz.

noise_bandwidth_ratio: float, default: 0.75

Noise bandwidth, in proportion to the critical bandwidth, that is taken into account for the calculation of the masking noise level (the default value 0.75 means that the masking noise level is estimated in a band delimited by 75 % of the critical bandwidth on each side of the tone). Value must be between 0.75 and 2.

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

Methods

TonalityISO1996_2.convert_fields_container_to_np_array(fc)	Convert a DPF fields container to a NumPy array.
TonalityISO1996_2.get_computation_details()	Get the ISO 1996-2 computation details.
TonalityISO1996_2.get_output()	Get the ISO 1996-2 tonality data, in a tuple containing data of various types.
TonalityISO1996_2.get_output_as_nparray()	Get the ISO 1996-2 tonality data, in a tuple of NumPy arrays.
TonalityISO1996_2.get_tonal_adjustment()	Get the ISO 1996-2 tonal adjustment, in dB.
TonalityISO1996_2.get_tonal_audibility()	Get the ISO 1996-2 tonal audibility, in dB.
TonalityISO1996_2.plot()	Plot the output.
TonalityISO1996_2.process()	Compute the ISO 1996-2 tonality.

Attributes

TonalityISO1996_2.effective_analysis_bandwidth	Effective analysis bandwidth in Hz.
TonalityISO1996_2.noise_bandwidth_ratio	Noise bandwidth in proportion to the critical bandwidth.
TonalityISO1996_2.noise_pause_threshold	Noise pause detection threshold (level excess) in dB.
TonalityISO1996_2.signal	Input signal in Pa.