Package: pydov
pydovpydov is a Python package to query and download data fromDatabank Ondergrond Vlaanderen (DOV). It is hosted onGitHuband 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 aweb application, whereas the focus of this package is tosupport machine-based extraction and conversion of the data.To get started, see the documentation athttps://pydov.readthedocs.io.Please note that downloading DOV data with pydov is governed by the samedisclaimerthat applies to the other DOV services. Be sure to consult it when using DOV data with pydov.InstallationYou can installpydovstable using pip:pipinstallpydovOr clone thegit repositoryand install withpython setup.py installto 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 therequirements_dev.txtfile. First, clone thegit repository.
We advice to use an Python development environment, for example withcondaorvirtualenv. Activate the (conda/virtualenv) environment and
install the package in development mode:pipinstall-e.[devs]Need more detailed instructions? Check out theinstallation instructionsand thedevelopment guidelines.Quick startRead thequick startfrom the docs or jump straight in:frompydov.search.boringimportBoringSearchfrompydov.util.locationimportWithin,Boxfromowslib.fes2importPropertyIsGreaterThanboringsearch=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 thelocationargument)
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    onbekendDocumentationFull documentation ofpydovcan be found on ourReadTheDocs page.ContributingYou 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 thecontributing page.MetaWe welcomecontributionsincluding bug reports.License: MITCitation information can be found onZenodo.Please note that this project is released with aContributor 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 samedisclaimerthat applies to the other DOV services. Be sure to consult it when using DOV data with pydov.