Metadata-Version: 2.3
Name: dutchsoils
Version: 0.1.3
Summary: Package to get soil profiles of the Netherlands.
License: GNU General Public Licence v3.0
Author: markvdbrink
Author-email: mark.vandenbrink@wur.nl
Maintainer: markvdbrink
Maintainer-email: mark.vandenbrink@wur.nl
Requires-Python: >=3.11
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Hydrology
Classifier: Topic :: Scientific/Engineering :: Hydrology
Classifier: Operating System :: OS Independent
Provides-Extra: dev
Provides-Extra: ipykernel
Requires-Dist: ipykernel (>=6.29,<7.0) ; extra == "ipykernel"
Requires-Dist: numpy (>=1.26,<2.0)
Requires-Dist: pandas (>=2.2,<3.0)
Requires-Dist: pedon (>=0.0,<1.0)
Requires-Dist: pre-commit (>=4.2,<5.0) ; extra == "dev"
Requires-Dist: pytest (>=8.4,<9.0) ; extra == "dev"
Project-URL: Homepage, https://github.com/markvdbrink/dutchsoils
Project-URL: Issues, https://github.com/markvdbrink/dutchsoils/issues
Project-URL: Source, https://bodemdata.nl/
Description-Content-Type: text/markdown

# DutchSoils - get Dutch soil data

![PyPI - Version](https://img.shields.io/pypi/v/:dutchsoils)

DutchSoils is a Python package to get soil data from the Dutch Soil Map, Staring series and BOFEK clustering.

It contains code to get soil texture data from the [Dutch Soil Map](https://www.wur.nl/nl/show/bodemkaart-van-nederland.htm) and combine that with the [BOFEK soil clustering](https://www.wur.nl/nl/show/Bodemfysische-Eenhedenkaart-BOFEK2020.htm) and the hydraulic parameters from the [Staring series](https://research.wur.nl/en/publications/waterretentie-en-doorlatendheidskarakteristieken-van-boven-en-ond-5).

## Installation

The easiest way to install the package is through `pip`:

```shell
pip install dutchsoils
```

## Get started

Getting a soil profile with the soil identification number and plotting the necessary parameters:

```
import dutchsoils as ds
sp = ds.SoilProfile(soil_index=1050)  # Peat soil
fig = sp.plot()
fig.show()
```

A brief example with other options is given in `docs/examples`.

## Directions

- Questions, issues, feature requests and bugs can be reported in the [issue section](https://github.com/markvdbrink/dutchsoils/issues).

## Ongoing work

- Add support for getting the soilprofile at a certain location (X,Y) in the Netherlands.
- Use `pedon` for Staring series instead of the csv table.

## Sources

- Heinen, M., Brouwer, F., Teuling, K., & Walvoort, D. (2021). BOFEK2020 - Bodemfysische schematisatie van Nederland: Update bodemfysische eenhedenkaart. Wageningen Environmental Research. https://doi.org/10.18174/541544
- Heinen, M., Bakker, G., & Wösten, J. H. M. (2020). Waterretentie- en doorlatendheidskarakteristieken van boven- en ondergronden in Nederland: De Staringreeks : Update 2018 [page 17]. Wageningen Environmental Research. https://doi.org/10.18174/512761

