plot.earth.models {earth} | R Documentation |
Compare earth
models by plotting them.
plot.earth.models(x = stop("no 'x' arg"), which = c(1:2), caption = "", rlim = c(0,1), jitter = 0, col.grsq = discrete.plot.cols(length(x)), col.rsq = 0, col.npreds = 0, col.cum = NULL, col.vline = "grey", lty.vline = 3, col.legend = 1, legend.pos = NULL, legend.text = NULL, do.par = TRUE, main = "Model Comparison", ...)
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 captionNULL generate a caption from the $call component of the earth objects.
|
rlim |
Two element vector c(min,max) specifying min and max
values on the y axis of the RSq/GRSq plot.
Default is c(0,1) .
The special value min= -1 means the minimum y axis value
is the smallest GRSq or RSq, excluding the intercept.
The special value max= -1 means the maximum y axis value
is the largest GRSq or RSq.
|
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 all the col arguments below, 0 means do not plot the corresponding graph element. You can use vectors of colors for the col arguments. |
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() .
|
col.rsq |
Vector of colors for the RSq plot.
Default is 0 , meaning no RSq plot.
|
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 ).
|
col.cum |
Vector of colors for the cumulative distribution plot.
The special value NULL (default) means borrow col.grsq
(or col.rsq if col.grsq is NULL ).
|
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 "grey" .
|
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.legend |
Default is 1 , meaning draw a legend.
Use 0 for no legend.
The legend is drawn in the cumulative distribution graph,
if that graph is plotted.
Else the legend is drawn in the model comparison chart.
|
legend.pos |
The special value NULL (default) means position the legend automatically.
Else specify c(x,y) in user coordinates.
|
legend.text |
Vector of strings to use as legend text.
The special value NULL (default) means generate the legend text automatically
from call$formula .The following settings are related to par() and are included so you can override the defaults.
|
do.par |
Call par() for global settings as appropriate.
Default is TRUE ,
which sets mfrow, mar=c(4,4,2,3), mgp=c(1.6,0.6,0), cex=0.7 .
Set to FALSE if you want to append figures to an existing plot.
|
main |
Title of each plot.
Default is NULL , meaning generate figure headings automatically.
|
... |
Extra arguments passed to plotting functions. |
This function ignores GLM and cross-validation components of the earth model, if any.
earth
,
plot.earth
,
plot.earth.models
,
plotd
,
plotmo
data(ozone1) a1 <- earth(O3 ~ ., data = ozone1, degree = 2) a2 <- earth(O3 ~ .-wind, data = ozone1, degree = 2, nk = 31) a3 <- earth(O3 ~ .-humidity, data = ozone1, degree = 2, nk = 31) plot.earth.models(list(a1,a2,a3), rlim=c(.6,.8))