⚠ PLANNED MAINTENANCE ⚠
Due to planned maintenance on DTU’s network infrastructure intermediate service interruptions are expected during the 30th and 31st of March
Venligst meld fejl i dette dokument eller forbedringsforeslag til : energydataDK@dtu.dk.
For at bedre kunne forstå denne vejledning og for at bruge EnergyDataDK optimalt, er det nyttigt at være bekendt med visse begreb.
Disse begreb er beskrevet i Tabel 1 nedunder.
| Term | Meaning |
|---|---|
| Datastream | A datastream is like a channel where data from a sensor, measurement device or similar is received. All observations at the channel are a tuple with a time stamp for when the observation was measured and the measurement itself, i.e., the “value”. All timestamps in energydata.dk are in UTC time. Each datastream is described by a number of mandatory tags (metadata) that qualify the data. |
| Dataset | A dataset is a collection of related datastreams. |
| Owner | The owner of a dataset is the user who has the rights to manage it. |
| Group | A collection of users is called a group, they all share the same privileges, i.e., which datasets they can access and what privileges they have for the dataset (read / write access). |
| Administrator (group) | An administrator is a group member with additional privileges. Administrators can manage group membership by adding or removing users. They can grant access to datasets by assigning licenses to the group. However, administrators can only grant access to datasets they own. |
| Member (group) | A user can be a member of a group and, through that membership, gain access to the datasets associated with the group. |
| License | Read or write access to a dataset is controlled by a license that is assigned to the group. This license defines the level of access the group has to the dataset. |
| Public | A privilege that makes it possible to view a dataset, but not read or write the data into it. |
| Open Dataset | "A public dataset that provides free access for energydata.dk users for reading the data. |
| Read | A read privilege allows users to view a datastream in the preview window, export the data to a CSV file, or access the data via the API for reading purposes. |
| Write | A privilege that makes it possible to insert data to a datastream via an API. |
| Topic | A unique label for a datastream. The topic is used when inserting or requesting data for a datastream via an API. |
| Tag | A tag is a descriptive metadata label used to characterize a datastream, helping to define its purpose or category and making it easier to search, filter, or organize. |
For yderlige sikkerhed kan du slå Tofaktorgodkendelse til.
For at slå Tofaktorgodkendelse til:
Når du opretter dig på Energydata.dk, får du automatisk adgang til alle åbne datasæt.
Efter login vil startsiden blive vist (Fig. 5). På højresiden vil små grafiske fliser blive vist, som repræsenterer de forskellige offentliggjorte datasets i EnergyDataDK.
På venstresiden er forskellige søgemuligheder,som kan begrænse visningen af datasets til kun dem med emner som du er interesseret i. Disse muligheder bliver beskrevet nedunder.
I venstre side af forsiden (Fig. 5) er der en søgefelt og en filtreringsformular.
I søgefeltet kan du indtaste en søgestreng for at søge efter et datasæt. Søgemaskinen vil søge efter match i alle dele af metadataene og beskrivelserne for de tilgængelige datasæt. Søgemaskinen fungerer ligesom andre søgemaskiner, så du kan f.eks. indtaste ‘Active power’, og søgningen vil finde alle datasæt, der indeholder datastrømme med søgestrengen i deres metadata eller beskrivelse. Resultatet vil blive vist som det antal datastrømme, der matcher søgestrengen (Fig. 6).
I ovennævnte eksempel blev 6 datasets fundet som matcher søgningen. De øvrige datasets indeholder ikke nogle datastreams hvilket er indikeret med deres falmede farver og meldingen “No datastreams found” på fliserne.
En søgning kan gøres mere præcis ved brug af operators, f.eks. kan du søge på “Active power” og undlade matches som indeholder “Bornholm” ved at søge på “Active power -Bornholm”. Resultatet af søgningen bliver vist i Figue 7.
Resultatet er nu at kun 4 datasets matcher din søgning.
OBS. 1:
Vær opmærksom på at søgemaskinen bruger en fuzzy search algoritme, hvilket betyder at den vil finde resultater som er tæt på men ikke en præcis match. F.eks hvis du søge på “frequency” vil du også få resultater med “fuse”, da disse ord ligner hinanden tilstrækkelig til at give en match..
OBS. 2:
Søgningen ser på beskrivelse og metadata af datastreams , som bliver tilføjet af dataejere. Det er muligt, at de ikke er detaljerede nok til at blive inkluderet i søgningen.
I sektionen Filter on tags kan du tilføje filtre til din søgning (Fig. 8). Kun de datasæt, der indeholder datastrømme, som matcher filteret og søgestrengen, vil blive vist.
I sektionen Geo tags kan du indtaste en geografisk placering. Tekstfeltet er en rullemenu, der viser en liste over alle tilgængelige geo-tags. De tilgængelige geo-tags inkluderer alle deklarerede geo-tags på tværs af samtlige datastrømme, der er defineret i Energydata.dk.
Det samme princip gælder for Theme tags.
Sektionen Filter by permission (Fig. 7) giver dig mulighed for at indsnævre de viste datasæt baseret på de specifikke adgangstilladelser, du har fået tildelt (Own, Read, Write). Denne indstilling hjælper med at forenkle visningen ved at fjerne de datasæt, som du ikke administrerer adgangen til, hvilket resulterer i en mere overskuelig og fokuseret side.
Når du vælger en dataset bliver rammen blå og du vil se en beskrivelse af dataet til venstre (Fig. 9).
Hvis du er tilfreds med dataet i datasættet kan du trykke på forstørrelsesglasset i den nedre højre hjørne af datasæt flisen. Ved at gøre dette bliver du sendt videre til til datastrømvisningen af den pågældende datasæt ( Fig. 10). Datastream view er der, hvor du kan inspicere dataene og vælge at downloade dem.
Datainspektionen sker i Search tab i Datastream view (Fig. 10). Her kan visuelt inspicere dataet og gennemgå metadata af datastrømmene.
Hvis du har adgang til datasættet, kan du inspicere hver enkelt datastrøm i Datastream preview vinduet (Fig. 11) , ved at klikke på en bestemt datastream.
I forhåndsvisningsvinduet vil en graf blive vist for:
Data bliver vist for standard tidsrummet (en uge). Du kan slå målinger til og fra ved at klikke på deres respektive ikoner. Tidsrummet kan tilpasses i forhåndsvisningen afsnittet ( Fig. 12).
Vær opmærksom på at:
Alle datasets du har læserettigheder til kan eksporteres. F.eks. du kan downloade en dataset helt eller delvis. Læserettigheder er indikeret af en afkrydsningsfelt i datastream vinduet ( Fig. 15a ), hvor en hængelås indikerer manglende rettigheder (Fig. 18a ).
Data kan downloades direkte fra hjemmesiden eller ved at bruge API’erne.
Eksporten af et datasæt resulterer i et link til en CSV-fil, som kan downloades. Linket sendes i en e-mail til den e-mailadresse, der er angivet i din profil. Du vælger en datastrøm, der skal inkluderes i eksporten, ved at sætte kryds i afkrydsningsfeltet til venstre for den pågældende datastrøm ( Fig. 15a ).
Standard vil eksportfilen blive navngivet “Energydata export dd-mm-åååå TT-MM-SS”, dvs. dato og tid eksporten blev foretaget. Man kan dog ændre navnet efter dine egne præferencer.
Eksportfilen er en CSV-fil som bliver sent til din email. Filen indeholder en kolonne for hver stream som blev selekteret for at blive eksporteret, samt en kolonne som indeholder tidsstemplet for observationen. Hver kolonne er navngivet efter følgende standard:
<datastream name>|<datastream topic>|<datastream property ID>
“Topic” and “property ID” er nødvendige, hvis du ønsker at bruge data-API’erne.
Ved oprettelse på Energydata.dk får du automatisk adgang til alle åbne datasæt.
Selvom datasættene er frit tilgængelige, kan de have licensbetingelser, som du skal overholde. Du kan finde disse betingelser i beskrivelsen af datasættet (Fig. 9) eller i datastrømmens metadata ( Fig. 13).
Du er ansvarlig for at imødekomme disse betingelser.
I beskrivelsen af et dataset (Fig. 9) bør også være beskrevet hvem ejer det. Du kan derfor også vælge at skrive til dem direkte for at bede om adgang til datasettet.
