Select datasets

To get started with pydov you should first determine which information you want to search for. DOV provides a lot of different datasets about soil, subsoil and groundwater of Flanders, most of which can be queried using pydov.

Depending on the type of data you want to query, you need a different search class instance. To search for boreholes for instance, you’d write:

from pydov.search.boring import BoringSearch

borehole_search = BoringSearch()
# df = borehole_search.search(...)

While you’ll need to instantiate a different search class for each datatype, querying the datatypes from then on is similar as each one supports the same search() method. You can use similar queries for each of them, filtering on attributes, location, sorting, limiting, and customizing the output fields.

Generally the datasets consist of a main type and a subtype, where the resulting dataframe will contain multiple records for each instance of the main type based on the records of the subtype (you can think of this as a ‘left join’ between the main and the subtype).

Some datasets have extra fieldsets available, that are not used by default but can be enabled easily. More information on how to find and enable them can be consulted in the adding extra fields section. For example, you could write:

from pydov.search.boring import BoringSearch
from pydov.types.boring import Boring, MethodeXyz

borehole_search = BoringSearch(
    objecttype=Boring.with_extra_fields(MethodeXyz)
)
# df = borehole_search.search(...)

For some datasets, multiple subtypes are available. One of them will be used by default, but you can easily select the subtype of your interest. More information on how to find the available subtypes and how to enable them can be found in the adding or switching subtypes section. For example, you could write:

from pydov.search.boring import BoringSearch
from pydov.types.boring import Boring, Kleur

borehole_search = BoringSearch(
    objecttype=Boring.with_subtype(Kleur)
)
# df = borehole_search.search(...)

Currently, we support the following datasets:

Soil

Soil sites (Bodemsites)

Type

Bodemsite (Soil site)

Subtype

No subtype

Search class

pydov.search.bodemsite.BodemsiteSearch

Default dataframe output
Soil sites (Bodemsites)

Field

Source

Cost

Datatype

Example

pkey_bodemsite

Bodemsite

1

string

https://www.dov.vlaanderen.be/data/bodemsite/2013-000180

naam

Bodemsite

1

string

Meise_Neerpoorten

waarnemingsdatum

Bodemsite

1

date

nan

beschrijving

Bodemsite

1

string

grasland

invoerdatum

Bodemsite

10

date

nan

Soil plots (Bodemlocaties)

Type

Bodemlocatie (Soil plot)

Subtype

No subtype

Search class

pydov.search.bodemlocatie.BodemlocatieSearch

Default dataframe output
Soil plots (Bodemlocaties)

Field

Source

Cost

Datatype

Example

pkey_bodemlocatie

Bodemlocatie

1

string

https://www.dov.vlaanderen.be/data/bodemlocatie/2011-000002

pkey_bodemsite

Bodemlocatie

1

string

https://www.dov.vlaanderen.be/data/bodemsite/2011-000245

naam

Bodemlocatie

1

string

STARC_4

type

Bodemlocatie

1

string

profielput

waarnemingsdatum

Bodemlocatie

1

date

nan

doel

Bodemlocatie

1

string

archeologische landschappelijke profielputten

x

Bodemlocatie

1

float

206553.85

y

Bodemlocatie

1

float

168891.11

mv_mtaw

Bodemlocatie

1

float

44.00

erfgoed

Bodemlocatie

1

boolean

true

bodemstreek

Bodemlocatie

1

string

Zandleemstreek

invoerdatum

Bodemlocatie

10

date

nan

educatieve_waarde

Bodemlocatie

10

string

ZEER

Soil intervals (Bodemdiepteintervallen)

Type

Bodemdiepteinterval (Soil interval)

Subtype

No subtype

Search class

pydov.search.bodemdiepteinterval.BodemdiepteintervalSearch

Default dataframe output
Soil intervals (Bodemdiepteintervallen)

Field

Source

Cost

Datatype

Example

pkey_diepteinterval

Bodemdiepteinterval

1

string

https://www.dov.vlaanderen.be/data/bodemdiepteinterval/2018-000003

pkey_bodemopbouw

Bodemdiepteinterval

1

string

https://www.dov.vlaanderen.be/data/bodemopbouw/2018-000001

pkey_bodemlocatie

Bodemdiepteinterval

1

string

https://www.dov.vlaanderen.be/data/bodemlocatie/2014-000001

nr

Bodemdiepteinterval

1

integer

3

type

Bodemdiepteinterval

1

string

horizont

naam

Bodemdiepteinterval

1

string

Bg

bovengrens1_cm

Bodemdiepteinterval

1

float

40.0

bovengrens2_cm

Bodemdiepteinterval

1

float

NaN

ondergrens1_cm

Bodemdiepteinterval

1

float

65.0

ondergrens2_cm

Bodemdiepteinterval

1

float

NaN

ondergrens_bereikt

