stackedplot — Create a stacked line chart with one y-axis per plotted variable.

stackedplot(Y) plots vector or matrix data with matrix columns in separate stacked axes and row/column vectors as one series. stackedplot(X,Y) uses a common x vector. stackedplot(tbl), stackedplot(tbl,vars), stackedplot(tbl1,...,tblN), and stackedplot({tbl1,...,tblN}) plot selected numeric, logical, datetime, duration, or categorical table/timetable variables and use timetable row times as x data when available.

Syntax

s = stackedplot(Y)
s = stackedplot(X, Y)
s = stackedplot(tbl)
s = stackedplot(tbl, vars)
s = stackedplot(..., LineSpec)
s = stackedplot(..., Name, Value)
s = stackedplot(parent, ...)

Inputs

Returns

Errors

How stackedplot works

• Y can be a vector or matrix. Row and column vectors become one stacked axes; matrix columns become separate stacked axes.
• X must be a vector whose length matches the vector length or matrix row count of Y.
• Table and timetable inputs select plottable variables by default. Text, cell, struct, and unsupported object variables are skipped unless explicitly selected, in which case the chart errors if no plottable variables remain.
• vars and DisplayVariables use the shared table variable selector machinery for table inputs, including names, string arrays, cellstr, numeric indices, logical masks, and supported selector objects. DisplayLabels accepts text scalars, string arrays, character arrays, or cell arrays of text scalars.
• Multiple table or multiple timetable inputs must be the same tabular kind. Matching variable names combine on one stacked axes by default; CombineMatchingNames=false separates them by input.
• XVariable selects the common x-axis variable from table inputs. It may be one variable shared by all table inputs or one variable per input table. Timetable row times are used automatically, and XVariable is rejected for timetables.
• LineSpec and line style name-value properties apply to every child line.
• The returned handle is a stackedplot chart object. get supports Type, Parent, DisplayVariables, SourceTable, XVariable, CombineMatchingNames, XData, YData, XLabel, Title, Visible, GridVisible, XLimits, LineWidth, LineStyle, and Color. YData is a numeric matrix when child lines have matching lengths and a cell array of vectors when multiple source tables have unequal lengths.
• SourceTable returns a lightweight provenance snapshot with source table classes and variable names rather than embedding the original table objects in plotting registry state.
• set supports Title, XLabel, DisplayLabels, YLabels, Visible, GridVisible, XLimits, Color, LineStyle, LineWidth, Marker, and MarkerSize. XLimits accepts finite or infinite numeric bounds as long as the range is increasing.
• Figure handles are accepted as parents. Axes handles, nested grouped DisplayVariables cells, event-table rendering, interactive chart controls, and provider-resident column splitting are not implemented yet and raise explicit errors or documented compatibility fallbacks.

Examples

Plot each matrix column in a separate stacked axes

Y = [1 10; 2 20; 3 30];
s = stackedplot(Y);

Use a common x vector and line style

x = [0 1 2];
Y = [1 10; 2 20; 3 30];
stackedplot(x, Y, '--o', 'LineWidth', 1.5);

Plot selected table variables

T = table([1;2;3], [4;5;6], [7;8;9], 'VariableNames', {'Time','A','B'});
s = stackedplot(T, {'A','B'}, 'XVariable', 'Time');
get(s, 'DisplayVariables')

Combine matching variables from multiple tables

T1 = table([1;2], 'VariableNames', {'A'});
T2 = table([3;4], 'VariableNames', {'A'});
s = stackedplot(T1, T2, 'A');

Using stackedplot with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how stackedplot changes the result.

FAQ

Related Plotting functions

Open-source implementation

Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how stackedplot is executed, line by line, in Rust.

• View the source for stackedplot in Rust on GitHub
• Learn how the RunMat runtime works
• Found a bug? Open an issue with a minimal reproduction.

About RunMat

RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.

• RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
• Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.

Getting started · Benchmarks · Pricing