skbio.diversity.alpha.pielou_e

skbio.diversity.alpha.pielou_e(counts)

Calculate Pielou’s evenness index.

Pielou’s evenness index (\(J'\)), a.k.a., Shannon’s equitability index (\(E_H\)), is defined as

\[J' = \frac{(H)}{\ln(S)}\]

where \(H\) is the Shannon index of the sample and \(S\) is the number of taxa in the sample.

That is, \(J'\) is the ratio of the actual Shannon index of the sample versus the maximum-possible Shannon index when all taxa have the same number of individuals. \(J'\) ranges between 0 and 1.

Parameters:

counts1-D array_like, int

Vector of counts.

Returns:

double

Pielou’s evenness index.

See also

shannon

heip_e

Notes

Pielou’s evenness index was originally described in [1].

References

[1]

Pielou, E. C., 1966. The measurement of diversity in different types of biological collections. Journal of Theoretical Biology, 13, 131-44.