This function generates a scatter plot or biplot of ranking metrics with an overlay describing partial order of treatment ranks.
# S3 method for netposet
plot(
x,
plottype = "scatter",
pooled = ifelse(x$random, "random", "common"),
dim = "2d",
sel.x = 1,
sel.y = 2,
sel.z = 3,
cex = 1,
col = "black",
cex.text = cex,
col.text = col,
adj.x = 0,
adj.y = 1,
offset.x = 0.005,
offset.y = -0.005,
pch = NULL,
cex.points = cex,
col.points = col,
col.lines = "black",
lty.lines = 1,
lwd.lines = 1,
arrows = FALSE,
length = 0.05,
grid = TRUE,
col.grid = "gray",
lty.grid = 2,
lwd.grid = 1,
...
)An object of class netmeta (mandatory).
A character string indicating whether a scatter
plot or biplot should be produced, either "scatter" or
"biplot". Can be abbreviated.
A character string indicating whether scatter plot
should be drawn for common ("common") or random effects
model ("random"). Can be abbreviated.
A character string indicating whether a 2- or
3-dimensional plot should be produced, either "2d" or
"3d". Can be abbreviated.
A numeric specifying number of outcome to use for the x-axis in a scatterplot (argument is not considered for a biplot).
A numeric specifying number of outcome to use for the y-axis in a scatterplot (argument is not considered for a biplot).
A numeric specifying number of outcome to use for the z-axis in a scatterplot (argument is not considered for a biplot).
The magnification to be used for treatment labels and points.
Colour(s) of treatment labels and points.
The magnification to be used for treatment labels.
Colour(s) of treatment labels.
Value(s) in [0, 1] to specify adjustment of treatment
labels on x-axis (only considered in 2-D plots); see
text.
Value(s) in [0, 1] to specify adjustment of treatment
labels on y-axis (only considered in 2-D plots); see
text.
Offset(s) of treatment labels on x-axis (only considered in 2-D plots).
Offset(s) of treatment labels on y-axis (only considered in 2-D plots).
Plot symbol(s) for points; no points printed if equal to
NULL.
Magnification(s) to be used for points.
Colour(s) of points.
Line colour.
Line type.
Line width.
A logical indicating whether arrows should be printed (only considered in 2-D plots).
Length of arrows; see arrows.
A logical indicating whether grid lines should be added to plot.
Colour of grid lines.
Line type of grid lines.
Line width of grid lines.
Additional graphical arguments.
Gerta Rücker [email protected], Guido Schwarzer [email protected]
By default (arguments plottype = "scatter" and dim =
"2d"), a scatter plot is created showing ranking metrics (see
netrank) for the first two outcomes considered in the
generation of a partially ordered set of treatment ranks (using
netposet). In addition to these rankings, the partial
order of treatment ranks is shown as lines connecting treatments
which is analogous to a Hasse diagram. If argument dim =
"3d"), a 3-D scatter plot is generated showing rankings for the
first three outcomes.
To overcome the restriction of two or three dimension, a biplot
(Gabriel, 1971) can be generated using argument plottype =
"biplot". This is essentially a scatter plot using the first two
(dim = "2d") or three (dim = "3d") components in a
principal components analysis (using
prcomp). Note, if only two / three outcomes
are considered in a netposet object, a 2-D / 3-D scatter
plot is generated instead of a biplot as a principal component
analysis is superfluous in such a situation.
Arguments sel.x and sel.y can be used to select
different outcomes to show on x- and y-axis in a 2-D scatter plot;
argument sel.z can be used accordingly in a 3-D scatter
plot. These arguments are ignored for a biplot.
Scatter plots use axes from 0 to 1 for P-scores, SUCRAs, and probabilities of being best. For mean and median ranks, axes are reversed so that favorable rankings are shown towards the top or right of the plot.
Note, in order to generate 3-D plots (argument dim = "3d"),
R package rgl is necessary. Note, under macOS the X.Org X
Window System must be available (see
https://www.xquartz.org).
Carlsen L, Bruggemann R (2014): Partial order methodology: a valuable tool in chemometrics. Journal of Chemometrics, 28, 226--34
Gabriel KR (1971): The biplot graphic display of matrices with application to principal component analysis. Biometrika, 58, 453--67
netposet, hasse,
netrank, netmeta,
Linde2015