Package 'LSVI'

Description

Deze functie bepaalt de Lokale Staat van Instandhouding en biotische indices op basis van gegevens, die in het juiste formaat moeten aangeleverd worden. Zie hiervoor de beschrijving bij de parameters ("Arguments" ) en de tabellen van het voorbeeld. In principe is enkel de parameter Data_habitat verplicht om op te geven, maar extra datasets zijn uiteraard wel nodig om een resultaat te bekomen. Welke datasets relevant zijn, is afhankelijk van de opgegeven habitattypes: voor een aantal habitattypes kan een tabel met observaties en hun bedekking of aanwezigheid (=parameter Data_soortenKenmerken) volstaan, voor bossen zijn bv. bijkomend gegevens nodig over dood hout.

De Lokale Staat van Instandhouding wordt weergegeven in de kolom Status met als mogelijke waarden TRUE (= gunstig) en FALSE (= ongunstig).

De biotische indices zijn afgeleid van het verschil tussen een geobserveerde waarde en de referentiewaarde voor elke indicator. Deze verschillen werden herschaald tussen +1 en -1, waarbij een positieve en negatieve waarde overeenkomt met respectievelijk een gunstige en ongunstige score. Deze verschilscores per indicator worden geaggregeerd, eerst voor de indicatoren die tot eenzelfde criterium behoren, vervolgens worden deze geaggregeerde scores verder geaggregeerd om tot een globale index te komen. Er worden drie verschillende globale indices berekend waarbij de naamgeving aangeeft welk aggregatie achtereenvolgens gebruikt werd: "index_min_min", "index_min_harm" en "index_harm_harm". Een naam met "min" duidt op minimum van de scores als aggregatie; bij "harm" werd het harmonisch gemiddelde berekend.

Usage

berekenLSVIbasis(
  Versie = "alle",
  Kwaliteitsniveau = "alle",
  Data_habitat,
  Data_voorwaarden = data.frame(ID = character(), Criterium = character(), Indicator =
    character(), Voorwaarde = character(), Waarde = character(), Type = character(),
    WaardeMin = double(), WaardeMax = double(), stringsAsFactors = FALSE),
  Data_soortenKenmerken = data.frame(ID = character()),
  Aggregatiemethode = "1-out-all-out",
  ConnectieLSVIhabitats = NULL,
  LIJST = geefVertaallijst(ConnectieLSVIhabitats),
  na.rm = FALSE
)

Arguments

Value

Deze functie genereert de resultaten in de vorm van een list met 4 tabellen: een eerste met de beoordelingen per kwaliteitsniveau, een tweede met de beoordelingen per criterium en kwaliteitsniveau, een derde met de beoordelingen per indicator en kwaliteitsniveau, en een vierde met de detailgegevens inclusief meetwaarden.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaand voorbeeld de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar het voorbeeld werkt en kan zeker
# uitgetest worden.
## Not run: 
library(LSVI)
maakConnectiePool()
library(readr)
Data_habitat <-
  read_csv2(system.file("vbdata/Opname4030habitat.csv", package = "LSVI"),
    col_types = list(col_character(), col_character(),col_character()))
Data_voorwaarden <-
  read_csv2(
    system.file("vbdata/Opname4030voorwaardenv2.csv", package = "LSVI"))
Data_soortenKenmerken <-
  read_csv2(
    system.file("vbdata/Opname4030soortenKenmerken.csv", package = "LSVI"))
berekenLSVIbasis(Versie = "Versie 2.0",
                 Kwaliteitsniveau = "1", Data_habitat,
                 Data_voorwaarden, Data_soortenKenmerken)

## End(Not run)

Description

Deze functie, die bedoeld is als hulpfunctie voor de hoofdfunctie berekenLSVIbasis(), evalueert de status van de records van een opgegeven Statustabel met velden Waarde, Referentiewaarde en Operator.

Usage

berekenStatus(Statustabel)

Arguments

Value

Deze functie geeft een tabel terug met velden Rijnr en Status

Description

Deze functie, die bedoeld is als hulpfunctie voor de hoofdfunctie berekenLSVIbasis(), berekent de verschilscores van de records van een opgegeven Statustabel met velden Rijnr, RefMin, RefMax, Operator, WaardeMin, WaardeMax en TheoretischMaximum. De verschilscores hebben een waarde tussen -1 en +1 en geven negatieve of positieve afwijking ten opzichte van de referentiewaarde.

