quantize: Stratified randomization of community matrix

In phylospatial: Spatial Phylogenetic Analysis

Stratified randomization of community matrix

Description

This is a simple wrapper around nullcat::quantize(), included in phylospatial mainly for backward compatibility.

Usage

quantize(x = NULL, ...)

Arguments

x	Community matrix with species in rows, sites in columns, and nonnegative quantities in cells.
...	Additional arguments passed to nullcat::quantize().

Details

The nullcat quantize routine involves three steps: converting a quantitative matrix to categorical strata, permuting the resulting categorical matrix using one of several categorical null model algorithms, and mapping the randomized categories back to quantitative values. Supply arguments via ... to control options for each of these stages.

Value

A randomized version of x.

Examples

if (requireNamespace("nullcat", quietly = TRUE)) {
      # example quantitative community matrix
      comm <- matrix(runif(2500), 50)

      # examples of different quantize usage
      rand <- quantize(comm)
      rand <- quantize(comm, n_strata = 4, transform = sqrt, fixed = "row")
      rand <- quantize(comm, method = "swapcat", n_iter = 500)
}

phylospatial documentation built on Dec. 24, 2025, 1:06 a.m.