Indholdsfortegnelse

Data visualisering

Introduktion

Visualisering af data fra EnergyDataDK kan hjælpe dig med at identificere eventuelle huller i dataene og vurdere datakvaliteten; den kan desuden anvendes til at overvåge, om datastrømme falder uden for de fastsatte tolerancer, samt til demonstrationsformål m.m.

EnergyDataDK har indbygget funktionalitet, der hjælper dig med dette; du skal blot vælge et datasæt, som du har læseadgang til, vælge en datastrøm og angive et tidsinterval for at få vist en forhåndsvisning. Dette hjælper dig med at vurdere, om der foreligger data for den pågældende periode, og om der er eventuelle huller i dataene.
Du kan finde en detaljeret vejledning i vores platformguide.

Du kan desuden bruge vores API‘er til at udtrække data og benytte forskellige muligheder for at præsentere dataene visuelt.
Herunder finder du vejledninger, eksempler og måske endda lidt inspiration.

Hvis du støder på fejl i dette dokument eller har forslag til forbedringer, bedes du kontakte os på EnergyDataDK@DTU.DK.

visualiseringsapplikationer

Der findes en række visualiseringsapplikationer fra tredjepart, der gør det muligt at generere grafer baseret på enten historiske data eller live-data.

Mange programmer til datavisualisering kan bruges gratis, er relativt nemme at anvende, og man kan som regel komme i gang på få minutter.

Grafana

Om Grafana

Grafana er en open source-webapplikation til analyse og visualisering. Den opretter forbindelse til tidsseriedatabaser og andre datakilder, hvilket gør det muligt for brugere at oprette dashboards, der viser måleværdier, logfiler og traces.

Wikipedia

Grafana er vores foretrukne værktøj til datavisualisering. Det er en kraftfuld og brugervenlig open source-løsning, hvilket betyder, at du kan bruge Grafana gratis. Du kan finde det her. Installationen af ​​Grafana er forholdsvis ligetil, så i denne guide går vi ud fra, at du kan komme i gang med Grafana ved at følge trinene i registreringsprocessen. I denne guide holder vi os til det grundlæggende, men som tidligere nævnt tilbyder Grafana en lang række funktioner. Hvis du vil vide mere om løsningen, henviser vi til deres dokumentationsside.

Live data overvågning

I dette eksempel forbinder vi Grafana til en datastrøm ved at abonnere på den via EnergyDataDK’s MQTT-broker.

Sørg venligst for, at følgende betingelser er opfyldt.

  • Du har adgang til de datastrømme, du ønsker at visualisere.
  • Du har et API-token, der giver tilladelse til at “oprette forbindelse til MQTT og læse/skrive data i realtid” for de datasæt, der indeholder de datastrømme, du ønsker at visualisere.
MQTT-datakilde-pluginet

Først og fremmest skal du installere “MQTT data source plugin“. Følg linket hvis du vide noget mere først, ellers fortsæt med installationen.

Trin 1:Selekter Administration → Plugins and data → Plugins fra hovedmenuen til venstre.

Trin 2:Skriv “MQTT” i søgefeltet og tryk på MQTT flisen.

Trin 3:Tryk på Install knappen i den øverste hjørne til højre.

Etabler forbindelsen

Nu skal vi etablere forbindelsen til datastrømmen.

Trin 1: Selekter Connections → Data sources fra hovedmenuen til venstreog tryk på Add new data source knappen in den øverste hjørne til højre.
Se skærmbilledet
Trin 2: Skriv “MQTT” i søgefeltet og tryk på MQTT flisen.
Se skærmbilledet
Trin 3: Du kan nu konfigurere data kilden. For at gøre dette, følge disse trin:
  1. Under afsnittet Connection skal du i feltet URI indtaste “mqtts://mqtts.energydata.dk:8883”.
  2. Under afsnittet Authentication skal du indtaste din API-nøgle i feltet Username.
  3. Lad felterne Client ID og Password være tomme.
  4. Klik på Save and test knappen.
