R: Spectral Map Analysis...

mpm {mpm} | R Documentation

## Spectral Map Analysis...

### Description

Spectral Map Analysis Produces an object of class `mpm` that allows for exploratory multivariate analysis of large data matrices, such as gene expression data from microarray experiments.

### Usage

    mpm(data, logtrans=TRUE, logrepl=1e-09, center=c("double", "row", "column",
        "global", "none"), normal=c("global", "row", "column", "none"),
        closure=c("none", "row", "column", "global", "double"),
        row.weight=c("constant", "mean", "median", "max", "logmean", "RW"),
        col.weight=c("constant", "mean", "median", "max", "logmean", "CW"),
        CW=rep(1, ncol(data) - 1), RW=rep(1, nrow(data)),
        pos.row=rep(FALSE, nrow(data)), pos.column=rep(FALSE, ncol(data) -
        1))

### Arguments

`data` | a data frame with the row descriptors in the first column. For microarray data rows indicate genes and columns biological samples.
`logtrans` | an optional logical value. If `TRUE`, data are first transformed to logarithms (base e) before the other operations. Non-positive numbers are replaced by `logrepl`. If `FALSE`, data are left unchanged. Defaults to `TRUE`.
`logrepl` | an optional numeric value that replaces non-positive numbers in log-transformations. Defaults to `1e-9`.
`closure` | optional character string specifying the closure operation that is carried out on the optionally log-transformed data matrix. If `"double"`, data are divided by row- and column-totals. If `"row"` data are divided by row-totals. If `"column"` data are divided by column-totals. If `"none"` no closure is carried out. Defaults to `"none"`.
`center` | optional character string specifying the centering operation that is carried out on the optionally log-transformed, closed data matrix. If `"double"` both row- and column-means are subtracted. If `"row"` row-means are subtracted. If `"column"` column-means are subtracted. If `"none"` the data are left uncentered. Defaults to `"double"`.
`normal` | optional character string specifying the normalization operation that is carried out on the optionally log-transformed, closed, and centered data matrix. If `"global"` the data are normalized using the global standard deviation. If `"row"` data are divided by the standard deviations of the respective row. If `"column"` data are divided by their respective column standard deviation. If `"none"` no normalization is carried out. Defaults to `"global"`.
`row.weight` | optional character string specifying the weights of the different rows in the analysis. This can be `"constant"`, `"mean"`, `"median"`, `"max"`, `"logmean"`, or `"RW"`. If `"RW"` is specified, weights must be supplied in the vector `RW`. In other cases weights are computed from the data. Defaults to `"constant"`, i.e. constant weighting.
`col.weight` | optional character string specifying the weights of the different columns in the analysis. This can be `"constant"`, `"mean"`, `"median"`, `"max"`, `"logmean"`, or `"CW"`. If `"CW"` is specified, weights must be supplied in the vector `CW`. In other cases weights are computed from the data. Defaults to `"constant"`, i.e. constant weighting.
`CW` | optional numeric vector with external column weights. Defaults to 1 (constant weights).
`RW` | optional numeric vector with external row weights. Defaults to 1 (constant weights).
`pos.row` | logical vector indicating rows that are not to be included in the analysis but must be positioned on the projection obtained with the remaining rows. Defaults to `FALSE`.
`pos.column` | logical vector indicating columns that are not to be included in the analysis but must be positioned on the projection obtained with the remaining columns. Defaults to `FALSE`.

### Details

The function `mpm` presents a unified approach to exploratory multivariate analysis encompassing principal component analysis, correspondence factor analysis, and spectral map analysis. The algorithm computes projections of high dimensional data in an orthogonal space. The resulting object can subsequently be used in the construction of biplots (i.e. `plot.mpm`).

The projection of the pre-processed data matrix in the orthogonal space is calculated using the `La.svd` function.

### Value

An object of class `mpm` representing the projection of data after the different operations of transformation, closure, centering, and normalization in an orthogonal space. Generic functions `plot` and `summary` have methods to show the results of the analysis in more detail. The object consists of the following components:

`TData` | matrix with the data after optional log-transformation, closure, centering and normalization.
`row.names` | character vector with names of the row elements as supplied in the first column of the original data matrix
`col.names` | character vector with the names of columns obtained from the column names from the original data matrix
`closure` | closure operation as specified in the function call
`center` | centering operation as specified in the function call
`normal` | normalization operation as specified in the function call
`row.weight` | type of weighting used for rows as specified in the function call
`col.weight` | type of weighting used for columns as specified in the function call
`Wn` | vector with calculated weights for rows
`Wp` | vector with calculated weights for columns
`RM` | vector with row means of original data
`CM` | vector with column means of original data
`pos.row` | logical vector indicating positioned rows as specified in the function call
`pos.column` | logical vector indicating positioned columns as specified in the function call
`SVD` | list with components returned by `La.svd`
`eigen` | eigenvalues for each orthogonal factor from obtained from the weighted singular value decomposition
`contrib` | contributions of each factor to the total variance of the pre-processed data, i.e. the eigenvalues as a fraction of the total eigenvalue.
`call` | the matched call.

### Note

Principal component analysis is defined as the projection onto an orthogonal space of the column-centered and column-normalized data. In correspondence factor analysis the data are pre-processed by double closure, double centering, and global normalization. Orthogonal projection is carried out using the weighted singular value decomposition. Spectral map analysis is in essence a principal component analysis on the log-transformed, double centered and global normalized data. Weighted spectral map analysis has been proven to be successful in the detection of patterns in gene expression data (Wouters et al., 2003).

### Author(s)

Luc Wouters, Rudi Verbeeck, Tobias Verbeke

### References

Wouters, L., Goehlmann, H., Bijnens, L., Kass, S.U., Molenberghs, G., Lewi, P.J. (2003). Graphical exploration of gene expression data: a comparative study of three multivariate methods. Biometrics 59, 1131-1140.

### See Also

`plot.mpm`, `summary.mpm`

### Examples

    data(Golub)
    # Principal component analysis
    r.pca <- mpm(Golub[,1:39], center = "column", normal = "column")
    # Correspondence factor analysis
    r.cfa <- mpm(Golub[,1:39],logtrans = FALSE, row.weight = "mean",
    col.weight = "mean", closure = "double")
    # Weighted spectral map analysis
    r.sma <- mpm(Golub[,1:39], row.weight = "mean", col.weight = "mean")

[Package mpm version 1.0-22 Index]