Title: | Exploratory Data Analysis for 'SciViews::R' |
---|---|
Description: | Multivariate analysis and data exploration for the 'SciViews::R' dialect. |
Authors: | Philippe Grosjean [aut, cre] |
Maintainer: | Philippe Grosjean <[email protected]> |
License: | MIT + file LICENSE |
Version: | 1.0.3 |
Built: | 2024-08-29 05:08:57 UTC |
Source: | https://github.com/SciViews/exploreit |
Multivariate analysis and data exploration for 'SciViews::R'. PCA, CA, MFA, K-Means clustering, hierarchical clustering, MDS...
pca()
for Principal Component Analysis (PCA)
ca()
for Correspondence Analysis (CA)
mfa()
for Multiple Factor Analysis (MFA)
k_means()
for K-Means clustering
dissimilarity for computing dissimilarity (distance) matrices
cluster()
for Hierarchical clustering
mds()
for metric and Non-metric MultiDimensional Scaling (MDS, NMDS)
Create a Dissimilarity
matrix from an existing distance matrix as dist
object (e.g., from stats::dist()
, or vegan::vegdist()
), or from a similarly shaped matrix
object.
as.dissimilarity(x, ...) as_dissimilarity(x, ...) ## S3 method for class 'matrix' as.dissimilarity(x, ...) ## S3 method for class 'dist' as.dissimilarity(x, ...) ## S3 method for class 'Dissimilarity' as.dissimilarity(x, ...)
as.dissimilarity(x, ...) as_dissimilarity(x, ...) ## S3 method for class 'matrix' as.dissimilarity(x, ...) ## S3 method for class 'dist' as.dissimilarity(x, ...) ## S3 method for class 'Dissimilarity' as.dissimilarity(x, ...)
x |
An object to coerce into a |
... |
Further argument passed to the coercion method. |
A Dissimilarity
object.
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] # Only numeric columns from iris # Construct a dist object iris_dist <- dist(iris_num) class(iris_dist) # Convert it into a Dissimilarity object iris_dis <- as.dissimilarity(iris_dist) class(iris_dis)
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] # Only numeric columns from iris # Construct a dist object iris_dist <- dist(iris_num) class(iris_dist) # Convert it into a Dissimilarity object iris_dis <- as.dissimilarity(iris_dist) class(iris_dis)
ca()
is a reexport of the function from the {ca} package, it
offers a ca(formula, data, ...)
interface. It is supplemented here with
various chart()
types.
ca(obj, ...) ## S3 method for class 'ca' autoplot( object, choices = 1L:2L, type = c("screeplot", "altscreeplot", "biplot"), col = "black", fill = "gray", aspect.ratio = 1, repel = FALSE, ... ) ## S3 method for class 'ca' chart( data, choices = 1L:2L, ..., type = c("screeplot", "altscreeplot", "biplot"), env = parent.frame() )
ca(obj, ...) ## S3 method for class 'ca' autoplot( object, choices = 1L:2L, type = c("screeplot", "altscreeplot", "biplot"), col = "black", fill = "gray", aspect.ratio = 1, repel = FALSE, ... ) ## S3 method for class 'ca' chart( data, choices = 1L:2L, ..., type = c("screeplot", "altscreeplot", "biplot"), env = parent.frame() )
obj |
A formula or a data frame with numeric columns, or a matrix, or a
table or xtabs two-way contingency table, see |
... |
Further arguments from |
object |
A pcomp object |
choices |
Vector of two positive integers. The two axes to plot, by |
type |
The type of plot to produce: |
col |
The color for the points representing the observations, black by default. |
fill |
The color to fill bars, gray by default |
aspect.ratio |
height/width of the plot, 1 by default (for plots where the ratio height / width does matter) |
repel |
Logical. Should repel be used to rearrange points labels?
|
data |
Idem |
env |
The environment where to evaluate code, |
pca()
produces a ca object.
library(chart) data(caith, package = "MASS") caith # A two-way contingency table class(caith) # in a data frame caith_ca <- ca(caith) summary(caith_ca) chart$scree(caith_ca) chart$altscree(caith_ca) chart$biplot(caith_ca)
library(chart) data(caith, package = "MASS") caith # A two-way contingency table class(caith) # in a data frame caith_ca <- ca(caith) summary(caith_ca) chart$scree(caith_ca) chart$altscree(caith_ca) chart$biplot(caith_ca)
Add a circle in a base R plot, given its center (x and y coordinates) and its diameter. In {exploreit}, this function can be used to cut a circular dendrogram, see example.
circle(x = 0, y = 0, d = 1, col = 0, lwd = 1, lty = 1, ...)
circle(x = 0, y = 0, d = 1, col = 0, lwd = 1, lty = 1, ...)
x |
The x coordinate of the center of the circle. |
y |
The y coordinate of the center of the circle. |
d |
The diameter of the circle. |
col |
The color of the border of the circle. |
lwd |
The width of the circle border. |
lty |
The line type to use to draw the circle. |
... |
More arguments passed to |
This function returns NULL
. It is invoked for it side effect of
adding a circle in a base R plot.
plot(x = 0:2, y = 0:2) circle(x = 1, y = 1, d = 1, col = "red", lwd = 2, lty = 2)
plot(x = 0:2, y = 0:2) circle(x = 1, y = 1, d = 1, col = "red", lwd = 2, lty = 2)
Hierarchical clustering is an agglomerative method that uses a dissimilarity matrix to group individuals. It is represented by a dendrogram that can be cut at a certain level to form the final clusters.
cluster(x, ...) ## Default S3 method: cluster(x, ...) ## S3 method for class 'dist' cluster(x, method = "complete", fun = NULL, ...) ## S3 method for class 'Cluster' str(object, max.level = NA, digits.d = 3L, ...) ## S3 method for class 'Cluster' labels(object, ...) ## S3 method for class 'Cluster' nobs(object, ...) ## S3 method for class 'Cluster' predict(object, k = NULL, h = NULL, ...) ## S3 method for class 'Cluster' augment(x, data, k = NULL, h = NULL, ...) ## S3 method for class 'Cluster' plot( x, y, labels = TRUE, hang = -1, check = TRUE, type = "vertical", lab = "Height", ... ) ## S3 method for class 'Cluster' autoplot( object, labels = TRUE, type = "vertical", circ.text.size = 3, theme = theme_sciviews(), xlab = "", ylab = "Height", ... ) ## S3 method for class 'Cluster' chart(data, ..., type = NULL, env = parent.frame())
cluster(x, ...) ## Default S3 method: cluster(x, ...) ## S3 method for class 'dist' cluster(x, method = "complete", fun = NULL, ...) ## S3 method for class 'Cluster' str(object, max.level = NA, digits.d = 3L, ...) ## S3 method for class 'Cluster' labels(object, ...) ## S3 method for class 'Cluster' nobs(object, ...) ## S3 method for class 'Cluster' predict(object, k = NULL, h = NULL, ...) ## S3 method for class 'Cluster' augment(x, data, k = NULL, h = NULL, ...) ## S3 method for class 'Cluster' plot( x, y, labels = TRUE, hang = -1, check = TRUE, type = "vertical", lab = "Height", ... ) ## S3 method for class 'Cluster' autoplot( object, labels = TRUE, type = "vertical", circ.text.size = 3, theme = theme_sciviews(), xlab = "", ylab = "Height", ... ) ## S3 method for class 'Cluster' chart(data, ..., type = NULL, env = parent.frame())
x |
A |
... |
Further arguments for the methods (see their respective manpages). |
method |
The agglomeration method used. |
fun |
The function to use to do the calculation. By default, it is
|
object |
A |
max.level |
The maximum level to present. |
digits.d |
The number of digits to print. |
k |
The number of clusters to get. |
h |
The height where the dendrogram should be cut (give either |
data |
The original dataset |
y |
Do not use it. |
labels |
Should we show the labels ( |
hang |
The fraction of the plot height at which labels should hang below (by default, -1 meaning labels are all placed at the extreme of the plot). |
check |
The validity of the |
type |
The type of dendrogram, by default, |
lab |
The label of the y axis (vertical) or x axis (horizontal), by
default |
circ.text.size |
Size of the text for a circular dendrogram |
theme |
The ggplot2 theme to use, by default, it is |
xlab |
Label of the x axis (nothing by default) |
ylab |
Label of the y axis, by default |
env |
The environment where to evaluate formulas. If you don't understand this, it means you should not touch it! |
A Cluster
object inheriting from hclust
. Specific methods are: str()
(compact display of the object content), labels()
(get the labels for the observations), nobs()
(number of observations), predict()
(get the clusters, given a cutting level), augment()
(add the groups to the original data frame or tibble), plot()
(create a dendrogram as base R plot), autoplot()
(create a dendrogram as a ggplot2), and chart()
(create a dendrogram as a chart variant of a ggplot2).
dissimilarity()
, stats::hclust()
, fastcluster::hclust()
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] # Only numeric columns from iris # Cluster the 150 flowers iris_dis <- dissimilarity(iris_num, method = "euclidean", scale = TRUE) (iris_clust <- cluster(iris_dis, method = "complete")) str(iris_clust) # More useful str(iris_clust, max.level = 3L) # Only the top of the dendrogram # Dendrogram with base R graphics plot(iris_clust) plot(iris_clust, labels = FALSE, hang = 0.1) abline(h = 3.5, col = "red") # Horizontal dendrogram plot(iris_clust, type = "horizontal", labels = FALSE) abline(v = 3.5, col = "red") # Circular dendrogram plot(iris_clust, type = "circular", labels = FALSE) circle(d = 3.5, col = "red") # Chart version of the dendrogram chart(iris_clust) + geom_dendroline(h = 3.5, color = "red") # Horizontal dendrogram and without labels chart$horizontal(iris_clust, labels = FALSE) + geom_dendroline(h = 3.5, color = "red") # Circular dendrogram with labels chart$circ(iris_clust, circ.text.size = 3) + # Abbreviate type and change size geom_dendroline(h = 3.5, color = "red") # Get the clusters predict(iris_clust, h = 3.5) # Four clusters predict(iris_clust, k = 4) # Add the clusters to the data (.fitted column added) augment(data = iris, iris_clust, k = 4)
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] # Only numeric columns from iris # Cluster the 150 flowers iris_dis <- dissimilarity(iris_num, method = "euclidean", scale = TRUE) (iris_clust <- cluster(iris_dis, method = "complete")) str(iris_clust) # More useful str(iris_clust, max.level = 3L) # Only the top of the dendrogram # Dendrogram with base R graphics plot(iris_clust) plot(iris_clust, labels = FALSE, hang = 0.1) abline(h = 3.5, col = "red") # Horizontal dendrogram plot(iris_clust, type = "horizontal", labels = FALSE) abline(v = 3.5, col = "red") # Circular dendrogram plot(iris_clust, type = "circular", labels = FALSE) circle(d = 3.5, col = "red") # Chart version of the dendrogram chart(iris_clust) + geom_dendroline(h = 3.5, color = "red") # Horizontal dendrogram and without labels chart$horizontal(iris_clust, labels = FALSE) + geom_dendroline(h = 3.5, color = "red") # Circular dendrogram with labels chart$circ(iris_clust, circ.text.size = 3) + # Abbreviate type and change size geom_dendroline(h = 3.5, color = "red") # Get the clusters predict(iris_clust, h = 3.5) # Four clusters predict(iris_clust, k = 4) # Add the clusters to the data (.fitted column added) augment(data = iris, iris_clust, k = 4)
Compute a distance matrix from all pairs of columns or rows in a data frame, using a unified SciViews::R formula interface.
dissimilarity( data, formula = ~., subset = NULL, method = "euclidean", scale = FALSE, rownames.col = getOption("SciViews.dtx.rownames", default = ".rownames"), transpose = FALSE, fun = NULL, ... ) ## S3 method for class 'Dissimilarity' print(x, digits.d = 3L, rownames.lab = "labels", ...) ## S3 method for class 'Dissimilarity' labels(object, ...) ## S3 method for class 'Dissimilarity' nobs(object, ...) ## S3 method for class 'Dissimilarity' autoplot( object, order = TRUE, show.labels = TRUE, lab.size = NULL, gradient = list(low = "blue", mid = "white", high = "red"), ... ) ## S3 method for class 'Dissimilarity' chart( data, order = TRUE, show.labels = TRUE, lab.size = NULL, gradient = list(low = "blue", mid = "white", high = "red"), ..., type = NULL, env = parent.frame() )
dissimilarity( data, formula = ~., subset = NULL, method = "euclidean", scale = FALSE, rownames.col = getOption("SciViews.dtx.rownames", default = ".rownames"), transpose = FALSE, fun = NULL, ... ) ## S3 method for class 'Dissimilarity' print(x, digits.d = 3L, rownames.lab = "labels", ...) ## S3 method for class 'Dissimilarity' labels(object, ...) ## S3 method for class 'Dissimilarity' nobs(object, ...) ## S3 method for class 'Dissimilarity' autoplot( object, order = TRUE, show.labels = TRUE, lab.size = NULL, gradient = list(low = "blue", mid = "white", high = "red"), ... ) ## S3 method for class 'Dissimilarity' chart( data, order = TRUE, show.labels = TRUE, lab.size = NULL, gradient = list(low = "blue", mid = "white", high = "red"), ..., type = NULL, env = parent.frame() )
data |
A data.frame, tibble or matrix. |
formula |
A right-side only formula ( |
subset |
An expression indicating which rows to keep from data. |
method |
The distance (dissimilarity) method to use. By default, it is |
scale |
Do we scale (mean = 0, standard deviation = 1) the data before calculating the distance ( |
rownames.col |
In case the |
transpose |
Do we transpose |
fun |
A function that does the calculation and return a |
... |
Further parameters passed to the |
x , object
|
A |
digits.d |
Number of digits to print, by default, 3. |
rownames.lab |
The name of the column containing the labels, by default |
order |
Do we reorder the lines and columns according to their resemblance ( |
show.labels |
Are the labels displayed on the axes ( |
lab.size |
Force the size of the labels ( |
gradient |
The palette of color to use in the plot. |
type |
The type of plot. For the moment, only one plot is possible and the default value ( |
env |
The environment where to evaluate the formula. If you don't understand this, you probably don't have to touch this arguments. |
An S3 object of class c("Dissimilarity", "dist")
, thus inheriting from dist
. A Dissimilarity
object is better displayed (specific print()
method), and has also dedicated methods labels()
(get line and column labels), nobs()
(get number of observations, that is, number of lines or columns), autoplot()
(generate a ggplot2 from the matrix) and chart()
(generate a chart version of the ggplot2).
stats::dist()
, vegan::vegdist()
, vegan::designdist()
, cluster::daisy()
, factoextra::get_dist()
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] # Only numeric columns from iris # Compare the 150 flowers and nicely print the result dissimilarity(iris_num, method = "manhattan") # Compare the measurements by transposing and scaling them first iris_dist <- dissimilarity(iris_num, method = "euclidean", scale = TRUE, transpose = TRUE) iris_dist class(iris_dist) labels(iris_dist) nobs(iris_dist) # specific plots autoplot(iris_dist) chart(iris_dist, gradient = list(low = "green", mid = "white", high = "red"))
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] # Only numeric columns from iris # Compare the 150 flowers and nicely print the result dissimilarity(iris_num, method = "manhattan") # Compare the measurements by transposing and scaling them first iris_dist <- dissimilarity(iris_num, method = "euclidean", scale = TRUE, transpose = TRUE) iris_dist class(iris_dist) labels(iris_dist) nobs(iris_dist) # specific plots autoplot(iris_dist) chart(iris_dist, gradient = list(low = "green", mid = "white", high = "red"))
Add a line (horizontal, vertical, or circular, depending on the
dendrogram type) at height h
to depict where it is cut into groups.
geom_dendroline(h, ...)
geom_dendroline(h, ...)
h |
The height to cut the dendrogram. |
... |
Further arguments passed to |
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] iris_num %>.% dissimilarity(.) %>.% cluster(.) -> iris_cluster chart(iris_cluster) + geom_dendroline(h = 3, color = "red")
SciViews::R iris <- read("iris", package = "datasets") iris_num <- iris[, -5] iris_num %>.% dissimilarity(.) %>.% cluster(.) -> iris_cluster chart(iris_cluster) + geom_dendroline(h = 3, color = "red")
Perform a k-means clustering analysis using the
stats::kmeans()
function in {stats} but creating a k_means object
that possibly embeds the original data with the analysis for a richer set
of methods.
k_means( x, k, centers = k, iter.max = 10L, nstart = 1L, algorithm = c("Hartigan-Wong", "Lloyd", "Forgy", "MacQueen"), trace = FALSE, keep.data = TRUE ) profile_k(x, fun = kmeans, method = "wss", k.max = NULL, ...) ## S3 method for class 'kmeans' augment(x, data, ...) ## S3 method for class 'k_means' predict(object, ...) ## S3 method for class 'k_means' plot( x, y, data = x$data, choices = 1L:2L, col = NULL, c.shape = 8, c.size = 3, ... ) ## S3 method for class 'k_means' autoplot( object, data = object$data, choices = 1L:2L, alpha = 1, c.shape = 8, c.size = 3, theme = NULL, use.chart = FALSE, ... ) ## S3 method for class 'k_means' chart(data, ..., type = NULL, env = parent.frame())
k_means( x, k, centers = k, iter.max = 10L, nstart = 1L, algorithm = c("Hartigan-Wong", "Lloyd", "Forgy", "MacQueen"), trace = FALSE, keep.data = TRUE ) profile_k(x, fun = kmeans, method = "wss", k.max = NULL, ...) ## S3 method for class 'kmeans' augment(x, data, ...) ## S3 method for class 'k_means' predict(object, ...) ## S3 method for class 'k_means' plot( x, y, data = x$data, choices = 1L:2L, col = NULL, c.shape = 8, c.size = 3, ... ) ## S3 method for class 'k_means' autoplot( object, data = object$data, choices = 1L:2L, alpha = 1, c.shape = 8, c.size = 3, theme = NULL, use.chart = FALSE, ... ) ## S3 method for class 'k_means' chart(data, ..., type = NULL, env = parent.frame())
x |
A data frame or a matrix with numeric data |
k |
The number of clusters to create, or a set of initial cluster centers. If a number, a random set of initial centers are computed first. |
centers |
Idem ( |
iter.max |
Maximum number of iterations (10 by default) |
nstart |
If |
algorithm |
The algorithm to use. May be abbreviated. See
|
trace |
Logical or integer. Should process be traced. Higher value produces more tracing information. |
keep.data |
Do we keep the data in the object? If |
fun |
The kmeans clustering function to use, |
method |
The method used in |
k.max |
Maximum number of clusters to consider (at least two). If not provided, a reasonable default is calculated. |
... |
Other arguments transmitted to |
data |
The original data frame |
object |
The k_means* object |
y |
Not used |
choices |
The axes (variables) to plot (first and second by default) |
col |
Color to use |
c.shape |
The shape to represent cluster centers |
c.size |
The size of the shape representing cluster centers |
alpha |
Semi-transparency to apply to points |
theme |
The ggplot theme to apply to the plot |
use.chart |
|
type |
Not used here |
env |
Not used here |
k_means()
creates an object of classes k_means and kmeans.
profile_k()
is used for its side-effect of creating a plot that should
help to chose the best value for k
.
data(iris, package = "datasets") iris_num <- iris[, -5] # Only numerical variables library(chart) # Profile k is to be taken only asx a (useful) indication! profile_k(iris_num) # 2, maybe 3 clusters iris_k2 <- k_means(iris_num, k = 2) chart(iris_k2) iris_k3 <- k_means(iris_num, k = 3, nstart = 20L) # Several random starts chart(iris_k3) # Get clusters and compare with Species iris3 <- augment(iris_k3, iris) # Use predict() to just get clusters head(iris3) table(iris3$.cluster, iris3$Species) # setosa OK, the other are mixed a bit
data(iris, package = "datasets") iris_num <- iris[, -5] # Only numerical variables library(chart) # Profile k is to be taken only asx a (useful) indication! profile_k(iris_num) # 2, maybe 3 clusters iris_k2 <- k_means(iris_num, k = 2) chart(iris_k2) iris_k3 <- k_means(iris_num, k = 3, nstart = 20L) # Several random starts chart(iris_k3) # Get clusters and compare with Species iris3 <- augment(iris_k3, iris) # Use predict() to just get clusters head(iris3) table(iris3$.cluster, iris3$Species) # setosa OK, the other are mixed a bit
Perform a PCoA ('type = "metric"). or other forms of MDS.
mds( dist, k = 2, type = c("metric", "nonmetric", "cmdscale", "wcmdscale", "sammon", "isoMDS", "monoMDS", "metaMDS"), p = 2, ... ) ## S3 method for class 'mds' plot(x, y, ...) ## S3 method for class 'mds' autoplot(object, labels, col, ...) ## S3 method for class 'mds' chart(data, labels, col, ..., type = NULL, env = parent.frame()) shepard(dist, mds, p = 2) ## S3 method for class 'shepard' plot( x, y, l.col = "red", l.lwd = 1, xlab = "Observed Dissimilarity", ylab = "Ordination Distance", ... ) ## S3 method for class 'shepard' autoplot( object, alpha = 0.5, l.col = "red", l.lwd = 1, xlab = "Observed Dissimilarity", ylab = "Ordination Distance", ... ) ## S3 method for class 'shepard' chart( data, alpha = 0.5, l.col = "red", l.lwd = 1, xlab = "Observed Dissimilarity", ylab = "Ordination Distance", ..., type = NULL, env = parent.frame() ) ## S3 method for class 'mds' augment(x, data, ...) ## S3 method for class 'mds' glance(x, ...)
mds( dist, k = 2, type = c("metric", "nonmetric", "cmdscale", "wcmdscale", "sammon", "isoMDS", "monoMDS", "metaMDS"), p = 2, ... ) ## S3 method for class 'mds' plot(x, y, ...) ## S3 method for class 'mds' autoplot(object, labels, col, ...) ## S3 method for class 'mds' chart(data, labels, col, ..., type = NULL, env = parent.frame()) shepard(dist, mds, p = 2) ## S3 method for class 'shepard' plot( x, y, l.col = "red", l.lwd = 1, xlab = "Observed Dissimilarity", ylab = "Ordination Distance", ... ) ## S3 method for class 'shepard' autoplot( object, alpha = 0.5, l.col = "red", l.lwd = 1, xlab = "Observed Dissimilarity", ylab = "Ordination Distance", ... ) ## S3 method for class 'shepard' chart( data, alpha = 0.5, l.col = "red", l.lwd = 1, xlab = "Observed Dissimilarity", ylab = "Ordination Distance", ..., type = NULL, env = parent.frame() ) ## S3 method for class 'mds' augment(x, data, ...) ## S3 method for class 'mds' glance(x, ...)
dist |
A dist object from |
k |
The dimensions of the space for the representation, usually |
type |
Not used |
p |
For types |
... |
More arguments (see respective |
x |
Idem |
y |
Not used |
object |
An mds object |
labels |
Points labels on the plot (optional) |
col |
Points color (optional) |
data |
A data frame to augment with columns from the MDS analysis |
env |
Not used |
mds |
Idem |
l.col |
Color of the line in the Shepard's plot (red by default) |
l.lwd |
Width of the line in the Shepard"s plot (1 by default) |
xlab |
Label for the X axis (a default value exists) |
ylab |
Idem for the Y axis |
alpha |
Alpha transparency for points (0.5 by default, meaning 50% transparency) |
A mds object, which is a list containing all components from the
corresponding function, plus possibly Shepard
if the Shepard plot is
precalculated.
library(chart) data(iris, package = "datasets") iris_num <- iris[, -5] # Only numeric columns iris_dis <- dissimilarity(iris_num, method = "euclidean") # Metric MDS iris_mds <- mds$metric(iris_dis) chart(iris_mds, labels = 1:nrow(iris), col = iris$Species) # Non-metric MDS iris_nmds <- mds$nonmetric(iris_dis) chart(iris_nmds, labels = 1:nrow(iris), col = iris$Species) glance(iris_nmds) # Good R^2 iris_sh <- shepard(iris_dis, iris_nmds) chart(iris_sh) # Excellent matching + linear -> metric MDS is OK here
library(chart) data(iris, package = "datasets") iris_num <- iris[, -5] # Only numeric columns iris_dis <- dissimilarity(iris_num, method = "euclidean") # Metric MDS iris_mds <- mds$metric(iris_dis) chart(iris_mds, labels = 1:nrow(iris), col = iris$Species) # Non-metric MDS iris_nmds <- mds$nonmetric(iris_dis) chart(iris_nmds, labels = 1:nrow(iris), col = iris$Species) glance(iris_nmds) # Good R^2 iris_sh <- shepard(iris_dis, iris_nmds) chart(iris_sh) # Excellent matching + linear -> metric MDS is OK here
Analyze several groups of variables at once with supplementary
groups of variables or individuals. Each group can be numeric, factor or
contingency tables. Missing values are replaced by the column mean and
missing values for factors are treated as an additional level. This is a
formula interface to the FactoMineR::MFA()
function.
mfa(data, formula, nd = 5, suprow = NA, ..., graph = FALSE) ## S3 method for class 'MFA' autoplot( object, type = c("screeplot", "altscreeplot", "loadings", "scores", "groups", "axes", "contingency", "ellipses"), choices = 1L:2L, name = deparse(substitute(object)), col = "black", fill = "gray", title, ..., env ) ## S3 method for class 'MFA' chart( data, choices = 1L:2L, name = deparse(substitute(data)), ..., type = NULL, env = parent.frame() )
mfa(data, formula, nd = 5, suprow = NA, ..., graph = FALSE) ## S3 method for class 'MFA' autoplot( object, type = c("screeplot", "altscreeplot", "loadings", "scores", "groups", "axes", "contingency", "ellipses"), choices = 1L:2L, name = deparse(substitute(object)), col = "black", fill = "gray", title, ..., env ) ## S3 method for class 'MFA' chart( data, choices = 1L:2L, name = deparse(substitute(data)), ..., type = NULL, env = parent.frame() )
data |
A data frame |
formula |
A formula that specifies the variables groups to consider (see details) |
nd |
Number of dimensions kept in the results (by default, 5) |
suprow |
A vector indicating the row indices for the supplemental individuals |
... |
Additional arguments to |
graph |
If |
object |
An MFA object |
type |
The type of plot to produce: |
choices |
Vector of two positive integers. The two axes to plot, by default first and second axes. |
name |
The name of the object (automatically defined by default) |
col |
The color for the points representing the observations, black by default. |
fill |
The color to fill bars, gray by default |
title |
The title of the plot (optional, a reasonable default is used) |
env |
The environment where to evaluate code, |
The formula presents how the different columns of the data frame are grouped
and indicates the kind of sub-table they are and the name we give to them in
the analysis. So, a component of the formula for one group is
n * kind %as% name
where n
is the number of columns belonging to this
group, starting at column 1 for first group, kind
is std
for numeric
variables to be standardized and used as a PCA, num
for numerical variables
to use as they are also as a PCA, cnt
for counts in a contingency table to
be treated as a CA and fct
for classical factors (categorical variables).
Finally, name
is a (short) name you use to identify this group. The kind
may be omitted and it will be std
by default. If %as% name
is omitted, a
generic name (group1, group2, group3, ...) is used. The complete formula is
the addition of the different groups to include in the analysis and the
subtraction of the supplementary groups not included in the analysis, like
~n1*std %as% gr1 - n2*fct %as% gr2 + n3*num %as% gr3
, with groups "gr1" and
"gr3" included in the analysis and group "gr2" as supplemental. The total
n1 + n2 + n3
must equal the number of columns in the data frame.
An MFA object
The symbols for the groups are different in mfa()
and FactoMineR::MFA()
).
To avoid further confusion, the symbols use three letters here:
std
is the same as s
in MFA()
: "standardized" and is the default
num
stands here for "numeric", thus continuous variables c
in MFA()
cnt
stands for "contingency" table and matches f
in MFA()
fct
stands for "factor", thus qualitative variables n
in MFA()
# Same example as in {FactoMineR} library(chart) data(wine, package = "FactoMineR") wine_mfa <- mfa(data = wine, ~ -2*fct %as% orig +5 %as% olf + 3 %as% vis + 10 %as% olfag + 9 %as% gust - 2 %as% ens) wine_mfa summary(wine_mfa) chart$scree(wine_mfa) chart$altscree(wine_mfa) chart$loadings(wine_mfa) chart$scores(wine_mfa) chart$groups(wine_mfa) chart$axes(wine_mfa) # No contingency group! chart$contingency(wine_mfa) chart$ellipses(wine_mfa)
# Same example as in {FactoMineR} library(chart) data(wine, package = "FactoMineR") wine_mfa <- mfa(data = wine, ~ -2*fct %as% orig +5 %as% olf + 3 %as% vis + 10 %as% olfag + 9 %as% gust - 2 %as% ens) wine_mfa summary(wine_mfa) chart$scree(wine_mfa) chart$altscree(wine_mfa) chart$loadings(wine_mfa) chart$scores(wine_mfa) chart$groups(wine_mfa) chart$axes(wine_mfa) # No contingency group! chart$contingency(wine_mfa) chart$ellipses(wine_mfa)
Principal Component Analysis (PCA)
pca(x, ...) ## S3 method for class 'pcomp' autoplot( object, type = c("screeplot", "altscreeplot", "loadings", "correlations", "scores", "biplot"), choices = 1L:2L, name = deparse(substitute(object)), ar.length = 0.1, circle.col = "gray", col = "black", fill = "gray", scale = 1, aspect.ratio = 1, repel = FALSE, labels, title, xlab, ylab, ... ) ## S3 method for class 'pcomp' chart( data, choices = 1L:2L, name = deparse(substitute(data)), ..., type = NULL, env = parent.frame() ) ## S3 method for class 'princomp' augment(x, data = NULL, newdata, ...) ## S3 method for class 'princomp' tidy(x, matrix = "u", ...) as.prcomp(x, ...) ## Default S3 method: as.prcomp(x, ...) ## S3 method for class 'prcomp' as.prcomp(x, ...) ## S3 method for class 'princomp' as.prcomp(x, ...)
pca(x, ...) ## S3 method for class 'pcomp' autoplot( object, type = c("screeplot", "altscreeplot", "loadings", "correlations", "scores", "biplot"), choices = 1L:2L, name = deparse(substitute(object)), ar.length = 0.1, circle.col = "gray", col = "black", fill = "gray", scale = 1, aspect.ratio = 1, repel = FALSE, labels, title, xlab, ylab, ... ) ## S3 method for class 'pcomp' chart( data, choices = 1L:2L, name = deparse(substitute(data)), ..., type = NULL, env = parent.frame() ) ## S3 method for class 'princomp' augment(x, data = NULL, newdata, ...) ## S3 method for class 'princomp' tidy(x, matrix = "u", ...) as.prcomp(x, ...) ## Default S3 method: as.prcomp(x, ...) ## S3 method for class 'prcomp' as.prcomp(x, ...) ## S3 method for class 'princomp' as.prcomp(x, ...)
x |
A formula or a data frame with numeric columns, for |
... |
For |
object |
A pcomp object |
type |
The type of plot to produce: |
choices |
Vector of two positive integers. The two axes to plot, by default first and second axes. |
name |
The name of the object (automatically defined by default) |
ar.length |
The length of the arrow head on the plot, 0.1 by default |
circle.col |
The color of the circle on the plot, gray by default |
col |
The color for the points representing the observations, black by default. |
fill |
The color to fill bars, gray by default |
scale |
The scale to apply for annotations, 1 by default |
aspect.ratio |
height/width of the plot, 1 by default (for plots where the ratio height / width does matter) |
repel |
Logical. Should repel be used to rearrange points labels?
|
labels |
The label of the points (optional) |
title |
The title of the plot (optional, a reasonable default is used) |
xlab |
The label for the X axis. Automatically defined if not provided |
ylab |
Idem for the Y axis |
data |
The original data frame used for the PCA |
env |
The environment where to evaluate code, |
newdata |
A data frame with similar structure to |
matrix |
Indicate which component should be be tidied. See
|
pca()
produces a pcomp object.
library(chart) library(ggplot2) data(iris, package = "datasets") iris_num <- iris[, -5] # Only numeric columns iris_pca <- pca(data = iris_num, ~ .) summary(iris_pca) chart$scree(iris_pca) # OK to keep 2 components chart$altscree(iris_pca) # Different presentation chart$loadings(iris_pca, choices = c(1L, 2L)) chart$scores(iris_pca, choices = c(1L, 2L), aspect.ratio = 3/5) # or better: chart$scores(iris_pca, choices = c(1L, 2L), labels = iris$Species, aspect.ratio = 3/5) + stat_ellipse() # biplot chart$biplot(iris_pca)
library(chart) library(ggplot2) data(iris, package = "datasets") iris_num <- iris[, -5] # Only numeric columns iris_pca <- pca(data = iris_num, ~ .) summary(iris_pca) chart$scree(iris_pca) # OK to keep 2 components chart$altscree(iris_pca) # Different presentation chart$loadings(iris_pca, choices = c(1L, 2L)) chart$scores(iris_pca, choices = c(1L, 2L), aspect.ratio = 3/5) # or better: chart$scores(iris_pca, choices = c(1L, 2L), labels = iris$Species, aspect.ratio = 3/5) + stat_ellipse() # biplot chart$biplot(iris_pca)
Center or scale all variables in a data frame. This takes a data frame and return an object of the same class.
## S3 method for class 'data.frame' scale(x, center = TRUE, scale = TRUE) ## S3 method for class 'tbl_df' scale(x, center = TRUE, scale = TRUE) ## S3 method for class 'data.table' scale(x, center = TRUE, scale = TRUE)
## S3 method for class 'data.frame' scale(x, center = TRUE, scale = TRUE) ## S3 method for class 'tbl_df' scale(x, center = TRUE, scale = TRUE) ## S3 method for class 'data.table' scale(x, center = TRUE, scale = TRUE)
x |
A data frame |
center |
Are the columns centered (mean = 0)? |
scale |
Are the column scaled (standard deviation = 1)? |
An object of the same class as x
.
data(trees, package = "datasets") colMeans(trees) trees2 <- scale(trees) head(trees2) class(trees2) colMeans(trees2)
data(trees, package = "datasets") colMeans(trees) trees2 <- scale(trees) head(trees2) class(trees2) colMeans(trees2)