Semantic Description of ElectricMeterReading UrbanDataset from SCP Ontology 2.0

This document provides human-friendly documentation for ElectricMeterReading 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 2024-05-20 13:55
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. ElectricMeterReading

SECTION II: Code lists

  1. ElectricityEndUseCode.gc
  2. FormatCode.gc
  3. LanguageCode.gc
  4. 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. ElectricMeterReading-2.0
  2. UrbanDataset Identification
    Scope Provides data relating to electric consumption detected at meter or POD level. The meter data of one or more real estate units can be inserted in the same instance of this UrbanDataset; for the same real estate unit there may be data from different meters (this is the case in which for the same POD there are different meters dedicated to detecting the different end uses of electricity). If the meter is indicated, the data at line level refers to the reading of the single meter
    Category / Subcategory EnergyManagement / EnergyDemand
    Identifier ElectricMeterReading-2.0
    Name Electric Meter Reading
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#ElectricMeterReading
    UrbanDataset Contextualization

    How to use the context properties

    A livello di contesto vanno indicate le coordinate geografiche 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
    ActiveEnergy Active energy withdrawn from the grid

    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

    ActivePower Active power per phase

    no double

    kilowatt[default]
    ElectricityEndUseCode End use of the electric consumed energy (e.g. lighting, motive power, general, air conditioning,...)

    no string

    ElectricityEndUseCode.gc
    LineCurrent Line current

    no double

    ampere[default]
    MeterID A unique identifier for the device that measures electricity consumption

    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

    PhaseVoltage Phase voltage

    no double

    volt[default]
    ReactiveEnergy Reactive energy (inductiveEnergy + capacitiveEnergy)

    no double

    kilovoltamperereactivePerHour[default]
    ReactivePower Reactive power

    no double

    kilovoltamperereactive[default]
    RealEstateUnitID An identifier for the real estate unit (e.g. apartment, building, independent house...)

    no string

    SchemeID Indicates the encoding scheme the identifier provided in the RealEstateUnitID field belongs to

    no string

    coordinates Geographic coordinates of the real estate unit 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

  1. ElectricityEndUseCode.gc
  2. Short name ElectricityEndUseCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/ElectricityEndUseCode.gc
    Agency ENEA
    Code Value
    LGH lighting
    CND air-conditioning
    PWR motive power
    ALL general

  3. FormatCode.gc
  4. 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

  5. LanguageCode.gc
  6. 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

  7. TimezoneCode.gc
  8. 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