Semantic Description of M2ElectricUserDevice UrbanDataset from SCP Ontology 2.0

This document provides human-friendly documentation for M2ElectricUserDevice 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 13:19
SCPS URL https://smartcityplatform.enea.it/#/it/index.html

Table of content

Introduction

  1. How to read this document
  2. Artifacts to create an UrbanDataset message

SECTION I: UrbanDataset

  1. M2ElectricUserDevice

SECTION II: Code lists

  1. Chain2WeaveCode.gc
  2. ElectricityEndUseCode.gc
  3. TownCode.gc
  4. FormatCode.gc
  5. LanguageCode.gc
  6. TimezoneCode.gc

Introduction

1. How to read this document

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:

2. Artifacts to create an UrbanDataset message

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

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

  1. M2ElectricUserDevice-2.0
  2. UrbanDataset Identification
    Scope Provides information detected by a single-phase or three-phase User Device M"; it supports the main information contained in the Chain2 CF101, CF103
    Category / Subcategory EnergyManagement / EnergyDemand
    Identifier M2ElectricUserDevice-2.0
    Name M2 Electric User Device
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#M2ElectricUserDevice
    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
    ProducedActiveEnergy Active energy produced in the period (in case of three-phases user device it is the sum of the phases). It corresponds to the first value of the Chain2 field with OBIS '1-0:99.1.1.255'

    yes double

    kilowattHour[default]
    ProducedActivePower Active power produced 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'

    yes dateTime

    kilowatt[default]

    watt
    TownCode Municipality ISTAT code

    yes string

    TownCode.gc
    UserDeviceID Identifier of the User Device

    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

    timestamp Timestamp

    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

    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

    ProducedActiveEnergyReading Total produced active energy (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]
    ProducedCapacitiveEnergy Capacitive reactive energy produced 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
    ProducedInductiveEnergy Inductive energy produced 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
    ProducedInductiveEnergyReading Total produced inductive energy (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
    RealEstateUnitID An identifier for the real estate unit (e.g. apartment, building, independent house...)

    no string

    SchemeID Identifies an encoding scheme

    no