Matlab listing: zpfmin.m

  function [zpmin] = zpfmin(window,MT,freqBiasMax,ampBiasMaxPct);
  % [zpmin] = zpfmin(freqBiasMax,fs,ampBiasMax,ampMax)
  % returns the minimum zero-padding factor to achieve prescribed
  % tolerances in sinusoidal peak parameters measured using the QIFFT
  % method with the  window.
  %
  % INPUTS:
  %   window      = 'rect', 'hamming', 'hanning', or 'blackman'
  %   MT          = window length (seconds)
  %   freqBiasMax = max frequency bias allowed in peak frequency (Hz)
  %   ampBiasMax  = max peak-magnitude bias allowed (relative fraction)
  %
  %   If ampBiasMaxPct is not specified, amplitude bias is not considered.
  %
  % RETURNED:
  %   zpmin = minimum zero-padding factor (1 means no zero padding)
  % 
  % EXAMPLE
  %   Assuming the window contains one cycle of a sinusoid whose
  %   frequency f must be estimated to within 0.1% accuracy, we have
  %   zpfmin(1/f,0.001*f,'blackman') = 1.9 for the minimum zero-padding factor.
  %   Similarly, 
  %       assuming two cycles under the Blackman window yields zpf > 1.5,
  %       assuming four cycles under the Blackman window yields zpf > 1.2,
  %   and assuming  six cycles under the Blackman window yields zpf > 1.02.
  %
  % Reference (bibtex format):
  %   @ARTICLE{AbeAndSmith04,
  %    AUTHOR = "Mototsugu Abe and Julius O. {Smith III}",
  %    TITLE = "Design Criteria for Simple Sinusoidal
  %  	Parameter Estimation based on Quadratic
  %  	Interpolation of FFT Magnitude Peaks",
  %    JOURNAL = "Audio Engineering Society Convention",
  %    VOLUME = "Preprint 6256",
  %    PUBLISHER = "Audio Engineering Society",
  %    ADDRESS = "New York",
  %    YEAR = 2004
  %  }
  %

  %!test
  %! assert(zpfmin('blackman',1,0.001),2.3609,0.001);

  % disp(sprintf('%s window',window));
  switch window
   case 'rect'
    c0 = 0.4467;
    r0 = -0.3218;
    c1 = 0.8560;
    r1 = -0.2366;
   case 'hamming'
    c0 = 0.2456;
    r0 = -0.3282;
    c1 = 0.4381;
    r1 = -0.2451;
   case 'hann'
    c0 = 0.2436;
    r0 = -0.3288;
    c1 = 0.4149;
    r1 = -0.2456;
   case 'blackman'
    c0 = 0.1868;
    r0 = -0.3307;
    c1 = 0.3156;
    r1 = -0.2475;
   otherwise
    error(sprintf('Window type %s unknown - say help zpfmin',window));
  end

  zpmin = c0*(MT*freqBiasMax)^r0;

  if nargin>3
    zpminamp = c1*(MT*freqBiasMax)^r1;
    zpmin = max(zpmin,zpminamp);
  end

  if strcmp(window,'rect')
    zpmin=max(1.7,zpmin); % See Abe and Smith 2004, Fig. 2 for why this
  else
    zpmin=max(1,zpmin);
  end

---

Order a Hardcopy of Spectral Audio Signal Processing

Previous: Matlab listing: qint.m
Next: Matlab listing: oboeanal.m

---

written by Julius Orion Smith III
Julius Smith's background is in electrical engineering (BS Rice 1975, PhD Stanford 1983). He is presently Professor of Music and Associate Professor (by courtesy) of Electrical Engineering at Stanford's Center for Computer Research in Music and Acoustics (CCRMA), teaching courses and pursuing research related to signal processing applied to music and audio systems. See http://ccrma.stanford.edu/~jos/ for details.