Semantic Description of Presences UrbanDataset from SCP Ontology 2.0

This document provides human-friendly documentation for Presences 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-01-31 06:05

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

Presences-2.0

UrbanDataset Identification
Scope	Provide information relating to the presence of people and/or transport means (if necessary categorized by age group, gender, origin, type of means of transport,....), giving them a spatial and time frame
Category / Subcategory	SocioEconomicDevelopment / E-Governance
Identifier	Presences-2.0
Name	Presences
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#Presences
UrbanDataset Contextualization
How to use the context properties 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
	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
LocationID	An identifier for the location where attendances were detected	yes	string
PresenceCount *	Number of detected presences	yes	integer
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
AgeRange	If presences refer to peopole, it indicates their age rage	no	string
EndTimeSlot	End time of the time slot in which attendances were detected. It applies to the whole period of the row	no
GenderCode	If presences refer to peopole, it indicates their gender	no	string GenderCode.gc
LocationName	Name of the place where attendances were detected	no	string
Nationality	If presences refer to peopole, it indicates their nationality	no	string
PeriodQualifierCode	A qualifier for the period	no	string PeriodValueQualifierCode.gc
PeriodValue	The period expressed as a textual value (e.g. "Tuesday", "Wednesday", "2022", etc.)	no	string
PhysicalUnitCategoryCode	A code indicating the category (people, vehicles) the number of attendances indicated in the PresenceCount field refers to	no	string PhysicalUnitCategoryCode.gc
SchemeID	Indicates the encoding scheme the identifier provided in the LocationID field belongs to	no	string
StartTimeSlot	Start time of the time slot in which attendances were detected. It applies to the whole period of the row	no
SubLocationName	A name for an area within a location	no	string
TimeSlotDescription	Time slot expressed as a value. Recommended values "daytime", "nighttime", where, if not specified by "Start time" and "End time", it is assumed that: - daytime: from 07:00 to 18:59 - nighttime: from 19:00 to 06:59	no	string
TotalCountFlag	Indicates whether the indicated number of presences is total (true) or partial (false) for the measurement period	no	boolean
TownName	If presences refer to peopole, it indicates their domicile or residence city	no	string
WorkingDayFlag	Indicates if the data contained in the row refers to weekdays or holidays	no	boolean
coordinates	Geographic coordinates of the place indicated in the message line	no	Aggregated property
subProperty: format	Wgs84 format in which the coordinates are expressed (optional attribute)	no	string FormatCode.gc
subProperty: height	Altitude (optional property)	no	double
subProperty: latitude	Latitude	yes	double
subProperty: longitude	Longitude	yes	double

SECTION II: Code lists

GenderCode.gc

Short name	GenderCode
Version	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/GenderCode.gc
Agency	ENEA
Code	Value
M	male
F	female
X	other

PeriodValueQualifierCode.gc

Short name	PeriodValueQualifierCodeCode
Version	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/PeriodValueQualifierCode.gc
Agency	ENEA
Code	Value
day	day
month	month
year	year

PhysicalUnitCategoryCode.gc

Short name	PhysicalUnitCategoryCode
Version	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/PhysicalUnitCategoryCode.gc
Agency	ENEA
Code	Value
NULL	NULL
PER	Person
TRM	Generic means of transport
VEL	Velocipede
CIC	Scooter
MOT	Motor vehicles
LV0	Light vehicles
LV1	Cars and minivans
LV2	Cars and minivans with trailer
LV3	Vans and pickup trucks
HV0	Heavy vehicles
HV1	Medium trucks (up to 7.5 m) or commercial light vehicles
HV2	Large trucks or commercial heavy vehicles
HV3	Trailer truck (trucks with trailer)
HV4	Articulated trucks (tractors with semi-trailer)
HV5	Bus
HV6	Others (special vehicles, exceptional transports, agricultural vehicles, operating machines,….)
PET	Animal

FormatCode.gc

Short name	FormatCode
Version	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/FormatCode.gc
Agency	ENEA
Code	Value
WGS84-DMS	WGS84 - Degree, Minutes, Seconds format
WGS84-DD	WGS84 - Decimal Degrees format

LanguageCode.gc

Short name	LanguageCode
Version	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/LanguageCode.gc
Agency	ENEA
Code	Value
IT	Italian
EN	English

TimezoneCode.gc

Short name	TimezoneCode
Version	2.0
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/gc/TimezoneCode.gc
Agency	ENEA
Code	Value
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

Semantic Description of Presences 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

Presences-2.0

SECTION II: Code lists

GenderCode.gc

PeriodValueQualifierCode.gc

PhysicalUnitCategoryCode.gc

FormatCode.gc

LanguageCode.gc

TimezoneCode.gc