HSIwarimean {ecorest}

Habitat Suitability Index with a Weighted Arithmetic Mean

Description

HSIwarimean uses a weighted arithmetic mean to combine suitability indices into an overarching habitat suitability index.

Usage

HSIwarimean(x, w)

Arguments

x

is a vector of suitability indices.

w

is a vector of weights (0 to 1 values that must sum to one).

Value

A value of habitat quality from 0 to 1 ignoring NA values.

References

US Fish and Wildlife Service. (1980). Habitat as a basis for environmental assessment. Ecological Services Manual, 101.

US Fish and Wildlife Service. (1980). Habitat Evaluation Procedures (HEP). Ecological Services Manual, 102.

US Fish and Wildlife Service. (1981). Standards for the Development of Habitat Suitability Index Models. Ecological Services Manual, 103.

Examples

#Determine patch quality based on a vector of four, equal-weight suitability indices.
HSIwarimean(c(1, 0, 0, 0), c(0.25, 0.25, 0.25, 0.25))

#Determine patch quality based on a vector of four, unequal-weight suitability indices.
HSIwarimean(c(1, 0, 0, 0), c(1, 0, 0, 0))

#Determine patch quality based on a vector of four, unequal-weight suitability indices.
HSIwarimean(c(1, 0, 0, 0), c(0, 1, 0, 0))

#Demonstrate error for mismataching inputs.
HSIwarimean(c(1, 0, 0, 0), c(0, 0, 0))

#Demonstrate error for incorrect weighting.
HSIwarimean(c(1, 0, 0, 0), c(1, 1, 0, 0))

#Demonstrate error for out of range output.
HSIwarimean(c(1, 1, 1, 10), c(0.2, 0.3, 0.3, 0.2))