SpHEAR/sphear_fir_design.m

%%
%% *SpHEAR Project
%%
%% sphear_fir_design: design a matrix of FIR filters that equalizes the microphone
%%
%% usage:
%%   [FIR] = sphear_fir_design(F, A2BF, n, Fs, Fl, W, XYZ)
%%
%% F: array of filter section center frequencies
%% A2BF: vector of A2B matrixes, one for each frequency
%% n: order of the FIR filter being created
%% maxboost: max high and low frequency boost in dB of the final filter
%% Fs: sampling rate
%%
%% for the first run do not supply Fl/W/XYZ, render the filters and from inspection
%% determine the limit frequency, then run sphear_fir_extract to extract the
%% W and XYZ filter shapes and run this again with the extra parameters below
%%
%% Fl: frequency limit, below it use A2B matrixes, above it use WXYZ shapes
%% W: extracted shape of W filter (used above Fl)
%% XYZ: extracted shape of X, Y and Z filters (used above Fl)
%%
%% Copyright 2016, Fernando Lopez-Lezcano, All Rights Reserved
%% nando@ccrma.stanford.edu
%%
%%  This program is free software: you can redistribute it and/or modify
%%  it under the terms of the GNU General Public License as published by
%%  the Free Software Foundation, either version 3 of the License, or
%%  (at your option) any later version.
%%
%%  This program is distributed in the hope that it will be useful,
%%  but WITHOUT ANY WARRANTY; without even the implied warranty of
%%  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
%%  GNU General Public License for more details.
%%
%%  You should have received a copy of the GNU General Public License
%%  along with this program.  If not, see <http://www.gnu.org/licenses/>.

function [FIR] = sphear_fir_design(F, A2BF, n, maxboost, Fs, Fl, W, XYZ)

  FIR = zeros(4, 4, (n + 1));

  %% all b format components
  for b = 1:4
    %% all capsules
    for c = 1:4

      for d = 1:size(A2BF(:,1,1))(1)
	if (F(d) <= Fl)
	  %% below the limit frequency we use the A2B coefficients
	  vlast = A2BF(d, c, b);
	  dlast = d;
	  if (exist("W") == 1)
	    wlast = W(d);
	  end
	  if (exist("XYZ") == 1)
	    xyzlast = XYZ(d);
	  end
	else
	  %% above the limit frequency we interpolate the W and XYZ
	  %% filters if they exist, otherwise keep the last valid value
	  if (b == 1)
	    if (exist("W") == 1)
	      A2BF(d, c, b) = vlast * (W(d)/wlast);
	    else
	      A2BF(d, c, b) = vlast;
	    end
	  else
	    if (exist("XYZ") == 1)
	      A2BF(d, c, b) = vlast * (XYZ(d)/xyzlast);
	    else
	      A2BF(d, c, b) = vlast;
	    end
	  end
	end
      end

      %% fit a spline over the existing points and extrapolate
      %% for low and high ends of spectrum
      fi = (0:200/(Fs/2):1)';
      ri = spline(F/(Fs/2), A2BF(:,c,b)', fi);

      printf("low frequency boost %f, high frequency boost %f\n", 20*log10(ri(1)), 20*log10(ri(end)));
      %% force a max boost at low and high frequencies
      if (maxboost != 0)
	if (abs(ri(1)) > 10^(maxboost/20))
	  printf("limit low freq boost from %f to %f dB (%f)\n", 20*log10(ri(1)), maxboost, ri(1));
	  ri(1) = sign(ri(1)) * 10^(maxboost/20);
	  printf("new limit %f\n", ri(1));
	end
	if (abs(ri(end)) > 10^(maxboost/20))
	  printf("limit high freq boost from %f dB to %f dB (%f)\n", 20*log10(ri(end)), maxboost, ri(end));
	  ri(end) = sign(ri(end)) * 10^(maxboost/20);
	  printf("new limit %f\n", ri(end));
	end
      end
      
      %% real measured points
      if (b == 1)
	semilogx(F/(Fs/2), A2BF(:,c,b)','*g');
      else
	semilogx(F/(Fs/2), A2BF(:,c,b)','*b');
      end
      hold on;
      %% extrapolated spline
      if (b == 1)
	semilogx(fi,ri,'g');
      else
	semilogx(fi,ri,'r');
      end

      %% design the filter
      FIR(b, c, :) = fir2(n, fi, ri);
    end
  end
  
end