plot.earth.models {earth} | R Documentation |
Compare ‘earth’ models by plotting them.
plot.earth.models(x = stop("no 'x' arg"), which = c(1:2), sub.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, col.grid = "grey", cum.grid = "percentages", 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.
|
sub.caption |
Overall caption.
"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) .
Special value min= -1 means the minimum y axis value
is the smallest GRSq or RSq value of the first object, excluding the intercept values.
Special value max= -1 means the maximum y axis value
is the largest GRSq or RSq value of the first object.
|
jitter |
Jitter applied to GRSq and RSq values to minimise overplotting.
Default is 0 , meaning no jitter.
A typical useful value is 0.01.
|
|
For all the col arguments, 0 means do not plot the corresponding graph element. You can use vectors of colours for the col arguments. |
col.grsq |
Vector of colours for the GRSq plot.
The default is discrete.plot.cols(length(x)) which is vector
of distinguishable colours, the first three of which are also distinguishable on
a monochrome printer.
You can examine the colours using earth:::discrete.plot.cols() .
|
col.rsq |
Vector of colours for the RSq plot.
Default is 0 , meaning no RSq plot.
|
col.npreds |
Vector of colours for the ‘number of predictors’ plot within the model 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 colours 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 each object.
The colour of the line is col.vline .
Default is "grey" .
|
lty.vline |
Line type of best model vertical line.
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. |
col.grid |
Colour of grid lines in cumulative distribution plot.
Default is "grey" .
|
cum.grid |
Specify grid on cumulative distribution graph.
Values are:"none" no grid on cumulative distribution plot"grid" add grid"percentages" (default) add grid, and percentage labels to quantile lines. |
legend.pos |
The special value NULL (default) means position the legend automatically.
Else specify c(x,y) in user coords.
|
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. |
earth
,
plot.earth
,
plot.earth.models
,
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), cum.grid="n")