{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# Example of DOV search methods for interpretations (informele hydrogeologische stratigrafie)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "[](https://mybinder.org/v2/gh/DOV-Vlaanderen/pydov/master?filepath=docs%2Fnotebooks%2Fsearch_informele_hydrostratigrafie.ipynb)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Use cases explained below\n", "* Get 'informele hydrogeologische stratigrafie' in a bounding box\n", "* Get 'informele hydrogeologische stratigrafie' with specific properties\n", "* Get 'informele hydrogeologische stratigrafie' in a bounding box based on specific properties\n", "* Select 'informele hydrogeologische stratigrafie' in a municipality and return date\n", "* Get 'informele hydrogeologische stratigrafie' based on fields not available in the standard output dataframe\n", "* Get 'informele hydrogeologische stratigrafie' data, returning fields not available in the standard output dataframe" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "%matplotlib inline\n", "import inspect, sys" ] }, { "cell_type": "code", "execution_count": 2, "metadata": {}, "outputs": [], "source": [ "# check pydov path\n", "import pydov" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Get information about the datatype 'Informele hydrogeologische stratigrafie'" ] }, { "cell_type": "code", "execution_count": 3, "metadata": {}, "outputs": [], "source": [ "from pydov.search.interpretaties import InformeleHydrogeologischeStratigrafieSearch\n", "itp = InformeleHydrogeologischeStratigrafieSearch()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "A description is provided for the 'Informele stratigrafie' datatype:" ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [ { "data": { "text/plain": [ "'Een informele hydrogeologische stratigrafie van een boring geeft, op basis van de (gecodeerde) lithologie, een indeling weer naar de al dan niet watervoerende eigenschappen van een bepaald beschreven diepte-interval. \\r\\nHet verschil met de hydrogeologische stratigrafie is dat voor de informele hydrogeologische stratigrafie geen algemene standaard gebruikt wordt. Bij de hydrogeologische stratigrafie wordt de Hydrogeologische Codering van de Ondergrond van Vlaanderen (HCOV). Deze kan beschouwd worden als de officiele hydrogeologische codering voor het Vlaams Gewest.'" ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "itp.get_description()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The different fields that are available for objects of the 'Informele hydrogeologische stratigrafie' datatype can be requested with the get_fields() method:" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "pkey_interpretatie\n", "Type_proef\n", "Proefnummer\n", "pkey_boring\n", "x\n", "y\n", "start_interpretatie_mtaw\n", "diepte_tot_m\n", "gemeente\n", "Auteurs\n", "Datum\n", "Opdrachten\n", "betrouwbaarheid_interpretatie\n", "Geldig_van\n", "Geldig_tot\n", "eerste_invoer\n", "geom\n", "diepte_laag_van\n", "diepte_laag_tot\n", "beschrijving\n" ] } ], "source": [ "fields = itp.get_fields()\n", "\n", "# print available fields\n", "for f in fields.values():\n", " print(f['name'])" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "You can get more information of a field by requesting it from the fields dictionary:\n", "* *name*: name of the field\n", "* *definition*: definition of this field\n", "* *cost*: currently this is either 1 or 10, depending on the datasource of the field. It is an indication of the expected time it will take to retrieve this field in the output dataframe.\n", "* *notnull*: whether the field is mandatory or not\n", "* *type*: datatype of the values of this field\n", "\n", "Alternatively, you can list all the fields and their details by inspecting the `get_fields()` output or the search instance itself in a notebook:" ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [ { "data": { "text/html": [ "\n", " \n", "
Een informele hydrogeologische stratigrafie van een boring geeft, op basis van de (gecodeerde) lithologie, een indeling weer naar de al dan niet watervoerende eigenschappen van een bepaald beschreven diepte-interval. \r\n", "Het verschil met de hydrogeologische stratigrafie is dat voor de informele hydrogeologische stratigrafie geen algemene standaard gebruikt wordt. Bij de hydrogeologische stratigrafie wordt de Hydrogeologische Codering van de Ondergrond van Vlaanderen (HCOV). Deze kan beschouwd worden als de officiele hydrogeologische codering voor het Vlaams Gewest.
pkey_interpretatie - URL die verwijst naar de gegevens van deze informele hydrogeologische stratigrafie op de website. Voeg '.xml' toe om een XML voorstelling van deze gegevens te verkrijgen.
Type_proef - Het type van de proef waarvan de informele hydrogeologische stratigrafie een interpretatie is. Bij een informele hydrogeologische stratigrafie zal dit altijd 'Boring' zijn.
Boring - Boring - De informele hydrogeologische stratigrafie is een interpretatie van een boring.
\n", "Proefnummer - Het proefnummer van de boring waarvan de informele hydrogeologische stratigrafie een interpretatie is.
pkey_boring - URL die verwijst naar de gegevens van de boring op de website. Voeg '.xml' toe om een XML voorstelling van deze gegevens te verkrijgen.
x - De x-coördinaat van de boring in het Lambert72 coördinaatsysteem (in meter, EPSG:31370).
y - De y-coördinaat van de boring in het Lambert72 coördinaatsysteem (in meter, EPSG:31370).
start_interpretatie_mtaw - De hoogte van het aanvangspeil van de boring in het TAW stelsel (in meter).
diepte_tot_m - De maximumdiepte van de informele hydrogeologische stratigrafie in meter. Dit is de 'tot' van de diepste geïnterpreteerde laag.
gemeente - De gemeente waarin de boring van deze interpretatie gelegen is.
Auteurs - De auteur of auteurs van de informele hydrogeologische stratigrafie.
Datum - De datum waarop de informele hydrogeologische stratigrafie werd beschreven.
Opdrachten - De opdracht(en) waaraan de informele hydrogeologische stratigrafie gekoppeld is.
betrouwbaarheid_interpretatie - De betrouwbaarheid van het geheel van de informele hydrogeologische stratigrafie (goed, twijfelachtig of onbekend). Deze wordt toegekend door een DOV-medewerker verantwoordelijk voor de ingave.
Geldig_van - Het tijdstip vanaf wanneer de informele hydrogeologische stratigrafie geldig is.
Geldig_tot - Het tijdstip tot wanneer de informele hydrogeologische stratigrafie geldig is.
eerste_invoer - Het tijdstip waarop deze interpretatie voor het eerst in DOV ingevoerd werd.
geom - None
diepte_laag_van - Diepte van de bovenkant van de laag informele hydrostratigrafie in meter.
diepte_laag_tot - Diepte van de onderkant van de laag informele hydrostratigrafie in meter.
beschrijving - Benoeming van de eenheid van de laag informele hydrostratigrafie in vrije tekst (onbeperkt in lengte).
| \n", " | pkey_interpretatie | \n", "pkey_boring | \n", "betrouwbaarheid_interpretatie | \n", "x | \n", "y | \n", "start_interpretatie_mtaw | \n", "diepte_laag_van | \n", "diepte_laag_tot | \n", "beschrijving | \n", "
|---|---|---|---|---|---|---|---|---|---|
| 0 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "0.0 | \n", "2.5 | \n", "QUARTAIR | \n", "
| 1 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "2.5 | \n", "13.6 | \n", "FORMATIE VAN MALDEGEM | \n", "
| 2 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "13.6 | \n", "25.5 | \n", "FORMATIE VAN MALDEGEM (Lid van Wemmel) | \n", "
| 3 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "25.5 | \n", "33.2 | \n", "FORMATIE VAN LEDE | \n", "
| 4 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "33.2 | \n", "67.3 | \n", "FORMATIE VAN BRUSSEL | \n", "
| \n", " | pkey_interpretatie | \n", "pkey_boring | \n", "betrouwbaarheid_interpretatie | \n", "x | \n", "y | \n", "start_interpretatie_mtaw | \n", "diepte_laag_van | \n", "diepte_laag_tot | \n", "beschrijving | \n", "
|---|---|---|---|---|---|---|---|---|---|
| 0 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "0.0 | \n", "2.5 | \n", "QUARTAIR | \n", "
| 1 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "2.5 | \n", "13.6 | \n", "FORMATIE VAN MALDEGEM | \n", "
| 2 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "13.6 | \n", "25.5 | \n", "FORMATIE VAN MALDEGEM (Lid van Wemmel) | \n", "
| 3 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "25.5 | \n", "33.2 | \n", "FORMATIE VAN LEDE | \n", "
| 4 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "33.2 | \n", "67.3 | \n", "FORMATIE VAN BRUSSEL | \n", "
| \n", " | pkey_interpretatie | \n", "pkey_boring | \n", "betrouwbaarheid_interpretatie | \n", "x | \n", "y | \n", "start_interpretatie_mtaw | \n", "diepte_laag_van | \n", "diepte_laag_tot | \n", "beschrijving | \n", "
|---|---|---|---|---|---|---|---|---|---|
| 0 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "0.0 | \n", "2.5 | \n", "QUARTAIR | \n", "
| 1 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "2.5 | \n", "13.6 | \n", "FORMATIE VAN MALDEGEM | \n", "
| 2 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "13.6 | \n", "25.5 | \n", "FORMATIE VAN MALDEGEM (Lid van Wemmel) | \n", "
| 3 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "25.5 | \n", "33.2 | \n", "FORMATIE VAN LEDE | \n", "
| 4 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "goed | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "33.2 | \n", "67.3 | \n", "FORMATIE VAN BRUSSEL | \n", "
| \n", " | Datum | \n", "
|---|---|
| 0 | \n", "1981-01-01 | \n", "
| \n", " | Datum | \n", "
|---|---|
| count | \n", "1 | \n", "
| unique | \n", "1 | \n", "
| top | \n", "1981-01-01 | \n", "
| freq | \n", "1 | \n", "
| \n", " | pkey_interpretatie | \n", "Datum | \n", "
|---|---|---|
| 0 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "1981-01-01 | \n", "
| \n", " | pkey_interpretatie | \n", "pkey_boring | \n", "x | \n", "y | \n", "start_interpretatie_mtaw | \n", "gemeente | \n", "Auteurs | \n", "Proefnummer | \n", "
|---|---|---|---|---|---|---|---|---|
| 0 | \n", "https://www.dov.vlaanderen.be/data/interpretat... | \n", "https://www.dov.vlaanderen.be/data/boring/1981... | \n", "172148.5 | \n", "182587.5 | \n", "10.94 | \n", "Rotselaar | \n", "Onbekend - Vlaamse Maatschappij voor Watervoor... | \n", "B/3005-016 | \n", "