# plot.earth.models

##### Compare earth models by plotting them.

Compare `earth`

models by plotting them.

- Keywords
- models

##### Usage

```
# S3 method for earth.models
plot(x = stop("no 'x' argument"), which = c(1:2),
caption = "", jitter = 0,
col.grsq = discrete.plot.cols(length(objects)), lty.grsq = 1,
col.rsq = 0, lty.rsq = 5,
col.vline = col.grsq, lty.vline = "12",
col.npreds = 0, lty.npreds = 2,
legend.text = NULL, do.par = NULL, trace = 0,
…)
```

##### Arguments

- x
A list of one or more

`earth`

objects, or a single`earth`

object. This is the only required argument. (This argument is called 'x' for consistency with the generic`plot`

.)- which
Which plots to plot: 1 model, 2 cumulative distribution of residuals. Default is

`1:2`

, meaning both.- caption
Overall caption. Values:

`"string"`

string`""`

(default) no caption`NULL`

generate a caption from the`$call`

component of the`earth`

objects.- jitter
Jitter applied to GRSq and RSq values to minimize over-plotting. Default is

`0`

, meaning no jitter. A typical useful value is 0.01.*For the col arguments below, 0 means do not plot the corresponding graph element. You can use vectors of colors.*- col.grsq
Vector of colors for the GRSq plot. The default is

`discrete.plot.cols(length(x))`

which is vector of distinguishable colors, the first three of which are also distinguishable on a monochrome printer. You can examine the colors using`earth:::discrete.plot.cols()`

.- lty.grsq
Line type for the GRSq plot. Default is

`1`

.- col.rsq
Vector of colors for the RSq plot. Default is

`0`

, meaning no RSq plot.- lty.rsq
Line type for the RSq plot. Default is

`5`

.- col.vline
A vertical line is drawn for each object to show which model size was chosen for that object. The color of the line is

`col.vline`

. Default is`col.grsq`

.- lty.vline
Line type of vertical lines (a vertical line is drawn to show the selected model for each object). Can be a vector. Default is

`3`

.- col.npreds
Vector of colors for the "number of predictors" plot within the model selection plot. Default is

`0`

, meaning no "number of predictors" plot. The special value`NULL`

means borrow`col.grsq`

(or`col.rsq`

if`col.grsq`

is`NULL`

).- lty.npreds
Line type of the "number of predictors" plot (in the Model Selection plot). Default is

`2`

.- legend.text,do.par,trace
Please see

`plotres`

- …
Please see

`plotres`

##### Note

This function ignores GLM and cross-validation components of the earth model, if any.

##### See Also

##### Examples

```
# NOT RUN {
data(ozone1)
a1 <- earth(O3 ~ ., data = ozone1, degree = 2)
a2 <- earth(O3 ~ .-wind, data = ozone1, degree = 2)
a3 <- earth(O3 ~ .-humidity, data = ozone1, degree = 2)
plot.earth.models(list(a1,a2,a3), ylim=c(.65,.85))
# }
```

*Documentation reproduced from package earth, version 4.6.0, License: GPL-3*