Documentation Center

  • Trial Software
  • Product Updates

plot

Class: RepeatedMeasuresModel

Plot data with optional grouping

Syntax

Description

example

plot(rm) plots the measurements in the repeated measures model rm for each subject as a function of time. If there is a single numeric within-subjects factor, plot uses the values of that factor as the time values. Otherwise, plot uses the discrete values 1 through r as the time values, where r is the number of repeated measurements.

example

plot(rm,Name,Value) also plots the measurements in the repeated measures model rm, with additional options specified by one or more Name,Value pair arguments.

For example, you can specify the factors to group by or change the line colors.

H = plot(___) returns handles, H, to the plotted lines.

Input Arguments

expand all

rm — Repeated measures modelRepeatedMeasuresModel object

Repeated measures model, returned as a RepeatedMeasuresModel object.

For properties and methods of this object, see RepeatedMeasuresModel.

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

'Group' — Name of between-subject factor or factorsstring | cell array of strings

Name of between-subject factor or factors, specified as the comma-separated pair consisting of 'Group' and a string or cell array of strings. This name-value pair argument groups the lines according to the factor values.

For example, if you have two between-subject factors, drug and sex, and you want to group the lines in the plot according to them, you can specify these factors as follows.

Example: 'Group',{'Drug','Sex'}

Data Types: char | cell

'Marker' — Marker to use for each groupcell array of strings

Marker to use for each group, specified as the comma-separated pair consisting of 'Marker' and a cell array of strings.

For example, if you have two between-subject factors, drug and sex, with each having two groups, you can specify o as the marker for the groups of drug and x as the marker for the groups of sex as follows.

Example: 'Marker',{'o','o','x','x'}

Data Types: cell

'Color' — Color for each groupstring | cell array of strings | rows of a three-column RGB matrix

Color for each group, specified as the comma-separated pair consisting of 'Color' and a string, cell array of strings, or rows of a three-column RGB matrix.

For example, if you have two between-subject factors, drug and sex, with each having two groups, you can specify red as the color for the groups of drug and blue as the color for the groups of sex as follows.

Example: 'Color','rrbb'

Data Types: single | double | cell

'LineStyle' — Line style for each groupcell array of strings

Line style for each group, specified as the comma-separated pair consisting of 'LineStyle' and a cell array of strings.

For example, if you have two between-subject factors, drug and sex, with each having two groups, you can specify - as the line style of one group and : as the line style for the other group as follows.

Example: 'LineStyle',{'-' ':' '-' ':'}

Data Types: cell

Output Arguments

expand all

H — Handle to plotted lineshandle

Handle to plotted lines, returned as a handle.

Examples

expand all

Plot Data by Group

Load the sample data.

load fisheriris

The column vector species consists of iris flowers of three different species: setosa, versicolor, and virginica. The double matrix meas consists of four types of measurements on the flowers: the length and width of sepals and petals in centimeters, respectively.

Store the data in a table array.

t = table(species,meas(:,1),meas(:,2),meas(:,3),meas(:,4),...
'VariableNames',{'species','meas1','meas2','meas3','meas4'});
Meas = dataset([1 2 3 4]','VarNames',{'Measurements'});

Fit a repeated measures model, where the measurements are the responses and the species is the predictor variable.

rm = fitrm(t,'meas1-meas4~species','WithinDesign',Meas);

Plot data grouped by the factor species.

plot(rm,'group','species')

Change the line style for each group.

plot(rm,'group','species','LineStyle',{'-','--',':'})

Plot Data Grouped by Two Factors

Load the sample data.

load repeatedmeas

The table between includes the between-subject variables age, IQ, group, gender, and eight repeated measures y1 through y8 as responses. The table within includes the within-subject variables w1 and w2. This is simulated data.

Fit a repeated measures model, where the repeated measures y1 through y8 are the responses, and age, IQ, group, gender, and the group-gender interaction are the predictor variables. Also specify the within-subject design matrix.

rm = fitrm(between,'y1-y8 ~ Group*Gender + Age + IQ','WithinDesign',within);

Plot data with Group coded by color and Gender coded by line type.

plot(R,'group',{'Group' 'Gender'},'Color','rrbbgg',...
              'LineStyle',{'-' ':' '-' ':' '-' ':'},'Marker','.')

See Also

| |

Was this topic helpful?