doc generated from pipeline

catalog-v001.xml

saref-pipeline.jar

target

documentation/ts_*

<figure id="Figure_1">

<figure>

        <img data-docx-width="23.33cm" src="diagrams/Overview.png" alt="SAREF4CITY overview"/>

        <figcaption>Figure 1: SAREF4CITY overview</figcaption>

    </figure>

In the SAREF4CITY ontology existing models have been reused when needed in order to increase interoperability and reduce effort in modelling general domains. As an example, for modelling the requirements related to the topology domain, standard ontologies already developed have been reused and connected to the SARE4CITY elements. As shown in Figure 2, for representing spatial objects the `geosp:SpatialObject` class from GeoSPARQL has been reused along with its subclasses `geosp:Feature`, `geosp:Geometry` and the properties `geosp:sfContains`, `geosp:sfWithin` and `geosp:hasGeometry`. In addition, the class `geo:Point` and the property `geo:location` have been reused from the W3C de-facto standard for geographical information "WGS84 Geo Positioning vocabulary" in order to be able to indicate that something is located at certain coordinates.

<figure id="Figure_2">

<figure>

        <img data-docx-width="9.50cm" src="diagrams/Topology.png" alt="Topology model"/>

        <figcaption>Figure 2: Topology model</figcaption>

    </figure>

Table 2 summarizes the properties that characterize the `geosp:SpatialObject` class in the context of the SAREF4CITY ontology. 

<table id="Table_2" data-docx-preferred-width="7.44cm 9.00cm">

<table data-docx-preferred-width="7.44cm 9.00cm">

  <caption>Table 2: Properties of geosp:SpatialObject</caption>

  <tr>

    <th>Property</th>

Table 3 summarizes the properties that characterize the `geosp:Feature` class in the context of the SAREF4CITY ontology that are locally defined in such class, that is, it does not include those inherited from the superclasses. Through the rest of the present document the same rule will be applied, that is, describing for each concept the restrictions locally defined rather than duplicating the top level ones through the hierarchy concepts.

<table id="Table_3" data-docx-preferred-width="7.44cm 9.00cm">

<table data-docx-preferred-width="7.44cm 9.00cm">

  <caption>Table 3: Properties of geosp:Feature</caption>

  <tr>

    <th>Property</th>

The model defined to describe administrative areas is depicted in Figure 3. As it can be observed, this model heavily relies on the topology pattern described in clause 4.2.2. In this sense, the ability to connect administrative areas (e.g. a city) with their inner areas, (e.g. its neighbourhoods) is given by inheritance of the `geosp:SpatialObject` class and through the `geosp:Feature` class. That is, as `s4city:AdministrativeArea` is subclass of `geosp:SpatialObject`, the `geosp:sfContains` and `geosp:sfWithin` properties could also be applied to all the administrative areas defined, namely `s4city:City`, `s4city:Country`, `s4city:District` and `s4city:Neighbourhood`.

<figure id="Figure_3">

<figure>

        <img data-docx-width="9.20cm" src="diagrams/AdministrativeArea.png" alt="Administrative Area model"/>

        <figcaption>Figure 3: Administrative Area model</figcaption>

    </figure>

The model developed to represent city objects is shown in Figure 4. This model also relies on the topology pattern described in clause 4.2.2, as for the administrative area case. The ability to connect city objects with the city or with the parts in which they are located is enabled by means of the properties `geosp:sfContains` and `geosp:sfWithin` inherited from the `geosp:SpatialObject` class.

<figure id="Figure_4">

<figure>

        <img data-docx-width="8.69cm" src="diagrams/CityObject.png" alt="City Object model"/>

        <figcaption>Figure 4: City Object model</figcaption>

    </figure>

Figure 5 presents the model developed to represent temporal and scheduled events. The main concept of this pattern is the class `s4city:Event`. Such event is linked to the agent organizing it by means of the `s4city:organizedBy` property. Note that a public administration is a subclass of agent; therefore, this model includes the possibility of events being organized by public administrations as well as by other types of agents. The events can take place at a particular facility (`s4city:Facility`) which is indicated by the `s4city:takesPlaceAtFacility` property and at a given time, which is represented by the `s4city:takesPlaceAtTime` property that links the event to temporal entities (`time:TemporalEntity`) defined by the W3C Time ontology. Finally, as events can be part of bigger events, this relation has been modelled by means of the property `s4city:isSubEventOf`.

<figure id="Figure_5">

<figure>

        <img data-docx-width="10.74cm" src="diagrams/Event.png" alt="Event model"/>

        <figcaption>Figure 5: Event model</figcaption>

    </figure>

Table 4 summarizes the properties that characterize the `s4city:Event`.

<table id="Table_4" data-docx-preferred-width="7.69cm 8.48cm">

<table data-docx-preferred-width="7.69cm 8.48cm">

  <caption>Table 4: Properties of s4city:Event</caption>

  <tr>

    <th>Property</th>

As it can be observed in Figure 6, the modelling of measurements in the SAREF4CITY ontology totally relies on the measurement model proposed in SAREF. This modelling includes the `saref:FeatureOfInterest` class that provides the means to refer to the real world phenomena that is being observed in the given measurement. In order to reduce duplication with SAREF documentation, the reader is referred to the SAREF specification for details about SAREF modelling including here details only for the new concepts.

