Descrizione semantica dell´UrbanDataset MicroclimateMonitoring della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset MicroclimateMonitoring 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-09 23:03

Link alle SCPS

https://smartcityplatform.enea.it/#/it/index.html

Introduzione

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:

Identificazione UrbanDataset: riporta lo scopo dell´UrbanDataset e i parametri (identificatore, nome e URI) con cui è identificato univocamente nell´ambito delle SCPS. Fornisce le informazioni che popolano la sezione "Specification" dei messaggi UrbanDataset.
Contestualizzazione UrbanDataset: riporta le proprietà di contesto (ContextProperty) associate all´UrbanDataset, indicandone il nome, il significato (descrizione), il tipo di dato e l´eventuale set di valori (lista di codici) a cui è vincolata; le proprietà che contestualizzano un UrbanDataset non hanno unità di misura e sono tutte obbligatorie a meno che non sia diversamente indicato nella descrizione. In questa sezione, inoltre, sono fornite eventuali indicazioni sull´uso delle proprietà di contesto nell´ambito dello specifico UrbanDataset. Indica le proprietà che popolano la sezione "Context" dei messaggi UrbanDataset.
Proprietà UrbanDataset: riporta le proprietà (UrbanDatasetProperty) che definiscono univocamente l´UrbanDataset nell´ontologia SCPS, indicandone il nome, il significato (descrizione), l´obbligatorietà, il tipo di dato, l´eventuale set di valori (lista di codici) a cui è vincolata e l´eventuale unità di misura. Le proprietà con l´asterisco sono quelle per cui, a livello di istanza, occorre l´indicare la modalità con cui sono stati rilevati i valori attribuiti alla proprietà (ad esempio, totale o valore medio sul periodo di misurazione). Indica le proprietà che popolano ogni riga della sezione "Values" dei messaggi UrbanDataset.

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

seconda della sintassi scelta, lo schema scps-urbandataset-schema-2.0:
- JSON Schema
- XML Schema
la definizione semantica dell´UrbanDataset che può essere acquisita o tramite l´ontologia OWL, o tramite la UDWebLibrary, o tramite questa documentazione.

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

MicroclimateMonitoring-2.0

Identificazione UrbanDataset
Scopo	Monitoraggio dei parametri di confort degli ambienti abitati
Categoria / Sottocategoria	BuiltEnvironment / SmartHome
Identificatore	MicroclimateMonitoring-2.0
Nome	Microclimate Monitoring
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#MicroclimateMonitoring
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
RoomCode	Codice che identifica la tipologia di stanza (es. cucina, bagno, ufficio) in cui ? installato il sensore	sì	string RoomCode.gc
SensorID	Identificativo univoco del sensore, per es. il serial number, il mac address	sì	string
SensorTypeCode	Tipo di sensore (es. smart plug, smart switch, presence, ..) che effettua la misura, espresso come codice	sì	string SensorTypeCode.gc
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
AirTemperature	Temperatura dell'aria	no	double	degreeCelsius[default] degreeFahrenheit
AtmosphericPressure	Pressione atmosferica osservata	no	double	hectopascal[default] pascal
IndoorAirQualityIndex	Indice di qualit? dell'aria in un ambiente chiuso	no	double
IndoorCO2	Misura (diretta o stimata) della CO2 in ambiente chiuso	no	double	partsPerMillion[default]
IndoorCO2Equivalent	Misura (indiretta) della CO2 correlata al VOC equivalente riferito al respiro medio di un essere umano	no	double	partsPerMillion[default]
Luminosity	misura della luminosit?	no	double	lux[default]
OccupantCount	Numero di occupanti di un ambiente confinato	no	integer
PM2	Quantita' di particolato, polveri sottili, con diametro <= 2,5 micron	no	double	microgramPerCubicMeter[default]
PMV	Indice PMV (predicted mean vote) della misura del confort indoor secondo la scala [-3,+3]	no	double
RadonConcentration	Concentrazione di Radon	no	double	becquerelPerCubicMetre[default]
RealEstateUnitID	Identificativo dell'unit? immobiliare (es. appartamento, edificio, abitazione indipendente...)	no	string
RelativeHumidity	Umidita' relativa dell'aria espressa in percentuale	no	double
RoomID	Identificatore della stanza	no	string
SensorName	Marca/modello (codice) del sensore	no	string
VOC	Composti organici volatili	no	double	partsPerMillion[default] partsPerBillion
WindowStatusCode	Codice indicante lo stato della finestra (aperta o chiusa)	no	string WindowStatusCode.gc
coordinates	Riferimento geografico	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	sì	double
subProperty: longitude	Longitudine	sì	double

PARTE II: Liste di codici

RoomCode.gc

Nome sintetico	RoomCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/RoomCode.gc
Agency	ENEA
Codice	Valore
KTH-R	Cucinotto
KTC-R	Cucina
LVN-R	Soggiorno
DRW-R	Sala/Salotto
BTH-R	Bagno
BED-R	Camera
STD-R	Studio
CRR-R	Corridoio
LND-R	Lavanderia
CLL-R	Cantina
OFF-R	Ufficio
CLS-R	Aula
ADT-R	Aula magna
LBR-R	Biblioteca
PTN-R	Stanza Degenza
LVN-A	Zona Giorno
SLP-A	Zona Notte
SRV-A	Zona Servizi
CMM-A	Spazio Comune
OTH-R	Altro

SensorTypeCode.gc

Nome sintetico	SensorTypeCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/SensorTypeCode.gc
Agency	ENEA
Codice	Valore
1	Smart Plug
2	Smart Switch
3	Sensore smart di presenza
4	Multisensore confort
5	Multisensore meteo
99	Altro

WindowStatusCode.gc

Nome sintetico	WindowStatusCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/WindowStatusCode.gc
Agency	ENEA
Codice	Valore
O	Finestra aperta
C	Finestra chiusa

FormatCode.gc

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

LanguageCode.gc

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

TimezoneCode.gc

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

Descrizione semantica dell´UrbanDataset MicroclimateMonitoring della SCP Ontology 2.0

Indice

Introduzione

PARTE I: UrbanDataset

PARTE II: Liste di codici

Introduzione

1. Come leggere questo documento

2. Strumenti per creare un messaggio UrbanDataset

PARTE I: UrbanDataset

MicroclimateMonitoring-2.0

PARTE II: Liste di codici

RoomCode.gc

SensorTypeCode.gc

WindowStatusCode.gc

FormatCode.gc

LanguageCode.gc

TimezoneCode.gc