pyTEF 0.1

Description:

pyTEF 0.1

pyTEF

pyTEF is a Python package that can be used to apply the Total Exchange Framework (TEF) to analyze the exchange flow of an estuary.

To do so TEF analyzes the exchange flow in salinity and/or temperature coordinates rather than spatial coordinates since the dynamics of most estuaries are controlled by the salt distribution. This package provides the necessary tools to use the TEF framework and is built on top of xarray.
Installing
To install use
git clone https://github.com/florianboergel/pyTEF.git and then
pip install -e pyTEF
How to use
00_tef_core.ipynb contains the TEF framework and all documentation.
01_calc.ipynb mainly contains the coordinate transformation of the transport terms and the calculation of the bulk values
Further you find different examples on how to use the TEF framework.


02_example_analytical.ipynb - validation of the pyTEF package


03_example_persian_gulf.ipynb - example TEF analysis applied to the Persian Gulf


Learn about TEF
The TEF analysis framework (Burchard et al., 2018; Lorenz et al., 2019; MacCready, 2011) allows a consistent calculation of the transports and salinities of an exchange flow in salinity space (or every other coordinate). The main idea of TEF is that transports of volume and salinity in and out the estuary of the same salinity partially compensate since only the net exchange changes salinity and volume of the estuary.
The reader is referenced to the follwing literature:


PhD thesis of Marvin Lorenz


Burchard, H., et al. (2018) The Knudsen theorem and the Total Exchange
Flow analysis framework applied to the Baltic Sea. Progress in Oceanography,
10.1016/j.pocean.2018.04.004.


Lorenz, M., Klingbeil, K., and Burchard, H. (2020) Numerical Study of the Persian Gulf using an Extended Total Exchange Flow Analysis Framework, J. Geophys. Res. Oceans, 125, e2019JC015527, https://doi.org/10.1029/2019JC015527


Lorenz, M., Klingbeil, K., MacCready, P., and Burchard, H. (2019) Numerical issues of the Total Exchange Flow (TEF) analysis framework for quantifying estuarine circulation, Ocean Sci., 15, 601-614, https://doi.org/10.5194/os-15-601-2019


MacCready, P., 2011: Calculating estuarine exchange flow using isohaline coordinates. Journal of Physical Oceanography, 41 (6), 1116–1124.


What's new
v0.2 (07.06.2021)

first version of pyTEF ready for testing

example cases added
calculation of bulk values
algorithm that finds minima and maxima in a given Q profile
added documentation



v0.1 (25.05.2021)

implementation of 2D sorting