Descrizione semantica dell´UrbanDataset EnergyConversionSystemRecords della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset EnergyConversionSystemRecords 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-10 13:30

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

EnergyConversionSystemRecords-2.0

Identificazione UrbanDataset
Scopo	Anagrafica sistemi di conversione dell'energia: fornisce una descrizione univoca di sistemi/macchine di conversione di energia
Categoria / Sottocategoria	EnergyManagement / EnergyTransmissionAndDistribution
Identificatore	EnergyConversionSystemRecords-2.0
Nome	Energy Conversion System Records
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#EnergyConversionSystemRecords
Contestualizzazione UrbanDataset
Come utilizzare le proprietà di contesto Le coordinate a livello di context sono riferite al sistema che ha fornito i dati
	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
EnergySystemID	Identificativo del sistema energetico (o macchina o apparecchio)	sì	string
EnergySystemPower	Potenza del sistema	sì	double	kilowatt[default]
EnergySystemTechnologyName	Nome che identifica la tecnologia del sistema energetico	sì	string
coordinates	Coordinate del singolo sistema o macchina	sì	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
DataDescription	Note in testo libero	no	string
EnergySystemEfficiencyPercentage	Rendimento totale della macchina, espresso in percentuale	no	double
MinInputCoolingPower	Input frigo minimo	no	double	kilowatt[default]
MinInputElectricPower	Input elettrico minimo	no	double	kilowatt[default]
MinInputFuelPower	Input combustibile minimo	no	double	kilowatt[default]
MinInputThermalPower	Input termico minimo	no	double	kilowatt[default]
MinOutputCoolingPower	Output frigo a carico minimo	no	double	kilowatt[default]
MinOutputElectricPower	Output elettrico a carico minimo	no	double	kilowatt[default]
MinOutputFuelPower	Output combustibile a carico minimo	no	double	kilowatt[default]
MinOutputThermalPower	Output temico a carico minimo	no	double	kilowatt[default]
NominalInputCoolingPower	Input frigo nominale	no	double	kilowatt[default]
NominalInputElectricPower	Input elettrico nominale	no	double	kilowatt[default]
NominalInputFuelPower	Input combustibile nominale	no	double	kilowatt[default]
NominalInputThermalPower	Input termico nominale	no	double	kilowatt[default]
NominalOutputCoolingPower	Output frigo a carico nominale	no	double	kilowatt[default]
NominalOutputElectricPower	Output elettrico a carico nominale	no	double	kilowatt[default]
NominalOutputFuelPower	Output combustibile a carico nominale	no	double	kilowatt[default]
NominalOutputThermalPower	Output termico a carico nominale	no	double	kilowatt[default]
OperationMaintenanceCost	Costo di Operation and Maintenance (come proporzione rispetto alla potenza). L'unità di misura e': Euro/kW	no	double	euro[default]
SchemeID	Identificativo dello schema di codifica a cui appartiene l'identificativo fornito nel campo EnergySystemID (è l'ambito nel quale l'identificativo è stato definito; ad es. "CampusParma", "CampusLeonardo")	no	string

PARTE II: Liste di codici

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 EnergyConversionSystemRecords 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

EnergyConversionSystemRecords-2.0

PARTE II: Liste di codici

FormatCode.gc

LanguageCode.gc

TimezoneCode.gc