Usage

berekenVerschilscores(Statustabel)

Arguments

Value

Deze functie geeft een tabel terug met velden Rijnr en Verschilscore

Description

Deze hulpfunctie berekent de waarde voor een opgegeven voorwaarde (verwijzend naar de "rekenregels" in de LSVI-indicatorendatabank) op basis van opgegeven datasets. Ze doet dit voor 1 enkele voorwaarde en 1 enkele opname (datum en locatie). Deze functie test NIET of de datasets zich beperken tot een enkele opname, dus het is aan de gebruiker om enkel gegevens van 1 locatie mee te geven. Voor een berekening van meerdere opnamen (en ook de volledige LSVI i.p.v. enkel 1 voorwaarde) verwijzen we naar de functie berekenLSVIbasis().

Usage

berekenVoorwaarde(
  OpnameID,
  VoorwaardeID,
  Kenmerken,
  ConnectieLSVIhabitats,
  LIJST
)

Arguments

Value

Een vector van 3 waarden die het resultaat is van de berekening, namelijk het minimum en het maximum van het interval waartussen de berekende waarde ligt en het theoretisch maximum. Als het resultaat een exacte waarde is en geen interval, bevat het minimum en maximum tweemaal dezelfde waarde. (Het resultaat is een interval als de brondata categorische variabelen zijn, bv. bedekkingen volgens de beheermonitoringschaal of Tansley-schaal.)

Description

Technische hulpfunctie die in een formule de VoorwaardeID's vervangt door opgegeven waarden en het resultaat van de formule teruggeeft.

Usage

combinerenVerschilscore(Formule, VoorwaardeID, Verschilscore)

Arguments

Value

gecombineerde verschilscore waarbij EN gecombineerd wordt via het minimum van beide verschilscores en OF gecombineerd wordt via het maximum van beide verschilscores

Examples

#onderstaand voorbeeld geeft problemen bij het testen van het package door
#devtools, maar buiten deze context werkt het wel
## Not run: 
combinerenVerschilscore(
  "(720 AND 721) OR 15",
  c(720, 721, 15),
  c(0.5, -0.3, 0.8)
)

## End(Not run)

Description

Technische hulpfunctie die in een formule de VoorwaardeID's vervangt door opgegeven logische waarden en het resultaat van de formule teruggeeft.

Usage

combinerenVoorwaarden(Formule, VoorwaardeID, Status)

Arguments

Value

logische waarde (TRUE of FALSE) die de uitkomst van de Formule is (gecombineerd met VoorwaardeID en Status)

Examples

#onderstaand voorbeeld geeft problemen bij het testen van het package door
#devtools, maar buiten deze context werkt het wel
## Not run: 
combinerenVoorwaarden(
  "(720 AND 721) OR 15",
  c(720, 721, 15),
  c(TRUE, FALSE, TRUE)
)

## End(Not run)

Description

Deze functie maakt een connectie met de in het package toegevoegde databank met LSVI-indicatoren, wat nodig is om de functies te kunnen gebruiken. Deze connectie moet als argument meegegeven worden bij elke functie functie die informatie uit de databank ophaalt. Alternatief is om eenmalig een connectiepool aan te maken met de functie maakConnectiePool().

Usage

connecteerMetLSVIdb()

Value

Deze functie geeft een open odbc-connectie naar de SQLite-databank in de installatie-file van het package.

Examples

library(LSVI)
ConnectieLSVIhabitats <- connecteerMetLSVIdb()
geefVersieInfo(ConnectieLSVIhabitats)
library(DBI)
dbGetQuery(ConnectieLSVIhabitats,
           "SELECT VersieLSVI, Referentie FROM Versie")
dbDisconnect(ConnectieLSVIhabitats)

Description

Deze technische hulpfunctie bevat een standaardroutine om te controleren of de door een gebruiker ingevoerde waarde(n) voorkomen in een gespecifieerde tabel in de databank. Indien niet, dan geeft de functie een informatieve error (welke waarde is fout, en welk zijn de mogelijke invoerwaarden voor de variabele?).

Usage

