Sharpness (FPScript)

21.09.2021

Calculates the sharpness of a sound signal.

Syntax

Sharpness(DataSet, [ Algorithm = SHARPNESS_DIN_45692 ], [ SoundField = SHARPNESS_DIFFUSE ], [ InputType = SHARPNESS_INPUT_SPECTRUM ], [ SkipTime = 0.0 s ], [ CalibrationValue = 0.0 dB ] [ , NormalizationFactor = 0.11 ])
or
Sharpness(Signal, ReferenceSignal, CalibrationLevel, [ Algorithm = SHARPNESS_DIN_45692 ], [ SoundField = SHARPNESS_DIFFUSE ], [ InputType = SHARPNESS_INPUT_SOUNDPRESSURE_STAT ], [ SkipTime = 0.0 s ] [ , NormalizationFactor = 0.11 ])

 

The syntax of the Sharpness function consists of the following parts:

Part

Description

DataSet

The input data set with the spectrum of the stationary sound, the measured voltages of the stationary sound, the measured voltages of the time-varying sound, the measured sound pressure levels of the stationary sound or the measured sound pressure levels of the time-varying sound.

Permitted data structures are data series, data matrix, signal und signal series. All numeric data types are permitted.

If the argument is a list, then the function is executed for each element of the list and the result is also a list.

Signal

The input data set with the measured voltages of the stationary sound, the measured voltages of the time-varying sound, the measured sound pressure levels of the stationary sound or the measured sound pressure levels of the time-varying sound.

Permitted data structures are signal und signal series. All numeric data types are permitted.

For the X component additional restrictions do apply.

For complex data types the absolute value is formed.

If the argument is a list, then the function is executed for each element of the list and the result is also a list.

ReferenceSignal

The reference signal with which the input signal is calibrated.

Permitted data structures are signal. All numeric data types are permitted.

For the X component additional restrictions do apply.

For complex data types the absolute value is formed.

If the argument is a list, then the function is executed for each element of the list and the result is also a list.

CalibrationLevel

The reference sound pressure level signal generated by the calibrator.

Permitted data structures are scalar value. All numeric data types are permitted.

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

Algorithm

Algorithm for calculating sharpness.

The argument Algorithm can have the following values:

Constant

Meaning

SHARPNESS_DIN_45692

DIN 45692 algorithm for calculating sharpness.

SHARPNESS_AURES

Aures algorithm for calculating sharpness.

SHARPNESS_BISMARCK

Bismarck algorithm for calculating sharpness.

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

If this argument is omitted, it will be set to the default value SHARPNESS_DIN_45692.

SoundField

Sound field. The procedure supports the diffuse field and direct field (free field).

The argument SoundField can have the following values:

Constant

Meaning

SHARPNESS_DIFFUSE

Diffuse field (spatial field).

SHARPNESS_FREE

Direct field (free field).

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

If this argument is omitted, it will be set to the default value SHARPNESS_DIFFUSE.

InputType

The input signal type. Specifies how to interpret the DataSet input data set. A microphone sensitivity of 50 mV/Pa is used for the conversion between voltage values (V) and sound pressure values (Pa). For more details, see Calibration in Acoustics.

The argument InputType can have the following values:

Constant

Meaning

SHARPNESS_INPUT_SPECTRUM

The input signal is the third-octave spectrum of the stationary sound. The third-octave spectrum must be a data series or signal with 28 third-octave bands for frequencies between 25 Hz and 12500 Hz.

SHARPNESS_INPUT_VOLTAGE_STAT

The input signal is the measured voltage signal of a stationary sound.

SHARPNESS_INPUT_VOLTAGE_VAR

The input signal is the measured voltage signal of a time-varying sound.

SHARPNESS_INPUT_SOUNDPRESSURE_STAT

The input signal is the measured sound pressure signal of a stationary sound.

SHARPNESS_INPUT_SOUNDPRESSURE_VAR

The input signal is the measured sound pressure signal of a time-varying sound.

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

If this argument is omitted, it will be set to the default value SHARPNESS_INPUT_SPECTRUM.

SkipTime

Time range to skip at the start of the stationary input signal. This value is ignored in the case of time-varying signals.

Permitted data structures are scalar value. All numeric data types are permitted. The argument is transformed to the unit s.

The value must be greater or equal to 0 s.

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

If this argument is omitted, it will be set to the default value 0.0 s.

CalibrationValue

Calibration value used to factor in the microphone sensitivity in dB. A calibration value of 0 dB is equivalent to a microphone sensitivity of 50 mV/Pa or level output of dB over 1 µV for voltages. If the calibration value is omitted, 0 dB is used. The calibration value can be calculated from the AcousticCalibration function.

Permitted data structures are scalar value. All numeric data types are permitted. The argument is transformed to the unit dB.

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

If this argument is omitted, it will be set to the default value 0.0 dB.

NormalizationFactor

The standard constant k for adjusting the calculated sharpness of the reference sound to 1 acum. The following applies: 0.105 ≤ k < 0.115. This value can be specified for the DIN 45692 procedure. This value is fixed for the other procedures.

Permitted data structures are scalar value. All numeric data types are permitted. The argument is transformed to the unit dB.

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

If this argument is omitted, it will be set to the default value 0.11.

Remarks

The sharpness is a psychoacoustic quantity caused by high frequencies in a sound. The unit for sharpness is acum. Like loudness, sharpness also maps human perception linearly. The calculation of sharpness is specified in the DIN 45692 standard. Sharpness can be calculated for stationary and time-varying sound. In the case of stationary sounds, the value is a scalar value; the value is a signal in the case of time-varying sounds (sharpness over time).

Available in

Option Acoustics

Applicable standards

Standard

Description

DIN 45692:2009-08

Measurement technique for the simulation of the auditory sensation of sharpness.

ISO 532-1:2017

Acoustics - Method for calculating loudness. Part 1: Zwicker method

DIN 45631

Calculation of loudness level and loudness from the sound spectrum - Zwicker method.

Examples

Sharpness(Signal1, SHARPNESS_DIN_45692, SHARPNESS_DIFFUSE, SHARPNESS_INPUT_SOUNDPRESSURE_STAT)
 

Determines sharpness from the stationary sound level signal 'Signal1' according to DIN 45692. The signal has already been calibrated.

Sharpness(Signal1, Reference, 60, SHARPNESS_AURES, SHARPNESS_FREE, SHARPNESS_INPUT_SOUNDPRESSURE_STAT, 0.2)
 

Determines sharpness from the stationary sound level signal 'Signal1'. The signal is calibrated via a reference signal corresponding to 60 dB. For the calculation 0.2 seconds are skipped at the start.

See Also

Loudness Function

AcousticCalibration Function

SoundLevel Function

TimeDomainOctaveAnalysis Function

Sharpness Analysis Object

Loudness Analysis Object

Octave Analysis - Analysis Object

Sound Level Analysis Object

Share article or send as email:

You might be interested in these articles