Bodemdiepteinterval

1

string

NVT

grensduidelijkheid

Bodemdiepteinterval

1

string

abrupt - overgang 0-2 cm breed

grensregelmatigheid

Bodemdiepteinterval

1

string

bijna vlak

beschrijving

Bodemdiepteinterval

1

string

onverweerd moedermateriaal met gleyverschijnselen

x

Bodemdiepteinterval

1

float

187237.11

y

Bodemdiepteinterval

1

float

163028.83

mv_mtaw

Bodemdiepteinterval

1

float

49.0

Soil samples (Bodemmonsters)

See generic type for Monster.

Soil observations (Bodemobservaties)

See generic type for Observatie.

Soil classifications (Bodemclassificaties)

Type

Bodemclassificatie (Soil classification)

Subtype

No subtype

Search class

pydov.search.bodemclassificatie.BodemclassificatieSearch

Default dataframe output
Soil classifications (Bodemclassificaties)

Field

Source

Cost

Datatype

Example

pkey_bodemclassificatie

Bodemclassificatie

1

string

https://www.dov.vlaanderen.be/data/belgischebodemclassificatie/2018-000146

pkey_bodemlocatie

Bodemclassificatie

1

string

https://www.dov.vlaanderen.be/data/bodemlocatie/2015-000146

x

Bodemclassificatie

1

float

248905.67

y

Bodemclassificatie

1

float

200391.29

mv_mtaw

Bodemclassificatie

1

float

32.9

classificatietype

Bodemclassificatie

1

string

Algemene Belgische classificatie

bodemtype

Bodemclassificatie

1

string

Scbz

auteurs

Bodemclassificatie

1

string

Dondeyne Stefaan (KULeuven)

Subsoil

Boreholes (Boringen)

Type

Boring (Borehole)

Extra fieldsets

  • MethodeXyz (Method of geolocation) - Method and quality assessment of geolocation of the borehole.

Subtypes

  • BoorMethode (Method) (default) - Method used to create the borehole, per depth interval.

  • Kleur (Colour) - Colour of the soil retrieved from the borehole, per depth interval.

Search class

pydov.search.boring.BoringSearch

Default dataframe output
Boreholes (boringen)

Field

Source

Cost

Datatype

Example

pkey_boring

Boring

1

string

https://www.dov.vlaanderen.be/data/boring/1930-120730

boornummer

Boring

1

string

kb15d28w-B164

x

Boring

1

float

152301.0

y

Boring

1

float

211682.0

mv_mtaw

Boring

10

float

8.00

start_boring_mtaw

Boring

1

float

8.00

gemeente

Boring

1

string

Wuustwezel

diepte_boring_van

Boring

10

float

0.00

diepte_boring_tot

Boring

1

float

19.00

datum_aanvang

Boring

1

date

1930-10-01

uitvoerder

Boring

1

string

Smet - Dessel

boorgatmeting

Boring

10

boolean

false

diepte_methode_van

BoorMethode

10

float

0.00

diepte_methode_tot

BoorMethode

10

float

19.00

boormethode

BoorMethode

10

string

droge boring
Extra fieldsets

pydov.types.boring.MethodeXyz

Extra fields to be used with the Boring type which add details regarding the method and reliability of its location.

MethodeXyz

Field

Source

Cost

Datatype

Example

methode_xy

MethodeXyz

10

string

gedigitaliseerd op topokaart

betrouwbaarheid_xy

MethodeXyz

10

string

onbekend

methode_z

MethodeXyz

10

string

afgeleid van topokaart

betrouwbaarheid_z

MethodeXyz

10

string

onbekend
Extra subtypes

pydov.types.boring.Kleur

Extra subtype which adds details regarding the colour of the layers from the borehole.

Kleur

Field

Source

Cost

Datatype

Example

diepte_kleur_van

Kleur

10

0.0

diepte_kleur_tot

Kleur

10

1.25

kleur

Kleur

10

bruin

Borehole samples (Grondmonsters)

See generic types for Monster and Observatie.

CPT measurements (Sonderingen)

Type

Sondering (CPT measurement)

Subtypes

  • Meetdata (CPT data) (default) - CPT measurement at each depth.

  • Techniek (technique) - Techniques used while performing the CPT measurement.

Search class

pydov.search.sondering.SonderingSearch

Default dataframe output
CPT measurements (sonderingen)

Field

Source

Cost

Datatype

Example

pkey_sondering

Sondering

1

string

https://www.dov.vlaanderen.be/data/sondering/2002-010317

sondeernummer

Sondering

1

string

GEO-02/079-S3

x

Sondering

1

float

142767

y

Sondering

1

float

221907

mv_mtaw

Sondering

10

float

NaN

start_sondering_mtaw

Sondering

1

float

2.39

diepte_sondering_van

Sondering

1

float

0

