Metadata-Version: 2.1
Name: pydov
Version: 2.1.0
Summary: A Python package to download data from Databank Ondergrond Vlaanderen (DOV).
Home-page: https://github.com/DOV-Vlaanderen/pydov
Author: DOV-Vlaanderen
Author-email: dov@vlaanderen.be
License: MIT license
Description: # pydov <img src="docs/_static/img/logo.png" align="right" alt="" width="120">
        
        ![CI](https://github.com/DOV-Vlaanderen/pydov/workflows/CI/badge.svg) [![Documentation Status](https://readthedocs.org/projects/pydov/badge/?version=latest)](https://pydov.readthedocs.io/en/latest/?badge=latest) [![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active) [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.2788680.svg)](https://doi.org/10.5281/zenodo.2788680) [![pyOpenSci](https://camo.githubusercontent.com/63ff31cdb80a06361e53ac2b9ac0d184118ebd0b/68747470733a2f2f74696e7975726c2e636f6d2f7932326e62387570)](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.fes 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.
        
Keywords: pydov
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Natural Language :: Dutch
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering
Description-Content-Type: text/markdown
Provides-Extra: docs
Provides-Extra: devs
Provides-Extra: vectorfile
