Semantic Description of M1ElectricUserDevice UrbanDataset from SCP Ontology 2.0

This document provides human-friendly documentation for M1ElectricUserDevice 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-13 08:53

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

M1ElectricUserDevice-2.0

UrbanDataset Identification
Scope	Provides information detected by a single-phase or three-phase User Device (M1); it supports the main information contained in the Chain2 CF1, CF2, CF3 and CF4
Category / Subcategory	EnergyManagement / EnergyDemand
Identifier	M1ElectricUserDevice-2.0
Name	M1 Electric User Device
URI	https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#M1ElectricUserDevice
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
WithdrawnActiveEnergy	Active energy withdrawn (in the case of three phase user device it is the sum of the phases). It can be calculated as difference between two meter readings. It corresponds to the Chain2 field with OBIS '1-0:99.1.0.255'	yes	double	kilowattHour[default] watthour
WithdrawnActiveEnergyReading	Total active energy withdrawn from the grid (corresponding to the value provided by the meter reading at the end period timestamp). It corresponds to the Chain2 field with OBIS '1-0:1.8.0.255'	yes	double	kilowattHour[default] watthour
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
Chain2WeaveCode	A code that identifying the Chain2 frame implemented by the UrbanDataset instance	no	string Chain2WeaveCode.gc
ElectricityEndUseCode	End use of the electric consumed energy (e.g. lighting, motive power, general, air conditioning,...)	no	string ElectricityEndUseCode.gc
EnergyCommunityID	Energy community identifier	no	string
FeedInActiveEnergy	Active energy fed into the grid in the period (in case of three-phase user device it is the sum of the phases), to be calculated as the difference between two meter readings. It corresponds to the Chain2 field with OBIS '1-0:99.1.1.255'	no	double	kilowattHour[default] watthour
FeedInActiveEnergyReading	Total active energy fed into the grid (corresponding to the value provided by the meter reading at the end period timestamp). It corresponds to the Chain2 field with OBIS '1-0:2.8.0.255'	no	double	kilowattHour[default] watthour
FeedInActivePower *	Power fed into the grid in the period (in case of three phase user device, it is the sum of the three phases). It corresponds to the Chain2 field with OBIS '1-0:2.27.0.255'	no	double	kilowatt[default] watt
FeedInCapacitiveEnergy	Capacitive reactive energy fed into the grid in the period (only for three-phase user devices). It corresponds to the Chain2 field with OBIS '1-0:99.1.5.255'	no	double	kilovoltamperereactivePerHour[default] voltamperereactivehour
FeedInInductiveEnergy	Inductive energy fed into the grid in the period (only for three-phase user devices). It corresponds to the first value of the Chain2 field with OBIS '1-0:99.1.4.255'	no	double	kilovoltamperereactivePerHour[default] voltamperereactivehour
FeedInInductiveEnergyReading	Total inductive energy fed into the grid (corresponding to the value provided by the meter reading at the end period timestamp). It corresponds to the Chain2 field with OBIS '1-0:7.8.0.255'	no	double	kilovoltamperereactivePerHour[default] voltamperereactivehour
MeterID	A unique identifier for the meter	no	string
MeterSchemeID	Indicates the encoding scheme the identifier provided in the MeterID field belongs to	no	string
PODID	Point Of Delivery (POD) identifier	no	string
PrimarySubstationID	Primary substation identifier	no	string
RealEstateUnitID	An identifier for the real estate unit (e.g. apartment, building, independent house...)	no	string
SchemeID	Identifies an encoding scheme	no	string
TownCode	Municipality ISTAT code	no	string TownCode.gc
UserDeviceID	Identifier of the User Device	no	string
WithdrawnActivePower *	Power withdrawn from the grid in the period (in case of three-phase user device it is the sum of the three phases). It corresponds to the Chain2 field with OBIS '1-0:1.27.0.255'	no	double	kilowatt[default] watt
WithdrawnCapacitiveEnergy	Capacitive reactive energy withdrawn from the grid during the period (only for three phase user devices), corresponding to the Chain2 field with OBIS '1-0:99.1.3.255'	no	double	kilovoltamperereactivePerHour[default] voltamperereactivehour
WithdrawnInductiveEnergy	Inductive energy withdrawn from the grid in the period (only for three-phase device). It corresponds to Chain2 field with OBIS '1-0:99.1.2.255'	no	double	kilovoltamperereactivePerHour[default] voltamperereactivehour
WithdrawnInductiveEnergyReading	Total inductive energy withdrawn from the grid (corresponding to the value provided by the meter reading at the end period timestamp). It corresponds to the Chain2 field with OBIS '1-0:3.8.0.255'	no	double	kilovoltamperereactivePerHour[default] voltamperereactivehour
coordinates	Geographical reference	no	Aggregated property
subProperty: format	Wgs84 format in which the coordinates are expressed (optional attribute)	no	string FormatCode.gc

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

M1ElectricUserDevice-2.0