Metadata-Version: 2.3
Name: dutchsoils
Version: 0.2.1
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: coverage (>=7.10,<8.0) ; extra == "dev"
Requires-Dist: coverage-badge ; extra == "dev"
Requires-Dist: ipykernel (>=6.29,<7.0) ; extra == "ipykernel"
Requires-Dist: numpy (>=1.26)
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: pyproj (>=3.7.1,<4.0.0)
Requires-Dist: pytest (>=8.4,<9.0) ; extra == "dev"
Requires-Dist: requests (>=2.32.4,<3.0.0)
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).

> [!Note]
> The data and soil profiles in this package are not actual measurements but are **derived** from field measurements. It is assumed that the soil profile and associated data are typical for the soil at a certain location.

## Installation

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

```shell
pip install dutchsoils
```

## Get started

Getting a soil profile with geographical coordinates, getting the data of its horizons and plotting the common parameters:

```
import dutchsoils as ds
sp = ds.SoilProfile.from_location(x=171827, y=445436, crs="EPSG:28992")
sp.get_data_horizons()
sp.plot()
```

An example with other available options is given in `docs/examples`.

## Feedback

Feedback is always welcome!

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

## Many thanks to
- The people behind [pyOpenSci](https://www.pyopensci.org/python-package-guide/index.html), who provided an elaborate step-by-step tutorial on how to publish a Python package.
- The developers of (among others) [pyswap](https://github.com/zawadzkim/pySWAP), [pedon](https://github.com/martinvonk/pedon), and [Artesia Water](https://github.com/ArtesiaWater), whose Python packages were a source of inspiration.

## Sources

- Wageningen Environmental Research (2024). Bodemkaart van Nederland V2024-01. https://www.broloket.nl/ondergrondmodellen; downloaded on 07-08-2025.
- 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

