Main Content


Multivari chart for grouped data


[charthandle,AXESH] = multivarichart(...)


multivarichart(y,GROUP) displays the multivari chart for the vector y grouped by entries in GROUP that can be a cell array or a matrix. If GROUP is a cell array, then each cell in GROUP must contain a grouping variable that is a categorical vector, numeric vector, character matrix, string array, or single-column cell array of character vectors. If GROUP is a numeric matrix, then its columns represent different grouping variables. Each grouping variable must have the same number of elements as y. The number of grouping variables must be 2, 3, or 4.

Each subplot of the plot matrix contains a multivari chart for the first and second grouping variables. The x-axis in each subplot indicates values of the first grouping variable. The legend at the bottom of the figure window indicates values of the second grouping variable. The subplot at position (i,j) is the multivari chart for the subset of y at the ith level of the third grouping variable and the jth level of the fourth grouping variable. If the third or fourth grouping variable is absent, it is considered to have only one level.

multivarichart(Y) displays the multivari chart for a matrix Y. The data in different columns represent changes in one factor. The data in different rows represent changes in another factor.

multivarichart(...,param1,val1,param2,val2,...) specifies one or more of the following name/value pairs:

  • 'varnames' — Grouping variable names in a character matrix, a string array, or a cell array of character vectors, one per grouping variable. Default names are 'X1', 'X2', ... .

  • 'plotorder''sorted' or a vector containing a permutation of the integers from 1 to the number of grouping variables.

    If 'plotorder' is 'sorted', the grouping variables are rearranged in descending order according to the number of levels in each variable.

    If 'plotorder' is a vector, it indicates the order in which each grouping variable should be plotted. For example, [2,3,1,4] indicates that the second grouping variable should be used as the x-axis of each subplot, the third grouping variable should be used as the legend, the first grouping variable should be used as the columns of the plot, and the fourth grouping variable should be used as the rows of the plot.

multivarichart(fig,___) plots into the figure specified by fig instead of the current figure (gcf) using any of the input argument combinations in the previous syntaxes. (since R2024a)

[charthandle,AXESH] = multivarichart(...) returns a handle charthandle to the figure window and a matrix AXESH of handles to the subplot axes.


collapse all

Display a multivari chart for data with two grouping variables.

rng default; % For reproducibility
y = randn(100,1); % Randomly generate response 
group = [ceil(3*rand(100,1)) ceil(2*rand(100,1))]; 

Display a multivari chart for data with four grouping variables.

y = randn(1000,1); % Randomly generate response
group = {ceil(2*rand(1000,1)),ceil(3*rand(1000,1)), ...

Version History

Introduced in R2006b

expand all