diepte_sondering_tot

Sondering

1

float

16

datum_aanvang

Sondering

1

date

2002-07-04

uitvoerder

Sondering

1

string

MVG - Afdeling Geotechniek

sondeermethode

Sondering

1

string

continu elektrisch

apparaat

Sondering

1

string

200kN - RUPS

datum_gw_meting

Sondering

10

datetime

2002-07-04 13:50:00

diepte_gw_m

Sondering

10

float

1.2

lengte

Meetdata

10

float

1.2

diepte

Meetdata

10

float

1.2

qc

Meetdata

10

float

0.68

Qt

Meetdata

10

float

NaN

fs

Meetdata

10

float

10

u

Meetdata

10

float

7

i

Meetdata

10

float

0.1
Extra subtypes

pydov.types.sondering.Techniek

Extra subtype which adds details regarding technique used for the CPT measurement.

Techniek

Field

Source

Cost

Datatype

Example

techniek_diepte_van

Techniek

10

float

5.5

techniek_diepte

Techniek

10

float

1.2

techniek

Techniek

10

string

V

techniek_andere

Techniek

10

string

Formal stratigraphy (Formele stratigrafie)

Type

FormeleStratigrafie (Formal stratigraphy)

Subtype

FormeleStratigrafieLaag (Formal stratigraphy layer)

Search class

pydov.search.interpretaties.FormeleStratigrafieSearch

Default dataframe output
Formal stratigraphy (Formele stratigrafie)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

FormeleStratigrafie

1

string

https://www.dov.vlaanderen.be/data/interpretatie/2002-227082

pkey_boring

FormeleStratigrafie

1

string

NaN

pkey_sondering

FormeleStratigrafie

1

string

https://www.dov.vlaanderen.be/data/sondering/1989-068788

betrouwbaarheid_interpretatie

FormeleStratigrafie

1

string

goed

x

FormeleStratigrafie

1

float

108455

y

FormeleStratigrafie

1

float

194565

start_interpretatie_mtaw

FormeleStratigrafie

1

float

6.62

diepte_laag_van

FormeleStratigrafieLaag

10

float

0

diepte_laag_tot

FormeleStratigrafieLaag

10

float

13

lid1

FormeleStratigrafieLaag

10

string

Q

relatie_lid1_lid2

FormeleStratigrafieLaag

10

string

T

lid2

FormeleStratigrafieLaag

10

string

Q

Informal stratigraphy (Informele stratigrafie)

Type

InformeleStratigrafie (Informal stratigraphy)

Subtype

InformeleStratigrafieLaag (Informal stratigraphy layer)

Search class

pydov.search.interpretaties.InformeleStratigrafieSearch

Default dataframe output
Informal stratigraphy (Informele stratigrafie)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

InformeleStratigrafie

1

string

https://www.dov.vlaanderen.be/data/interpretatie/2016-290843

pkey_boring

InformeleStratigrafie

1

string

https://www.dov.vlaanderen.be/data/boring/1893-073690

pkey_sondering

InformeleStratigrafie

1

string

NaN

betrouwbaarheid_interpretatie

InformeleStratigrafie

1

string

onbekend

x

InformeleStratigrafie

1

float

108900

y

InformeleStratigrafie

1

float

194425

start_interpretatie_mtaw

InformeleStratigrafie

1

float

6.00

diepte_laag_van

InformeleStratigrafieLaag

10

float

0

diepte_laag_tot

InformeleStratigrafieLaag

10

float

18.58

beschrijving

InformeleStratigrafieLaag

10

string

Q

Hydrogeological stratigraphy (Hydrogeologische stratigrafie)

Type

HydrogeologischeStratigrafie (Hydrogeological stratigraphy)

Subtype

HydrogeologischeStratigrafieLaag (Hydrogeological stratigraphy layer)

Search class

pydov.search.interpretaties.HydrogeologischeStratigrafieSearch

Default dataframe output
Hydrogeological stratigraphy (Hydrogeologische stratigrafie)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

HydrogeologischeStratigrafie

1

string

https://www.dov.vlaanderen.be/data/interpretatie/2001-198755

pkey_boring

HydrogeologischeStratigrafie

1

string

https://www.dov.vlaanderen.be/data/boring/1890-073688

betrouwbaarheid_interpretatie

HydrogeologischeStratigrafie

1

string

goed

x

HydrogeologischeStratigrafie

1

float

108773

y

HydrogeologischeStratigrafie

1

float

194124

start_interpretatie_mtaw

HydrogeologischeStratigrafie

1

float

7.00

diepte_laag_van

HydrogeologischeStratigrafieLaag

10

float

0

diepte_laag_tot

HydrogeologischeStratigrafieLaag

10

float

8

aquifer

HydrogeologischeStratigrafieLaag

10

string

0110

Informal hydrogeological stratigraphy (Informele hydrogeologische stratigrafie)

