plot.pvclust {pvclust} | R Documentation |
Draws Dendrogram with P-values for Pvclust Object
Description
plot dendrogram for a pvclust
object and add p
-values for
clusters.
Usage
## S3 method for class 'pvclust'
plot(x, print.pv=TRUE, print.num=TRUE, float=0.01,
col.pv=c(si=4, au=2, bp=3, edge=8), cex.pv=0.8, font.pv=NULL,
col=NULL, cex=NULL, font=NULL, lty=NULL, lwd=NULL, main=NULL,
sub=NULL, xlab=NULL, ...)
## S3 method for class 'pvclust'
text(x, col=c(au=2, bp=3, edge=8), print.num=TRUE,
float=0.01, cex=NULL, font=NULL, ...)
Arguments
x |
object of class |
print.pv |
logical flag to specify whether print |
print.num |
logical flag to specify whether print edge numbers below clusters. |
float |
numeric value to adjust the height of |
col.pv |
named numeric vector to specify the colors for
|
cex.pv |
numeric value which specifies the size of characters for
|
font.pv |
numeric value which specifies the font of characters
for |
col , cex , font |
in |
lty , lwd , main , sub , xlab , ... |
generic graphic parameters. See |
Details
This function plots a dendrogram with p
-values for given object
of class pvclust
.
SI p
-value (printed in blue color in default) is the approximately unbiased
p
-value for selective inference, and
AU p
-value (printed in red color in default) is also the approximately unbiased
p
-value but for non-selective inference. They ared calculated by multiscale bootstrap
resampling. BP value (printed in green color in default) is "bootstrap
probability" value, which is less accurate than AU value as
p
-value. One can consider that clusters (edges) with high SI or AU
values (e.g. 95%) are strongly supported by data.
SI value is newly introduced in Terada and Shimodaira (2017) for selective inference,
which is more appropriate for testing clusters identified by looking at the tree.
AU value has been used since Shimodaira (2002), which is not designed for selective inference.
AU is valid when you know the clusters before looking at the data.
See also documatation (Multiscale Bootstrap using Scaleboot Package, verison 0.4-0 or higher) in scaleboot
package.
Author(s)
Ryota Suzuki suzuki@ef-prime.com
References
Terada, Y. and Shimodaira, H. (2007) "Selective inference for the problem of regions via multiscale bootstrap", arXiv:1711.00949.
Shimodaira, H. (2004) "Approximately unbiased tests of regions using multistep-multiscale bootstrap resampling", Annals of Statistics, 32, 2616-2641.
Shimodaira, H. (2002) "An approximately unbiased test of phylogenetic tree selection", Systematic Biology, 51, 492-508.