R: Matrix X

matrix.x {SYNCSA} | R Documentation

## Matrix X

### Description

Function to obtain a matrix containing trait-weighted species composition. For more details, see `syncsa`.

### Usage

    matrix.x(
      comm,
      traits,
      scale = TRUE,
      ranks = TRUE,
      ord,
      notification = TRUE,
      ...
    )

### Arguments

`comm` | Community data, with species as columns and sampling units as rows. This matrix can contain either presence/absence or abundance data.
`traits` | Matrix or data frame of species described by traits, with traits as columns and species as rows.
`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 the matrix of traits is subjected to standardization within each trait, and Gower Index is used to calculate the degree of belonging to the species. When scale = FALSE traits are measured on the same scale the matrix of traits is not subjected to standardization, and Euclidean distance is calculated to determine the degree of belonging to the species.
`ranks` | Logical argument (TRUE or FALSE) to specify if ordinal variables are convert to ranks (Default ranks = TRUE).
`ord` | Method to be used for ordinal variables, see `gowdis`, if any method is forneced the rank parameter is not apply.
`notification` | Logical argument (TRUE or FALSE) to specify if notifications of missing observations are shown (Default notification = TRUE).
`...` | Parameters for `gowdis` function.

### Value

`matriz.w` | Standardized community matrix, where rows are communities and columns species. Row totals (communities) = 1.
`matriz.u` | Standardized matrix containing the degree of belonging of each species in relation to each other species. Row totals (species) = 1.
`matriz.X` | Trait-weighted species composition matrix. Row totals (communities) = 1.

### Note

IMPORTANT: The sequence species show up in community data matrix MUST be the same as they show up in traits matrix. See `organize.syncsa`.

### Author(s)

Vanderlei Julio Debastiani <vanderleidebastiani@yahoo.com.br>

### 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.

### See Also

`syncsa`, `organize.syncsa`, `belonging`, `matrix.t`, `matrix.p`, `gowdis`

### Examples

    data(ADRS)
    matrix.x(ADRS$community, ADRS$traits)

[Package SYNCSA version 1.3.4 Index]