Descrizione semantica dell´UrbanDataset M2ElectricUserDevice della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset M2ElectricUserDevice 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-12-07 05:43
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. M2ElectricUserDevice

PARTE II: Liste di codici

  1. Chain2WeaveCode.gc
  2. ElectricityEndUseCode.gc
  3. TownCode.gc
  4. FormatCode.gc
  5. LanguageCode.gc
  6. 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. M2ElectricUserDevice-2.0

    2. Identificazione UrbanDataset
    Scopo Fornisce le informazioni rilevate da un dispositivo utente M2 monofase o trifase. Supporta le trame Chain 2 CF101 e CF103
    Categoria / Sottocategoria EnergyManagement / EnergyDemand
    Identificatore M2ElectricUserDevice-2.0
    Nome M2 Electric User Device
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#M2ElectricUserDevice
    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
    ProducedActiveEnergy Energia attiva prodotta nel periodo (nel caso di DU trifase e' il totale delle tre fasi) associabile al primo valore del campo Chain2 con OBIS '1-0:99.1.1.255'

    		 sì double

    		 kilowattHour[default]
    ProducedActivePower Potenza attiva prodotta nel periodo (nel caso di DU trifase e' il totale delle tre fasi), corrispondente al campo Chain2 con OBIS '1-0:2.27.0.255'

    		 sì dateTime

    		 kilowatt[default]

    watt
    TownCode Codice ISTAT del Comune

    		 sì string

    TownCode.gc
    UserDeviceID Identificativo del Dispositivo Utente

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

    		 sì Proprietà aggregata
    subProperty: end_ts Marca temporale indicante la fine del periodo sì dateTime
    subProperty: start_ts Marca temporale indicante l'inizio del periodo sì dateTime
    timestamp Marca temporale

    		 sì dateTime
    Chain2WeaveCode Codice che identifica la trama Chain2 implementata dall'istanza dell'UrbanDataset

    		 no string

    Chain2WeaveCode.gc
    ElectricityEndUseCode Uso finale dell'energia elettrica consumata (ad es. illuminazione, forza motrice, generale, condizionamento,...)

    		 no string

    ElectricityEndUseCode.gc
    EnergyCommunityID Identificatore della comunita' energetica

    		 no string
    MeterID Identificativo univoco del contatore

    		 no string
    MeterSchemeID Identificativo dello schema di codifica a cui appartiene l'identificativo fornito nel campo MeterID

    		 no string
    PODID Codice POD che identifica univocamente il punto di prelievo

    		 no string
    PrimarySubstationID Identificativo della Cabina Primaria

    		 no string
    ProducedActiveEnergyReading Energia attiva totale prodotta (corrispondente al valore visualizzato sul contatore nell'istante della fine del periodo della riga). Corrisponde al campo Chain2 con OBIS '1-0:2.8.0.255'

    		 no double

    		 kilowattHour[default]
    ProducedCapacitiveEnergy Energia reattiva capacitiva prodotta nel periodo (solo per dispositivi utente trifase) corrispondente al campo Chain2 con OBIS '1-0:99.1.5.255'

    		 no double

    		 kilovoltamperereactivePerHour[default]

    voltamperereactivehour
    ProducedInductiveEnergy Energia reattiva induttiva prodotta nel periodo (solo per dispositivi utente trifase), corrispondente al primo valore del campo Chain2 con OBIS '1-0:99.1.4.255'

    		 no double

    		 kilovoltamperereactivePerHour[default]

    voltamperereactivehour
    ProducedInductiveEnergyReading Energia reattiva induttiva totale prodotta (corrispondente al valore visualizzato sul contatore nell'istante della fine del periodo della riga) corrispondente al campo Chain2 con OBIS '1-0:7.8.0.255