controleerInvoerwaarde(
  Beschrijving,
  Invoerwaarden,
  Tabelnaam,
  Veldnaam,
  ConnectieLSVIhabitats,
  Tolower = TRUE
)

Arguments

Value

Deze functie geeft geen waarde terug, maar gooit een error als er een foute waarde ingevoerd is

Description

Deze hulpfunctie voor de s4-klassen aantal en bedekking selecteert soorten of kenmerken uit een opname die niet tot de soortgroep of studiegroep van een bepaalde voorwaarde behoren. Op basis hiervan kunnen de s4-klassen bedekkingExcl en maxBedekkingExcl berekend worden (bv. dominantie van een soort: maximale bedekking van soorten in een opname exclusief de sleutelsoorten).

Usage

deselecteerKenmerkenInOpname(
  Kenmerken,
  Soortengroep,
  Studiegroep,
  SubAnalyseVariabele,
  SubRefMin,
  SubRefMax,
  SubOperator
)

Arguments

Value

Deze functie geeft een aangepaste tabel Data_soorten terug waarin enkel de soorten uit de soortenlijst(en) opgenomen zijn en die bovendien gekoppeld is aan de gegevens van de soortenlijst.

Description

Deze functie geeft de inhoud van de tabellen habitatkarakteristieken en beoordelingsmatrix uit de rapporten van de Lokale Staat van Instandhouding voor de habitattypes die voldoen aan de opgegeven parameters. Volledigheidshalve geeft ze ook de uitgebreide namen van de habitattypes en habitatsubtypes. De uitvoer van deze functie kan gebruikt worden om rapportages op te maken (bv. rapport samenstellen met LSVI-criteria,...). Een "afgewerkt rapport" kan gegenereerd worden met de functie maakHabitatfiches().

De parameters kunnen enkel de hieronder gespecifieerde waarden bevatten en moeten als string opgegeven worden. Default is telkens "alle", waarbij de soortenlijsten voor alle mogelijke waarden van die parameter weergegeven worden (m.a.w. er is geen selectie voor deze parameter).

Usage

geefInfoHabitatfiche(
  Versie = "alle",
  Habitatgroep = "alle",
  Habitattype = "alle",
  Criterium = "alle",
  Indicator = "alle",
  Stijl = c("Rmd", "tekst"),
  ConnectieLSVIhabitats = NULL
)

Arguments

Value

Deze functie genereert een tabel met alle gegevens die nodig zijn om de tabellen habitatkarakteristieken en beoordelingsmatrix uit de LSVI-rapporten te genereren.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaand voorbeeld de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar het voorbeeld werkt en kan zeker
# uitgetest worden.
## Not run: 
library(LSVI)
maakConnectiePool()
geefInfoHabitatfiche(Versie = "Versie 2.0", Habitattype = "4030")
library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze functie geeft alle informatie die nodig is om veldobservaties klaar te maken voor de berekening van de de Lokale Staat van Instandhouding met de functie berekenLSVIbasis(), alsook de berekeningsregels die gebruikt worden. Allereerst geeft ze de Voorwaarde die vermeld moet worden bij de observaties (zie Data_voorwaarden bij berekenLSVIbasis()), samen met informatie uit de LSVI-tabellen (vnl. beoordelingsmatrix) en een beschrijving van de voorwaarde (Voorwaarde) die zou moeten toelaten om de koppeling te maken.

Verder geeft ze informatie over de Waarde die verwacht wordt in de functie berekenLSVIbasis(). AnalyseVariabele is een korte omschrijving voor de variabele waarde, bv. "aantal" staat voor het aantal soorten of klassen en "bedekking" voor de totale bedekking van de lijst soorten of klassen. (Zie vignette("berekeningen", package = "LSVI") voor een uitgebreide beschrijving van de achterliggende berekeningen.) Referentiewaarde en Operator geven respectievelijk de grenswaarde en de vergelijking aan op basis waarvan de beoordeling van de waarde zal gebeuren. Voor elke AnalyseVariabele wordt informatie gegeven over het formaat dat verwacht wordt voor Waarde: de Eenheid (die niet opgenomen moet worden in Waarde maar wel de grootte-orde van het verwachte getal aangeeft), het formaat van de variabele (TypeVariabele), en bij categorische variabelen het Invoertype en de Invoerwaarde (een naam voor de categorische variabele en de mogelijke waarden die deze kan aannemen).

