https://github.com/DOV-Vlaanderen/pydov
Python package to retrieve data from Databank Ondergrond Vlaanderen (DOV)
https://github.com/DOV-Vlaanderen/pydov
data-access lifewatch oscibio package python water
Last synced: 6 months ago
JSON representation
Python package to retrieve data from Databank Ondergrond Vlaanderen (DOV)
- Host: GitHub
- URL: https://github.com/DOV-Vlaanderen/pydov
- Owner: DOV-Vlaanderen
- License: mit
- Created: 2016-12-23T10:09:53.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-10-01T11:12:56.000Z (8 months ago)
- Last Synced: 2025-10-26T18:03:34.994Z (8 months ago)
- Topics: data-access, lifewatch, oscibio, package, python, water
- Language: Python
- Homepage: https://pydov.readthedocs.io/en/latest/
- Size: 20.2 MB
- Stars: 36
- Watchers: 16
- Forks: 19
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.rst
- Contributing: .github/CONTRIBUTING.rst
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.rst
- Authors: AUTHORS.rst
Awesome Lists containing this project
- open-sustainable-technology - pydov - Aggregates data about soil, subsoil and groundwater of Flanders and makes them publicly available. (Natural Resources / Soil and Land)
README
# pydov 
[](https://github.com/DOV-Vlaanderen/pydov/actions/workflows/ci.yml) [](https://pydov.readthedocs.io/en/latest/?badge=latest) [](https://www.repostatus.org/#active) [](https://doi.org/10.5281/zenodo.2788680) [](https://github.com/pyOpenSci/software-review/issues/19)
pydov is a Python package to query and download data from [Databank Ondergrond Vlaanderen (DOV)](https://www.dov.vlaanderen.be). It is hosted on [GitHub](https://github.com/DOV-Vlaanderen/pydov) and development is coordinated by Databank Ondergrond Vlaanderen (DOV). DOV aggregates data about soil, subsoil and groundwater of Flanders and makes them publicly available. Interactive and human-readable extraction and querying of the data is provided by a [web application](https://www.dov.vlaanderen.be/portaal/?module=verkenner#ModulePage), whereas the focus of this package is to **support machine-based extraction and conversion of the data**.
To get started, see the documentation at https://pydov.readthedocs.io.
Please note that downloading DOV data with pydov is governed by the same [disclaimer](https://www.dov.vlaanderen.be/page/disclaimer) that applies to the other DOV services. Be sure to consult it when using DOV data with pydov.
## Installation
You can install `pydov` stable using pip:
```shell script
pip install pydov
```
Or clone the [git repository](https://github.com/DOV-Vlaanderen/pydov) and install with `python setup.py install` to get the latest snapshot from the master branch.
To contribute to the code, make sure to install the package and all of the development dependencies enlisted in the
[requirements_dev.txt](requirements_dev.txt) file. First, clone the [git repository](https://github.com/DOV-Vlaanderen/pydov).
We advice to use an Python development environment, for example with [conda](https://docs.conda.io/en/latest/miniconda.html) or
[virtualenv](https://virtualenv.pypa.io/en/latest/). Activate the (conda/virtualenv) environment and
install the package in development mode:
```shell script
pip install -e .[devs]
```
Need more detailed instructions? Check out the [installation instructions](https://pydov.readthedocs.io/en/stable/installation.html) and the [development guidelines](https://pydov.readthedocs.io/en/stable/development.html).
## Quick start
Read the [quick start](https://pydov.readthedocs.io/en/stable/quickstart.html) from the docs or jump straight in:
```python
from pydov.search.boring import BoringSearch
from pydov.util.location import Within, Box
from owslib.fes2 import PropertyIsGreaterThan
boringsearch = BoringSearch()
dataframe = boringsearch.search(
query=PropertyIsGreaterThan(propertyname='diepte_tot_m', literal='550'),
location=Within(Box(107500, 202000, 108500, 203000))
)
```
The resulting dataframe contains the information on boreholes (boringen) within the provided bounding box (as defined by the `location` argument)
with a depth larger than 550m:
```
>>> dataframe
pkey_boring boornummer x y mv_mtaw start_boring_mtaw gemeente diepte_boring_van diepte_boring_tot datum_aanvang uitvoerder boorgatmeting diepte_methode_van diepte_methode_tot boormethode
0 https://www.dov.vlaanderen.be/data/boring/1989... kb14d40e-B777 108015.0 202860.0 5.0 5.0 Gent 0.0 660.0 1989-01-25 onbekend False 0.0 660.0 onbekend
1 https://www.dov.vlaanderen.be/data/boring/1972... kb14d40e-B778 108090.0 202835.0 5.0 5.0 Gent 0.0 600.0 1972-05-17 onbekend False 0.0 600.0 onbekend
```
## Documentation
Full documentation of `pydov` can be found on our [ReadTheDocs page](https://pydov.readthedocs.io).
## Contributing
You do not need to be a code expert to contribute to this project as there are several ways you can contribute to
this project. Have a look at the [contributing page](https://pydov.readthedocs.io/en/latest/contributing.html).
## Meta
- We welcome [contributions](.github/CONTRIBUTING.rst) including bug reports.
- License: MIT
- Citation information can be found on [Zenodo](https://doi.org/10.5281/zenodo.2788680).
- Please note that this project is released with a [Contributor Code of Conduct](.github/CODE_OF_CONDUCT.rst). By participating in this project you agree to abide by its terms.
- Also note that downloading DOV data with pydov is governed by the same [disclaimer](https://www.dov.vlaanderen.be/page/disclaimer) that applies to the other DOV services. Be sure to consult it when using DOV data with pydov.