| HSIeqtn {ecorest} | R Documentation |
Computes Habitat Suitability Index based on Model-Specified Equation
Description
HSIeqtn computes a habitat suitability index based on equations specified
in U.S. Fish and Wildlife Service habitat suitability models contained within ecorest
via HSImodels and HSImetadata. Habitat suitability indices represent an overall assessment
of habitat quality from combining individual suitability indices for multiple independent
variables. The function computes an overall habitat suitability index.
Usage
HSIeqtn(HSImodelname, SIV, HSImetadata)
Arguments
HSImodelname |
a character string in quotations that must match an existing model name in HSImetadata. |
SIV |
a vector of suitability index values used in the model specified in HSImodelname. |
HSImetadata |
a data frame of HSI model metadata within the ecorest package. |
Value
A numeric of the habitat suitability index ranging from 0 to 1.
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
#Compute patch quality for the Barred Owl model (no components)
#Allen A.W. 1982. Habitat Suitability Index Models: Barred owl. FWS/OBS 82/10.143.
#U.S. Fish and Wildlife Service. https://pubs.er.usgs.gov/publication/fwsobs82_10_143.
#Suitability indices relate to density of large trees, mean diameter of overstory trees,
#and percent canopy cover of overstory.
#Example suitability vectors
HSIeqtn("barredowl", c(1,1,1), HSImetadata) #c(1,1,1) should result in 1.00
HSIeqtn("barredowl", c(0.5,1,1), HSImetadata) #c(0.5,1,1) should result in 0.707
HSIeqtn("barredowl", c(0,1,1), HSImetadata) #c(0,1,1) should result in 0.00
HSIeqtn("barredowl", c(0,NA,1), HSImetadata) #c(0,NA,1) should return error message
HSIeqtn("barredowl", c(NA,1,1,1), HSImetadata) #c(NA,1,1,1) should return error message
#Compute patch quality for the Juvenile Alewide mode (two components)
#Pardue, G.B. 1983. Habitat Suitability index models: alewife and blueback herring.
#U.S. Dept. Int. Fish Wildl. Serv. FWS/OBS-82/10.58. 22pp.
#Suitability indices relate to zooplankton density, salinity, and water temperature
#Example suitability vectors are c(1,1,1), c(0.5,1,1), and c(0,1,1)
HSIeqtn("alewifeJuv", c(1,1,1), HSImetadata) #c(1,1,1) should result in 1.00
HSIeqtn("alewifeJuv", c(0.5,1,1), HSImetadata) #c(0.5,1,1) should result in 0.50
HSIeqtn("alewifeJuv", c(0,1,1), HSImetadata) #c(0,1,1) should result in 0.00
HSIeqtn("alewifeJuv", c(1,NA,1), HSImetadata) #c(1,NA,1) returns error message
HSIeqtn("alewifeJuv", c(1,1,1,NA), HSImetadata) #c(1,1,1,NA) returns error message