#' @title Matrix T
#'
#' @description Function to obtain a matrix containing trait averages at community level.
#' For more details, see \code{\link{syncsa}}.
#'
#' @encoding UTF-8
#' @param comm Community data, with species as columns and sampling units as
#' rows. This matrix can contain either presence/absence or abundance data.
#' @param traits Matrix or data frame of species described by traits, with traits as
#' columns and species as rows.
#' @param scale Logical argument (TRUE or FALSE) to specify if the traits are
#' measured on different scales (Default scale = TRUE). When scale = TRUE traits
#' are measured on different scales and the matrix T is subjected to
#' standardization within each trait. When scale = FALSE traits are measured on
#' the same scale the matrix T is not subjected to standardization.
#' @param ranks Logical argument (TRUE or FALSE) to specify if ordinal variables are
#' convert to ranks (Default ranks = TRUE).
#' @param transformation Method to community data transformation, "none", "standardized" or "weights" (Default transformation = "standardized").
#' @param spp.weights Vector with 0 or 1 to specify individual species weights (Default spp.weights = NULL).
#' @param notification Logical argument (TRUE or FALSE) to specify if
#' notifications of missing observations are shown (Default notification =
#' TRUE).
#' @return \item{matriz.w}{Standardized community matrix, where rows are
#' communities and columns species. If default transformation, row totals (communities) = 1.}
#' \item{matriz.b}{Matrix of traits, exactly the same data input.}
#' \item{matriz.T}{Matrix containing trait averages at community level. If
#' Scale = TRUE the matrix T is standardized within the traits.}
#' @note \strong{IMPORTANT}: The sequence species show up in community data
#' matrix MUST be the same as they show up in traits matrix or in the spp.weights vector. See
#' \code{\link{organize.syncsa}}.
#' @author Vanderlei Julio Debastiani <vanderleidebastiani@@yahoo.com.br>
#' @seealso \code{\link{syncsa}}, \code{\link{organize.syncsa}},
#' \code{\link{matrix.p}}, \code{\link{matrix.x}}
#' @references Pillar, V.D.; Duarte, L.d.S. (2010). A framework for
#' metacommunity analysis of phylogenetic structure. Ecology Letters, 13,
#' 587-596.
#'
#' Pillar, V.D., Duarte, L.d.S., Sosinski, E.E. & Joner, F. (2009).
#' Discriminating trait-convergence and trait-divergence assembly patterns in
#' ecological community gradients. Journal of Vegetation Science, 20, 334:348.
#' @keywords SYNCSA
#' @examples
#' data(ADRS)
#' matrix.t(ADRS$community, ADRS$traits)
#' @export
matrix.t <- function (comm, traits, scale = TRUE, ranks = TRUE, transformation = "standardized",
spp.weights = NULL, notification = TRUE)
{
vartype <- var.type(traits)
if(any(vartype == "n")){
stop("\n trait must contain only numeric, binary or ordinal variables \n")
}
for(i in 1:length(vartype)){
if(ranks & vartype[i] == "o"){
traits[, i] <- rank(traits[, i], na.last = "keep")
}
traits[, i] <- as.numeric(traits[, i])
}
traits <- as.matrix(traits)
TRANS <- c("none", "standardized", "weights", "beals")
trans <- pmatch(transformation, TRANS)
if (length(trans) > 1) {
stop("\n Only one argument is accepted in transformation \n")
}
if (is.na(trans) | trans == 4) {
stop("\n Invalid transformation \n")
}
matrix.w <- matrix.w.transformation(comm, transformation = transformation,
spp.weights = spp.weights, notification = notification)
b.NA <- apply(traits, 2, is.na)
if(notification){
if(any(b.NA)){
warning("Warning: NA in traits matrix", call. = FALSE)
}
}
matrix.b <- traits
matrix.T <- matmult.syncsa(matrix.w, traits)
if (scale) {
matrix.traits <- apply(matrix.T^2, 2, sum)
matrix.T <- sweep(matrix.T, 2, sqrt(matrix.traits), "/")
}
return(list(matrix.w = matrix.w, matrix.b = matrix.b, matrix.T = matrix.T))
}
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.