Environmental Science using Symbolic Math

This package contains helpers to deal with physical variables and units.

The documentation is available on https://essm.rtfd.io/.

The quick installation for impatient users can be done by running:

pip install essm

User’s Guide

This part of the documentation will show you how to get started in using ESSM.

• Installation
  • Development
• Usage
  • Creating variables
  • Creating equations
  • Importing variables and equations

Importable variables and equations

Here you find examples for importing pre-defined variables and equations fromm ESSM.

• Importable variables and equations
  • General physics variables and equations
    • Variables
    • Equations
  • Variables and equations related to plant leaves
    • Variables for leaf energy and water balance
    • Equations for leaf energy and water balance
    • Variables for leaf radiative balance
  • Variables for leaf chamber model
    • Leaf chamber insulation
    • Leaf chamber mass balance
  • Bibliography

Use examples

Here you find use examples for different API features of ESSM.

• Use examples
  • Importing variables and equations from essm
  • Plotting
  • Creating new variables
    • Variables with expressions as definitions
    • Linking assumptions to variables
  • Creating new equations
    • Custom equation
    • New equation based on manipulation of previous equations
    • Show inheritance of equations
    • Computational burden of deriving equations within class definition
    • Empirical equations with internal variables
    • Piecewise defined equations
  • Substituting into integrals and derivatives and evaluating
  • Unit conversions
  • Exporting definitions
• Use examples for numerical calculations
  • Numerical evaluations
    • Substitution of equations and values into equations
    • Evaluation of equations for long lists of variable sets
    • Numerical solution
    • Generate code from sympy expressions and execute

API Reference

If you are looking for information on a specific function, class or method, this part of the documentation is for you.

• API Docs
  • Jupyter notebooks with API examples
  • Variables
    • Creating variables
    • Chamber
    • Leaf
    • Physics
    • Units
  • Equations
    • Creating equations
    • Importing pre-defined equations
    • Leaf
    • Physics
  • Internals

Additional Notes

Notes on how to contribute, legal information and changes are here for the interested.

• Changes
• License
• Authors

References

[Har94]

Dennis L. Hartmann. Global physical climatology. Academic Press, 1994. ISBN 978-0-12-328530-0.

[MU07]

John Monteith and Mike Unsworth. Principles of Environmental Physics. Academic Press, Oxford, UK, 3rd edition, November 2007. ISBN 0-12-505103-4.

[SO17]

S. J. Schymanski and D. Or. Leaf-scale experiments reveal an important omission in the Penman–Monteith equation. Hydrol. Earth Syst. Sci., 21(2):685–706, February 2017. URL: http://www.hydrol-earth-syst-sci.net/21/685/2017/ (visited on 2017-02-02), doi:10.5194/hess-21-685-2017.

Indices and tables

• Index
• Module Index
• Search Page