Type

InformeleHydrogeologischeStratigrafie (Informal hydrogeological stratigraphy)

Subtype

InformeleHydrogeologischeStratigrafieLaag (Informal hydrogeological stratigraphy layer)

Search class

pydov.search.interpretaties.InformeleHydrogeologischeStratigrafieSearch

Default dataframe output
Informal hydrogeological stratigraphy (Informele hydrogeologische stratigrafie)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

InformeleHydrogeologischeStratigrafie

1

string

https://www.dov.vlaanderen.be/data/interpretatie/2003-297769

pkey_boring

InformeleHydrogeologischeStratigrafie

1

string

https://www.dov.vlaanderen.be/data/boring/2003-147935

betrouwbaarheid_interpretatie

InformeleHydrogeologischeStratigrafie

1

string

goed

x

InformeleHydrogeologischeStratigrafie

1

float

208607

y

InformeleHydrogeologischeStratigrafie

1

float

210792

start_interpretatie_mtaw

InformeleHydrogeologischeStratigrafie

1

float

38.94

diepte_laag_van

InformeleHydrogeologischeStratigrafieLaag

10

float

0

diepte_laag_tot

InformeleHydrogeologischeStratigrafieLaag

10

float

1.5

beschrijving

InformeleHydrogeologischeStratigrafieLaag

10

string

Quartair

Coded lithology (Gecodeerde lithologie)

Type

GecodeerdeLithologie (Coded lithology)

Subtype

GecodeerdeLithologieLaag (Coded lithology layer)

Search class

pydov.search.interpretaties.GecodeerdeLithologieSearch

Default dataframe output
Coded lithology (Gecodeerde lithologie)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

GecodeerdeLithologie

1

string

https://www.dov.vlaanderen.be/data/interpretatie/2003-205091

pkey_boring

GecodeerdeLithologie

1

string

https://www.dov.vlaanderen.be/data/boring/2003-076348

betrouwbaarheid_interpretatie

GecodeerdeLithologie

1

string

goed

x

GecodeerdeLithologie

1

float

110601

y

GecodeerdeLithologie

1

float

196625

start_interpretatie_mtaw

GecodeerdeLithologie

1

float

6.38

diepte_laag_van

GecodeerdeLithologieLaag

10

float

4

diepte_laag_tot

GecodeerdeLithologieLaag

10

float

4.5

hoofdnaam1_grondsoort

GecodeerdeLithologieLaag

10

string

MZ

hoofdnaam2_grondsoort

GecodeerdeLithologieLaag

10

string

NaN

bijmenging1_plaatselijk

GecodeerdeLithologieLaag

10

boolean

False

bijmenging1_hoeveelheid

GecodeerdeLithologieLaag

10

string

N

bijmenging1_grondsoort

GecodeerdeLithologieLaag

10

string

SC

bijmenging2_plaatselijk

GecodeerdeLithologieLaag

10

boolean

NaN

bijmenging2_hoeveelheid

GecodeerdeLithologieLaag

10

string

NaN

bijmenging2_grondsoort

GecodeerdeLithologieLaag

10

string

NaN

bijmenging3_plaatselijk

GecodeerdeLithologieLaag

10

boolean

NaN

bijmenging3_hoeveelheid

GecodeerdeLithologieLaag

10

string

NaN

bijmenging3_grondsoort

GecodeerdeLithologieLaag

10

string

NaN

Geotechnical encoding (Geotechnische codering)

Type

GeotechnischeCodering (Geotechnical encoding)

Subtype

GeotechnischeCoderingLaag (Geotechnical encoding layer)

Search class

pydov.search.interpretaties.GeotechnischeCoderingSearch

Default dataframe output
Geotechnical encoding (Geotechnische codering)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

GeotechnischeCodering

1

string

https://www.dov.vlaanderen.be/data/interpretatie/2014-184535

pkey_boring

GeotechnischeCodering

1

string

https://www.dov.vlaanderen.be/data/boring/1957-033538

betrouwbaarheid_interpretatie

GeotechnischeCodering

1

string

goed

x

GeotechnischeCodering

1

float

108851

y

GeotechnischeCodering

1

float

196510

start_interpretatie_mtaw

GeotechnischeCodering

1

float

10.55

diepte_laag_van

GeotechnischeCoderingLaag

10

float

1

diepte_laag_tot

GeotechnischeCoderingLaag

10

float

1.5

hoofdnaam1_grondsoort

GeotechnischeCoderingLaag

10

string

XZ

hoofdnaam2_grondsoort

GeotechnischeCoderingLaag

10

string

NaN

bijmenging1_plaatselijk

GeotechnischeCoderingLaag

10

boolean

NaN

bijmenging1_hoeveelheid

GeotechnischeCoderingLaag

10

string

NaN

bijmenging1_grondsoort

