Last data update: 2014.03.03

R: Simple estimate of energy gained by a layer of water
watts.inR Documentation

Simple estimate of energy gained by a layer of water

Description

Estimate the amount of energy gained by a layer of water as the difference between energy entering from the top of the layer and energy leaving at the bottom. Energy gained/ lost is calculated from photosynthetically active radiation (PAR, which is then converted to watts) and an estimate of kd (light attenuation coefficient) which is derived from the depth of 1 percent surface light.

Usage

watts.in(top, bot, irr, z1perc)

Arguments

top

Depth of the top of the layer, in meters

bot

Depth of the bottom of the layer, in meters

irr

PAR in uE/s (umol / m^2 / s)

z1perc

Depth of 1 percent of surface light, in meters

Details

This rough estimate is used in the Kalman filter/ smoother for water temperature. It does not account for a variety of potentially important factors, and is made specifically for use with temp.kalman(), which uses maximum likelihood to fit a linear coefficient that converts this heat gain estimate into temperature change.

Value

numeric vector of estimates of energy gain

Author(s)

Ryan Batt, Luke Winslow

References

Batt, Ryan D. and Stephen R. Carpenter. 2012. Free-water lake metabolism: addressing noisy time series with a Kalman filter. Limnology and Oceanography: Methods 10: 20-30. doi: 10.4319/lom.2012.10.20

See Also

temp.kalman metab.kalman

Examples

watts.in(3.2, 4, 1200, 4.5)

Results


R version 3.3.1 (2016-06-21) -- "Bug in Your Hair"
Copyright (C) 2016 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)

R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.

R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.

Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> library(LakeMetabolizer)
Loading required package: rLakeAnalyzer
> png(filename="/home/ddbj/snapshot/RGM3/R_CC/result/LakeMetabolizer/watts.in.Rd_%03d_medium.png", width=480, height=480)
> ### Name: watts.in
> ### Title: Simple estimate of energy gained by a layer of water
> ### Aliases: watts.in
> ### Keywords: math methods
> 
> ### ** Examples
> 
> watts.in(3.2, 4, 1200, 4.5)
[1] 5.516019
> 
> 
> 
> 
> 
> dev.off()
null device 
          1 
>