Create tiled chart layout for displaying subplots (2024)

Create tiled chart layout for displaying subplots

Since R2019b. Recommended over subplot.

collapse all in page

Syntax

tiledlayout(m,n)

tiledlayout(arrangement)

tiledlayout(___,Name,Value)

tiledlayout(parent,___)

t = tiledlayout(___)

Description

example

tiledlayout(m,n) creates a tiled chart layout for displaying multiple plots, also called subplots, in the current figure. The layout has a fixed m-by-n tile arrangement that can display up to m*n plots. If there is no figure, MATLAB® creates a figure and places the layout into it. If the current figure contains an existing axes or layout, MATLAB replaces it with a new layout.

A tiled chart layout contains an invisible grid of tiles that covers the entire figure or parent container. Each tile can contain an axes for displaying a plot. After creating a layout, call the nexttile function to place an axes object into the layout. Then call a plotting function to plot into the axes.

example

tiledlayout(arrangement) creates a layout that can hold any number of axes. Initially, there is only one empty tile that fills the entire layout. Specify an arrangement value to control the placement of subsequent axes:

  • "flow" — Create a layout for a grid of axes that can reflow depending on the size of the figure and the number of axes.

  • "vertical" — Create a layout for a vertical stack of axes. (since R2023a)

  • "horizontal" — Create a layout for a horizontal stack of axes. (since R2023a)

You can specify the arrangement argument without parentheses. For example, tiledlayout vertical creates a layout for a vertical stack of axes.

example

tiledlayout(___,Name,Value) specifies additional options for the layout using one or more name-value pair arguments. Specify the options after all other input arguments. For example, tiledlayout(2,2,"TileSpacing","compact") creates a 2-by-2 layout with minimal spacing between the tiles. For a list of properties, see TiledChartLayout Properties.

example

tiledlayout(parent,___) creates the layout in the specified parent container rather than in the current figure. Specify the parent container before all other input arguments.

example

t = tiledlayout(___) returns the TiledChartLayout object. Use t to configure properties of the layout after creating it.

Examples

collapse all

Create 2-by-2 Layout

Open Live Script

Create a 2-by-2 tiled chart layout, and call the peaks function to get the coordinates of a predefined surface. Create an axes object in the first tile by calling the nexttile function. Then call the surf function to plot into the axes. Repeat the process using different plotting functions for the other three tiles.

tiledlayout(2,2);[X,Y,Z] = peaks(20);% Tile 1nexttilesurf(X,Y,Z)% Tile 2nexttilecontour(X,Y,Z)% Tile 3nexttileimagesc(Z)% Tile 4nexttileplot3(X,Y,Z)

Create tiled chart layout for displaying subplots (1)

Specify Flow Tile Arrangement

Open Live Script

Create four coordinate vectors: x, y1, y2, and y3. Call the tiledlayout function with the 'flow' argument to create a tiled chart layout that can accommodate any number of axes. Call the nexttile function to create the first axes. Then plot y1 in the first tile. This first plot fills the entire layout.

x = linspace(0,30);y1 = sin(x/2);y2 = sin(x/3);y3 = sin(x/4);% Plot into first tile three timestiledlayout('flow')nexttileplot(x,y1)

Create tiled chart layout for displaying subplots (2)

Create a second tile and axes, and plot into the axes.

nexttileplot(x,y2)

Create tiled chart layout for displaying subplots (3)

Repeat the process to create a third plot.

nexttileplot(x,y3)

Create tiled chart layout for displaying subplots (4)

Repeat the process to create a fourth plot. This time, plot all three lines in the same axes by calling hold on after plotting y1.

nexttileplot(x,y1)hold onplot(x,y2)plot(x,y3)hold off

Create tiled chart layout for displaying subplots (5)

Create Vertical Stack of Plots

Open Live Script

Create a tiled chart layout that has a vertical stack of plots by specifying the "vertical" option when you call the tiledlayout function. Then create three plots by calling the nexttile function followed by a plotting function. Each time you call nexttile, a new axes object is added to the bottom of the stack.

