Access to Aquo domaintables from R (Dutch).
aquodom
Met aquodom is het op eenvoudige wijze mogelijk om de aquo-domeintabellen te downloaden en te gebruiken in R.
Installatie
aquodom is te installeren vanaf CRAN met:
install.packages("aquodom")
De ontwikkelversie is te installeren van GitHub met:
# install.packages("devtools")
devtools::install_github("RedTent/aquodom")
Aquo-domeintabellen
De Aquo-standaard vormt de Nederlandse standaard voor de uitwisseling van gegevens in het waterbeheer. Met aquodom (kort voor aquo-domeintabellen) is het makkelijk om via de API domeintabellen van de Aquo-standaard in R te downloaden en te gebruiken.
De belangrijkste functies van aquodom zijn dom() en dom_save(). Met deze functies kan iedere domeintabel van www.aquo.nl worden gedownload. De functie dom() geeft de domeintabel als een dataframe. dom_save() doet hetzelfde maar slaat daarnaast ook de domeintabel op als xlsx- of csv-bestand. De functie dom_overzicht() geeft een compleet overzicht van alle beschikbare domeintabellen.
Alle functies hebben een optioneel argument peildatum. Dit argument kan worden gebruikt om alleen domeinwaarden of domeintabellen te tonen die geldig zijn op de peildatum. Met peildatum = NULL worden alle resultaten inclusief verouderde waarden getoond.
library(aquodom)
dom("MonsterType")
#> # A tibble: 7 x 6
#> id omschrijving begin_geldigheid eind_geldigheid guid gerelateerd
#> <dbl> <chr> <date> <date> <chr> <chr>
#> 1 10 analysemonster 2017-12-13 2100-01-01 Id-6a3e6~ Id-99092d94-d~
#> 2 8 materiaalmons~ 2015-11-18 2100-01-01 Id-f811d~ Id-2d146a3e-3~
#> 3 11 samengevoegd ~ 2017-12-13 2100-01-01 Id-81ce3~ Id-8df42796-7~
#> 4 4 toetsmonster 2015-11-18 2100-01-01 Id-0034d~ Id-ad4f1180-6~
#> 5 9 uitloogmonster 2015-11-18 2100-01-01 Id-6053f~ Id-48826f74-c~
#> 6 1 veldmonster 2015-11-18 2100-01-01 Id-74dd8~ Id-3e9918e3-4~
#> 7 7 zeefmonster 2015-11-18 2100-01-01 Id-8d483~ Id-63ac95ff-1~
#De namen van domeintabellen zijn niet hoofdlettergevoelig
all.equal(dom("MonsterType"), dom("monstertype"))
#> [1] TRUE
# Alle domeinwaarden inclusief verouderde waarden
dom("MonsterType", peildatum = NULL)
#> # A tibble: 8 x 6
#> id omschrijving begin_geldigheid eind_geldigheid guid gerelateerd
#> <dbl> <chr> <date> <date> <chr> <chr>
#> 1 10 analysemonster 2017-12-13 2100-01-01 Id-6a3e6~ Id-99092d94-d~
#> 2 8 materiaalmons~ 2015-11-18 2100-01-01 Id-f811d~ Id-2d146a3e-3~
#> 3 10 mengmonster 2015-11-18 2017-12-12 Id-a0a78~ <NA>
#> 4 11 samengevoegd ~ 2017-12-13 2100-01-01 Id-81ce3~ Id-8df42796-7~
#> 5 4 toetsmonster 2015-11-18 2100-01-01 Id-0034d~ Id-ad4f1180-6~
#> 6 9 uitloogmonster 2015-11-18 2100-01-01 Id-6053f~ Id-48826f74-c~
#> 7 1 veldmonster 2015-11-18 2100-01-01 Id-74dd8~ Id-3e9918e3-4~
#> 8 7 zeefmonster 2015-11-18 2100-01-01 Id-8d483~ Id-63ac95ff-1~
head(dom_overzicht(), 3)
#> # A tibble: 3 x 7
#> domeintabel domeintabelsoort wijzigingsdatum begin_geldigheid eind_geldigheid
#> <chr> <chr> <date> <date> <date>
#> 1 Afsluitmid~ Domeintabel 2020-11-11 2016-03-12 2100-01-01
#> 2 Bekleding_~ Domeintabel 2020-06-30 2016-03-12 2100-01-01
#> 3 BekledingT~ Domeintabel 2020-06-30 2016-03-12 2100-01-01
#> # ... with 2 more variables: kolommen <list>, guid <chr>
nrow(dom_overzicht())
#> [1] 126
# inclusief ongeldige domeintabellen
nrow(dom_overzicht(peildatum = NULL))
#> [1] 261
dom_save("monstertype")
Caching en opslaan
Het downloaden van grotere domeintabellen kan behoorlijk wat tijd in beslag nemen. Daarom maakt aquodom gebruik van caching. Als een domeintabel eenmaal is gedownload wordt in dezelfde R-sessie gebruik gemaakt van de cache. Voor het gebruik van dezelfde domeintabel in verschillende R-sessies kan de domeintabel het beste opgeslagen worden, bijv. met dom_save().
# De eerste keer duurt vrij lang
system.time(dom("Hoedanigheid"))
#> ..
#> user system elapsed
#> 0.27 0.14 2.06
# De tweede keer gaat veel sneller
system.time(dom("Hoedanigheid"))
#> user system elapsed
#> 0.02 0.00 0.02