GeotechnischeCoderingLaag

10

string

NaN

bijmenging2_plaatselijk

GeotechnischeCoderingLaag

10

boolean

NaN

bijmenging2_hoeveelheid

GeotechnischeCoderingLaag

10

string

NaN

bijmenging2_grondsoort

GeotechnischeCoderingLaag

10

string

NaN

bijmenging3_plaatselijk

GeotechnischeCoderingLaag

10

boolean

NaN

bijmenging3_hoeveelheid

GeotechnischeCoderingLaag

10

string

NaN

bijmenging3_grondsoort

GeotechnischeCoderingLaag

10

string

NaN

Lithological descriptions (Lithologische beschrijvingen)

Type

LithologischeBeschrijvingen (Lithological descriptions)

Subtype

LithologischeBeschrijvingenLaag (Lithological descriptions layer)

Search class

pydov.search.interpretaties.LithologischeBeschrijvingenSearch

Default dataframe output
Lithological descriptions (Lithologische beschrijvingen)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

LithologischeBeschrijvingen

1

string

https://www.dov.vlaanderen.be/data/interpretatie/2017-302166

pkey_boring

LithologischeBeschrijvingen

1

string

https://www.dov.vlaanderen.be/data/boring/2017-151410

betrouwbaarheid_interpretatie

LithologischeBeschrijvingen

1

string

onbekend

x

LithologischeBeschrijvingen

1

float

109491

y

LithologischeBeschrijvingen

1

float

196700

start_interpretatie_mtaw

LithologischeBeschrijvingen

1

float

7.90

diepte_laag_van

LithologischeBeschrijvingenLaag

10

float

0

diepte_laag_tot

LithologischeBeschrijvingenLaag

10

float

1

beschrijving

LithologischeBeschrijvingenLaag

10

string

klei/zand

Quaternary stratigraphy (Quartair stratigrafie)

Type

QuartairStratigrafie (Quaternary stratigraphy)

Subtype

QuartairStratigrafieLaag (Quaternary stratigraphy layer)

Search class

pydov.search.interpretaties.QuartairStratigrafieSearch

Default dataframe output
Quaternary stratigraphy (Quartaire stratigrafie)

Field

Source

Cost

Datatype

Example

pkey_interpretatie

QuartairStratigrafie

1

string

https://www.dov.vlaanderen.be/data/interpretatie/1999-057087

pkey_boring

QuartairStratigrafie

1

string

https://www.dov.vlaanderen.be/data/boring/1941-000322

betrouwbaarheid_interpretatie

QuartairStratigrafie

1

string

onbekend

x

QuartairStratigrafie

1

float

128277

y

QuartairStratigrafie

1

float

178987

start_interpretatie_mtaw

QuartairStratigrafie

1

float

9.56

diepte_laag_van

QuartairStratigrafieLaag

10

float

0

diepte_laag_tot

QuartairStratigrafieLaag

10

float

8

lid1

QuartairStratigrafieLaag

10

string

F1

relatie_lid1_lid2

QuartairStratigrafieLaag

10

string

T

lid2

QuartairStratigrafieLaag

10

string

F1

Groundwater

Groundwater screens (Grondwaterfilters)

Type

GrondwaterFilter (Groundwater screen)

Subtypes

  • Peilmeting (Water head level) (default) - Water head level measurements over time.

  • Gxg - Average water head levels per calendar year.

Search class

pydov.search.grondwaterfilter.GrondwaterFilterSearch

Remarks

Mind that the timeseries contains two columns referring to the time: datum and tijdstip, with datatype date, respectively string. This distinction is required because the tijdstip field is not mandatory whereas the date is. It is up to the user to combine these fields in a datetime object if required.

Default dataframe output
Groundwater screens (grondwaterfilters)

Field

Source

Cost

Datatype

Example

pkey_filter

GrondwaterFilter

1

string

https://www.dov.vlaanderen.be/data/filter/1989-001024

pkey_grondwaterlocatie

GrondwaterFilter

1

string

https://www.dov.vlaanderen.be/data/put/2017-000200

gw_id

GrondwaterFilter

1

string

4-0053

filternummer

GrondwaterFilter

1

string

1

filtertype

GrondwaterFilter

1

string

peilfilter

x

GrondwaterFilter

1

float

110490

y

GrondwaterFilter

1

float

194090

start_grondwaterlocatie_mtaw

GrondwaterFilter

1

float

NaN

mv_mtaw

GrondwaterFilter

10

float

NaN

gemeente

GrondwaterFilter

1

string

Destelbergen

meetnet_code

GrondwaterFilter

10

string

1

aquifer_code

GrondwaterFilter

10

string

A0100

grondwaterlichaam_code

GrondwaterFilter

10

string

CVS_0160_GWL_1

regime

GrondwaterFilter

10

string

freatisch

