%% Remove Interfering Tone From Audio Stream
% This example shows how to remove a 250 Hz interfering tone from a streaming audio signal using a notch filter.
%% Introduction
% A notch filter is used to eliminate a specific frequency from a given signal. In their most common form, the filter design parameters for notch filters are center frequency for the notch and the 3 dB bandwidth. The center frequency is the frequency point at which the filter has a gain of zero. The 3 dB bandwidth measures the frequency width of the notch filter computed at the half-power, or 3 dB, attenuation point.
% In this example, you tune a notch filter in order to eliminate a 250 Hz sinusoidal tone corrupting an audio signal. You can control both the center frequency and the bandwidth of the notch filter and listen to the filtered audio signal as you tune the design parameters.
%% Example Architecture
% The audioToneRemovalExampleApp command opens a user interface designed to interact with the simulation. It also opens a spectrum analyzer to view the spectrum of the audio with and without filtering and the magnitude response of the notch filter.
% audioToneRemovalExampleApp
%
% The notch filter is implemented using dsp.NotchPeakFilter. The filter has two specification modes: 'Design parameters' and 'Coefficients'. The 'Design parameters' mode allows you to specify the center frequency and bandwidth in Hz. This is the only mode used in this example. The 'Coefficients' mode allows you to specify the multipliers or coefficients in the filter directly. In the latter mode, each coefficient affects only one characteristic of the filter (either the center frequency or the 3 dB bandwidth). In other words, the effect of tuning the coefficients is completely decoupled.
%
%% Using a Generated MEX File
% Using MATLAB Coder, you can generate a MEX file for the main processing algorithm by executing the HelperAudioToneRemovalCodeGeneration command. You can use the generated MEX file by executing the audioToneRemovalExampleApp(true) command.
% Copyright 2013-2019 The MathWorks, Inc.