Descrizione semantica dell´UrbanDataset EnergyCommunityKPI della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset EnergyCommunityKPI la cui semantica è definita formalmente dalla SCP Ontology 2.0, parte delle "Specifiche Smart City Platform (SCPS) - Livello semantico" realizzate nell´ambito del Progetto di Ricerca di Sistema Elettrico.

Data di creazione di questo documento 2025-03-12 12:41
Link alle SCPS https://smartcityplatform.enea.it/#/it/index.html

Indice

Introduzione

  1. Come leggere questo documento
  2. Strumenti per creare un messaggio UrbanDataset

PARTE I: UrbanDataset

  1. EnergyCommunityKPI

PARTE II: Liste di codici

  1. EnergyCommunityKPICode.gc
  2. FormatCode.gc
  3. LanguageCode.gc
  4. TimezoneCode.gc

Introduzione

1. Come leggere questo documento

Questo documento fornisce una rappresentazione human-friendly della definizione semantica di uno o più UrbanDataset dell´ontologia SCPS.

Ogni UrbanDataset è descritto attraverso una tabella costituita da tre sezioni principali:

2. Strumenti per creare un messaggio UrbanDataset

I riferimenti normativi per la conformità sintattica e semantica degli UrbanDataset alle SCPS sono:

Inoltre, nella UDWebLibrary, tra le risorse disponibili nella scheda di ogni UrbanDataset, è possibile scaricare i template dei messaggi in sintassi JSON e XML, conformi alle specifiche. Un template costituisce un esempio di istanza UrbanDataset avente tutte le proprietà (obbligatorie e opzionali) che lo compongono (per le eventuali proprietà con unità di misura alternative e/o metodo di calcolo vengono usati i valori di default).

PARTE I: UrbanDataset

  1. EnergyCommunityKPI-2.0
  2. Identificazione UrbanDataset
    Scopo Fornisce KPI relativi a una comunita' energetica
    Categoria / Sottocategoria BuiltEnvironment / LandUseAndManagement
    Identificatore EnergyCommunityKPI-2.0
    Nome EnergyCommunityKPI
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#EnergyCommunityKPI
    Contestualizzazione UrbanDataset
    Descrizione Formato/Lista di Codici
    coordinates Riferimento geografico

    Proprietà aggregata
    subProperty: format Formato wgs84 in cui sono espresse le coordinate (attributo opzionale) string

    FormatCode.gc
    subProperty: height Altitudine (proprietà opzionale) double

    subProperty: latitude Latitudine double

    subProperty: longitude Longitudine double

    language Lingua in cui sono espressi i campi testo dell'istanza

    string

    LanguageCode.gc
    timestamp Marca temporale

    dateTime

    timezone Fuso orario delle marche temporali espresso come offset, ovvero come + oppure - il numero di ore e minuti di distanza dall'ora UTC: +/-hh:mm (ISO 8601)

    string

    TimezoneCode.gc
    Proprietà UrbanDataset

    * le proprietà marcate con asterisco sono proprietà per le quali è necessario indicare, a livello di istanza, il metodo di calcolo adottato (ad es. "average", "total", "instantaneous",...)
    Nome Descrizione Obbligatoria Formato/Lista di Codici Unità di misura
    EnergyCommunityID Identificatore della comunita' energetica

    string

    EnergyCommunityKPICode Codice indicante un Key Performance Indicator (KPI) applicabile al contesto delle comunita' energetiche

    string

    EnergyCommunityKPICode.gc
    KPIValue Valore calcolato per il KPI specifico

    double

    period Periodo durante il quale sono stati rilevati i dati riportati nella riga

    Proprietà aggregata
    subProperty: end_ts Marca temporale indicante la fine del periodo dateTime

    subProperty: start_ts Marca temporale indicante l'inizio del periodo dateTime

    KPIUnitOfMeasure Unita' di misura del KPI (se applicabile)

    no string

    TownName Nome esteso del Comune es. Roma, Anguillara Sabazia, ecc

    no string

    coordinates Coordinate geografiche della comunita' energetica

    no Proprietà aggregata
    subProperty: format Formato wgs84 in cui sono espresse le coordinate (attributo opzionale) no string

    FormatCode.gc
    subProperty: height Altitudine (proprietà opzionale) no double

    subProperty: latitude Latitudine double

    subProperty: longitude Longitudine double