diepte_onderkant_filter

GrondwaterFilter

1

float

13

lengte_filter

GrondwaterFilter

1

float

2

datum

Peilmeting

10

date

2004-05-18

tijdstip

Peilmeting

10

string

NaN

peil_mtaw

Peilmeting

10

float

4.6

betrouwbaarheid

Peilmeting

10

string

goed

methode

Peilmeting

10

string

peillint

filterstatus

Peilmeting

10

string

1

filtertoestand

Peilmeting

10

string

in rust
Extra subtypes

pydov.types.grondwaterfilter.Gxg

Extra subtype which adds details regarding the average water head level per year.

Gxg

Field

Source

Cost

Datatype

Example

gxg_jaar

Gxg

10

integer

2001

gxg_hg3

Gxg

10

float

3.03

gxg_lg3

Gxg

10

float

2.14

gxg_vg3

Gxg

10

float

3.2

Groundwater samples (Grondwatermonsters)

See generic types for Monster and Observatie.

Groundwater permits (Grondwatervergunningen)

Type

GrondwaterVergunning (Groundwater permit)

Subtype

No subtype

Search class

pydov.search.grondwatervergunning.GrondwaterVergunningSearch

Default dataframe output
Groundwater permits (grondwatervergunningen)

Field

Source

Cost

Datatype

Example

id_vergunning

GrondwaterVergunning

1

string

66229

pkey_installatie

GrondwaterVergunning

1

string

https://www.dov.vlaanderen.be/data/installatie/2020-093103

x

GrondwaterVergunning

1

float

157403.75

y

GrondwaterVergunning

1

float

214471.32

diepte

GrondwaterVergunning

1

float

10.0

exploitant_naam

GrondwaterVergunning

1

string

AQUAFIN

watnr

GrondwaterVergunning

1

string

VLA-0019-A

vlaremrubriek

GrondwaterVergunning

1

string

53.2.2.b)2

vergund_jaardebiet

GrondwaterVergunning

1

float

493000.0

vergund_dagdebiet

GrondwaterVergunning

1

float

nan

van_datum_termijn

GrondwaterVergunning

1

date

2019-08-09

tot_datum_termijn

GrondwaterVergunning

1

date

nan

aquifer_vergunning

GrondwaterVergunning

1

string

A0200: Kempens Aquifersysteem

inrichtingsklasse

GrondwaterVergunning

1

string

Klasse 1 - Vlaams project

nacebelcode

GrondwaterVergunning

1

string

37000: Afvalwaterafvoer

actie_waakgebied

GrondwaterVergunning

1

string

nan

cbbnr

GrondwaterVergunning

1

string

00418870000022

kbonr

GrondwaterVergunning

1

string

044691388

Generic

Samples (Monsters)

Type

Monster (Sample)

Extra fieldsets

  • MonsterDetails (Details of sample) - For instance the time the sample was taken.

Subtypes

  • BemonsterdObject (Sampled object) - More information about the sampled object(s) of a sample.

  • Opslaglocatie (Location of sample) - More information about the storage location of a sample.

  • Monsterbehandeling (Sample treatment) - More information about the treatment of a sample.

Search class

pydov.search.monster.MonsterSearch

Default dataframe output
Samples (monsters)

Field

Source

Cost

Datatype

Example

pkey_monster

Monster

1

string

https://www.dov.vlaanderen.be/data/monster/2017-141452

naam

Monster

1

string

000/00/2/M1

pkey_parents

Monster

1

tuple of string

(https://www.dov.vlaanderen.be/data/boring/2003-025366

)

materiaalklasse

Monster

1

string

sediment

datum_monstername

Monster

1

date

2003-04-08

diepte_van_m

Monster

1

float

0.90

diepte_tot_m

Monster

1

float

1.00

monstertype

Monster

1

string

geroerd

monstersamenstelling

Monster

1

string

ENKELVOUDIG

bemonsteringsprocedure

Monster

1

string

nan

bemonsteringsinstrument

Monster

1

tuple of string

(avegaarbooras

)

bemonstering_door

Monster

1

string

BVMO
Extra fieldsets

pydov.types.monster.MonsterDetails

Extra fields to be used with the Monster type which add details regarding the time the sample was taken.

MonsterDetails

Field

Source

Cost

Datatype

Example

tijdstip_monstername

MonsterDetails

10

string

13:37
Extra subtypes

pydov.types.monster.BemonsterdObject

Extra subtype which adds more information about the sampled object(s) of a sample.

BemonsterdObject

Field

Source

Cost

Datatype

Example

bemonsterd_object_type

BemonsterdObject

10

string

BORING

bemonsterd_object_naam

BemonsterdObject

10

string

GEO-02/028-B5

bemonsterd_object_permkey

BemonsterdObject

10

string

2002-003282

pydov.types.monster.Opslaglocatie

