Inleiding

Aan een filter kunnen zowel laagfrequente als hoogfrequente peilmetingen worden toegevoegd. Laagfrequente metingen zijn bijvoorbeeld tweewekelijkse handmatige metingen met een peillint, of ad hoc ijkingsmetingen, zie aanleveren manuele peilmetingen. Op deze pagina worden hoogfrequente metingen besproken, die gemeten met een sensor verbonden aan een instrument.

Meetreeks aanleveren

Synchroon versus asynchroon

Bij het opladen van één punt zal dat punt onmiddellijk worden toegevoegd aan DOV, i.e. synchroon. Bij het toevoegen van meerdere punten (zowel in de body van een POST-request als via een CSV-bestand) zal de import asynchroon verlopen. De status van een asynchrone import kan opgevraagd worden. Mogelijke waarden zijn: NIET_VERWERKT, IN_VERWERKING, VERWERKT_MET_FOUTEN, VERWERKT_ZONDER_FOUTEN, VERWERKT_MET_WAARSCHUWINGEN, VALIDATIE_MET_FOUTEN,  VALIDATIE_ZONDER_FOUTEN, VALIDATIE_MET_WAARSCHUWINGEN.

Dataformaat

DOV verwacht een specifiek formaat waaraan elk datapunt moet voldoen. Elk datapunt moet volgende gegevens bevatten:

• • Datum/tijd met tijdzone van het datapunt: yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm)
  • Sensorwaarde in de eenheid geregistreerd voor de sensor (zie tabblad sensor). 
  • Gevalideerd/niet gevalideerd: 1 is gevalideerd, 0 is niet gevalideerd.

Bijvoorbeeld: 2018-08-29T23:59:00.000+01:00,20.13,1

Meerdere punten kunnen in de API-call worden doorgestuurd worden of via een CSV-bestand. Het CSV bestand is een kommagescheiden bestand met op elke lijn 1 meetpunt.

Voor het omzetten van Ellitrack-bestanden naar DOV-formaat, zie titel Ellitrack naar DOV-formaat.

Meetreeks verwijderen

Gegevens verwijderen van een sensor kan door een tijdsinterval mee te geven waartussen alle meetwaarden moeten verwijderd worden.

• Indien de starttijd niet meegegeven is, zal alle data tot en met de eindtijd verwijderd worden.
• Indien de eindtijd niet meegegeven is, zal alle data vanaf de starttijd verwijderd worden.
• Indien geen tijd meegegeven is, zal alle data verwijderd worden.
• Indien zowel start- als eindtijd meegegeven wordt, zal alle data (incl. grenzen) binnen die periode verwijderd worden.

Meetreeks updaten

Om gegevens te updaten, moeten de bestaande meetwaarden eerst worden verwijderd en vervolgens opnieuw worden toegevoegd.

Indien gegevens worden opgeladen die al waren toegevoegd, zal bij de upload een validatiefout als antwoord terug komen. Voorbeeld van dergelijke boodschap is 'Meetpunt "2022-09-16T01:00:00.000+02:00" bestaat reeds in de databank voor deze sensor'.

Meetreeks downloaden

Er kan data aan een sensor of object (meetreeks) opgehaald worden. Het resultaat kan een JSON, CSV of ZIP zijn. Een ZIP zal steeds CSV-bestanden bevatten met data gegroepeerd per maand.

Meetreeks van een sensor

Een meetreeks kan gedownload worden voor een sensor op een instrument voor een bepaalde tijdperiode. Indien het instrument in deze periode aan verschillende objecten gekoppeld was (bv. 2 verschillende bodemlocaties), dan zal de meetreeks resultaten bevatten van de verschillende objecten.

Meetreeks van een object (filter/bodemlocatie)

Een meetreeks van een bepaalde parameter op een gekoppeld object kan gedownload worden voor een bepaalde tijdsperiode. De data kan afkomstig zijn van verschillende instrumenten. 

Indien het instrument meerdere sensoren van dezelfde parameter bevat, moet er een sensoridentificatie worden toegevoegd. Als een gazondolk bijvoorbeeld de temperatuur 10cm boven het maaiveld, en 10cm onder het maaiveld meet, moet naast de parametercode voor temperatuur ook de sensoridentificatie meegegeven worden. Op die manier kan dan ofwel de temperatuur boven het maaiveld, ofwel de temperatuur onder het maaiveld opgevraagd worden.

