# Documentation

## 1-D Continuous Wavelet Analysis

The Wavelet Toolbox™ software enables you to perform a continuous wavelet analysis of your univariate or bivariate 1-D input signals. You can perform continuous wavelet analyses at the command line or with graphical user interfaces accessible through `wavemenu`.

Key features include:

In this section, you'll learn how to

• Load a signal

• Perform a continuous wavelet transform of a signal

• Produce a plot of the coefficients

• Produce a plot of coefficients at a given scale

• Produce a plot of local maxima of coefficients across scales

• Select the displayed plots

• Switch from scale to pseudo-frequency information

• Zoom in on detail

• Display coefficients in normal or absolute mode

• Choose the scales at which analysis is performed

Since you can perform analyses either from the command line or using the graphical interface tools, this section has subsections covering each method.

The final subsection discusses how to exchange signal and coefficient information between the disk and the graphical tools.

### Command Line Continuous Wavelet Analysis

This example involves a noisy sinusoidal signal.

1. Load a signal.

From the MATLAB® prompt, type

```load noissin; ```

You now have the signal `noissin` in your workspace:

```whos ```
NameSizeBytesClass
`noissin``1x1000``8000``double array`

2. Perform a Continuous Wavelet Transform.

Use the `cwt` command. Type

```c = cwt(noissin,1:48,'db4'); ```

The arguments to `cwt` specify the signal to be analyzed, the scales of the analysis, and the wavelet to be used. The returned argument `c` contains the coefficients at various scales. In this case, `c` is a 48-by-1000 matrix with each row corresponding to a single scale.

3. Plot the coefficients.

The `cwt` command accepts a fourth argument. This is a flag that, when present, causes `cwt` to produce a plot of the absolute values of the continuous wavelet transform coefficients.

The `cwt` command can accept more arguments to define the different characteristics of the produced plot. For more information, see the `cwt` reference page.

```c = cwt(noissin,1:48,'db4','plot'); ```

A plot appears.

Of course, coefficient plots generated from the command line can be manipulated using ordinary MATLAB graphics commands.

4. Choose scales for the analysis.

The second argument to `cwt` gives you fine control over the scale levels on which the continuous analysis is performed. In the previous example, we used all scales from 1 to 48, but you can construct any scale vector subject to these constraints:

• All scales must be real positive numbers.

• The scale increment must be positive.

• The highest scale cannot exceed a maximum value depending on the signal.

Let's repeat the analysis using every other scale from 2 to 128. Type

```c = cwt(noissin,2:2:128,'db4','plot'); ```

A new plot appears:

This plot gives a clearer picture of what's happening with the signal, highlighting the periodicity.

### Continuous Analysis Using the Graphical Interface

We now use the Continuous Wavelet 1-D tool to analyze the same noisy sinusoidal signal we examined earlier using the command line interface in Command Line Continuous Wavelet Analysis.

1. Start the Continuous Wavelet 1-D Tool. From the MATLAB prompt, type

```wavemenu ```

The Wavelet Toolbox Main Menu appears.

Click the Continuous Wavelet 1-D menu item.

The continuous wavelet analysis tool for one-dimensional signal data appears.

2. Load a signal.

Choose the File > Load Signal menu option.

When the Load Signal dialog box appears, select the MAT-file `noissin.mat`, which should reside in the MATLAB folder `toolbox/wavelet/wavedemo`. Click the OK button.

The noisy sinusoidal signal is loaded into the Continuous Wavelet 1-D tool.

The default value for the sampling period is equal to 1 (second).

3. Perform a Continuous Wavelet Transform.

To start our analysis, let's perform an analysis using the `db4` wavelet at scales 1 through 48, just as we did using command line functions in the previous section.

In the upper right portion of the Continuous Wavelet 1-D tool, select the `db4` wavelet and scales 1–48.

4. Click the Analyze button.

After a pause for computation, the tool displays the coefficients plot, the coefficients line plot corresponding to the scale a = 24, and the local maxima plot, which displays the chaining across scales (from a = 48 down to a = 1) of the coefficients local maxima.

5. View Wavelet Coefficients Line.

