RA1 Niche Overlap Randomization Algorithm

Share:

Description

Randomizes a numeric utilization matrix speciesData by replacing all elements with a random uniform [0,1] value.

Usage

1
ra1(speciesData = matrix(rpois(80, 1), nrow = 10))

Arguments

speciesData

a resource utilization matrix (rows = species, columns = discrete resource states) filled with non-negative real numbers.

Details

The resource utilization matrix (rows = species, columns = discrete resource categories) may include zeroes, but no negative numbers or missing values. Relative resource within a species is first calculated, so the rows need not sum to 1.0.

Value

Returns a random utilization matrix with the same dimensions as the input matrix.

Note

Because all matrix elements, including zeroes, are replaced with a random uniform distribution, the null expectation is based on an assemblage of generalist species with maximum niche breadth. This algorithm retains neither the niche breadth of the individuals species nor the placement of 0 values (= unutilized resource states) in the matrix. These assumptions are unrealistic, and a random matrix with zeroes will generate significantly low niche overlap values with this metric. It is not recommended for niche overlap analysis.

References

Kobayashi, S. 1991. Interspecific relations in forest floor coleopteran assemblages: niche overlap and guild structure. Researches in Population Ecology 33: 345-360.

Examples

1
ranUtil <- ra1(speciesData=matrix(rpois(40,0.5),nrow=8))

Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.