Sharpness (FPScript)
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:
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:
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:
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
TimeDomainOctaveAnalysis Function