czekanowski: Czekanowski Niche Overlap Metric

Description Usage Arguments Details Value Note References See Also Examples

View source: R/metrics.R


Takes a resource utilization matrix as input and returns the average pairwise Czekanowki niche overlap index.


czekanowski(m = matrix(rpois(80, 1), nrow = 10))



a matrix of resource utilization values.


The Czekanowski niche overlap index is averaged over each unique species pair. The index measures the area of intersection of the resource utilization histograms of each species pair. Values of Czekanowski niche overlap index close to 0.0 reflect usage of exclusive resource categories, whereas values close to 1.0 reflect similar resource utilization spectra.

O_jk = O_kj = 1 - 0.5*sum|p_ij - p_ik|



Returns the average pairwise niche overlap.


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.


Feinsinger, P., E.E. Spears, and R. Poole. 1981. A simple measure of niche breadth. Ecology 62: 27-32.

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

See Also

pianka niche overlap index.


obsOverlap <- czekanowski(m=matrix(rpois(40,0.5),nrow=8))

EcoSimR documentation built on May 19, 2017, 7:40 p.m.
Search within the EcoSimR package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at

Please suggest features or report bugs in the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.