Semantic Description of Events UrbanDataset from SCP Ontology 2.0

This document provides human-friendly documentation for Events UrbanDataset having semantic definition in the SCP Ontology 2.0, part of the "Smart City Platform Specifications (SCPS) - Semantic Level" developed as part of the Electricity System Research Project.

File creation date

2025-12-07 17:47

SCPS URL

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

Introduction

This document provides the human-friendly representation of the semantic definition of one or more SCPS ontology´s UrbanDatasets.

Each UrbanDataset is described through a table composed of three main sections:

UrbanDataset Identification: defines the purpose of the UrbanDataset and the parameters (identifier, name and URI) uniquely identifing it in the SCPS scope. It states the information that populates the "Specification" section of UrbanDataset messages.
UrbanDataset Contextualization: defines the context properties (ContextProperty) associated with the UrbanDataset; for each one it specifies name, meaning (description), data type and set of values (code list) to which it is constrained, if any. The UrbanDataset context properties have not units of measurement and are all mandatory unless otherwise indicated in the description. Furthermore, this section provides any indications on the use of context properties within the specific UrbanDataset. It states the properties that populate the "Context" section of UrbanDataset messages.
UrbanDataset Properties: states the properties (UrbanDatasetProperty) uniquely defining the UrbanDataset in the SCPS ontology; for each one it specifies name, meaning (description), if it is required, data type, set of values (code list) to which it is constrained, if any, and the admitted units of measurement. The properties properties marked with an asterisk require to indicate, at instance level, the adopted calculation method (for example, total or average value over the measurement period). It states the properties that populate each row of the "Values" section of UrbanDataset messages.

The normative references concerning the syntactic and semantic compliance of UrbanDatasets with the SCPS are:

depending on the adopted syntax, the schema scps-urbandataset-schema-2.0:
- JSON Schema
- XML Schema
the UrbanDataset semantic definition that can be acquired or through the OWL ontology, or through the UDWebLibrary, or through this documentation.

Furthermore, in the resources section available in the tab of each UrbanDataset in the UDWebLibrary, it is possible to download the message templates in JSON and XML syntax, compliant with the specifications. A template is an example of an UrbanDataset instance having all the properties (mandatory and optional) that make it (for any properties with alternative units of measurement and/or calculation method, the default values are used).

SECTION I: UrbanDataset

Events-2.0

UrbanDataset Identification
Scope	Provides the set of information relating to an Event considered as a scheduled event (e.g. concert, football match, fair,...), anniversary (e.g. Christmas, patron saint festival,...) or circumstance (e.g. school closure)
Category / Subcategory	SocioEconomicDevelopment / E-Governance
Identifier	Events-2.0
Name	Events
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#Events
UrbanDataset Contextualization
	Description	Format/Code list
coordinates	Geographical reference	Aggregated property
subProperty: format	Wgs84 format in which the coordinates are expressed (optional attribute)	string FormatCode.gc
subProperty: height	Altitude (optional property)	double
subProperty: latitude	Latitude	double
subProperty: longitude	Longitude	double
language	The language in which the text fields of the instance are expressed	string LanguageCode.gc
timestamp	Timestamp	dateTime
timezone	The time zone to be applied to each timestamp in the instance; it is expressed as an offset, i.e. as + or - the number of hours and minutes respect to UTC time: +/-hh:mm (ISO 8601)	string TimezoneCode.gc
UrbanDataset Properties * properties marked with an asterisk require to indicate, at instance level, the adopted calculation method (e.g. "average", "total", "instantaneous",...)
Name	Description	Mandatory	Format/Code list	Unit of Measure
EventID	An unique identifier for the event	yes	string
EventName	A name/title for the event	yes	string
period	Measurement period of the data reported in the row	yes	Aggregated property
subProperty: end_ts	Timestamp indicating the end of the period	yes	dateTime
subProperty: start_ts	Timestamp indicating the beginning of the period	yes	dateTime
EventAccessCode	A code indicating whether access is free or paid	no	string EventAccessCode.gc
EventCategoryCode	A code indicating the event category, considered as type of organization of the event (fair, market, ...)	no	string EventCategoryCode.gc
EventCoverageCode	Coverage and territorial relevance of the event (local, region, national, international)	no	string EventCoverageCode.gc
EventDescription	Textual description of the event	no	string
EventFrequencyCode	A code indicating how often the event occurs (e.g. yearly, weekly, etc.)	no	string EventFrequencyCode.gc
EventQualifierCode	A code specifying whether the event is a scheduled event (e.g. concert, football match, fair, etc.), an anniversary (e.g. Christmas, patron saint's festival, etc.) or a circumstance (e.g. school closure, Covid)	no	string EventQualifierCode.gc
EventRecurrenceDescription	The event frequency expressed as free text	no	string
EventScopeCode	A code specifying the theme or scope of the event (sport, culture, music,...)	no	string EventScopeCode.gc
EventSecondaryCategoryCode	A code indicating a further category contextualising the event, considered as type of organization of the event (fair, market, ...)	no	string EventCategoryCode.gc
EventSecondaryScopeCode	A code specifying a further theme or scope of the event (football, jazz,...)	no	string EventScopeCode.gc
EventSourceName	The name of the source from which the event data was acquired	no	string
EventSourceURL	The web page URL from which the event data was acquired	no	string
EventTag	Keywords characterizing the event	no	string
EventWebPageURL	The web page URL of the event	no	string
LocationCapacityCode	A code specifying the size of the event in terms of attendance (expected number of participants, expressed as an order of size). It can also correspond to the capacity of the venue hosting the event. It also allows you to give a dimension to the event	no	string LocationCapacityCode.gc
LocationID	A unique identifier for the location of the event	no	string
LocationName	A name for the second location of the event	no	string
OrganizerName	The name of the entity organizing an event	no	string
OrganizerTypeCode	Code specifying the type of an entity (PA, individual, cultural association, etc.)	no	string OrganizerTypeCode.gc
SchemeID	Indicates the encoding scheme the identifiers provided in LocationID and SecondaryLocationID fields belong to (e.g. ISTAT if the city of the event is identified by the ISTAT municipality code)	no	string
SecondaryLocationID	A unique identifier for the second location of the event	no	string
SecondaryLocationName	A name for the second location of the event	no	string
SecondaryTargetAudienceCode	A code indicating a further user category to whom the event is aimed	no	string TargetAudienceCode.gc
TargetAudienceCode	A code indicating the users category to whom the event is aimed	no	string TargetAudienceCode.gc
coordinates	Geographical reference	no	Aggregated property
subProperty: format	Wgs84 format in which the coordinates are expressed (optional attribute)	no	string

Semantic Description of Events UrbanDataset from SCP Ontology 2.0

Table of content

Introduction

SECTION I: UrbanDataset

SECTION II: Code lists

Introduction

1. How to read this document

2. Artifacts to create an UrbanDataset message

SECTION I: UrbanDataset

Events-2.0