Semantic Description of Events UrbanDataset from SCP Ontology 2.0

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

SECTION II: Code lists

  1. EventAccessCode.gc
  2. EventCategoryCode.gc
  3. EventCoverageCode.gc
  4. EventFrequencyCode.gc
  5. EventQualifierCode.gc
  6. EventScopeCode.gc
  7. LocationCapacityCode.gc
  8. OrganizerTypeCode.gc
  9. TargetAudienceCode.gc
  10. FormatCode.gc
  11. LanguageCode.gc
  12. 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. Events-2.0
  2. UrbanDataset Identification
    Scope Provides the set of information relating to an Event considered as a scheduled event (e.g. concert, football match, fair,...), anniversary (e.g. Christmas, patron saint festival,...) or circumstance (e.g. school closure)
    Category / Subcategory SocioEconomicDevelopment / E-Governance
    Identifier Events-2.0
    Name Events
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/ontology/scps-ontology-2.0.owl#Events
    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
    EventID An unique identifier for the event

    yes string

    EventName A name/title for the event

    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

    EventAccessCode A code indicating whether access is free or paid

    no string

    EventAccessCode.gc
    EventCategoryCode A code indicating the event category, considered as type of organization of the event (fair, market, ...)

    no string

    EventCategoryCode.gc
    EventCoverageCode Coverage and territorial relevance of the event (local, region, national, international)

    no string

    EventCoverageCode.gc
    EventDescription Textual description of the event

    no string

    EventFrequencyCode A code indicating how often the event occurs (e.g. yearly, weekly, etc.)

    no string

    EventFrequencyCode.gc
    EventQualifierCode A code specifying whether the event is a scheduled event (e.g. concert, football match, fair, etc.), an anniversary (e.g. Christmas, patron saint's festival, etc.) or a circumstance (e.g. school closure, Covid)

    no string

    EventQualifierCode.gc
    EventRecurrenceDescription The event frequency expressed as free text

    no string

    EventScopeCode A code specifying the theme or scope of the event (sport, culture, music,...)

    no string

    EventScopeCode.gc
    EventSecondaryCategoryCode A code indicating a further category contextualising the event, considered as type of organization of the event (fair, market, ...)

    no string

    EventCategoryCode.gc
    EventSecondaryScopeCode A code specifying a further theme or scope of the event (football, jazz,...)

    no string

    EventScopeCode.gc
    EventSourceName The name of the source from which the event data was acquired

    no string

    EventSourceURL The web page URL from which the event data was acquired

    no string

    EventTag Keywords characterizing the event

    no string

    EventWebPageURL The web page URL of the event

    no string

    LocationCapacityCode A code specifying the size of the event in terms of attendance (expected number of participants, expressed as an order of size). It can also correspond to the capacity of the venue hosting the event. It also allows you to give a dimension to the event

    no string

    LocationCapacityCode.gc
    LocationID A unique identifier for the location of the event

    no string

    LocationName A name for the second location of the event

    no string

    OrganizerName The name of the entity organizing an event

    no string

    OrganizerTypeCode Code specifying the type of an entity (PA, individual, cultural association, etc.)

    no string

    OrganizerTypeCode.gc
    SchemeID Indicates the encoding scheme the identifiers provided in LocationID and SecondaryLocationID fields belong to (e.g. ISTAT if the city of the event is identified by the ISTAT municipality code)

    no string

    SecondaryLocationID A unique identifier for the second location of the event

    no string

    SecondaryLocationName A name for the second location of the event

    no string

    SecondaryTargetAudienceCode A code indicating a further user category to whom the event is aimed

    no string

    TargetAudienceCode.gc
    TargetAudienceCode A code indicating the users category to whom the event is aimed

    no string

    TargetAudienceCode.gc
    coordinates Geographical reference

    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. EventAccessCode.gc
  2. Short name EventAccessCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventAccessCode.gc
    Agency ENEA
    Code Value
    01 Free
    02 Fee-paying

  3. EventCategoryCode.gc
  4. Short name EventCategoryCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventCategoryCode.gc
    Agency ENEA
    Code Value
    01 COMMEMORATION
    02 COMPETITION, RACE, TOURNAMENT, CONTEST, PRIZE
    03 CONGRESS, CONVENTION, CONFERENCE, FORUM, MEETING
    04 DEBATE, PANEL DISCUSSION, ROUNDTABLE
    05 TOUR, EXCURSION, FREE VISIT, GUIDED TOUR
    06 FESTIVITIES, CELEBRATIONS, HISTORICAL TOURNAMENT, PALIO
    07 FESTIVAL
    08 FAIRS, SHOWS
    09 JUBILEE
    10 INAUGURATION, PRESENTATION
    11 DEMONSTRATION, PARADE, STRIKE
    12 MARKETS, MARKET EXHIBITIONS
    13 EXHIBITIONS
    14 PROCESSION
    15 FASHION SHOW
    16 SHOW, PERFORMANCE, PROJECTIONS
    17 INTERNSHIPS, COURSES, SEMINARS, WORKSHOPS, LABORATORIES
    50 BEGINNING OF SCHOOLS
    51 END OF SCHOOLS
    52 BEGINNING OF HOLIDAYS
    53 END OF HOLIDAYS
    54 NATURAL DISASTER (EARTHQUAKE, HURRICANE, FLOOD, etc. ), EPIDEMIC, LOCKDOWN
    99 OTHER

  5. EventCoverageCode.gc
  6. Short name EventCoverageCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventCoverageCode.gc
    Agency ENEA
    Code Value
    01 Local
    02 Regional
    03 National
    04 International

  7. EventFrequencyCode.gc
  8. Short name EventFrequencyCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventFrequencyCode.gc
    Agency ENEA
    Code Value
    01 Weekly
    02 Monthly
    03 Annual

  9. EventQualifierCode.gc
  10. Short name EventQualifierCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventQualifierCode.gc
    Agency ENEA
    Code Value
    01 EVENT
    02 RECURRENCE / ANNIVERSARY
    03 CIRCUMSTANCE
    04 PROBLEMS

  11. EventScopeCode.gc
  12. Short name EventScopeCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/EventScopeCode.gc
    Agency ENEA
    Code Value
    01 AGRICULTURE
    02 ANIMALS
    03 ANTIQUE
    04 VISUAL ARTS
    05 HANDICRAFT
    06 CARS and MOTORCYCLES
    07 DANCE (tango, country, group dances, etc.)
    08 BEAUTY, AESTHETICS
    09 BUSINESS
    10 CINEMA
    11 CIRCUS and STREET SHOWS
    12 TRADE
    13 todo
    14 PUBLISHING, LITERATURE and COMICS
    15 GASTRONOMY and WINE
    16 FOLKLORE and ETHNIC
    17 HOBBY
    18 INDUSTRY
    1801 Furniture
    1802 Building
    1803 Fashion
    19 MEDICINE and PHARMACEUTICALS
    20 MUSIC
    2001 Jazz
    2002 Contemporary music (country, dance, rock, pop, hard rock, metal, psychedelic, Rock'n'roll, underground, etc.)
    2003 Classical
    2004 Opera
    21 POLITICS, JOURNALISM, RIGHTS AND TRADE UNIONS
    22 THEATRICAL REPRESENTATION
    2201 Prose
    2202 Dance
    23 RELIGION
    24 HISTORICAL RE-ENACTMENTS
    25 SPORTS and GAMES
    2501 Athletics
    2502 Car racing
    2503 Football
    2504 Cycling
    2505 Golf
    2506 Marathon
    2507 Motorcycling
    2508 Swimming
    2509 Basketball
    2510 Volleyball
    2511 Rugby
    2512 Ski
    2513 Tennis
    2514 Trekking
    2515 Other (mountain climbing, baseball, cricket, American football, gymnastics, hockey, handball, table tennis, bobsledding, sailing, etc.)
    26 TECHNOLOGY
    27 TOURISM
    28 GREEN (gardens, gardening, flowers, nature, etc.)
    29 TRAVEL
    30 WELLNESS (fitness, yoga, martial arts, thai chi, etc.)
    40 Environment
    41 Registry office and Marital status
    42 Disability and Accessibility
    43 todo
    44 Public and private construction
    45 Family, School, Youngsters and Social Policies
    461 Public lighting, traffic lights
    462 Road maintenance
    463 Public Security and Municipal Police
    464 Traffic and parking
    465 Taxes and Duties
    99 OTHER (work, Christmas markets, etc.)

  13. LocationCapacityCode.gc
  14. Short name LocationCapacityCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/LocationCapacityCode.gc
    Agency ENEA
    Code Value
    01 up to 100 people
    02 up to 200 people
    03 up to 1000 people
    04 from 1000 people up to 10000 people
    05 from 10000 people up to 100000 people
    06 more than 100000 people

  15. OrganizerTypeCode.gc
  16. Short name OrganizerTypeCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/OrganizerTypeCode.gc
    Agency ENEA
    Code Value
    01 Sport associations
    02 Voluntary associations
    03 Trade associations
    04 Private company, company
    05 Ecclesiastical body
    06 Fair
    07 Foundation, Consortium
    08 Non-profit enterprise
    09 Region, Municipality, Metropolitan City, Public Administration, Public bodies, Research bodies, Tourist bodies, Environmental bodies, Parks
    10 University

  17. TargetAudienceCode.gc
  18. Short name TargetAudienceCode
    Version 2.0
    URI https://smartcityplatform.enea.it/specification/semantic/2.0/gc/TargetAudienceCode.gc
    Agency ENEA
    Code Value
    01 Adults
    02 Elderly people
    03 Children
    04 Families
    05 Young people
    06 Schoolchildren
    07 Students
    08 Freelances
    09 Tourists
    99 Other

  19. FormatCode.gc
  20. 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

  21. LanguageCode.gc
  22. 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

  23. TimezoneCode.gc
  24. 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