Main Content

parallel

Create parallel sum filter structure

Description

PF = parallel(branch1,branch2,...,branchn) returns an object PF of type dsp.ParallelFilter. PF is a parallel structure of the filter branches branch1, branch2, ..., branchn. Each individual branch can be a filter System object™ or a scalar gain value, but at least one branch must be a filter object.

The input filter objects must be supported by the parallel function. To see a list of filter objects that you can add as branches to the parallel filter stack, run this command in the MATLAB® command prompt.

dsp.ParallelFilter.helpSupportedSystemObjects

example

Examples

collapse all

You can construct a parallel filter using the dsp.ParallelFilter object or the parallel function.

First, create the branches.

B1 = dsp.FIRFilter;
B2 = dsp.Delay(3);
B3 = 2;

Specify these branches while constructing the dsp.ParallelFilter object.

pf1 = dsp.ParallelFilter(B1,B2,B3)
pf1 = 
  dsp.ParallelFilter with properties:

          Branch1: [1x1 dsp.FIRFilter]
          Branch2: [1x1 dsp.Delay]
          Branch3: 2
    CloneBranches: true

You can also use the addBranch function to add branches to the default parallel filter.

pf2 = dsp.ParallelFilter(B1);
addBranch(pf2,B2,B3);
pf2
pf2 = 
  dsp.ParallelFilter with properties:

          Branch1: [1x1 dsp.FIRFilter]
          Branch2: [1x1 dsp.Delay]
    CloneBranches: true

Now, use the parallel filter function to construct a dsp.ParallelFilter object.

pf3 = parallel(B1,B2,B3)
pf3 = 
  dsp.ParallelFilter with properties:

          Branch1: [1x1 dsp.FIRFilter]
          Branch2: [1x1 dsp.Delay]
          Branch3: 2
    CloneBranches: true

Input Arguments

collapse all

Filter branch, specified as a filter System object or a scalar gain value. The parallel function does not create a dsp.ParallelFilter object when all input branches are scalar values. At least one branch in the structure must be a filter object.

To see a list of filter objects that you can add as branches to the parallel filter stack, run this command in the MATLAB command prompt.

dsp.ParallelFilter.helpSupportedSystemObjects

Output Arguments

collapse all

Parallel filter, returned as a System object of type dsp.ParallelFilter. For information on the properties of the filter in each branch, type info(PF) in the MATLAB command prompt.

Version History

Introduced before R2006a

expand all