calcVolume: Calculate Pelagic Habitat Volumes

In rLakeHabitat: Interpolate Bathymetry and Quantify Physical Aquatic Habitat

Calculate Pelagic Habitat Volumes

Description

Calculates epilimnion, metalimnion, and hypolimnion volumes based on defined thermocline depths across water levels.

Usage

calcVolume(
  DEM,
  thermo_depth = NULL,
  thermo_high,
  thermo_low,
  DEMunits = "m",
  depthUnits = "ft",
  by = 1,
  stop = NULL
)

Arguments

DEM	SpatRaster object of a given waterbody, rasters can be transformed to SpatRaster via the rast() function in 'terra'
thermo_depth	number giving the estimated middle of thermocline, results in calculation of only epilimnion and hypolimnion volumes. Default = NULL, cannot use in conjunction with thermo_low and thermo_high
thermo_high	number giving the upper bound of thermocline depth, results in calculation of epilimnion, metalimnion, and hypolimnion values
thermo_low	number giving the lower bound of thermocline depth, results in calculation of epilimnion, metalimnion, and hypolimnion values
DEMunits	character describing units of raster coordinate system. Can be meters, kilometers, or hectares ("m", "km", "ha"), default = "m"
depthUnits	character describing units of depth measurement. Can be either feet or meters ("ft", "m"), default = "ft"
by	numeric increment per unit by which volumes are calculated. Higher values will result in lower resolution. Default = 1
stop	optional numeric value specifying depth at which to stop habitat volume calculations, default = NULL

Value

a data frame of volumes in cubic meters calculated for each habitat (epilimnion, metalimnion, hypolimnion)

Author(s)

Tristan Blechinger, Department of Zoology & Physiology, University of Wyoming

Examples

#load raster
DEM <- terra::rast(system.file("extdata", "example_raster.tif", package = 'rLakeHabitat'))
#run function
calcVolume(DEM, thermo_depth = 3, DEMunits = 'm', depthUnits = 'm')

rLakeHabitat documentation built on April 16, 2025, 1:10 a.m.