<figure id="Figure_6">

<figure>

        <img data-docx-width="13.50cm" src="diagrams/Measurement.png" alt="Measurement model"/>

        <figcaption>Figure 6: Measurement model</figcaption>

    </figure>

The relation between a specific assessment of a KPI (`s4city:KeyPerformanceIndicatorAssessment`) and the general KPI definition (`s4city:KeyPerformanceIndicator`) can be established by means of the property `s4city:quantifiesKPI`. A `s4city:KeyPerformanceIndicatorAssessment` is related to the `saref:FeatureOfInterest` by means of the property `s4city:assesses`. The temporal entity to which the assessment of the KPI refers to is represented by the property `s4city:refersToTime`. The agent assessing the KPI is linked by means of the property `s4city:isAssessedBy`. In order to express the administrative area or geographical location assessed by the KPI, the property `s4city:refersToSpace` is included in the model. In case the KPI represents a value extracted from an aggregation of measurements, the property `s4city:isDerivedFrom` can be used to link to such measurements (`saref:Measurement`). The unit of measure in which a KPI value is expressed is indicated by means of the reused property `saref:isMeasuredIn` while the value itself is indicated by the attribute `saref:hasValue`. The name and a natural language description of the `s4city:KeyPerformanceIndicatorAssessment` are indicated by the attributes `s4city:hasName` and `s4city:hasDescription`, respectively. The creation, expiration and last update dates of the value are represented by the attributes `s4city:hasCreationDate`, `s4city:hasExpirationDate` and `s4city:hasLastUpdateDate`, respectively.

<figure id="Figure_7">

<figure>

        <img data-docx-width="17.00cm" src="diagrams/KPI.png" alt="Key Performance Indicator model"/>

        <figcaption>Figure 7: Key Performance Indicator model</figcaption>

    </figure>

Table 5 summarizes the properties that characterize the `s4city:KeyPerformanceIndicator` class. 

<table id="Table_5" data-docx-preferred-width="8.24cm 7.93cm">

<table data-docx-preferred-width="8.24cm 7.93cm">

  <caption>Table 5: Restrictions of the s4city:KeyPerformanceIndicator class</caption>

  <tr>

    <th>Property</th>

Table 6 summarizes the properties that characterize the `s4city:KeyPerformanceIndicatorAssessment` class.

<table id="Table_6" data-docx-preferred-width="8.14cm 8.97cm">

<table data-docx-preferred-width="8.14cm 8.97cm">

  <caption>Table 6: Restrictions of the s4city:KeyPerformanceIndicatorAssessment class</caption>

  <tr>

    <th>Property</th>

The model developed to describe public services within the SAREF4CITY ontology is depicted in Figure 8. The main entity included is the `s4city:PublicService` class which is a specialization of the reused concept `cpsv:PublicService` class defined in the Public Service vocabulary provided by the ISA vocabularies European initiative. The facility in which the service is provided is indicated by the `s4city:involvesFacility` property. It can be also possible to indicate in which administrative area it is provided, for example a neighbourhood, by means of the property `cpsv:physicallyAvailableAt`. The public services that an agent (`s4city:Agent`) provides or uses are indicated by means of the properties `cpsv:provides` and `cpsv:uses`, respectively. The languages in which a service is provided are indicated by the property `s4city:isAvailableInLanguage`. The name and a natural language description of the `s4city:PublicService` are indicated by the attributes `s4city:hasName` and `s4city:hasDescription`, respectively.

<figure id="Figure_8">

<figure>

        <img data-docx-width="14.02cm" src="diagrams/PublicService.png" alt="Public Service model"/>

        <figcaption>Figure 8: Public Service model</figcaption>

    </figure>

Table 7 summarizes the properties that characterize the `s4city:PublicService` class.

<table id="Table_7" data-docx-preferred-width="8.14cm 8.97cm">

<table data-docx-preferred-width="8.14cm 8.97cm">

  <caption>Table 7: Properties of Public Service</caption>

  <tr>

    <th>Property</th>

<figure id="Figure_9">

<figure>

        <img data-docx-width="21.84cm" src="diagrams/Example.png" alt="Public Service model"/>

        <figcaption>Figure 9: Public Service model</figcaption>

    </figure>

### Normative references

# References

## Normative references

* <a id="[0]">[0]</a> [ETSI TS 103 410-4 (V1.1.2)](https://www.etsi.org/deliver/etsi_ts/103400_103499/10341004/01.01.01_60/ts_10341004v010102p.pdf): "SmartM2M;; Extension to SAREF; Part 4: Smart Cities Domain".

* <a id="[1]">[1]</a>	ETSI TS 103 264 (V3.1.1) (02-2020): "SmartM2M; Smart Applications; Reference Ontology and oneM2M Mapping".

### Informative references

## Informative references

* <a id="[i.1]">[i.1]</a>	ETSI TR 103 506 (V1.1.1) (09-2018): "SmartM2M; SAREF extension investigation; Requirements for Smart Cities".