Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

pydov

Aggregates data about soil, subsoil and groundwater of Flanders and makes them publicly available.
https://github.com/DOV-Vlaanderen/pydov

Category: Natural Resources
Sub Category: Soil and Land

Keywords

data-access lifewatch oscibio package python water

Keywords from Contributors

open-science weather occurrence vegetation ogc ogcapi ows soil

Last synced: about 14 hours ago
JSON representation

Repository metadata

Python package to retrieve data from Databank Ondergrond Vlaanderen (DOV)

README.md

pydov

CI Documentation Status Project Status: Active – The project has reached a stable, usable state and is being actively developed. DOI pyOpenSci

pydov is a Python package to query and download data from Databank Ondergrond Vlaanderen (DOV). It is hosted on GitHub 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, 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 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:

pip install pydov

Or clone the git repository 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 file. First, clone the git repository.
We advice to use an Python development environment, for example with conda or
virtualenv. Activate the (conda/virtualenv) environment and
install the package in development mode:

pip install -e .[devs]

Need more detailed instructions? Check out the installation instructions and the development guidelines.

Quick start

Read the quick start from the docs or jump straight in:

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.

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.

Meta

  • We welcome contributions including bug reports.
  • License: MIT
  • Citation information can be found on Zenodo.
  • Please note that this project is released with a Contributor Code of Conduct. 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 that applies to the other DOV services. Be sure to consult it when using DOV data with pydov.

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 1,398
Total Committers: 17
Avg Commits per committer: 82.235
Development Distribution Score (DDS): 0.719

Commits in past year: 16
Committers in past year: 2
Avg Commits per committer in past year: 8.0
Development Distribution Score (DDS) in past year: 0.063

Name Email Commits
Roel Huybrechts r****s@r****m 393
Roel Huybrechts r****l@h****e 355
stijnvanhoey s****y@g****m 275
pjhaest g****t@g****m 148
Guillaume Vandekerckhove 7****e 75
Johan Van de Wauw j****n@g****e 49
JorisSynaeve j****e@g****m 47
pieterjan p****t@a****e 19
Killian Paenen p****i@c****e 9
Peter Desmet p****k@g****m 8
B0hr t****s@g****m 7
BEGILT g****n@s****e 4
Johan Van de Wauw J****w@r****m 4
Joris Van den Bossche j****e@g****m 2
marleenvd m****e@v****e 1
Guillaume Vandekerckhove g****e@v****e 1
meisty s****6@g****m 1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 44
Total pull requests: 83
Average time to close issues: 5 months
Average time to close pull requests: about 1 month
Total issue authors: 19
Total pull request authors: 11
Average comments per issue: 3.2
Average comments per pull request: 0.86
Merged pull request: 75
Bot issues: 0
Bot pull requests: 0

Past year issues: 2
Past year pull requests: 11
Past year average time to close issues: N/A
Past year average time to close pull requests: 22 days
Past year issue authors: 2
Past year pull request authors: 4
Past year average comments per issue: 0.5
Past year average comments per pull request: 0.18
Past year merged pull request: 7
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/DOV-Vlaanderen/pydov

Top Issue Authors

  • Roel (16)
  • pjhaest (4)
  • dluts (3)
  • yairlevy (3)
  • katrijndirix (2)
  • GuillaumeVandekerckhove (2)
  • jorissynaeve (2)
  • tibovanheule (1)
  • johanvdw (1)
  • marleenvd (1)
  • jclaus88 (1)
  • pdweerdt (1)
  • denilka (1)
  • f-vn (1)
  • VdwWout (1)

Top Pull Request Authors

  • Roel (59)
  • GuillaumeVandekerckhove (9)
  • rebot (4)
  • jorissynaeve (3)
  • stijnvanhoey (2)
  • arnedegr (1)
  • jorisvandenbossche (1)
  • kpaenen (1)
  • rubenv-locus (1)
  • marleenvd (1)
  • pjhaest (1)

Top Issue Labels

  • dov (12)
  • enhancement (6)
  • bug (6)
  • docs (5)
  • good-first-issue (3)
  • upstream (1)
  • question (1)
  • needs info (1)
  • cannot-reproduce (1)
  • CI (1)

Top Pull Request Labels

  • docs (8)
  • CI (3)
  • tests (3)
  • enhancement (1)

Package metadata

pypi.org: pydov

A Python package to download data from Databank Ondergrond Vlaanderen (DOV).

  • Homepage: https://github.com/DOV-Vlaanderen/pydov
  • Documentation: https://pydov.readthedocs.io/
  • Licenses: MIT license
  • Latest release: 3.2.0 (published 2 months ago)
  • Last Synced: 2025-04-25T12:09:01.607Z (1 day ago)
  • Versions: 17
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 1,243 Last month
  • Docker Downloads: 0
  • Rankings:
    • Docker downloads count: 4.134%
    • Dependent packages count: 7.31%
    • Forks count: 9.144%
    • Stargazers count: 11.417%
    • Average: 12.402%
    • Downloads: 20.317%
    • Dependent repos count: 22.088%
  • Maintainers (2)

Dependencies

.github/workflows/ci.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/pypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • pypa/gh-action-pypi-publish master composite
binder/requirements.txt pypi
  • fiona >=1.8.18
  • folium *
  • geopandas *
  • ipykernel *
  • ipython *
  • jupyter_client *
  • matplotlib *
  • numpy *
  • owslib *
  • pandas *
  • pyproj *
  • requests *
requirements.txt pypi
  • numpy *
  • owslib *
  • pandas *
  • requests *
requirements_dev.txt pypi
  • PyYAML * development
  • Sphinx * development
  • bumpversion * development
  • coverage * development
  • cryptography * development
  • flake8 * development
  • flask * development
  • nbsphinx * development
  • numpydoc * development
  • pip * development
  • pytest * development
  • pytest-cov * development
  • pytest-runner * development
  • sphinx_rtd_theme * development
  • tox * development
  • watchdog * development
  • wheel * development
requirements_doc.txt pypi
  • folium *
  • ipykernel *
  • ipython *
  • jupyter_client *
  • matplotlib *
  • pyproj *
requirements_proxy.txt pypi
  • pypac *
contrib/PFAS_concentrations/environment.yml pypi
  • pydov >=3.1.0
contrib/PFAS_concentrations/requirements.txt pypi
  • OWSLib *
  • git *
  • loguru *
  • openpyxl *
  • packaging *
  • pandas *
  • pydov >=3.1.0
  • tqdm *
requirements_geom.txt pypi
  • fiona *
  • geopandas *
  • pygml *
  • shapely *
setup.py pypi

Score: 13.811054645113673