Waar nodig, wordt een soortengroep of studiegroep opgegeven. Een studiegroep is eigenlijk equivalent aan een soortengroep: de verschillende klassen of fasen of ... waarvoor een bedekking of andere analysevariabele moet berekend worden. Voorbeelden zijn groeiklassen, vegetatielagen, ... Omwille van de overzichtelijkheid van de tabel is voor de Soortengroep enkel een ID gegeven, de volledige lijst kan opgevraagd worden met de functie geefSoortenlijstInvoerniveau().

Ingeval van de AnalyseVariabele aantal kan er ook een SubAnalyseVariabele vermeld zijn, meestal bedekking, die aangeeft aan welke voorwaarde elke soort of klasse afzonderlijk moet voldoen. Aan deze SubAnalysevariabele zijn dezelfde velden gekoppeld als aan AnalyseVariabele, nl. SubReferentiewaarde, SubOperator, SubEenheid, TypeSubVariabele, SubInvoertype en SubInvoerwaarde. Bijvoorbeeld, bij de voorwaarde "minimum 5 soorten minimum talrijk aanwezig" zal de AnalyseVariabele aantal zijn, de Referentiewaarde "5", de Operator ">=", TypeVariabele "Geheel getal", SubAnalysevariabele "bedekking", SubReferentiewaarde "T", SubOperator ">=", TypeSubVariabele "Categorie" en SubInvoertype "Beheermonitoringsschaal 2017".

Usage

geefInvoervereisten(
  Versie = "alle",
  Habitatgroep = "alle",
  Habitattype = "alle",
  Criterium = "alle",
  Indicator = "alle",
  Kwaliteitsniveau = "alle",
  Weergave = c("basis", "uitgebreid"),
  ConnectieLSVIhabitats = NULL
)

Arguments

Value

Deze functie geeft een tabel met de hierboven beschreven informatie uit de databank.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaande voorbeelden de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar de voorbeelden werken en kunnen zeker
# uitgetest worden.
## Not run: 
library(LSVI)
maakConnectiePool()
geefInvoervereisten(
  Versie = "Versie 2.0",
  Habitattype = "4030",
  Kwaliteitsniveau = "1"
)
library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze functie genereert soortenlijsten (met wetenschappelijke en Nederlandse namen) die gebruikt worden voor de bepaling van de Lokale Staat van Instandhouding van de opgegeven parameters. In feite genereert ze een tabel met velden Versie, Habitattype, Habitatsubtype, WetNaam, WetNaamKort en NedNaam en evt. Criterium, Indicator en/of Beschrijving waarin de gespecifieerde parameters uitgeselecteerd zijn en waar voor andere parameters alle waarden uit de databank weergegeven zijn.

Voor de vorm van de soortenlijst zijn er meerdere opties: een soortenlijst met alle soorten per habitat(sub)type, ofwel gegroepeerd per criterium, indicator of voorwaarde. Dit kan opgegeven worden in de parameter Taxonlijstniveau.

Ook voor de weergave van de taxa zijn 2 opties: de taxa weergeven zoals in de habitatfiches (op soortniveau, genusniveau of hoger niveau, zoals het in de habitatfiches vermeld is) of alle taxa op lagere niveaus ook weergeven en dus bij soortengroepen alle mogelijke soorten van deze groep weergeven. Deze opties kunnen opgegeven worden in de parameter Taxonlijsttype.

De parameters kunnen enkel de hieronder gespecifieerde waarden bevatten en moeten als string opgegeven worden. Default is telkens "alle", waarbij de soortenlijsten voor alle mogelijke waarden van die parameter weergegeven worden (m.a.w. er is geen selectie voor deze parameter).

Usage

geefSoortenlijst(
  Versie = "alle",
  Habitatgroep = "alle",
  Habitattype = "alle",
  Criterium = "alle",
  Indicator = "alle",
  Taxonlijstniveau = c("habitattype", "criterium", "indicator", "voorwaarde"),
  Taxonlijsttype = c("LSVIfiche", "alle"),
  ConnectieLSVIhabitats = NULL
)

Arguments

Value

