yregion

Create a line plot and a filled region between y=0 and y=106.

x = 0:0.1:50;
y = 2*x .* (sin(x) + cos(2*x));
plot(x,y)
yregion(0,106)

You can modify aspects of a region by setting properties. You can set properties by specifying name-value arguments when you call yregion, or you can set properties later using dot notation.

For example, create a plot with a filled region, and customize the fill and boundary line colors by specifying the FaceColor and EdgeColor name-value arguments. Also, specify an output argument to store the ConstantRegion object.

x = 0:0.1:50;
y = 2*x .* (sin(x) + cos(2*x));
plot(x,y)
yr = yregion(0,106,FaceColor="b",EdgeColor=[0.4 0 0.7]);

Modify the appearance further by setting properties of the ConstantRegion object yr. Change the opacity of the fill color and boundary line color by setting the FaceAlpha and EdgeAlpha properties to numbers from 0 to 1, where 1 is fully opaque. Then, set the boundary line thickness by setting the LineWidth property.

yr.FaceAlpha = 0.1;
yr.EdgeAlpha = 0.5;
yr.LineWidth = 3;

Move the lower boundary to -25.

yr.Value = [-25 106];

You can create multiple filled regions by specifying the starting and ending coordinates as vectors of the same size. You can also display entries for these regions in a legend.

For example, create a horizontal bar chart with two filled regions. Specify an output argument to store both ConstantRegion objects so you can modify them later.

x = [1 2 3 4 13 11 2.5];
barh(x,DisplayName="Results")
yr = yregion([0.5 4.5],[2.5 6.5]);

Specify a color for each region by setting the FaceColor property. Specify a legend entry name for each region by setting the DisplayName property. To access the individual ConstantRegion objects for setting the properties, index into the output argument yr. After setting the properties, display a legend.

yr(1).FaceColor = "r";
yr(1).DisplayName = "Low";
yr(2).FaceColor = "#88FE45";
yr(2).DisplayName = "High";
legend

Create a horizontal bar chart with five bars positioned at specific numbers of minutes. Then display a filled region from the second bar to the fourth bar. To contain the three bars within the region, calculate the boundaries by subtracting 30 seconds from the second bar's location and adding 30 seconds to the fourth bar's location.

dur = minutes(1:5)';
y = [1 5 11 4 3];
barh(dur,y)
yregion(dur(2)-seconds(30), dur(4)+seconds(30))

Create a horizontal bar chart of categorical data, and create a filled region that spans the second and third bars. The reordercats function specifies the order of the categories for the bar chart.

cats = categorical(["Pumpkin" "Apple" "Pecan" "Cherry"]);
cats = reordercats(cats,["Pumpkin" "Apple" "Pecan" "Cherry"]);
barlengths = [15 21 33 12];
barh(cats,barlengths)
yregion(cats(2),cats(3))
title("Favorite Pies")

Since R2023b

Create a plot, and add three filled regions. Specify a 2-by-3 matrix with the lower bounds in the first row and the upper bounds in the second row. The first region has a lower bound of -Inf, and the last region has an upper bound of Inf, so the first and last regions are unbounded.

x = 0:0.1:50;
y = 2*x .* (sin(x) + cos(2*x));
plot(x,y)
Y = [-Inf -50 50; -100 0 Inf];
yregion(Y)