Semantic Description of WeatherForecast UrbanDataset from SCP Ontology 2.0

This document provides human-friendly documentation for WeatherForecast 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 20:34
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. WeatherForecast

SECTION II: Code lists

  1. WeatherConditionCode.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. WeatherForecast-2.0
  2. UrbanDataset Identification
    Scope Provides weather forecast
    Category / Subcategory BuiltEnvironment / LandUseAndManagement
    Identifier WeatherForecast-2.0
    Name Weather Forecast
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#WeatherForecast
    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
    AirTemperature Air temperature

    yes double

    degreeCelsius[default]

    degreeFahrenheit
    AtmosphericPressure Observed atmospheric pressure

    yes double

    hectopascal[default]

    pascal
    LocationID An identifier for the monitored location

    yes string

    PrecipitationProbabilityPercentage Probabilità, espressa in percentuale, che si verifichino precipitazioni

    yes double

    RelativeHumidity Relative humidity, expressed as percentage

    yes double

    SchemeID Identifies an encoding scheme

    yes string

    ThreeHoursRainfall Amount of rain calculated in 3 hours by pluviometers in millimeters of accumulation

    yes double

    millimetre[default]
    TotalCloudCoveragePercentage Cloud cover percentage: indicates how much of the sky is covered by clouds (0% stands for clear skies, 100% for completely cloudy sky)

    yes double

    WeatherConditionCode A code stating the weather condition (rain, snow, clear, overcast,...)

    yes string

    WeatherConditionCode.gc
    WeatherConditionDescription Textual description of the weather conditions

    yes string

    WindSpeed Observed wind speed

    yes double

    metrePerSecond-Time[default]

    kilometrePerHour
    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

SECTION II: Code lists

  1. WeatherConditionCode.gc
  2. Short name WeatherConditionCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/WeatherConditionCode.gc
    Agency ENEA
    Code Value
    200 thunderstorm with light rain
    201 thunderstorm with rain
    202 thunderstorm with heavy rain
    210 light thunderstorm
    211 thunderstorm
    212 heavy thunderstorm
    221 ragged thunderstorm
    230 thunderstorm with light drizzle
    231 thunderstorm with drizzle
    232 thunderstorm with heavy drizzle
    300 light intensity drizzle
    301 drizzle
    310 light intensity drizzle rain
    311 drizzle rain
    312 heavy intensity drizzle rain
    321 shower drizzle
    500 light rain
    501 moderate rain
    502 heavy intensity rain
    503 very heavy rain
    504 extreme rain
    511 freezing rain
    520 light intensity shower rain
    521 shower rain
    522 heavy intensity shower rain
    531 ragged shower rain
    600 light snow
    601 snow
    602 heavy snow
    611 sleet
    615 light rain and snow
    616 rain and snow
    620 light shower snow
    621 shower snow
    622 heavy shower snow
    701 mist
    711 smoke
    721 haze
    731 sand/dust whirls
    741 fog
    751 sand
    761 dust
    762 volcanic ash
    771 squalls
    781 tornado
    800 clear sky
    801 few clouds: 11-25%
    802 scattered clouds: 25-50%
    803 broken clouds: 51-84%
    804 overcast clouds: 85-100%

  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