Deze functie geeft een tabel met velden Versie, Habitattype, Habitatsubtype, Criterium, Indicator, evt. Beschrijving, WetNaam, WetNaamKort en NedNaam (waarbij Beschrijving een omschrijving is voor een groep van taxa binnen eenzelfde indicator). WetNaam is de volledige Latijnse naam inclusief auteursnaam, WetNaamKort geeft de verkorte naam zonder auteursnaam.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaande voorbeelden de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar de voorbeelden werken en kunnen zeker
# uitgetest worden.
## Not run: 
maakConnectiePool()
geefSoortenlijst(Habitattype = "4030", Taxonlijsttype = "LSVIfiche")
geefSoortenlijst(Habitattype = "4030", Taxonlijsttype = "alle")
library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze functie genereert soortenlijsten (met wetenschappelijke en Nederlandse namen) uit de databank met de criteria en indicatoren voor de bepaling van de Lokale Staat van Instandhouding. Het is in feite een hulpfunctie die voor verschillende andere functies gebruikt wordt en die de complexe zoekfunctie in de tabellen met soorten uitvoert op basis van een opgegeven TaxongroepId (en in die zin iets minder gebruiksvriendelijk is). Voor een selectie van soortenlijsten op basis van specifieke parameters is de functie geefSoortenlijst() een beter alternatief.

Deze functie geeft standaard voor de gespecifieerde taxongroepen per groep een lijst van alle taxa zoals ze in de LSVI-habitatfiche vermeld zijn (genusniveau, soortniveau, ondersoort,...). Op basis van de parameter soortenlijsttype kan ook gekozen worden om een volledige lijst te geven van deze taxa en alle taxa die hieronder vallen (en opgenomen zijn in de onderliggende databank).

Usage

geefSoortenlijstVoorIDs(
  Taxongroeplijst,
  Taxonlijsttype = c("LSVIfiche", "alle"),
  ConnectieLSVIhabitats = NULL
)

Arguments

Value

Deze functie geeft een tabel met velden TaxongroepId, evt. Beschrijving, WetNaam, WetNaamKort en NedNaam (waarbij Beschrijving een omschrijving is voor een groep van taxons binnen eenzelfde indicator). WetNaam is de volledige Latijnse naam inclusief auteursnaam, WetNaamKort geeft de verkorte naam zonder auteursnaam.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaande voorbeelden de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar de voorbeelden werken en kunnen zeker
# uitgetest worden.
## Not run: 
maakConnectiePool()
geefSoortenlijstVoorIDs("434,88,565")
geefSoortenlijstVoorIDs("434,88,565","alle")
library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze hulpfunctie geeft een vector met alle verschillende waarden die in een gespecifieerd veld van een gespecificeerde tabel in de databank met LSVI-indicatoren staan, voorafgegaan door de (toegevoegde) waarde "alle". Deze functie wordt in verschillende functies van het package gebruikt om de invoer van parameters te controleren (waar de mogelijke invoer bestaat uit "alle" of een item uit het veld). In enkele gevallen wordt dit commando in de documentatie vermeld zodat ook de gebruiker in die specifieke gevallen de lijst met mogelijke invoerwaarden op een eenvoudige manier kan opvragen.

Gebruikers die de databankstructuur en bijhorende naamgeving niet kennen, kunnen dezelfde info het gemakkelijkst bekomen door een tabel voor de volledige dataset op te vragen, het gewenste veld te selecteren en hiervan de unieke waarden weer te geven (zie voorbeeld).

Usage

geefUniekeWaarden(Tabelnaam, Veldnaam, ConnectieLSVIhabitats = NULL)

Arguments

Value

Deze functie geeft een vector bestaande uit "alle" en de verschillende waarden uit de gespecifieerde tabel.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaand voorbeeld de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar het voorbeelden werkt en kan zeker
# uitgetest worden.
## Not run: 
maakConnectiePool()
geefUniekeWaarden("Versie","VersieLSVI")

#alternatieven om deze invoerlijst te bekomen:
unique(geefVersieInfo()$VersieLSVI)

library(dplyr)
geefVersieInfo() %>%
  select(VersieLSVI) %>%
  distinct()

library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze functie geeft een overzicht van alle versies die er zijn voor de berekening van de de Lokale Staat van Instandhouding, met naast de opsomming van de versies en de referenties een overzicht van de 2 kwaliteitsniveaus of types van beoordelingscriteria die in deze versie gedefinieerd zijn.

Usage