tiledlayout("vertical")x = 0:0.1:5;nexttileplot(x,sin(x))nexttileplot(x,sin(x+1))nexttileplot(x,sin(x+2))

Create tiled chart layout for displaying subplots (6)

Create Horizontal Stack of Plots

Create a tiled chart layout that has a horizontal stack of plots by specifying the "horizontal" option when you call the tiledlayout function. Then create three plots by calling the nexttile function followed by a plotting function. Each time you call nexttile, a new axes object is added to the right side of the stack.

tiledlayout("horizontal")x = 0:0.1:10;nexttileplot(x,sin(x/2))nexttileplot(x,sin(x))nexttileplot(x,sin(2*x))

Create tiled chart layout for displaying subplots (7)

Adjust Layout Spacing

Open Live Script

Create five coordinate vectors: x, y1, y2, y3, and y4. Then call the tiledlayout function to create a 2-by-2 layout and specify a return argument to store the TileChartLayout object. Call the nexttile function to create an axes object in the next empty tile before calling the plot function.

x = linspace(0,30);y1 = sin(x);y2 = sin(x/2);y3 = sin(x/3);y4 = sin(x/4);t = tiledlayout(2,2);% Tile 1nexttileplot(x,y1)% Tile 2nexttileplot(x,y2)% Tile 3nexttileplot(x,y3)% Tile 4nexttileplot(x,y4)

Create tiled chart layout for displaying subplots (8)

Decrease the amount of space between the tiles by setting the TileSpacing property to 'compact'. Then decrease the space between the edges of the layout and the edges of the figure by setting the Padding property to 'compact'.

t.TileSpacing = 'compact';t.Padding = 'compact';

Create tiled chart layout for displaying subplots (9)

Create Shared Title and Axis Labels

Open Live Script

Create a 2-by-2 tiled chart layout t. Specify the TileSpacing name-value pair argument to minimize the space between the tiles. Then create a titled plot in each tile.

t = tiledlayout(2,2,'TileSpacing','Compact');% Tile 1nexttileplot(rand(1,20))title('Sample 1')% Tile 2nexttileplot(rand(1,20))title('Sample 2')% Tile 3nexttileplot(rand(1,20))title('Sample 3')% Tile 4nexttileplot(rand(1,20))title('Sample 4')

Create tiled chart layout for displaying subplots (10)

Display a shared title and axis labels by passing t to the title, xlabel, and ylabel functions.

title(t,'Size vs. Distance')xlabel(t,'Distance (mm)')ylabel(t,'Size (mm)')

Create tiled chart layout for displaying subplots (11)

Create Layout in a Panel

Open Live Script

Create a panel in a figure. Then create a tiled chart layout in the panel by specifying the panel object as the first argument to the tiledlayout function. Display a plot in each tile.

p = uipanel('Position',[.1 .2 .8 .6]);t = tiledlayout(p,2,1);% Tile 1nexttile(t)stem(1:13)% Tile 2nexttile(t)bar([10 22 31 43 52])

Create tiled chart layout for displaying subplots (12)

Set Properties on the Axes

Open Live Script

Call the tiledlayout function to create a 2-by-1 tiled chart layout. Call the nexttile function with an output argument to store the axes. Then plot into the axes, and set the x- and y-axis colors to red. Repeat the process in the second tile.

t = tiledlayout(2,1);% First tileax1 = nexttile;plot([1 2 3 4 5],[11 6 10 4 18]);ax1.XColor = [1 0 0];ax1.YColor = [1 0 0];% Second tileax2 = nexttile;plot([1 2 3 4 5],[5 1 12 9 2],'o');ax2.XColor = [1 0 0];ax2.YColor = [1 0 0];

Create tiled chart layout for displaying subplots (13)

Create Axes That Span Multiple Rows and Columns

Open Live Script

Define scores and strikes as vectors containing bowling league data over four games. Then create a tiled chart layout and display three plots showing the number of strikes for each team.

