# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

# plotDiagnostics

Class: LinearModel

Plot diagnostics of linear regression model

## Syntax

```plotDiagnostics(mdl) plotDiagnostics(mdl,plottype) h = plotDiagnostics(___) h = plotDiagnostics(mdl,plottype,Name,Value) ```

## Description

`plotDiagnostics(mdl)` plots diagnostics from the `mdl` linear model using the leverage values.

`plotDiagnostics(mdl,plottype)` plots diagnostics in a plot of type `plottype`.

`h = plotDiagnostics(___)` returns handles to the lines in the plot, using any of the previous syntaxes.

`h = plotDiagnostics(mdl,plottype,Name,Value)` plots with additional options specified by one or more `Name,Value` pair arguments.

## Input Arguments

expand all

Full, fitted linear regression model, specified as a `LinearModel` object constructed using `fitlm` or `stepwiselm`.

Type of plot, specified as one of the following:

 `'contour'` Residual vs. leverage with overlayed Cook's contours `'cookd'` Cook's distance `'covratio'` Delete-1 ratio of determinant of covariance `'dfbetas'` Scaled delete-1 coefficient estimates `'dffits'` Scaled delete-1 fitted values `'leverage'` Leverage `'s2_i'` Delete-1 variance estimate

Delete-1 means compute a new model without the current observation. If the delete-1 calculation differs significantly from the model using all observations, then the observation is influential.

### 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`.

### Note

The plot property name-value pairs apply to the first returned handle `h(1)`.

expand all

Color of the line or marker, specified as the comma-separated pair consisting of `'Color'` and a `ColorSpec` specification. For details, see `linespec`.

Line style, specified as the comma-separated pair consisting of `'LineStyle'` and a Line Properties specification. For details, see `linespec`.

Width of the line or edges of filled area, in points, specified as the comma-separated pair consisting of `'LineWidth'` and a positive numeric value. One point is equal to 1/72 inch.

Color of the marker or edge color for filled markers, specified as the comma-separated pair consisting of `'MarkerEdgeColor'` and a `ColorSpec` specification. For details, see `linespec`.

Color of the marker face for filled markers, specified as the comma-separated pair consisting of `'MarkerFaceColor'` and a `ColorSpec` specification. For details, see `linespec`.

Size of the marker in points, specified as the comma-separated pair consisting of `'MarkerSize'` and a positive numeric value. One point is 1/72 inch.

## Output Arguments

expand all

Graphics handles, returned as a vector of graphics handles corresponding to the lines or patches in the plot.

## Examples

expand all

Plot the leverage values of observations in a fitted model.

Load the `carsmall` data and fit a linear model of the mileage as a function of model year, weight, and weight squared.

```load carsmall tbl = table(MPG,Weight); tbl.Year = categorical(Model_Year); mdl = fitlm(tbl,'MPG ~ Year + Weight^2'); ```

Plot the leverage values.

```plotDiagnostics(mdl) ```

Plot the Cook's distance.

```plotDiagnostics(mdl,'cookd') ```

The two diagnostic plots give different results.

expand all

## Tips

• For many plots, the Data Cursor tool in the figure window displays the x and y values for any data point, along with the observation name or number.

## Alternatives

The `mdl.Diagnostics` property contains the information that `plotDiagnostics` uses to create plots.

## References

[1] Neter, J., M. H. Kutner, C. J. Nachtsheim, and W. Wasserman. Applied Linear Statistical Models, Fourth Edition. Irwin, Chicago, 1996.