PARTE II: Liste di codici

  1. EnergyCommunityKPICode.gc
  2. Nome sintetico EnergyCommunityKPICode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EnergyCommunityKPICode.gc
    Agency ENEA
    Codice Valore
    SE Energia Condivisa: valore minimo, in ogni intervallo di tempo, tra l'energia prelevata dalla rete elettrica e l'energia elettrica immessa in rete.
    SCR Percentuale di autoconsumo: rapporto tra l'energia elettrica autoconsumata più l'energia condivisa e l'energia elettrica prodotta all'interno della CER.
    SSR Percentuale di autosufficienza: rapporto tra l'energia elettrica autoconsumata più l'energia condivisa e la domanda di energia elettrica all'interno della CER.
    ESP Percentuale di autoproduzione elettrica: rapporto tra la quantita' totale di energia elettrica prodotta nel sito e la domanda di energia elettrica.
    GEIF Fattore di interazione dell'energia della rete: rapporto tra l'energia prelevata dalla rete, l'energia immessa in rete e la domanda di energia elettrica della REC.
    SYC Coefficiente di sincronizzazione: rapporto tra l'energia elettrica prelevata dalla rete quando l'energia elettrica è prodotta anche dalla REC e l'energia elettrica complessivamente prelevata dalla rete.
    ESO Opportunita' di stoccaggio dell'energia: quantifica la necessita' di sistemi di accumulo di energia all'interno del REC confrontando il surplus di energia elettrica al momento t, il deficit di energia elettrica e l'energia elettrica caricata o scaricata al momento t dalle batterie all'interno della REC.
    FA Flessibilita' attivata: Energia annuale utilizzata all'interno della REC per scopi di flessibilita'.

  3. FormatCode.gc
  4. Nome sintetico FormatCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/FormatCode.gc
    Agency ENEA
    Codice Valore
    WGS84-DMS WGS84 - Formato Gradi, Minuti, Secondi
    WGS84-DD WGS84 - Formato Gradi Decimali

  5. LanguageCode.gc
  6. Nome sintetico LanguageCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/LanguageCode.gc
    Agency ENEA
    Codice Valore
    IT Italiano
    EN Inglese

  7. TimezoneCode.gc
  8. Nome sintetico TimezoneCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/TimezoneCode.gc
    Agency ENEA
    Codice Valore
    UTC-12 −12:00
    UTC-11 −11:00
    UTC-10 −10:00
    UTC-9:30 −09:30
    UTC-9 −09:00
    UTC-8 −08:00
    UTC-7 −07:00
    UTC-6 −06:00
    UTC-5 −05:00
    UTC-4 −04:00
    UTC-3:30 −03:30
    UTC-3 −03:00
    UTC-2 −02:00
    UTC-1 −01:00
    UTC +00:00
    UTC+1 +01:00
    UTC+2 +02:00
    UTC+3 +03:00
    UTC+3:30 +03:30
    UTC+4 +04:00
    UTC+4:30 +04:30
    UTC+5 +05:00
    UTC+5:30 +05:30
    UTC+5:45 +05:45
    UTC+6 +06:00
    UTC+6:30 +06:30
    UTC+7 +07:00
    UTC+8 +08:00
    UTC+8:30 +08:30
    UTC+8:45 +08:45
    UTC+9 +09:00
    UTC+9:30 +09:30
    UTC+10 +10:00
    UTC+10:30 +10:30
    UTC+11 +11:00
    UTC+12 +12:00
    UTC+12:45 +12:45
    UTC+13 +13:00
    UTC+14 +14:00