Extra subtype which adds more information about the storage location of a sample.

Opslaglocatie

Field

Source

Cost

Datatype

Example

opslaglocatie_naam

Opslaglocatie

10

string

Afdeling Geotechniek (Zwijnaarde)

opslaglocatie_van

Opslaglocatie

10

string

2022-10-12

opslaglocatie_tot

Opslaglocatie

10

string

2024-03-12

pydov.types.monster.Monsterbehandeling

Extra subtype which add more information about the treatment of a sample.

Monsterbehandeling

Field

Source

Cost

Datatype

Example

monsterbehandeling_door

Monsterbehandeling

10

string

VO - Instituut voor Landbouw-, Visserij- en Voedingsonderzoek (ILVO)

monsterbehandeling_datum

Monsterbehandeling

10

string

2024-05-07

monsterbehandeling_tijdstip

Monsterbehandeling

10

string

14:20

monsterbehandeling_behandeling

Monsterbehandeling

10

string

Type droging vooraf opslag

monsterbehandeling_behandeling_waarde

Monsterbehandeling

10

string

Ovengedroogd op 40°C

pydov.types.monster.Monsterbehandeling

Extra subtype which add more information about the treatment of a sample.

Monsterbehandeling

Field

Source

Cost

Datatype

Example

monsterbehandeling_door

Monsterbehandeling

10

string

VO - Instituut voor Landbouw-, Visserij- en Voedingsonderzoek (ILVO)

monsterbehandeling_datum

Monsterbehandeling

10

string

2024-05-07

monsterbehandeling_tijdstip

Monsterbehandeling

10

string

14:20

monsterbehandeling_behandeling

Monsterbehandeling

10

string

Type droging vooraf opslag

monsterbehandeling_behandeling_waarde

Monsterbehandeling

10

string

Ovengedroogd op 40°C

Observations (Observaties)

Type

Observatie (Observations)

Subtypes

  • Fractiemeting (Fraction measurement) - More information about the fraction measurement of observations of type ‘Textuurmeting’.

  • Meetreeks (Measurement series) - More information about the measurement series of observations of type ‘Meetreeks’.

  • ObservatieHerhaling (Repetition of the observation) - More information about the repetition(s) of the observation.

  • SecundaireParameter (Secondary observations related to the first observation) - More information about the related observations.

Extra fieldsets

  • ObservatieDetails (Details of observation) - Extra details about the observation.

Search classes
Default dataframe output

pydov.search.observatie.ObservatieSearch

This search class will return all observations, by default without extra fields or subtypes.

Observations (Observaties)

Field

Source

Cost

Datatype

Example

pkey_observatie

Observatie

1

string

https://oefen.dov.vlaanderen.be/data/observatie/2022-1667272

pkey_parent

Observatie

1

string

https://oefen.dov.vlaanderen.be/data/monster/2018-211698

fenomeentijd

Observatie

1

date

2018-01-09

diepte_van_m

Observatie

1

float

4.50

diepte_tot_m

Observatie

1

float

4.75

parametergroep

Observatie

1

string

Onderkenning-grondsoort

parameter

Observatie

1

string

Grondsoort volgens ASTM, de beschrijving (ASTM_naam)

detectieconditie

Observatie

1

string

nan

resultaat

Observatie

1

string

Silt with sand

eenheid

Observatie

1

string

nan

methode

Observatie

1

string

Onbekend

uitvoerder

Observatie

1

string

VO - Afdeling Geotechniek

herkomst

Observatie

1

string

LABO

pydov.search.observatie.ObservatieFractiemetingSearch

This search class will return only observations of type ‘Textuurmeting’ and will by default include the fraction measurement subtype.

Observations of type ‘Textuurmeting’ (Observaties van type ‘Textuurmeting’)

Field

Source

Cost

Datatype

Example

pkey_observatie

Observatie

1

string

https://oefen.dov.vlaanderen.be/data/observatie/2019-317331

pkey_parent

Observatie

1

string

https://oefen.dov.vlaanderen.be/data/monster/1951-263333

fenomeentijd

Observatie

1

date

1951-12-12

diepte_van_m

Observatie

1

float

Nan

diepte_tot_m

Observatie

1

float

NaN

parametergroep

Observatie

1

string

Bodem_fysisch_textuur

parameter

Observatie

1

string

Textuurfracties (textuurmeting)

eenheid

Observatie

1

string

%

methode

Observatie

1

string

Onbekend

uitvoerder

Observatie

1

string

NaN

herkomst

Observatie

1

string

VELD

fractiemeting_ondergrens

Fractiemeting

10

float

0.0

fractiemeting_bovengrens

Fractiemeting

10

float

2.0

fractiemeting_waarde

Fractiemeting

10

float

5.5

pydov.search.observatie.ObservatieMeetreeksSearch

