Descrizione semantica dell´UrbanDataset BuildingDeviceAnomalies della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset BuildingDeviceAnomalies 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 2024-05-14 19:17
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. BuildingDeviceAnomalies

PARTE II: Liste di codici

  1. DeviceAnomalyCode.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. BuildingDeviceAnomalies-2.0
  2. Identificazione UrbanDataset
    Scopo Conteggia le anomalie di uno o più sensori associati a un determinato edificio, calcolati per una particolare causa, su una particolare finestra temporale
    Categoria / Sottocategoria BuiltEnvironment / SmartBuilding
    Identificatore BuildingDeviceAnomalies-2.0
    Nome Building Device Anomalies
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#BuildingDeviceAnomalies
    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
    BuildingID Identificatore dell'edificio

    string

    BuildingName Etichetta associata all'edificio

    string

    DataDescription Descrizione testuale dei dati inviati

    string

    DeviceAnomalyCode Codice identificativo dell'anomalia del device

    string

    DeviceAnomalyCode.gc
    DeviceID Identificatore del device

    string

    DeviceTotalAnomalies Numero totale delle anomalie individuate su un device

    integer

    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

PARTE II: Liste di codici

  1. DeviceAnomalyCode.gc
  2. Nome sintetico DeviceAnomalyCode
    Versione 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/DeviceAnomalyCode.gc
    Agency ENEA
    Codice Valore
    1 Nessun nuovo dato acquisito sul sensore Scada
    2 Valore al di fuori del range operativo
    3 Valore al di fuori del range funzionale

  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