Metadata-Version: 2.3
Name: groundwater-tools
Version: 0.2.1
Summary: Library for processing groundwater data and constructing simple analytical models.
Author: Kaarel Mänd
Author-email: Kaarel Mänd <kaarel.mand@protonmail.com>
License: MIT
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Hydrology
Requires-Dist: matplotlib>=3.10.5
Requires-Dist: pandas>=2.3.1
Requires-Dist: scipy>=1.16.1
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/kaarelmand/groundwater_tools
Description-Content-Type: text/markdown

# groundwater_tools

A library to analyse groundwater survey and geophysical logging data and build simple analytical groundwater flow models.

## marinelli.py

This first iteration only contains the library **marinelli.py**, which contains classes
for constructing the simple analytical groundwater flow model by Marinelli & Niccoli
([2000](https://doi.org/10.1111/j.1745-6584.2000.tb00342.x)) for assessing flow into a
mine pit.

To construct a groundwater flow model, call the `PitFlow` class (all units in meters and
seconds) or `PitFlowCommonUnits` (units in more common formats).
To construct several models (e.g., for comparing various scenarios), use
`PitFlowCollection` or `PitflowCommonUnitsCollection`.

The classes contain methods to calculate inflow, water table depression, and to output
`matplotlib` depression cone profiles and `pandas.DataFrame` reports.
More exact documentation is work-in-progress.

Recommended to be used with Jupyter Notebooks.

## To do

* Add more testing for the critical mathematical methods.
* A more straightforward method to account for springtime high water. 
* Better code quality: type hints, docstrings, etc.
* Add proper documentation.