pydov

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

https://github.com/DOV-Vlaanderen/pydov

Science Score: 49.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 5 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (18.6%) to scientific vocabulary

Keywords

data-access lifewatch oscibio package python water

Keywords from Contributors

erosion rusle soil watem-sedem open-science weather
Last synced: 6 months ago · JSON representation

Repository

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

Basic Info
Statistics
  • Stars: 33
  • Watchers: 18
  • Forks: 19
  • Open Issues: 18
  • Releases: 18
Topics
data-access lifewatch oscibio package python water
Created about 9 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct Authors

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:

shell script 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:

shell script 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:

```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='dieptetotm', 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 pkeyboring boornummer x y mvmtaw startboringmtaw gemeente diepteboringvan diepteboringtot datumaanvang uitvoerder boorgatmeting dieptemethodevan dieptemethode_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

  • Name: Databank Ondergrond Vlaanderen
  • Login: DOV-Vlaanderen
  • Kind: organization

GitHub Events

Total
  • Create event: 20
  • Release event: 2
  • Watch event: 3
  • Delete event: 17
  • Issue comment event: 6
  • Member event: 1
  • Push event: 97
  • Pull request review event: 12
  • Pull request review comment event: 15
  • Pull request event: 36
Last Year
  • Create event: 20
  • Release event: 2
  • Watch event: 3
  • Delete event: 17
  • Issue comment event: 6
  • Member event: 1
  • Push event: 97
  • Pull request review event: 12
  • Pull request review comment event: 15
  • Pull request event: 36

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 1,407
  • Total Committers: 23
  • Avg Commits per committer: 61.174
  • Development Distribution Score (DDS): 0.721
Past Year
  • Commits: 23
  • Committers: 1
  • Avg Commits per committer: 23.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Roel Huybrechts r****s@r****m 393
Roel Huybrechts r****l@h****e 364
stijnvanhoey s****y@g****m 243
pjhaest g****t@g****m 148
JorisSynaeve j****e@g****m 46
Guillaume Vandekerckhove 7****e@u****m 46
Johan Van de Wauw j****n@g****e 41
Stijn Van Hoey s****n@f****m 32
GuillaumeVandekerckhove g****e@o****m 29
pieterjan p****t@a****e 19
Johan Van de Wauw j****w@g****m 8
Killian Paenen p****i@c****e 8
Peter Desmet p****k@g****m 8
B0hr t****s@g****m 6
BEGILT g****n@s****e 4
Johan Van de Wauw J****w@r****m 4
Joris Van den Bossche j****e@g****m 2
Gilles Trenson r****t@u****m 1
Guillaume Vandekerckhove g****e@v****e 1
Killian Paenen 3****n@u****m 1
jorissynaeve 3****e@u****m 1
marleenvd m****e@v****e 1
meisty s****6@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 44
  • Total pull requests: 117
  • Average time to close issues: 5 months
  • Average time to close pull requests: 25 days
  • Total issue authors: 19
  • Total pull request authors: 11
  • Average comments per issue: 3.2
  • Average comments per pull request: 0.66
  • Merged pull requests: 102
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 42
  • Average time to close issues: N/A
  • Average time to close pull requests: 10 days
  • Issue authors: 2
  • Pull request authors: 3
  • Average comments per issue: 0.5
  • Average comments per pull request: 0.19
  • Merged pull requests: 31
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
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)
Pull Request Authors
  • Roel (83)
  • GuillaumeVandekerckhove (9)
  • arnedegr (8)
  • rubenv-locus (4)
  • rebot (4)
  • jorissynaeve (3)
  • stijnvanhoey (2)
  • jorisvandenbossche (1)
  • kpaenen (1)
  • marleenvd (1)
  • pjhaest (1)
Top Labels
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)
Pull Request Labels
docs (8) CI (3) tests (3) enhancement (1)

Packages

  • Total packages: 3
  • Total downloads:
    • pypi 1,175 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 1
    (may contain duplicates)
  • Total versions: 57
  • Total maintainers: 2
proxy.golang.org: github.com/DOV-Vlaanderen/pydov
  • Versions: 19
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
proxy.golang.org: github.com/dov-vlaanderen/pydov
  • Versions: 19
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
pypi.org: pydov

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

  • Versions: 19
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 1,175 Last month
  • Docker Downloads: 0
Rankings
Docker downloads count: 4.1%
Dependent packages count: 7.3%
Forks count: 9.1%
Stargazers count: 11.4%
Average: 12.4%
Downloads: 20.3%
Dependent repos count: 22.1%
Maintainers (2)
Last synced: 6 months ago

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