created ontology documentation

SAREF4LIFT is an OWL-DL ontology that extends SAREF for the Smart Lifts domain. This SAREF extension is based on a limited set of use cases and existing data models identified within available initiatives that was detailed in previous documents ETSI TR 103 546 [[i.1]](#[i.1]) and ETSI TS 103 735 [[i.2]](#[i.2]). The work conducted in the present document has been developed in the context of the <a href="https://portal.etsi.org/STF/STFs/STF-HomePages/STF602">STF 602</a>, which was established with the goal of creating SAREF extension for the domain mentioned above, i.e. Smart Lifts. This work has been developed in close collaboration with the industrial world and alliances.

One of the tasks of STF 602 consists of specifying and producing the extension of SAREF for the aforementioned domain based on the requirements resulting from previous initiatives. The related initiatives and use cases considered for the development of the SAREF4LIFT extension are the ones reported previously in ETSI TR 103 546 [[i.1]](#[i.1]) and ETSI TS 103 735 [[i.2]](#[i.2]). Such related initiatives and use cases are not repeated in this document. Hence, the reader can rely on those references for further details.

The prefixes and namespaces used in SAREF4LIFT and in the present document are listed in [the Namespace Declarations section](#namespacedeclarations)

The editors would like to thank the ETSI SmartM2M technical committee for providing guidance and expertise.

Also, many thanks to the ETSI staff and all other current and former active Participants of the ETSI SmartM2M group for their support, technical input and suggestions that led to improvements to this ontology.

Also, special thanks goes to the ETSI SmartM2M Technical Officer Guillemin Patrick for his help.

- [Mahdi Bennara](https://www.linkedin.com/in/mahdi-bennara/) ([IMT - MINES Saint-Étienne](https://www.mines-stetienne.fr/))

- [Mauro Dragoni](https://w3id.org/scholarlydata/person/mauro-dragoni) ([FBK](https://pdi.fbk.eu/))

- Alba Fernandez Izquierdo ([Universidad Politécnica de Madrid](http://www.oeg-upm.net/))

- [Raúl Garcia-Castro](http://www.garcia-castro.com/foaf.rdf#me) ([Universidad Politécnica de Madrid](http://www.oeg-upm.net/))

- [Maxime Lefrançois](https://www.maxime-lefrancois.info/) ([IMT - MINES Saint-Étienne](https://www.mines-stetienne.fr/))

<p>SAREF4LIFT has been specified and formalised by investigating related resources in the smart lifts domain, as reported in ETSI TR 103 546 <a href="#[i.1]">[i.1]</a> and ETSI TS 103 735 <a href="#[i.2]">[i.2]</a>. Therefore, SAREF4LIFT shall both:

<ul>

  <li>Allow the implementation of a limited set of related use cases already identified in <a href="#[i.1]">[i.1]</a>.</li>

  <li>Fulfil the requirements provided in Clause 5, mainly the ontological ones that were mostly taken as input for the ontology specification.</li>

</ul>

<p>SAREF4LIFT is an OWL-DL ontology. For embedded semantic analytics purposes, SAREF4LIFT shall be designed using the modularity principle and can thus be mainly described by a set of knowledge modules. All these SAREF4LIFT modules are fully detailed below. </p>

<h3>General overview</h3>

<p><a href="#Figure_1">Figure 1</a> presents the high level view of the envisioned model of SAREF4LIFT ontology. In <a href="#Figure_1">Figure 1</a>, classes directly imported from SAREF ontology are in light orange, classes directly imported from other SAREF extension ontologies are in green. While, classes developed for SAREF4LIFT are in blue.</p>

<figure>

  <a href="diagrams/TS103735_Clause_6_2_1_General-Overview.png"><img src="diagrams/TS103735_Clause_6_2_1_General-Overview.png" alt="SAREF4LIFT overview."/></a>

  <figcaption id="Figure_1">Figure 1: SAREF4LIFT overview.</figcaption>

</figure>

<p>Within <a href="#Figure_1">Figure 1</a>, as well as within all the figures that are depicted in this documentation, the following conventions are used: </p>

<ul>

  <li>Arrows are used to represent properties between classes and to represent some RDF, RDF-S and OWL constructs, more precisely:</li>

  <ul>

    <li>Plain arrows with white triangles represent the rdfs:subClassOf relation between two classes. The origin of the arrow is the class to be declared as subclass of the class at the destination of the arrow.</li>

    <li>Dashed arrows between two classes indicate a local restriction in the origin class, i.e. that the object property can be instantiated between the classes in the origin and the destination of the arrow. The identifier of the object property is indicated within the arrow.</li>

  </ul>

  <li>Datatype properties are denoted by rectangles attached to the classes, in an UML-oriented way. Dashed boxes represent local restrictions in the class, i.e. datatype properties that can be applied to the class they are attached to.</li>

  <li>Individuals are denoted by rectangles in which the identifier is underlined.</li>

</ul>

<p>SAREF4LIFT is an OWL-DL ontology and shall be designed using the modularity principle (see ETSI TR 103 510 <a href="#[i.1]">[i.1]</a>) and can thus be mainly described by the following self-contained knowledge modules:

<ul>

  <li><strong>Command.</strong> This module describes the type of commands supported by the defined smart lift. A command is defined as a directive that a device should support to perform a certain function. A command may act upon a state, but does not necessarily act upon a state. For example, the ON command acts upon the ON/OFF state, but the GET command does not act upon any state, it simply gives a directive to retrieve a certain value. The root of this branch (<a href="https://saref.etsi.org/core/Command">saref:Command</a>) is inherited directly from the SAREF Core ontology.</li>

  <li><strong>Device.</strong> This module defines the devices included within a smart lift. A device is defined as a tangible object designed to accomplish a particular task. In order to accomplish this task, the device performs one or more functions. The root of this branch (<a href="https://saref.etsi.org/core/Device">saref:Device</a>) is inherited directly from the SAREF Core ontology.</li>

  <li><strong>System.</strong> This module defines the different systems modelled within a smart lift environment. A system is described as a component virtually isolated from the environment, whose behaviour and interactions with the environment are specifically defined. Systems can be connected to other systems. Connected systems interact in some ways. Systems can also have subsystems. Properties of subsystems somehow contribute to the properties of the supersystem.</li>

  <li><strong>Signal.</strong> This module describes the types of signals supported by a smart lift. Four type of signals have been identified: bidirectional communication system signal (<a href="#s4lift:BCSSignal">s4lift:BCSSignal</a>), car signal (<a href="#s4lift:CarSignal">s4lift:CarSignal</a>), power supply signal (<a href="#s4lift:PowerSupplySignal">s4lift:PowerSupplySignal</a>), and statistic signal (<a href="#s4lift:StatisticSignal">s4lift:StatisticSignal</a>). The <a href="#Signal">section on Signals</a> provides a complete taxonomy of supported signals with respect to the ones reported in <a href="#Figure_1">Figure 1</a>.</li>

</ul>

<p>Beside the four module described above, the SAREF4LIFT extension defines also:</p>

<ul>

  <li>a new property (<a href="#s4lift:Load">s4lift:Load</a>) defining the amount of electricity on the grid at any given time.</li>

  <li>the concept <a href="#s4lift:Network">s4lift:Network</a> providing a conceptualization of the type of network with which the smart lift is equipped for communicating information.</li>

</ul>

<h3 id="Command">Command</h3>

<p>This model specifies the list of commands that we considered relevant for the smart lift domain. We defined seven new commands that are subsumed by the <a href="https://saref.etsi.org/core/Command">saref:Command</a> concept that can be triggered, in turn, by a <a href="https://saref.etsi.org/core/Function">saref:Function</a> as presented in <a href="#Figure_2">Figure 2</a>:</p>

<ul>

  <li><a href="#s4lift:BoardResetCommand">s4lift:BoardResetCommand</a> defines the command for resetting the board of a smart lift;</li>

  <li><a href="#s4lift:CallCarToSpecificFloorCommand">s4lift:CallCarToSpecificFloorCommand</a> defines the internal command for calling the car of the smart lift to a specific floor;</li>

  <li><a href="#s4lift:SendCarToSpecificFloorCommand">s4lift:SendCarToSpecificFloorCommand</a> defines the internal command for sending the car to a specific floor;</li>

  <li><a href="#s4lift:SetOutOfServiceCommand">s4lift:SetOutOfServiceCommand</a> defines the command for putting the smart lift in out of service mode;</li>

  <li><a href="#s4lift:SetRealTimeModeCommand">s4lift:SetRealTimeModeCommand</a> defines the command for putting the smart lift in out of service mode;</li>

  <li><a href="#s4lift:TestEmergencyNumberCommand">s4lift:TestEmergencyNumberCommand</a> defines the command for testing if the emergency number is working;</li>

  <li><a href="#s4lift:TestRideCommand">s4lift:TestRideCommand</a> defines the command for performing a test ride of a smart lift.</li>

</ul>

<figure>

  <a href="diagrams/TS103735_Clause_6_2_2_Command.png"><img src="diagrams/TS103735_Clause_6_2_2_Command.png" alt="Command model."/></a>

  <figcaption id="Figure_2">Figure 2: Command model.</figcaption>

</figure>

<h3 id="Device">Device</h3>

<p>A Smart Lift system can be defined as a <a href="https://saref.etsi.org/core/Device">saref:Device</a> made by different components. This module defines the subcomponents that are part of Smart Lift. In particular, we denoted two subcomponents: the <a href="#s4lift:SmartLiftEdgeComponent">s4lift:SmartLiftEdgeComponent</a> and the <a href="#s4lift:SmartLiftEdgeControlUnit">s4lift:SmartLiftEdgeControlUnit</a>. 

The former is dedicated to the hosting of smart lift additional modules in the case that they are not hosted directly in the <a href="#s4lift:SmartLiftEdgeControlUnit">s4lift:SmartLiftEdgeControlUnit</a>. An example could be the case of an additional earthquake sensor added after the lift deployment and not controlled by the <a href="#s4lift:SmartLiftEdgeControlUnit">s4lift:SmartLiftEdgeControlUnit</a>.</p>

<p>The</a> latter is the main element of a Smart Lift installation and it is typically associated with the lift control cabinet.

Both concepts are subsumed by the s4syst:System concept that, in turn, it subsumes the <a href="#s4lift:SmartLiftInstallation">s4lift:SmartLiftInstallation</a> that corresponds to a single lift, with all its elements. Such a concept is equipped with the list of properties shown in <a href="#Figure_3">Figure 3</a>.</p>

<p>Finally, the <a href="#s4lift:SmartLiftGroup">s4lift:SmartLiftGroup</a>, subsumed by the <a href="https://saref.etsi.org/core/FeatureOfInterest">saref:FeatureOfInterest</a> concept, represents the correlation of multiple Smart Lifts Installation and it is supported by the introduction of a Smart Lift Group identifier common each Smart Lifts Installation belonging to the same Smart Lift Group. Such kind of installations usually presents control units connected one each other to coordinate the movement and position of the different lifts, where the common commands (e.g. the call buttons) are given to one of these control units that acts as a principal master and coordinates the other installations or is composed by peer installations that coordinates one each other.</p>

<figure>

  <a href="diagrams/TS103735_Clause_6_2_3_Device.png"><img src="diagrams/TS103735_Clause_6_2_3_Device.png" alt="Device model."/></a>

  <figcaption id="Figure_3">Figure 3: Device model.</figcaption>

</figure>

<h3>System</h3>

<p>This module expands the Device module by specifying two aspects.</p>

<p>First, the <a href="#s4lift:SmartLiftInstallation">s4lift:SmartLiftInstallation</a> concept subsumes four type of installations considered relevant for this extension, namely <a href="#s4lift:SmartLiftPlatform">s4lift:SmartLiftPlatform</a>, <a href="#s4lift:GoodsSmartLift">s4lift:GoodsSmartLift</a>, <a href="#s4lift:GoodsOnlySmartLift">s4lift:GoodsOnlySmartLift</a>, and <a href="#s4lift:FiremanLift">s4lift:FiremanLift</a>.

All these concepts represents a type of smart lift that can be instantiated by the ontology.</p>

<p>Second, the relationship between a <a href="#s4lift:SmartLiftInstallation">s4lift:SmartLiftInstallation</a> entity and the <a href="https://saref.etsi.org/core/Time">saref:Time</a> one. Indeed, three object properties have been defined modelling both the opening and closing time of the smart lift (<a href="#s4lift:hasDoorOpenTime">s4lift:hasDoorOpenTime</a> and <a href="#s4lift:hasDoorCloseTime">s4lift:hasDoorCloseTime</a> respectively) and the total usage time of the smart lift described by the object property <a href="#s4lift:hasTraveledTime">s4lift:hasTraveledTime</a>.</p>

<figure>

  <a href="diagrams/TS103735_Clause_6_2_4_System.png"><img src="diagrams/TS103735_Clause_6_2_4_System.png" alt="System model."/></a>

  <figcaption id="Figure_4">Figure 4: System model.</figcaption>

</figure>

<h3 id="Signal">Signal</h3>

<p>This module describes the types of signals that can be read from a smart lift console. <a href="#Figure_5">Figure 5</a> shows the taxonomy of the relevant types of signals foreseen within this extension.</p>

<p>It is possible to observe a set of four main types of signals:</p>

<ul>

  <li><a href="#s4lift:BCSSignal">s4lift:BCSSignal</a>: this type of signals relates to bidirectional signals where the communication works from the smart lift to an external console service and vice-versa. Here, it is possible to find network and test signals (i.e. <a href="#s4lift:NetworkCoverage">s4lift:NetworkCoverage</a>, <a href="#s4lift:NetworkQualityBER">s4lift:NetworkQualityBER</a>, <a href="#s4lift:NetworkQualityRSSI">s4lift:NetworkQualityRSSI</a>, <a href="#s4lift:RegisteredNetworkOperator">s4lift:RegisteredNetworkOperator</a>, <a href="#s4lift:TimeOfConfirmationOfLastPeriodicTest72hAttempt">s4lift:TimeOfConfirmationOfLastPeriodicTest72hAttempt</a>, and <a href="#s4lift:TimeOfLastPeriodicTest72hAttempt">s4lift:TimeOfLastPeriodicTest72hAttempt</a>).</li>

  <li><a href="#s4lift:PowerSupplySignal">s4lift:PowerSupplySignal</a>: these are the signals provided by a smart lift concerning the power supply status. Here, two signals are foreseen, i.e. <a href="#s4lift:EmergencyPowerSupplySignal">s4lift:EmergencyPowerSupplySignal</a> and <a href="#s4lift:StandardEmergencyPowerSupplySignal">s4lift:StandardEmergencyPowerSupplySignal</a>.</li>

  <li><a href="#s4lift:StatisticSignal">s4lift:StatisticSignal</a>: such signals refer to the collection of statistics about smart lift usage. Relevant type of signals detected are <a href="#s4lift:CallsPerService">s4lift:CallsPerService</a>, <a href="#s4lift:DownwardsTravels">s4lift:DownwardsTravels</a>, <a href="#s4lift:UpwardsTravels">s4lift:UpwardsTravels</a>, <a href="#s4lift:NumberOfCalls">s4lift:NumberOfCalls</a>, <a href="#s4lift:NumberOfFaults">s4lift:NumberOfFaults</a>, <a href="#s4lift:TotalFloorsCovered">s4lift:TotalFloorsCovered</a>, <a href="#s4lift:TotalResetSequence">s4lift:TotalResetSequence</a>, <a href="#s4lift:TotalReverseDirection">s4lift:TotalReverseDirection</a>, <a href="#s4lift:TotalTimeOpened">s4lift:TotalTimeOpened</a>.</li>

  <li><a href="#s4lift:CarSignal">s4lift:CarSignal</a>: these are the signals sent by the smart lift car about its overall status. This concept subsumes three further concepts grouping likewise car signal types.</li>

  <ul>

    <li><a href="#s4lift:FaultSignal">s4lift:FaultSignal</a>, defining the type of faults that can affect a smart lift car;</li>

    <li><a href="#s4lift:PositionSignal">s4lift:PositionSignal</a>, defining the position where the smart lift car is; and,</li>

    <li><a href="#s4lift:StatusSignal">s4lift:StatusSignal</a>, subsuming a list of status information that can be send by the smart lift car.</li>

  </ul>

</ul>

<p>All descendants of the <a href="#s4lift:Signal">s4lift:Signal</a> inherit the <a href="https://saref.etsi.org/core/hasTimestamp">saref:hasTimestamp</a> and <a href="https://saref.etsi.org/core/hasValue">saref:hasValue</a> properties defining the timestamp when the signal has been generated and its value, respectively.</p>

<p>Then, the <a href="#s4lift:PowerSupplySignal">s4lift:PowerSupplySignal</a> concept is associated with its power supply value through the <a href="#s4lift:hasPowerSupplyValue">s4lift:hasPowerSupplyValue</a> property; while the <a href="#s4lift:PositionSignal">s4lift:PositionSignal</a> is associated with the corresponding position value through the <a href="#s4lift:hasPositionValue">s4lift:hasPositionValue</a> property.</p>

<figure>

  <a href="diagrams/TS103735_Clause_6_2_5_Signal.png"><img src="diagrams/TS103735_Clause_6_2_5_Signal.png" alt="Signal model."/></a>

  <figcaption id="Figure_5">Figure 5: Signal model.</figcaption>

</figure>