scores = [444 460 380 387 366 500 365 451 611 548 412 452];strikes = [9 6 5 6 4 8 4 7 16 10 9 8]; t = tiledlayout('flow');% Team 1nexttileplot([1 2 3 4],strikes(:,1),'-o')title('Team 1 Strikes')% Team 2nexttileplot([1 2 3 4],strikes(:,2),'-o')title('Team 2 Strikes')% Team 3nexttileplot([1 2 3 4],strikes(:,3),'-o')title('Team 3 Strikes')

Create tiled chart layout for displaying subplots (14)

Call the nexttile function to create an axes object that spans two rows by three columns. Then display a bar graph in the axes with a legend, and configure the axis tick values and labels. Call the title function to add a tile to the layout.

nexttile([2 3]);bar([1 2 3 4],scores)legend('Team 1','Team 2','Team 3','Location','northwest')% Configure ticks and axis labelsxticks([1 2 3 4])xlabel('Game')ylabel('Score')% Add layout titletitle(t,'April Bowling League Data')

Create tiled chart layout for displaying subplots (15)

Span Axes at Specific Tile Number

Open Live Script

To span an axes object from a specific location, specify the tile number and the span value.

Define scores and strikes as vectors containing bowling league data over four games. Then create a 3-by-3 tiled chart layout and display five bar graphs showing the number of strikes for each team.

scores = [444 460 380 388 389 387 366 500 467 460 365 451 611 426 495 548 412 452 471 402];strikes = [9 6 5 7 5 6 4 8 10 7 4 7 16 9 9 10 9 8 8 9]; t = tiledlayout(3,3);% Team 1nexttilebar([1 2 3 4],strikes(:,1))title('Team 1 Strikes')% Team 2nexttilebar([1 2 3 4],strikes(:,2))title('Team 2 Strikes')% Team 3nexttilebar([1 2 3 4],strikes(:,3))title('Team 3 Strikes')% Team 4nexttilebar([1 2 3 4],strikes(:,4))title('Team 4 Strikes')% Team 5nexttile(7)bar([1 2 3 4],strikes(:,5))title('Team 5 Strikes')

Create tiled chart layout for displaying subplots (16)

Display a larger plot with a legend. Call the nexttile function to place the upper left corner of the axes in the fifth tile, and span the axes across two rows by two columns of tiles. Plot the scores for all the teams. Configure the x-axis to display four ticks, and add labels to each axis. Then add a shared title at the top of the layout.

nexttile(5,[2 2]);plot([1 2 3 4],scores,'-.')labels = {'Team 1','Team 2','Team 3','Team 4','Team 5'};legend(labels,'Location','northwest')% Configure ticks and axis labelsxticks([1 2 3 4])xlabel('Game')ylabel('Score')% Add layout titletitle(t,'April Bowling League Data')

Create tiled chart layout for displaying subplots (17)

Display Polar and Geographic Plots

Open Live Script

Create a 1-by-2 tiled chart layout. In the first tile, display a geographic plot containing a line that connects two cities on a map. In the second tile, create a scatter plot in polar coordinates.

tiledlayout(1,2)% Display geographic plotnexttilegeoplot([47.62 61.20],[-122.33 -149.90],'g-*')% Display polar plotnexttiletheta = pi/4:pi/4:2*pi;rho = [19 6 12 18 16 11 15 15];polarscatter(theta,rho)

Create tiled chart layout for displaying subplots (18)

Reconfigure Content in Previous Tile

Open Live Script

One of the ways that the nexttile output argument is useful is when you want to adjust the content in a previous tile. For example, you might decide to reconfigure the colormap used in a previous plot.

Create a 2-by-2 tiled chart layout. Call the peaks function to get the coordinates for a predefined surface. Then create a different plot of the surface in each tile.

tiledlayout(2,2);[X,Y,Z] = peaks(20);% Tile 1nexttilesurf(X,Y,Z)% Tile 2nexttilecontour(X,Y,Z)% Tile 3nexttileimagesc(Z)% Tile 4nexttileplot3(X,Y,Z)

Create tiled chart layout for displaying subplots (19)