Select another scale a = 40 by clicking in the coefficients plot with the right mouse button. See step 9 to know, more precisely, how to select the desired scale.

Click the New Coefficients Line button. The tool updates the plot.

6. View Maxima Line.

Click the Refresh Maxima Line button. The local maxima plot displays the chaining across scales of the coefficients local maxima from a = 40 down to a = 1.

Hold down the right mouse button over the coefficients plot. The position of the mouse is given by the Info frame (located at the bottom of the screen) in terms of location (X) and scale (Sca).

7. Switch from scale to Pseudo-Frequency Information.

Using the option button on the right part of the screen, select Frequencies instead of Scales. Again hold down the right mouse button over the coefficients plot, the position of the mouse is given in terms of location (X) and frequency (Frq) in Hertz.

This facility allows you to interpret scale in terms of an associated pseudo-frequency, which depends on the wavelet and the sampling period..

8. Deselect the last two plots using the check boxes in the Selected Axes frame.

9. Zoom in on detail.

Drag a rubber band box (by holding down the left mouse button) over the portion of the signal you want to magnify.

10. Click the X+ button (located at the bottom of the screen) to zoom horizontally only.

The Continuous Wavelet 1-D tool enlarges the displayed signal and coefficients plot (for more information on zooming, see Connection of Plots in the Wavelet Toolbox User's Guide).

As with the command line analysis on the preceding pages, you can change the scales or the analyzing wavelet and repeat the analysis. To do this, just edit the necessary fields and click the Analyze button.

11. View normal or absolute coefficients.

The Continuous Wavelet 1-D tool allows you to plot either the absolute values of the wavelet coefficients, or the coefficients themselves.

More generally, the coefficients coloration can be done in several different ways. For more details on the Coloration Mode, see Controlling the Coloration Mode.

Choose either one of the absolute modes or normal modes from the Coloration Mode menu. In normal modes, the colors are scaled between the minimum and maximum of the coefficients. In absolute modes, the colors are scaled between zero and the maximum absolute value of the coefficients.

### Importing and Exporting Information from the Graphical Interface

The Continuous Wavelet 1-D graphical interface tool lets you import information from and export information to disk.

You can

• Load signals from disk into the Continuous Wavelet 1-D tool.

• Save wavelet coefficients from the Continuous Wavelet 1-D tool to disk.

#### Loading Signals into the Continuous Wavelet 1-D Tool

To load a signal you've constructed in your MATLAB workspace into the Continuous Wavelet 1-D tool, save the signal in a MAT-file (with extension `mat` or other).

For instance, suppose you've designed a signal called `warma` and want to analyze it in the Continuous Wavelet 1-D tool.

```save warma warma ```

The workspace variable `warma` must be a vector.

```sizwarma = size(warma) sizwarma = 1 1000 ```

To load this signal into the Continuous Wavelet 1-D tool, use the menu option File > Load Signal. A dialog box appears that lets you select the appropriate MAT-file to be loaded.

 Note   The first one-dimensional variable encountered in the file is considered the signal. Variables are inspected in alphabetical order.

#### Saving Wavelet Coefficients

The Continuous Wavelet 1-D tool lets you save wavelet coefficients to disk. The toolbox creates a MAT-file in the current folder with the extension `wc1` and a name you give it.

To save the continuous wavelet coefficients from the present analysis, use the menu option File > Save > Coefficients.

A dialog box appears that lets you specify a folder and filename for storing the coefficients.

Consider the example analysis:

File > Example Analysis > with haar at scales [1:1:64] → Cantor curve.

After saving the continuous wavelet coefficients to the file `cantor.wc1`, load the variables into your workspace:

```load cantor.wc1 -mat whos ```
NameSizeBytesClass
`coeff``64x2188``1120256``double array`
`scales``1x64``512``double array`
`wname``1x4``8``char array`

Variables `coefs` and `scales` contain the continuous wavelet coefficients and the associated scales. More precisely, in the above example, `coefs` is a 64-by-2188 matrix, one row for each scale; and `scales` is the 1-by-64 vector `1:64`. Variable `wname` contains the wavelet name.

Was this topic helpful?

Get trial now