## Usage

ra3(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.

## Value

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

## Description

Randomizes a numeric utilization matrix speciesData by
reshuffling the elements within each row.

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

## Note

This algorithm retains the niche breadth and zero states for each
species, but randomizes the assignment of each utilization value to a
different niche category. It performs effectively in simulation studies and
is recommended for analysis of niche overlap patterns.

## References

Winemiller, K.O. and E.R. Pianka. 1990. Organization in natural
assemblages of desert lizards and tropical fishes. Ecological Monographs
60: 27-55.

## Examples

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