To change the colormap in the third tile, get the axes in that tile. Call the nexttile function by specifying the tile number, and return the axes output argument. Then pass the axes to the colormap function.

ax = nexttile(3);colormap(ax,cool)

Create tiled chart layout for displaying subplots (20)

Reconfigure Spanned Axes

Open Live Script

Create a 2-by-3 tiled chart layout containing two plots in individual tiles, and one plot that spans across two rows and two columns.

t = tiledlayout(2,3);[X,Y,Z] = peaks;% Tile 1nexttilecontour(X,Y,Z)% Span across two rows and columnsnexttile([2 2])contourf(X,Y,Z)% Last tilenexttileimagesc(Z)

Create tiled chart layout for displaying subplots (21)

To change the colormap for the spanned axes, identify the tile location as one containing the upper-left corner of the axes. In this case, the upper-left corner is in the second tile. Call the nexttile function with 2 as tile location, and specify an output argument to return the axes object at that location. Then pass the axes to the colormap function.

ax = nexttile(2);colormap(ax,hot)

Create tiled chart layout for displaying subplots (22)

Replace Content in Previous Tile

Open Live Script

Load the patients data set and create a table from a subset of the variables. Then create a 2-by-2 tiled chart layout. Display a scatter plot in the first tile, a heatmap in the second tile, and a stacked plot across the bottom two tiles.

load patientstbl = table(Diastolic,Smoker,Systolic,Height,Weight,SelfAssessedHealthStatus);tiledlayout(2,2)% Scatter plotnexttilescatter(tbl.Height,tbl.Weight)% Heatmapnexttileheatmap(tbl,'Smoker','SelfAssessedHealthStatus','Title','Smoker''s Health');% Stacked plotnexttile([1 2])stackedplot(tbl,{'Systolic','Diastolic'});

Create tiled chart layout for displaying subplots (23)

Call nexttile, and specify the tile number as 1 to make the axes in that tile the current axes. Replace the contents of that tile with a scatter histogram.

nexttile(1)scatterhistogram(tbl,'Height','Weight');

Create tiled chart layout for displaying subplots (24)

Display Shared Colorbar in Separate Tile

Open Live Script

When you want to share a colorbar or legend between two or more plots, you can place it in a separate tile.

Create filled contour plots of the peaks and membrane data sets in a tiled chart layout.

Z1 = peaks;Z2 = membrane;tiledlayout(2,1);nexttilecontourf(Z1)nexttilecontourf(Z2)

Create tiled chart layout for displaying subplots (25)

Add a colorbar, and move it to the east tile.

cb = colorbar;cb.Layout.Tile = 'east';

Create tiled chart layout for displaying subplots (26)

Create Axes Without nexttile and Position it Manually

Open Live Script

Occasionally, you might need to create the axes by calling one of the axes functions (axes, polaraxes, or geoaxes). When you create the axes with one of these functions, specify the parent argument as the tiled chart layout. Then position the axes by setting the Layout property on the axes.

Create a tiled chart layout t and specify the 'flow' tile arrangement. Display a plot in each of the first three tiles.

t = tiledlayout('flow');nexttileplot(rand(1,10));nexttileplot(rand(1,10));nexttileplot(rand(1,10));

Create tiled chart layout for displaying subplots (27)

Create a geographic axes object gax by calling the geoaxes function and specify t as the parent argument. By default, the axes goes into the first tile, so move it to the fourth tile by setting gax.Layout.Tile to 4. Span the axes across a 2-by-3 region of tiles by setting gax.Layout.TileSpan to [2 3].

gax = geoaxes(t);gax.Layout.Tile = 4;gax.Layout.TileSpan = [2 3];

Create tiled chart layout for displaying subplots (28)

Call the geoplot function. Then configure the map center and zoom level for the axes.

geoplot(gax,[47.62 61.20],[-122.33 -149.90],'g-*')gax.MapCenter = [47.62 -122.33];gax.ZoomLevel = 2;

Create tiled chart layout for displaying subplots (29)

Input Arguments

collapse all

mNumber of rows
positive whole number

Number of rows, specified as a positive whole number.