geefVersieInfo(ConnectieLSVIhabitats = NULL)

Arguments

Value

Deze functie geeft de tabel Versie uit de databank.

Examples

maakConnectiePool()
geefVersieInfo()
library(pool)
poolClose(ConnectiePool)

Description

Deze functie haalt een lijst uit de databank van de gebruikte schalen (bv. Tansley-schaal en beheermonitoringschaal uit 2017) met telkens de verschillende mogelijke categorieën en een overeenkomstige bedekkingswaarde. De functie berekenLSVIbasis() gebruikt deze waarden om de nodige omzettingen te doen tussen deze verschillende schalen

Usage

geefVertaallijst(ConnectieLSVIhabitats)

Arguments

Value

Dataframe met Naam, Waarde, Volgnummer, Omschrijving, Ondergrens, Gemiddelde en Bovengrens. Telkens is een waarde tussen 0 en 1 opgegeven die afkomstig is van het delen van het percentage door 100)

Description

Om te vermijden dat we meermaals dezelfde invoercontrole moeten uitvoeren en om de hoofdscripts overzichtelijk te houden, maken we voor elke invoercontrole een aparte hulpfunctie aan, die we kunnen aanroepen. Deze wordt NIET geëxporteerd, dus deze functies kunnen niet als commando gerund worden (maar worden wel gerund als de functie waarin ze voorkomen, aangeroepen wordt).

Usage

invoercontroleData_habitat(Data_habitat, ConnectieLSVIhabitats)

Arguments

Description

Om te vermijden dat we meermaals dezelfde invoercontrole moeten uitvoeren en om de hoofdscripts overzichtelijk te houden, maken we voor elke invoercontrole een aparte hulpfunctie aan, die we kunnen aanroepen. Deze wordt NIET geëxporteerd, dus deze functies kunnen niet als commando gerund worden (maar worden wel gerund als de functie waarin ze voorkomen, aangeroepen wordt). Ingeval van Data_soortenKenmerken is ook de omzetting van soortnamen naar een NbnTaxonVersionKey en de omzettingen van bedekkingen naar een interval opgenomen in de functie.

Usage

invoercontroleData_soortenKenmerken(
  Data_soortenKenmerken,
  ConnectieLSVIhabitats,
  LIJST
)

Arguments

Description

Om te vermijden dat we meermaals dezelfde invoercontrole moeten uitvoeren en om de hoofdscripts overzichtelijk te houden, maken we voor elke invoercontrole een aparte hulpfunctie aan, die we kunnen aanroepen. Deze wordt NIET geëxporteerd, dus deze functies kunnen niet als commando gerund worden (maar worden wel gerund als de functie waarin ze voorkomen, aangeroepen wordt). Ingeval van Data_voorwaarden is ook de omzetting van de voorwaarden naar een interval opgenomen in de functie.

Usage

invoercontroleData_voorwaarden(Data_voorwaarden, ConnectieLSVIhabitats, LIJST)

Arguments

Description

Om te vermijden dat we meermaals dezelfde invoercontrole moeten uitvoeren en om de hoofdscripts overzichtelijk te houden, maken we voor elke invoercontrole een aparte hulpfunctie aan, die we kunnen aanroepen. Deze wordt NIET geëxporteerd, dus deze functies kunnen niet als commando gerund worden (maar worden wel gerund als de functie waarin ze voorkomen, aangeroepen wordt).

Usage

invoercontroleKwaliteitsniveau(Kwaliteitsniveau, ConnectieLSVIhabitats)

Arguments

Description

Om te vermijden dat we meermaals dezelfde invoercontrole moeten uitvoeren en om de hoofdscripts overzichtelijk te houden, maken we voor elke invoercontrole een aparte hulpfunctie aan, die we kunnen aanroepen. Deze wordt NIET geëxporteerd, dus deze functies kunnen niet als commando gerund worden (maar worden wel gerund als de functie waarin ze voorkomen, aangeroepen wordt).

Usage

invoercontroleVersie(Versie, ConnectieLSVIhabitats)

Arguments

Description

Deze functie maakt een tabel met alle problemen die nog in de databank zitten. Enerzijds is er een beperkte tabel met problemen die op een hoger niveau opgelost kunnen worden en anderzijds een detail met alle Voorwaarden waar nog een fout in zit. Problemen die op beide niveaus kunnen opgelost worden (bv. benoemen van analysevariabelen), staan op beide niveaus vermeld.