This search class will return only observations of type ‘Meetreeks’ and will by default include the measurement series subtype.

Observations of type ‘Meetreeks’ (Observaties van type ‘Meetreeks’)

Field

Source

Cost

Datatype

Example

pkey_observatie

Observatie

1

string

https://oefen.dov.vlaanderen.be/data/observatie/2024-33862493

pkey_parent

Observatie

1

string

https://oefen.dov.vlaanderen.be/data/monster/2024-367983

fenomeentijd

Observatie

1

date

2024-040-03

diepte_van_m

Observatie

1

float

NaN

diepte_tot_m

Observatie

1

float

NaN

parametergroep

Observatie

1

string

Bodem_spectra

parameter

Observatie

1

string

NIRS (nirs)

methode

Observatie

1

string

NIRS met FOSS XDS toestel (Cmon analyseprotocol)

uitvoerder

Observatie

1

string

NaN

herkomst

Observatie

1

string

LABO

meetreeks_meetpunt_parameter

Meetreeks

10

string

golflengte

meetreeks_meetpunt

Meetreeks

10

string

400.0

meetreeks_meetpunt_eenheid

Meetreeks

10

string

nm

meetreeks_meetwaarde_parameter

Meetreeks

10

string

nir_spectrale_absorptie

meetreeks_meetwaarde

Meetreeks

10

float

0.6227

meetreeks_meetwaarde_eenheid

Meetreeks

10

string

-
Extra subtypes

pydov.types.observatie.ObservatieHerhaling

Extra subtype which adds more information about the repetitions of the observations data.

ObservatieHerhaling

Field

Source

Cost

Datatype

Example

herhaling_aantal

ObservatieHerhaling

10

integer

16

herhaling_minimum

ObservatieHerhaling

10

float

2.00000000

herhaling_maximum

ObservatieHerhaling

10

float

8.00000000

herhaling_standaardafwijking

ObservatieHerhaling

10

float

2.75680975

pydov.types.observatie.SecundaireParameter

Extra subtype which adds more information about additional recorded parameters.

SecundaireParameter

Field

Source

Cost

Datatype

Example

secundaireparameter_parameter

SecundaireParameter

10

string

temp_water

secundaireparameter_resultaat

SecundaireParameter

10

string

5.0

secundaireparameter_eenheid

SecundaireParameter

10

string

°C

pydov.types.observatie.Fractiemeting

Extra subtype which adds more information about the fraction measurement of observations of type ‘Textuurmeting’.

Fractiemeting

Field

Source

Cost

Datatype

Example

fractiemeting_ondergrens

Fractiemeting

10

float

0.0

fractiemeting_bovengrens

Fractiemeting

10

float

0.2

fractiemeting_waarde

Fractiemeting

10

float

10.17

pydov.types.observatie.Meetreeks

Extra subtype which adds more information about the measurement series of observations of type ‘Meetreeks’.

Meetreeks

Field

Source

Cost

Datatype

Example

meetreeks_meetpunt_parameter

Meetreeks

10

string

Diameter

meetreeks_meetpunt

Meetreeks

10

string

0.074

meetreeks_meetpunt_eenheid

Meetreeks

10

string

mm

meetreeks_meetwaarde_parameter

Meetreeks

10

string

Fractie met grotere diameter

meetreeks_meetwaarde

Meetreeks

10

float

89.94

meetreeks_meetwaarde_eenheid

Meetreeks

10

string

%
Extra fieldsets

pydov.types.observate.ObservatieDetails

Extra fields to be used with the Observatie type which add details regarding the reliability and observed object.

ObservatieDetails

Field

Source

Cost

Datatype

Example

betrouwbaarheid

ObservatieDetails

10

string

goed

geobserveerd_object_type

ObservatieDetails

10

string

Onbekend

geobserveerd_object_naam

ObservatieDetails

10

string

VO - Afdeling Geotechniek

geobserveerd_object_permkey

ObservatieDetails

10

string

LABO

DOV WFS layer

Next to the custom types defined in pydov above, you can also query any WFS layer available in the DOV WFS service. You can find all available WFS layers in our metadata catalogue.

Search class

pydov.search.generic.WfsSearch

Remarks

When instantiating the WfsSearch class, you can provide the workspace-qualified layer name of your interest, for example:

from pydov.search.generic import WfsSearch

s = WfsSearch('erosie:erosie_gemeente')
Example dataframe output

By default the output dataframe will contain all attribute columns from the requested WFS layer, for example:

Groundwater permits (grondwatervergunningen)

Field

Source

Cost

Datatype

Example

dataengine_id

WfsType

1

integer

1

gemeentelijke_erosiegevoeligheid

WfsType

1

string

zeer weinig erosiegevoelig

klasse

WfsType

1

integer

5

gemeente

WfsType

1

string

Zoersel

provincie

WfsType

1

string

Antwerpen