Main Content

plotsigroi

Plot signal regions based on signal mask

Since R2020b

collapse all in page

Syntax

plotsigroi(msk,x)
plotsigroi(msk,x,patchflag)
h = plotsigroi(msk,x)

Description

plotsigroi(msk,x) plots signal x with color-coded regions based on the source and properties in msk. If x is complex-valued, the function plots its magnitude.

example

plotsigroi(msk,x,patchflag) plots regions of interest using rectangular patches if patchflag is true.

example

h = plotsigroi(msk,x) returns the figure handle of the color-coded plot. You can use the figure handle to query and modify figure properties.

Examples

collapse all

Open Live Script

Consider a mask of binary sequences for two categories, ran and dom. Use the sequences to generate a signalMask object. Discard regions with fewer than 3 samples.

rng default

sq = randi(2,200,2)-1;

m = signalMask(sq,"MinLength",3,"Categories",["ran" "dom"]);

Generate a sequence of 200 random numbers. Plot the regions of interest.

x = rand(200,1);

plotsigroi(m,x)

Figure contains an axes object. The axes object with xlabel Samples contains 3 objects of type line.

Plot the regions of interest using rectangular patches.

plotsigroi(m,x,true)

Figure contains an axes object. The axes object with xlabel Samples contains 27 objects of type line, patch.

Input Arguments

collapse all

Signal mask, specified as a signalMask object.

Example: signalMask(table([2 4;6 7],["male" "female"]')) specifies a signal mask with a three-sample male region and a two-sample female region.

Example: signalMask(categorical(["" "male" "male" "male" "" "female" "female" ""]',["male" "female"])) specifies a signal mask with a three-sample male region and a two-sample female region.

Example: signalMask([0 1 1 1 0 0 0 0;0 0 0 0 0 1 1 0]','Categories',["male" "female"]) specifies a signal mask with a three-sample male region and a two-sample female region.

Input signal, specified as a vector.

Example: chirp(0:1/1e3:1,25,1,50) specifies a chirp sampled at 1 kHz.

Data Types: single | double
Complex Number Support: Yes

Rectangular patch option, specified as a logical value. plotsigroi uses rectangular patches to plot regions of interest if patchflag is true.

Data Types: logical

Output Arguments

collapse all

Figure handle, returned as an Axes object.

For more information about the list of properties in Axes objects, see Axes Properties.

Version History

Introduced in R2020b

See Also

Apps

Objects

Topics