Usage

logDatabankfouten(ConnectieLSVIhabitats = NULL)

Arguments

Value

Deze functie geeft een list met 2 dataframes terug

Description

Deze functie maakt een connectiepool met de in het package toegevoegde databank met LSVI-indicatoren, wat nodig is om de functies te kunnen gebruiken. Deze connectiepool moet eenmalig aangemaakt worden, en functies zullen automatisch deze connectiepool gebruiken om te connecteren met de databank. Alternatief is om een connectie aan te maken met de functie connecteerMetLSVIdb() en deze bij elke functie mee te geven.

Usage

maakConnectiePool()

Value

Deze functie maakt een Environment-object aan dat de connecties regelt met de betreffende databank.

Examples

library(LSVI)
maakConnectiePool()
geefVersieInfo()
library(pool)
poolClose(ConnectiePool)

Description

Deze functie genereert habitatfiches die gebruikt worden voor de bepaling van de Lokale Staat van Instandhouding van de habitattypes die voldoen aan de opgegeven parameters. (Om een tabel te genereren met deze informatie om zelf een fiche te kunnen samenstellen, wordt verwezen naar de functie geefInfoHabitatfiche(). Om een rapport samen te stellen met alle fiches na elkaar in 1 document, wordt verwezen naar de functie maakLSVIrapport())

De parameters kunnen enkel de hieronder gespecifieerde waarden bevatten en moeten als string opgegeven worden. Default is telkens "alle", waarbij de soortenlijsten voor alle mogelijke waarden van die parameter weergegeven worden (m.a.w. er is geen selectie voor deze parameter).

Usage

maakHabitatfiches(
  Versie = "alle",
  Habitatgroep = "alle",
  Habitattype = "alle",
  ConnectieLSVIhabitats = NULL,
  verbose = TRUE
)

Arguments

Value

Deze functie genereert een rapport met habitatfiches in de vorm van een html-bestand dat in de working directory opgeslagen wordt.

Examples

# Omwille van de iets langere lange duurtijd van het commando staat bij
# onderstaand voorbeeld de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar het voorbeeld werkt en mag zeker
# uitgetest worden.
## Not run: 
maakConnectiePool()
maakHabitatfiches(Versie = "Versie 2.0", Habitattype = "4030")
library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze functie genereert een rapport met habitatfiches die gebruikt worden voor de bepaling van de Lokale Staat van Instandhouding van de habitat(sub)types die voldoen aan de opgegeven parameters. (Om een tabel te genereren met deze informatie om zelf een rapport te kunnen samenstellen, wordt verwezen naar de functie geefInfoHabitatfiche().)

De parameters kunnen enkel de hieronder gespecifieerde waarden bevatten en moeten als string opgegeven worden. Default is telkens "alle", waarbij de soortenlijsten voor alle mogelijke waarden van die parameter weergegeven worden (m.a.w. er is geen selectie voor deze parameter).

Usage

maakLSVIrapport(
  Bestandsnaam = "LSVIrapport.html",
  Versie = "alle",
  Habitatgroep = "alle",
  Habitattype = "alle",
  ConnectieLSVIhabitats = NULL,
  verbose = TRUE
)

Arguments

Value

Deze functie genereert habitatfiches in de vorm van html-bestanden die in de working directory opgeslagen worden.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaande voorbeelden de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar de voorbeelden werken en kunnen zeker
# uitgetest worden.
## Not run: 
maakConnectiePool()
maakLSVIrapport(
  Bestandsnaam = "LSVIrapport_heiden_versie3.html",
  Versie = "Versie 2.0", Habitatgroep = "Heiden"
)
maakLSVIrapport(
  Bestandsnaam = "LSVIrapport_4030.html",
  Habitattype = "4030"
)
library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze functie vereenvoudigt de opgegeven taxonnamen door de auteursnaam te verwijderen. Ze is gebaseerd op de functie name_parse() uit het package rgbif, maar ze vangt enkele specifieke situaties uit de INBO-plantenlijsten wel op die de originele functie niet correct opvangt, bv. v., an en den herkennen als deel van een auteursnaam en s.l. en meerdere soortnamen gescheiden door / (zonder spatie) vervangen door een achtervoegsel groep.

