Plots the trajectories of minimum Mahalanobis distances from different starting points
mmdrsplot(out, quant = c(0.01, 0.5, 0.99), envm, lwd, lwdenv, xlim, ylim,
tag, datatooltip, label, xlab, ylab, envlab = TRUE, main, nameX,
cex.lab, cex.axis, databrush, scaled = FALSE, trace = FALSE, ...)
An object of S3 class fsmmmdrs.object
returned by
fsmmmdrs
-
a list containing the following elements:
mmdrs
= a matrix of size (n-ninit)-by-(nsimul+1) containing the monitoring
of minimum Mahalanobis distance in each step of the forward search for each
of the nsimul random starts. The first column of mmdrs must contain the forward search index.
This matrix can be created using function fsmmmdrs
.
BBrs
= 3D array of size n-by-n-(init)-by-nsimul containing
units forming subset for rach random start. This field is necessary
if datatooltip is true or databrush is not empty.
X
= n-by-v matrix containing the original data matrix. This
field is necessary if datatooltip is true or databrush is not empty.
Quantiles for which envelopes have to be computed.
The default is to produce 1%, 50% and 99% envelopes. In other
words the default is quant=c(0.01, 0.5, 0.99)
.
Sample size for drawing enevlopes. Specifies the size of the sample which is
used to superimpose the envelope. The default is to add an envelope based on
all the observations (size n
envelope).
Controls the linewidth of the curve which contains the monitoring of minimum deletion residual.
line width: a scalar which controls the width of the lines associated
with the envelopes. Default is lwdenv=1
Control the x scale in plot. Vector with two elements controlling minimum and maximum on the x axis. Default is to use automatic scale.
Control the y scale in plot. Vector with two elements controlling minimum and maximum on the y axis. Default is to use automatic scale.
Plot handle. String which identifies the handle of the plot which is about to be created.
The default is tag='pl_mmd'
. Notice that if the program finds a plot which has
a tag equal to the one specified by the user, then the output of the new plot overwrites
the existing one in the same window else a new window is created.
If datatooltip is not empty the user can use the mouse in order to have
information about the unit selected, the step in which the unit enters the search and
the associated label. If datatooltip is a list, it is possible to control the aspect
of the data cursor (see MATLAB function datacursormode()
for more details or
see the examples below). The default options are DisplayStyle="Window"
and SnapToDataVertex="on"
.
Row labels. Character vector containing the labels of the units (optional argument used
when datatooltip=TRUE
. If this field is not present labels
row1, ..., rown will be automatically created and included in the pop up datatooltip window).
A title for the x axis
A title for the y axis
wheather to label the envelopes. If envlab
is true (default)
labels of the confidence envelopes which are used are added on the y axis.
An overall title for the plot
Add variable labels in the plot. A vector of strings of length p
containing the labels of the variables of the original data matrix X
.
If it is empty (default) the sequence X1, ..., Xp
will be created automatically
The magnification to be used for x and y labels relative to the current setting of cex
The magnification to be used for axis annotation relative to the current setting of cex
Interactive mouse brushing. If databrush is missing or empty (default), no brushing is done. The activation of this option (databrush is TRUE or a list) enables the user to select a set of trajectories in the current plot and to see them highlighted in the scatterplot matrix. If the scatterplot matrix does not exist it is automatically created. In addition, brushed units can be highlighted in the monitoring MD plot. Note that the window style of the other figures is set equal to that which contains the monitoring residual plot. In other words, if the monitoring residual plot is docked all the other figures will be docked too.
If databrush=TRUE
the default selection tool is a rectangular brush and it is
possible to brush only once (that is persist='').
Note that the window style of the other figures is set equal to that which contains the monitoring residual plot. In other words, if the monitoring residual plot is docked all the other figures will be docked too
If databrush=TRUE
the default selection tool is a rectangular brush and
it is possible to brush only once (that is persist='').
If databrush=list(...)
, it is possible to use all optional arguments of
the MATLAB function selectdataFS()
and the following optional arguments:
persist. Persist is an empty value or a character containing 'on' or 'off'.
The default value is persist=""
, that is brushing is allowed only once.
If persist="on"
or persis="off"
brushing can be done as many time as
the user requires. If persist='on'
then the unit(s) currently brushed are
added to those previously brushed. It is possible, every time a new brushing is
done, to use a different color for the brushed units. If persist='off'
every time a new brush is performed units previously brushed are removed.
Wheather to use scaled or unscaled envelopes. If scaled=TRUE
the envelopes are produced for scaled Mahalanobis distances (no consistency factor
is applied) else the traditional consistency factor is applied.
Default is scaled=FALSE
Whether to print intermediate results. Default is trace=FALSE
.
potential further arguments passed to lower level functions.
none
Atkinson, A.C., Riani, M. and Cerioli, A. (2004), 'Exploring multivariate data with the forward search, Springer Verlag, New York.
# NOT RUN {
# }
# NOT RUN {
data(hbk)
out <- fsmmmdrs(hbk[,1:3])
mmdrsplot(out)
# }
Run the code above in your browser using DataLab