Descrizione semantica dell´UrbanDataset Presences della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset Presences 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-01-31 02:45

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

Presences-2.0

Identificazione UrbanDataset
Scopo	Fornire informazioni relative alla presenza di persone e/o mezzi di trasporto (anche con categorizzazione per fascia di età, genere, provenienza, tipologia mezzo di trasporto,....), dando loro una collocazione spaziale e temporale
Categoria / Sottocategoria	SocioEconomicDevelopment / E-Governance
Identificatore	Presences-2.0
Nome	Presences
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#Presences
Contestualizzazione UrbanDataset
Come utilizzare le proprietà di contesto Se l'UrbanDataset contiene presenze relative a un solo luogo, si indicano nel context le coordinate geografiche di quel luogo; altrimenti si indicano nel context le coordinate del centro dell'area monitorata
	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
LocationID	Identificativo del luogo in cui sono state rilevate le presenze	sì	string
PresenceCount *	Numero di presenze rilevato	sì	integer
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
AgeRange	Se le presenze si riferiscono a persone, indica la fascia di età in cui ricadono	no	string
EndTimeSlot	Ora di fine della fascia oraria in cui sono state rilevale le presenze. Si applica a tutto il periodo della riga	no
GenderCode	Se le presenze si riferiscono a persone, indica il loro genere	no	string GenderCode.gc
LocationName	Nome del luogo in cui sono state rilevate le presenze	no	string
Nationality	Se le presenze si riferiscono a persone, indica la loro nazionalità	no	string
PeriodQualifierCode	Qualificatore che descrive il periodo	no	string PeriodValueQualifierCode.gc
PeriodValue	Periodo espresso come valore testuale (es. "martedì", "mercoledì", "2022", ecc.)	no	string
PhysicalUnitCategoryCode	Indica a quale categoria (persone, veicoli) si riferisce il numero di presenze indicato nel campo PresenceCount	no	string PhysicalUnitCategoryCode.gc
SchemeID	Identificativo dello schema di identificazione a cui appartiene LocationID	no	string
StartTimeSlot	Ora di inizio della fascia oraria in cui sono state rilevale le presenze. Si applica a tutto il periodo della riga	no
SubLocationName	Nome di un'area all'interno di un luogo	no	string
TimeSlotDescription	Fascia oraria espressa come valore. Valori suggeriti "diurna", "notturna", dove, se non diversamente specificato tramite "Ora inizio" e "Ora fine", si assume che: - diurna: dalle 07:00 alle 18:59 - notturna: dalle 19:00 alle 06:59	no	string
TotalCountFlag	Indica se il numero di presenze indicato è un totale (true) o un parziale (false) per il periodo indicato	no	boolean
TownName	Se le presenze si riferiscono a persone, indica la città di domicilio o residenza	no	string
WorkingDayFlag	Indica se i dati contenuti nella riga sono riferiti a giorni feriali o festivi	no	boolean
coordinates	Coordinate del luogo indicato nella riga	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

GenderCode.gc

Nome sintetico	GenderCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/GenderCode.gc
Agency	ENEA
Codice	Valore
M	maschio
F	femmina
X	altro

PeriodValueQualifierCode.gc

Nome sintetico	PeriodValueQualifierCodeCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/PeriodValueQualifierCode.gc
Agency	ENEA
Codice	Valore
day	giorno
month	mese
year	anno

PhysicalUnitCategoryCode.gc

Nome sintetico	PhysicalUnitCategoryCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/PhysicalUnitCategoryCode.gc
Agency	ENEA
Codice	Valore
NULL	NULL
PER	Persona
TRM	Mezzo di trasporto non meglio specificato
VEL	Velocipede
CIC	Ciclomotore
MOT	Motoveicolo
LV0	Mezzi leggeri
LV1	Auto e monovolume
LV2	Auto e monovolume con rimorchio
LV3	Furgoncini e camioncini
HV0	Mezzi pesanti
HV1	Camion medi (fino a 7,5 m) o veicoli commerciali leggeri
HV2	Camion grandi o veicoli commerciali pesanti
HV3	Autotreni (autocarri con rimorchio)
HV4	Autoarticolati (trattori con semirimorchio)
HV5	Autobus
HV6	Altri (mezzi speciali, trasporti eccezionali, mezzi agricoli, macchine operatrici,….)
PET	Animale

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

Presences-2.0

PARTE II: Liste di codici

GenderCode.gc

PeriodValueQualifierCode.gc

PhysicalUnitCategoryCode.gc

FormatCode.gc

LanguageCode.gc

TimezoneCode.gc