1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97
|
function c=pfilt(f,g,varargin)
%-*- texinfo -*-
%@deftypefn {Function} pfilt
%@verbatim
%PFILT Apply filter with periodic boundary conditions
% Usage: h=pfilt(f,g);
% h=pfilt(f,g,a,dim);
%
% PFILT(f,g) applies the filter g to the input f. If f is a
% matrix, the filter is applied along each column.
%
% PFILT(f,g,a) does the same, but downsamples the output keeping only
% every a'th sample (starting with the first one).
%
% PFILT(f,g,a,dim) filters along dimension dim. The default value of
% [] means to filter along the first non-singleton dimension.
%
% The filter g can be a vector, in which case the vector is treated
% as a zero-delay FIR filter.
%
% The filter g can be a cell array. The following options are
% possible:
%
% If the first element of the cell array is the name of one of the
% windows from FIRWIN, the whole cell array is passed onto
% FIRFILTER.
%
% If the first element of the cell array is 'bl', the rest of the
% cell array is passed onto BLFILTER.
%
% If the first element of the cell array is 'pgauss', 'psech',
% the rest of the parameters is passed onto the respective
% function. Note that you do not need to specify the length L.
%
% The coefficients obtained from filtering a signal f by a filter g are
% defined by
%
% L-1
% c(n+1) = sum f(l+1) * g(an-l+1)
% l=0
%
% where an-l is computed modulo L.
%
%@end verbatim
%@strong{Url}: @url{http://ltfat.github.io/doc/sigproc/pfilt.html}
%@seealso{pconv}
%@end deftypefn
% Copyright (C) 2005-2016 Peter L. Soendergaard <peter@sonderport.dk>.
% This file is part of LTFAT version 2.3.1
%
% 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/>.
% Assert correct input.
if nargin<2
error('%s: Too few input parameters.',upper(mfilename));
end;
definput.import={'pfilt'};
definput.keyvals.a=1;
definput.keyvals.dim=[];
[flags,kv,a,dim]=ltfatarghelper({'a','dim'},definput,varargin);
[f,L,Ls,W,dim,permutedsize,order]=assert_sigreshape_pre(f,[],dim,upper(mfilename));
[g,info] = comp_fourierwindow(g,L,upper(mfilename));
outIsReal = isreal(f) &&...
(isfield(g,'h') && isreal(g.h) && ~(isfield(g,'fc') && g.fc~=0) || isfield(g,'H') && g.realonly);
asan = comp_filterbank_a(a,1);
g = comp_filterbank_pre({g},a,L,kv.crossover);
c = comp_filterbank(f,g,a);
c = c{1};
permutedsize(1)=size(c,1);
c=assert_sigreshape_post(c,dim,permutedsize,order);
if outIsReal
c = real(c);
end
|