Descrizione semantica dell´UrbanDataset EarthquakeDamagedBuildingsCounter della SCP Ontology 2.0

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

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

EarthquakeDamagedBuildingsCounter-2.0

Identificazione UrbanDataset
Scopo	Fornisce dati sul numero di edifici danneggiati in una specifica area geografica a causa di un evento sismico. Il livello di danno e' indicato secondo la Scala Europea Macrosismica (EMS-98)
Categoria / Sottocategoria	PublicSafetyPolicyEmergencyResponse / NaturalHazard
Identificatore	EarthquakeDamagedBuildingsCounter-2.0
Nome	Earthquake Damaged Buildings Counter
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#EarthquakeDamagedBuildingsCounter
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
ModerateDamageBuildingCount	Numero di edifici che hanno subito un livello di danno D2 ('moderato' secondo l'EMS-98)	sì	integer
NegligibleDamageBuildingCount	Numero di edifici che hanno subito un livello di danno D1 ('trascurabile' secondo l'EMS-98)	sì	integer
SubstantialDamageBuildingCount	Numero di edifici che hanno subito un livello di danno D3 ('da sostanziale a pesante' secondo l'EMS-98)	sì	integer
TotalDestructionBuildingCount	Numero di edifici che hanno subito un livello di danno D5 ('distruzione totale' secondo l'EMS-98)	sì	integer
VeryHeavyDamageBuildingCount	Numero di edifici che hanno subito un livello di danno D4 ('molto pesanti' secondo l'EMS-98)	sì	integer
coordinates	Riferimento geografico dell'area danneggiata	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
timestamp	Data e ora di rilevamento dei danni	sì	dateTime
CountryCode	Codice che identifica la nazione	no	string CountryCode.gc
EventID	Identificativo univoco assegnato all'evento	no	string
ProvinceName	Nome della provincia	no	string
RegionCode	Codice Regione	no	string RegionCode.gc
SchemeID	Identificativo di uno schema di identificazione utilizzato	no	string
SimulatedFlag	Indica se l'evento riportato e' simulato (true) o reale (false)	no	boolean
TownName	Nome esteso del Comune es. Roma, Anguillara Sabazia, ecc	no	string
ZIPCode	Codice di Avviamento Postale (CAP)	no	string
ZeroDamageBuildingCount	Numero di edifici che non hanno subito danni	no	integer

Descrizione semantica dell´UrbanDataset EarthquakeDamagedBuildingsCounter 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

EarthquakeDamagedBuildingsCounter-2.0

PARTE II: Liste di codici

CountryCode.gc