Usage

parseTaxonnaam(Taxonnaam, ParseType = "canonicalnamewithmarker")

Arguments

Value

Deze functie geeft de vereenvoudigde naam of namen terug (als string of vector van strings)

Examples

parseTaxonnaam("Rosa canina L.")

Description

Deze hulpfunctie selecteert de indicatoren die gebruikt worden voor de bepaling van de Lokale Staat van Instandhouding voor de opgegeven parameters. Ze is bedoeld om te gebruiken als bouwsteen in andere functies waar de gegevens voor bijvoorbeeld een welbepaalde versie of welbepaalde habitattypes geselecteerd moeten kunnen worden.

De parameters kunnen enkel de hieronder gespecifieerde waarden bevatten en moeten als string opgegeven worden. Default is telkens "alle", waarbij de soortenlijsten voor alle mogelijke waarden van die parameter weergegeven worden (m.a.w. er is geen selectie voor deze parameter).

Usage

selecteerIndicatoren(
  Versie = "alle",
  Habitatgroep = "alle",
  Habitattype = "alle",
  Criterium = "alle",
  Indicator = "alle",
  HabitatnamenToevoegen = FALSE,
  ConnectieLSVIhabitats = NULL
)

Arguments

Value

Deze functie geeft een tabel met velden Versie, Habitattype, Habitatsubtype, Criterium, Indicator, Indicator_habitatID, TaxongroepId en Indicator_beoordelingID.

Examples

# Omwille van de iets langere lange duurtijd van de commando's staat bij
# onderstaande voorbeelden de vermelding 'dontrun' (om problemen te vermijden
# bij het testen van het package). Maar de voorbeelden werken en kunnen zeker
# uitgetest worden.
## Not run: 
library(LSVI)
maakConnectiePool()
selecteerIndicatoren(Versie = "Versie 2.0", Habitattype = "4030")
selecteerIndicatoren(Versie = "Versie 2.0", Habitatgroep = "Heiden")
library(pool)
poolClose(ConnectiePool)

## End(Not run)

Description

Deze hulpfunctie voor de s4-klassen aantal en bedekking zoekt soorten of kenmerken uit de voorwaarde in de opname en maakt een lijstje van de soorten die voldoen en in de opname voorkomen. Op basis hiervan kunnen de s4-klassen het totale aantal of de bedekking berekenen.

Usage

selecteerKenmerkenInOpname(
  Kenmerken,
  Soortengroep,
  Studiegroep,
  SubAnalyseVariabele,
  SubRefMin,
  SubRefMax,
  SubOperator
)

Arguments

Value

Deze functie geeft een aangepaste tabel Data_soorten terug waarin enkel de soorten uit de soortenlijst(en) opgenomen zijn en die bovendien gekoppeld is aan de gegevens van de soortenlijst.

Description

Deze functie zet een interval bestaande uit minimumwaarde en maximumwaarde om naar een uitvoerwaarde in de opgegeven eenheid. De functie gebruikt Type, Eenheid en Invoertype om te bepalen welke omzetting eventueel nodig is. Als minimum en maximum niet dezelfde waarde hebben, geeft ze beide waarden weer, gescheiden door een "-".

Usage

vertaalIntervalUitvoer(Dataset, LIJST, ConnectieLSVIhabitats)

Arguments

Value

Dataframe met velden Min

Description

Deze functie zet ingevoerde gegevens van meerdere types om naar een interval bestaande uit minimumwaarde en maximumwaarde. De functie gebruikt Type, Eenheid en Invoertype om te bepalen welke omzetting eventueel nodig is. Percentages worden bv. omgezet naar een decimaal getal (waarbij minimum en maximum dezelfde waarde zullen krijgen), en categorische variabelen met Invoertype Tansley worden omgezet naar de onder- en bovengrens die in de databank gegeven worden voor de betreffende categorie (op basis van parameter LIJST). Om een onderscheid te maken tussen numerieke waarden en aan-/afwezigheid, wordt voor deze laatste enkel de minimumwaarde ingevoerd (dus maximum = NA).

Usage

vertaalInvoerInterval(Dataset, LIJST, ConnectieLSVIhabitats)

Arguments

Value

Dataframe met velden Rijnr, Min en Max