Descrizione semantica dell´UrbanDataset Events della SCP Ontology 2.0

Questo documento fornisce una documentazione human-friendly dell´UrbanDataset Events 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-11 20:25

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

Events-2.0

Identificazione UrbanDataset
Scopo	Fornisce il set di informazioni che rappresenta un Evento inteso come manifestazione organizzata (ad es. concerto, partita di calcio, fiera,...), ricorrenza (ad es. Natale, patrono,...) o circostanza (ad es. chiusura scuole)
Categoria / Sottocategoria	SocioEconomicDevelopment / E-Governance
Identificatore	Events-2.0
Nome	Events
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#Events
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
EventID	Identificativo univoco assegnato all'evento	sì	string
EventName	Titolo o nome dell'evento	sì	string
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
EventAccessCode	Codice indicante se l'accesso è gratuito o a pagamento	no	string EventAccessCode.gc
EventCategoryCode	Codice indicante la categoria dell'evento, intesa come tipo di organizzazione dell'evento (fiera, mercato, ...)	no	string EventCategoryCode.gc
EventCoverageCode	Copertura e rilevanza territoriale dell'evento (locale, regionale, nazionale, internazionale)	no	string EventCoverageCode.gc
EventDescription	Descrizione estesa dell'evento	no	string
EventFrequencyCode	Codice indicate la cadenza con cui si verifica l'evento (ad es., annuale, settimanale, ecc.)	no	string EventFrequencyCode.gc
EventQualifierCode	Codice indicante se l'evento è una manifestazione organizzata (ad es. concerto, partita di calcio, fiera, ecc.), una ricorrenza (ad es. Natale, patrono, ecc.) o una circostanza (ad es. chiusura scuole, covid)	no	string EventQualifierCode.gc
EventRecurrenceDescription	Descrizione testuale della periodicità dell'evento	no	string
EventScopeCode	Codice indicante il tema o l'ambito dell'evento (sport, cultura, musica,...)	no	string EventScopeCode.gc
EventSecondaryCategoryCode	Categoria ulteriore a cui può essere riferito l'evento, intesa come tipo di organizzazione dell'evento (fiera, mercato, ...)	no	string EventCategoryCode.gc
EventSecondaryScopeCode	Codice indicante un tema o ambito ulteriore a cui può essere riferito l'evento (calcio, jazz,...)	no	string EventScopeCode.gc
EventSourceName	Nome della sorgente da cui sono stati acquisiti i dati dell'evento	no	string
EventSourceURL	URL della pagina web della sorgente da cui sono stati acquisiti i dati dell'evento	no	string
EventTag	Parole chiave che caratterizzano l'evento	no	string
EventWebPageURL	URL della pagina web dedicata all'evento	no	string
LocationCapacityCode	Codice indicante la dimensione dell'evento in termini di presenze (numero di partecipati atteso, espresso come ordine di grandezza). Può anche corrispondere alla capacità del luogo ospitante l'evento. Consente anche di dare una dimensione all'evento	no	string LocationCapacityCode.gc
LocationID	Identificativo univoco del luogo di svolgimento dell'evento	no	string
LocationName	Nome del luogo di svolgimento dell'evento	no	string
OrganizerName	Denominazione del soggetto che organizza l'evento	no	string
OrganizerTypeCode	Codice che specifica il tipo di un soggetto (PA, privato, associazione culturale, ecc.)	no	string OrganizerTypeCode.gc
SchemeID	Indica lo schema di codifica a cui appartengono gli identificativi forniti nei campi LocationID e SecondaryLocationID (ad es. 'ISTAT' se la città dell'evento è identificata tramite i codici ISTAT delle città)	no	string
SecondaryLocationID	Identificativo univoco di un secondo luogo di svolgimento dell'evento	no	string
SecondaryLocationName	Nome di un secondo luogo di svolgimento dell'evento	no	string
SecondaryTargetAudienceCode	Codice indicante una ulteriore categoria di utenti a cui è rivolto l'evento	no	string TargetAudienceCode.gc
TargetAudienceCode	Codice indicante la categoria di utenti a cui è rivolto l'evento	no	string TargetAudienceCode.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

EventAccessCode.gc

Nome sintetico	EventAccessCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventAccessCode.gc
Agency	ENEA
Codice	Valore
01	Gratuito
02	A pagamento

EventCategoryCode.gc

Nome sintetico	EventCategoryCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventCategoryCode.gc
Agency	ENEA
Codice	Valore
01	COMMEMORAZIONE
02	COMPETIZIONE, GARA, TORNEO, CONCORSO e PREMI
03	CONGRESSO, CONVEGNO, CONVENTION, CONFERENZA, FORUM, MEETING, COMIZIO
04	INCONTRO, DIBATTITO, RIUNIONE, TAVOLA ROTONDA
05	ESCURSIONE, VISITA LIBERA e VISITA GUIDATA
06	FESTIVITA', FESTE, TORNEO STORICO, PALIO, SAGRE
07	FESTIVAL
08	FIERE, SALONI e ESPOSIZIONI
09	GIUBILEO
10	INAUGURAZIONE, PRESENTAZIONE
11	MANIFESTAZIONE, CORTEO, SCIOPERO
12	MERCATI, MERCATINI, MOSTRE MERCATO
13	MOSTRE
14	PROCESSIONE
15	SFILATA
16	SPETTACOLO e PROIEZIONI
17	STAGE, CORSI, SEMINARI, WORKSHOP, LABORATORI
50	INIZIO SCUOLA
51	FINE SCUOLA
52	INIZIO VACANZE
53	FINE VACANZE
54	CATASTROFE NATURALE (TERREMOTO, URAGANO, ALLUVIONE..), EPIDEMIA, LOCKDOWN,...
99	ALTRO

EventCoverageCode.gc

Nome sintetico	EventCoverageCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventCoverageCode.gc
Agency	ENEA
Codice	Valore
01	Locale
02	Regionale
03	Nazionale
04	Internazionale

EventFrequencyCode.gc

Nome sintetico	EventFrequencyCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventFrequencyCode.gc
Agency	ENEA
Codice	Valore
01	Settimanale
02	Mensile
03	Annuale

EventQualifierCode.gc

Nome sintetico	EventQualifierCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventQualifierCode.gc
Agency	ENEA
Codice	Valore
01	MANIFESTAZIONE
02	RICORRENZA
03	CIRCOSTANZA
04	PROBLEMATICA

EventScopeCode.gc

Nome sintetico	EventScopeCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventScopeCode.gc
Agency	ENEA
Codice	Valore
01	AGRICOLTURA
02	ANIMALI
03	ANTIQUARIATO
04	ARTI FIGURATIVE
05	ARTIGIANATO
06	AUTO E MOTO
07	BALLO (tango, country, balli di gruppo, ecc.)
08	BELLEZZA, ESTETICA
09	BUSINESS
10	CINEMA
11	CIRCO E SPETTACOLI DI STRADA
12	COMMERCIO
13	CULTURE (ARCHAEOLOGY, PHILOSOPHY, HISTORY, PSYCHOLOGY, SCIENCE, ECONOMICS, etc.)
14	EDITORIA, LETTERATURA e FUMETTO
15	ENOGASTRONOMIA
16	FOLKLORE e ETNICO
17	HOBBISTICA
18	INDUSTRIA
1801	Arredamento
1802	Edilizia
1803	Moda
19	MEDICINA e FARMACEUTICA
20	MUSICA
2001	Jazz
2002	Musica contemporanea (country, dance, rock, pop, hard rock, metal, psichedelica, Rock’n’roll, underground, ecc.)
2003	Classica
2004	Opera lirica
21	POLITICA, GIORNALISMO, DIRITTI E SINDACATO
22	RAPPRESENTAZIONE TEATRALE
2201	Prosa
2202	Danza
23	RELIGIONE
24	RIEVOCAZIONI STORICHE
25	SPORT e GIOCHI
2501	atletica leggera
2502	automobilismo
2503	calcio
2504	ciclismo
2505	golf
2506	maratona
2507	motociclismo
2508	nuoto
2509	pallacanestro
2510	pallavolo
2511	rugby
2512	sci
2513	tennis
2514	trekking
2515	Altro (alpinismo, baseball, cricket, football americano, ginnastica, hockey, pallamano, ping-pong, slittino, vela, ecc.)
26	TECNOLOGIA
27	TURISMO
28	VERDE (giardini, giardinaggio, fiori, natura, ecc.)
29	VIAGGI
30	WELLNESS (fitness, yoga, arti marziali, thai chi, ecc.)
40	Ambiente
41	Anagrafe e Stato Civile
42	Attività produttive e Commercio
43	Disabilità e Accessibilità
44	Edilizia pubblica e privata
45	Famiglia, Scuola, Giovani e Politiche sociali
461	Illuminazione pubblica, semafori
462	Manutenzione Stradale
463	Sicurezza Pubblica e Polizia Municipale
464	Viabilità e parcheggi
465	Tasse e Tributi
99	ALTRO (lavoro, mercatini di Natale, ecc.)

LocationCapacityCode.gc

Nome sintetico	LocationCapacityCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/LocationCapacityCode.gc
Agency	ENEA
Codice	Valore
01	fino a 100 persone
02	fino a 200 persone
03	fino a 1000 persone
04	tra 1000 e 10mila persone
05	tra 10mila e 100mila persone
06	piu' di 100mila persone

OrganizerTypeCode.gc

Nome sintetico	OrganizerTypeCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/OrganizerTypeCode.gc
Agency	ENEA
Codice	Valore
01	Associazioni sportive
02	Associazioni di volontariato
03	Associazioni di categoria
04	Azienda Privata, società
05	Ente ecclesiastico
06	Fiera
07	Fondazione, Consorzio
08	Impresa no profit
09	Regione, Comune, Città Metropolitana, Pubblica Amministrazione, Enti pubblici, Enti di ricerca, Enti turistici, Enti ambientali, Parchi
10	Università

TargetAudienceCode.gc

Nome sintetico	TargetAudienceCode
Versione	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/TargetAudienceCode.gc
Agency	ENEA
Codice	Valore
01	Adulti
02	Anziani
03	Bambini
04	Famiglie
05	Giovani
06	Scolaresche
07	Studenti
08	Professionisti
09	Turisti
99	Altro

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

Events-2.0

PARTE II: Liste di codici

EventAccessCode.gc

EventCategoryCode.gc

EventCoverageCode.gc

EventFrequencyCode.gc

EventQualifierCode.gc

EventScopeCode.gc

LocationCapacityCode.gc

OrganizerTypeCode.gc

TargetAudienceCode.gc

FormatCode.gc

LanguageCode.gc

TimezoneCode.gc