Via het DOV-Portaal

Meetreeks aanleveren

• Navigeer via 'Beheer instrumenten', naar het instrument en naar de tab 'Sensoren'
• Vink de sensor aan die de meetreeks heeft opgemeten
• Klik onder 'Acties' op 'Voeg data toe'

• Upload CSV-bestand en klik op 'Registreer'
  • Er opent een dialoog waarin je een CSV-bestand kan uploaden.
  • Voor meer informatie over het formaat zie dataformaat 

• Status verwerking
  • Het bestand wordt asynchroon verwerkt, en je krijgt de verwerkingsstatus te zien.
  • Klik op 'OK' om de dialoog te sluiten.

• • Je kan de verwerkingsstatus voor een sensor steeds opnieuw opvragen onder 'Acties' > 'Status laatste import'.

Meetreeks verwijderen

• Vink de sensor aan waarvoor je een meetreeks wenst te verwijderen
• Klik onder 'Acties' op 'Verwijder data'

• Geef een start en einddatum op
  • Of klik op 'Selecteer alles' en de datums worden vanzelf ingevuld op het eerste en laatste datapunt voor deze sensor.
  • Kies optioneel of je enkel gevalideerde of niet-gevalideerde meetpunten wilt verwijderen,
• Klik op 'Verwijder'

Meetreeks updaten

Om meetreeksen up te daten, moet je eerst de gewenste periode verwijderen, en daarna opnieuw opladen. Indien je een meetreeks oplaadt die overlapt met een bestaande meetreeks, krijg je een foutmelding.

Via de DOV-webservices

Instrumenten, sensoren en bijhorende meetreeksen kunnen automatisch worden beheerd via de DOV webservices.

API documentatie

Voor meer informatie zie:

• Overzicht API-endpoints instrumenten
• Technische handleiding van de webservices omtrent hoogfrequente metingen

Python

Er is een voorbeeldscript beschikbaar waar API-endpoints en calls worden gedemonstreerd voor

• Het testen van je certificaat
• Aanmaken en koppelen van een Gazondolk (Type van instrument)
• Aanmaken en koppelen van een Diver (Type van instrument)
• Uploaden van loggermetingen/peilmetingen
• Uploaden via API van manuele peilmetingen via XML bestanden

Java

Dit java quickstart-project op Github demonstreert hoe je de DOV-services kan oproepen. Hoe je een secure connection opbouwt met een certificaat vind je hier.

Node.js

In hetzelfde quickstart-project vind je ook een voorbeeld in Node.js.

Nuttige tools

Ellitrack naar DOV-formaat

Ellitrack levert verschillende types dataloggers waarmee grondwaterstanden automatisch gemeten en doorgestuurd kunnen worden. De data komt in het Ellitrack-platform terecht, van waaruit het geëxporteerd kan worden als XML. Hieronder vind je een script waarmee dit XML-formaat kan worden omgezet in het CSV-formaat van DOV.

• EXE-bestand: Ellitrack_to_DOV_v1.exe
• Python-script: Ellitrack_to_DOV_v1.py

Hoe gebruiken

• • Plaats het EXE-bestand in een folder naar keuze.
  • Dubbelklik op het bestand.
  • Selecteer het XML-bestand via de knop 'Selecteer', klik daarna op 'naar DOV-formaat'.
  • De bestanden zijn nu te vinden in de nieuwe folder 'output'.

Opgelet: voorlopig werkt het script enkel voor het XML-formaat versie 2 van toesteltype Ellitrack-A. Het scriptje maakt enkel de importbestanden aan voor de tijdreeksen. Die kunnen dan opgeladen worden manueel of geautomatiseerd via DOV-webservices (zoals hierboven beschreven). De putten, filters, instrumenten en koppelingen tussen instrument en filter moeten eerst op een andere manier worden aangemaakt (hetzij manueel, hetzij via webservices). Het script voorziet wel een meta-databestand waarin de beschikbare metadata uit het XML-bestand terug te vinden is (bv. serienummer, beschrijving, ophanglengte, kalibratiefactoren).