Overview

Computes total harmonic distortion + noise

Discussion

This modules computes the THD+N (total harmonic distortion + noise) of a signal chain. It is typically used to compute THD+N through a loudspeaker to a microphones. The module has one audio input pin and one audio output pin. The audio pins are signal channel and the module supports any block size and any sample rate. The module works by generating a pure sine wave on the output pin and then analyzing the signal on the input pin. At instantiation time you specify the length of the DFT via the argument L. At run-time, the module computes a single point DFT of length L at precisely the frequency of the sine wave. This corresponds to the signal energy. The module also computes all of the residual energy that is not at the sine wave. This corresponds to the distortion + noise. With these two quantities, the module is able to compute the THD+N.

The module computes THD+N as a percentage. 2.0 corresponds to 2% THD+N. The module quantizes the sine wave frequency to the closest DFT bin. Allowable frequencies are at multiples of (sample rate) / L. For example, if you are processing at a sample rate of 48 kHz, then a reasonable choice is L=4800. Then the allowable sine waves fall on multiples of 48000/4800 = 10 Hz.

The module has an optional output pin which can be enabled as a second module argument. When enabled, this output pin will hold the computed THD.

The module allows you to specify the level of the output sine wave, in dB. The module also computes the level of the input signal, in dB. And lastly, the enable variable allows you to turn the sine wave on or off. The module takes a short time (maybe a second) to settle down after you change the frequency or sine wave level.

Type Definition

typedef struct _ModuleTHD
{
    ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
    INT32 L;                                      // Integration period in samples
    FLOAT32 freq;                                 // Frequency at which to compute THD
    FLOAT32 gain;                                 // Sine wave amplitude in dB
    INT32 enable;                                 // Boolean that controls whether the module is active
    FLOAT32 thd;                                  // Measured THD
    FLOAT32 signalLevel;                          // Measured signal level
    FLOAT32 gainLin;                              // Sine wave amplitude in linear units
    INT32 count;                                  // Internal counter. Counts from 0 to L-1
    FLOAT32 sumReal;                              // Accumulates the real part of the DFT calculation
    FLOAT32 sumImag;                              // Accumulates the imaginary part of the DFT calculation
    FLOAT32 freqInc;                              // Sample to sample frequency increment
    FLOAT32 energySin;                            // Energy at the indicated sine wave fundamental frequency
    FLOAT32 energyTotal;                          // Total energy in the signal
    FLOAT32 energyPartial;                        // Partial energy in the signal
} ModuleTHDClass;

Properties

Name	Type	Usage	isHidden	Default value	Range	Units
L	int	const	0	1024	Unrestricted
freq	float	parameter	0	984.4	46.875:46.875:23953.125
gain	float	parameter	0	-20	-60:1:0	dB
enable	int	parameter	0	1	0:1
thd	float	state	0	0	0:10	percent
signalLevel	float	state	0	0	-100:0	dB
gainLin	float	derived	1	0.1	Unrestricted
count	int	state	1	0	Unrestricted
sumReal	float	state	1	0	Unrestricted
sumImag	float	state	1	0	Unrestricted
freqInc	float	derived	1	0.1289	Unrestricted	radians/sample
energySin	float	state	1	0	Unrestricted
energyTotal	float	state	1	0	Unrestricted
energyPartial	float	state	1	0	Unrestricted

Pins

Input Pins

Name: in

Description: Input signal

Data type: float

Channel range: 1

Block size range: Unrestricted

Sample rate range: Unrestricted

Complex support: Real

Output Pins

Name: out

Description: Output signal

Data type: float

MATLAB Usage

File Name: thd_module.m

 M = thd_module(NAME, L, OUTPUTVALUE)
 This module measures the total harmonic distortion plus noise.  Arguments:
 Arguments:
    NAME - name of the module.
    L - integration period (samples) over which the measurement is done
    OUTPUTVALUE - optional argument which causes the measured THD to be
         output on a second output pin.
 Copyright 2018.  DSP Concepts, Inc.  All Rights Reserved.

Documentation Hub [PUBLIC]

(8.D.2.2 ) THD