Du bør nu få en “MQTT connected” besked. Hvis din API nøgle er ugyldig får du “error connecting to MQTT broker: not Authorized” fejlbesked i stedet for.
Se skærmbilledet
Opret et dashboard

Nu forbindelsen er oprettet er det tid til at visualisere datastrømmen.

Trin 1: Selekter Dashboards fra hovedmenuet til venstre, tryk på New knappen i den øverste hjørne til højre, og valg New dashboard muligheden.
Se skærmbilledet
Trin 2: Skriv “MQTT” i søgefeltet og tryk på MQTT flisen.
Se skærmbilledet
Trin 3: Klik eller slæb en fane fra menuet til højre til midten af skærmen.
Se skærmbilledet
Trin 4: Tryk på Configure visualization knappen.
Se skærmbilledet
Trin 5: Selekter grafana-mqtt-datasource valgmuligheden fra Data source feltet.
Se skærmbilledet
Trin 6: I Topic feltet, skriv dit fulde MQTT emne (både præfiks og suffiks), for eksempel: dataset/datastream-collection/datastream. Du burde nu se en grafik blive dannet mens værdierne bliver modtaget.
Se skærmbilledet
Valgfri trin: Du vil muligvis lægge mærke til, at der bliver vist Unix tidsstempler på x-aksen, som ikke giver meget mening for os.Vi skal derfor omdanne det til noget læseligt. Du kan opnå det ved at gøre følgende:
  • Vælg timestamp i X field under X axis i menuen til venstre.
  • Skift til Transformations fanen nederst på skærmen i venstre side.
  • Vælg Timestamp og Time i de to inputfelter.
Når du har foretaget dine ændringer og tilpasninger, skal du klikke på Save knappen for at gemme dit panel og derefter på Back to dashboard knappen. Du bør nu kunne se normal tid og dato på x-aksen.
Se skærmbilledet

Du kan tilføje yderlige paneler ved at gentage ovennævnte trin for hver datastrøm du vil overvåge.

Skræddersyede visualiseringer ved brug af API

Du kan bruge EnergyDataDKs API for at skabe dine egne visualiseringer. Dette kan være ting som grafikker, diagrammer, eller dashboards. Nedenunder vil vi vise nogle eksempler af visualisering som gør brug af EnergyDataDK API’et.

Graphs generator

Grafgeneratoren giver dig i bund og grund mulighed for at uploade en fil, der beskriver det datasæt fra EnergyDataDK, du ønsker at visualisere, hvorefter du vælger, hvilke datastrømme du vil generere grafer for, og for hvilken periode.

Der genereres grafer for hver af de valgte datastrømme for den pågældende periode.

Applikationen er udelukkende bygget ved hjælp af klientside-scripting (JavaScript). Den sammensætter fetch kommando på baggrund af brugerens input og bruger disse oplysninger til at generere grafer med jsGraph.

Graph generator
Prøv det selv

Instruktioner

Forudsætninger:

  • En API-nøgle, der giver rettigheder til at “hente data fra datasæt via

    API

    “. Du kan finde vejledning i, hvordan du opretter et API-token, her.
  • En definitionsfil.

    Find datasættet du vil visualisere som beskrevet her.

    Klik på ikonet, selekter Download, og Export to .CSV

Trin:

  1. Tryk på knappen og selekter definitionsfilen.
    En liste med datastrømme bør nu blive vist på venstre side af skærmen.
  2. Valg de datastrømme som du vil visualisere.
  3. Indtast din API key.
  4. Valg start- og slutdatoerne for at specificere hvilken periode de vil visualisere.
  5. Tryk på knappen.

Når du har fulgt disse trin bør du få vist grafer efter alt data er blevet hentet.

Dashboards

Et dashboard er en måde at vise en tilstand. Derfor giver det mening at bruge en MQTT broker for at kontinuerligt modtage de seneste værdier. Du kan også vælge at hente de seneste værdier kan også blive hentet i et bestemt interval. Nedenunder er eksempler af dashboards som bruger EnergyDataDK API’et.