# paths

## Description

## Examples

### Wavelet Scattering Paths

Create two wavelet scattering networks, both for a signal of length 500. In the second network, set the `OptimizePath`

value to `true`

.

sf = waveletScattering('SignalLength',500); sfOpt = waveletScattering('SignalLength',500, ... 'OptimizePath',true);

Obtain the path information of the default and path-optimized networks. Determine the total number of scattering paths in both networks.

[spaths,npaths] = paths(sf); [spathsOpt,npathsOpt] = paths(sfOpt); fprintf('Default Network: %d paths\nOptimized Network: %d paths\n', ... sum(npaths),sum(npathsOpt));

Default Network: 65 paths Optimized Network: 52 paths

Both networks have two filter banks. Visualize the scattering paths that include the wavelets in the second filter bank. Create a directed graph. For every wavelet filter that is on at least one path, label the corresponding node as *waveletNumber*.*filterbank*. For each path, connect the corresponding nodes. Use the helper function `helperPlotScatteringGraph`

to construct the graphs. Plot the graphs of both networks.

scatGraph = helperPlotScatteringGraph(spaths); plot(scatGraph) title({'Scattering Paths', ... ['OptimizePath: ',num2str(sf.OptimizePath)]})

figure scatGraphOpt = helperPlotScatteringGraph(spathsOpt); plot(scatGraphOpt) title({'Scattering Paths', ... ['OptimizePath: ',num2str(sfOpt.OptimizePath)]})

**Supporting Functions**

**plotScatteringGraph**

function dirGraph = helperPlotScatteringGraph(networkPaths) % This function is intended for use only in this example. % It may change or be removed in a future release. path = networkPaths{3}.path; % Set to 0 if want to plot the multiple paths between 0 and each % first level node mkunique = 1; if mkunique == 1 f1 = path(:,1:2); c = unique(f1,'rows'); else c = path(:,1:2); end p1 = string(c(:,1)); p2 = string(c(:,2)+.1); p3 = string(path(:,2)+.1); p4 = string(path(:,3)+.2); dirGraph = digraph([p1;p3],[p2;p4]); end

## Input Arguments

`sf`

— Wavelet time scattering network

`waveletScattering`

object

Wavelet time scattering network, specified as a `waveletScattering`

object.

## Output Arguments

`spaths`

— Scattering paths

cell array

Scattering paths, returned as a *NO*-by-1 cell array of MATLAB tables, where *NO* is the number of orders of the
scattering network.

Each MATLAB table in `spaths`

contains three variables:

`path`

— Scattering network paths. In the*k*th element of`spaths`

,`path`

is a*N*-by-*k*matrix where each row contains a path from the input data through the (*k*-1)th wavelet filter bank. For example, when*k*equals 1,*N*is equal to 1 and the only path is 0 denoting the input data. When k equals 2,*N*is equal to the number of wavelet filters in the first filter bank and`path`

is a*N*-by-2 matrix describing the path from the input data, 0, through the wavelet filters in the first filter bank. The second column of`path`

contains the wavelet filters in the first filter bank ordered by decreasing center frequency.`log2ds`

— The incremental base-2 log downsampling factor for the scalogram coefficients corresponding to the cumulative path in the same row.`log2res`

— The base-2 log resolution of the scalogram coefficients corresponding to the cumulative path in the same row.

`npaths`

— Number of wavelet scattering paths

vector

Number of wavelet scattering paths in the network by order, returned as a vector.
`npaths`

is a *NO*-by-1 vector where
*NO* is the number of orders in the network. The
*i*th element of `npaths`

contains the number of
scattering paths in the (*i*-1)th order. The sum of the elements of
`npaths`

is the total number of scattering paths.

## Extended Capabilities

### C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

## Version History

**Introduced in R2021a**

## See Also

## MATLAB Command

You clicked a link that corresponds to this MATLAB command:

Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.

Select a Web Site

Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .

You can also select a web site from the following list:

## How to Get Best Site Performance

Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.

### Americas

- América Latina (Español)
- Canada (English)
- United States (English)

### Europe

- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)

- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)