Example: tiledlayout(2,3) creates a tiled chart layout that has two rows and three columns of tiles.

nNumber of columns
positive whole number

Number of columns, specified as a positive whole number.

Example: tiledlayout(2,3) creates a tiled chart layout that has two rows and three columns of tiles.

arrangementTile arrangement
"flow" | "vertical" | "horizontal"

Tile arrangement, specified as one of these values:

  • "flow" — Create a layout for a grid of axes. Each time you call nexttile, the layout reflows as needed to accommodate the new axes while maintaining an aspect ratio of roughly 4:3 for all the axes.

  • "vertical" — Create a layout for a vertical stack of axes. Each time you call nexttile, a new axes object is added to the bottom of the stack. (since R2023a)

  • "horizontal" — Create a layout for a horizontal stack of axes. Each time you call nexttile, a new axes object is added to the right side of the stack. (since R2023a)

Example: tiledlayout("vertical") creates a layout for a vertical stack of axes.

parentParent container
Figure object | Panel object | Tab object | TiledChartLayout object

Parent container, specified as a Figure, Panel, Tab, or TiledChartLayout object.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: tiledlayout(2,2,"TileSpacing","compact") creates a 2-by-2 layout that has minimal spacing between the tiles.

Note

The properties listed here are only a subset. For a complete list, see TiledChartLayout Properties.

TileSpacingTile spacing
"loose" (default) | "compact" | "tight" | "none"

Tile spacing, specified as "loose", "compact", "tight" or "none". Use this property to control the spacing between the tiles.

This table shows how each value affects the appearance of a 2-by-2 layout.

ValueAppearance

"loose"

Create tiled chart layout for displaying subplots (30)

"compact"

Create tiled chart layout for displaying subplots (31)

"tight"

Create tiled chart layout for displaying subplots (32)

"none"

Create tiled chart layout for displaying subplots (33)

PaddingPadding around layout
"loose" (default) | "compact" | "tight"

Padding around the perimeter of the layout, specified as "loose", "compact", or "tight". The layout provides space for all decorations, such as axis labels, regardless of the value of this property.

This table shows how each value affects the appearance of a 2-by-2 layout.

ValueAppearance

"loose"

Create tiled chart layout for displaying subplots (34)

"compact"

Create tiled chart layout for displaying subplots (35)

"tight"

Create tiled chart layout for displaying subplots (36)

Version History

Introduced in R2019b

expand all

Create a vertical or horizontal layout by specifying "vertical" or "horizontal" as the arrangement value when you call tiledlayout.

tiledlayout creates layouts that are more customizable and configurable than the layouts created by subplot. For example, you can create layouts with adjustable tile spacing, tiles that reflow according to the size of the figure, and better placed colorbars and legends.

See Also

Functions

  • nexttile | tilenum | tilerowcol

Properties

  • TiledChartLayout Properties

Topics

  • Combine Multiple Plots
  • Customized Presentations and Special Effects with Tiled Chart Layouts

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.

Create tiled chart layout for displaying subplots (50)

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:

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
    • Deutsch
    • English
    • Français
  • United Kingdom (English)

Asia Pacific

  • Australia (English)
  • India (English)
  • New Zealand (English)
  • 中国
  • 日本 (日本語)
  • 한국 (한국어)

Contact your local office

Create tiled chart layout for displaying subplots (2024)
Top Articles
Latest Posts
Article information

Author: Gregorio Kreiger

Last Updated:

Views: 5973

Rating: 4.7 / 5 (77 voted)

Reviews: 84% of readers found this page helpful

Author information

Name: Gregorio Kreiger

Birthday: 1994-12-18

Address: 89212 Tracey Ramp, Sunside, MT 08453-0951

Phone: +9014805370218

Job: Customer Designer

Hobby: Mountain biking, Orienteering, Hiking, Sewing, Backpacking, Mushroom hunting, Backpacking

Introduction: My name is Gregorio Kreiger, I am a tender, brainy, enthusiastic, combative, agreeable, gentle, gentle person who loves writing and wants to share my knowledge and understanding with you.