Merge pull request #256 from w3c/239-operating-surival-ranges

239 operating survival ranges, closes #239
w3c · Jan 8, 2025 · 299ba0f · 299ba0f
2 parents fee3fa5 + 270d357
commit 299ba0f
Show file tree

Hide file tree

Showing 11 changed files with 198 additions and 68 deletions.
diff --git a/ssn/chapters/System-capabilities.html b/ssn/chapters/System-capabilities.html
@@ -71,6 +71,7 @@ <h4>Specification</h4>
             , <a href="#SSNSYSTEMLatency">ssn-system:Latency</a>
             , <a href="#SSNSYSTEMPrecision">ssn-system:Precision</a>
             , <a href="#SSNSYSTEMResolution">ssn-system:Resolution</a>
+            , <a href="#SSNSYSTEMRange">ssn-system:Range</a>
             , <a href="#SSNSYSTEMResponseTime">ssn-system:ResponseTime</a>
             , <a href="#SSNSYSTEMSelectivity">ssn-system:Selectivity</a>
             , <a href="#SSNSYSTEMSensitivity">ssn-system:Sensitivity</a>
@@ -453,7 +454,8 @@ <h5><a href="#SSNSYSTEMMeasurementRange">ssn-system:MeasurementRange</a></h5>
                     <th>Sub class of</th>
                     <td>
                         <span rel="rdfs:subClassOf" resource="ssn-system:SystemProperty"><a
-                                href="#SSNSYSTEMSystemProperty">ssn-system:SystemProperty</a></span>
+                                href="#SSNSYSTEMSystemProperty">ssn-system:SystemProperty</a>, <a
+                                href="#SSNSYSTEMRange">ssn-system:Range</a></span>
                     </td>
                 </tr>
                 <tr class="ssn">
@@ -517,7 +519,8 @@ <h5><a href="#SSNSYSTEMActuationRange">ssn-system:ActuationRange</a></h5>
                     <th>Sub class of</th>
                     <td>
                         <span rel="rdfs:subClassOf" resource="ssn-system:SystemProperty"><a
-                                href="#SSNSYSTEMSystemProperty">ssn-system:SystemProperty</a></span>
+                                href="#SSNSYSTEMSystemProperty">ssn-system:SystemProperty</a>, <a
+                                href="#SSNSYSTEMRange">ssn-system:Range</a></span>
                     </td>
                 </tr>
                 <tr class="ssn">
@@ -909,6 +912,42 @@ <h5><a href="#SSNSYSTEMResolution">ssn-system:Resolution</a></h5>
         </div>
     </section>
 
+    <section class="specterm sosa" id="SSNSYSTEMRange" about="ssn-system:Range" typeof="owl:Class">
+        <h5><a href="#SSNSYSTEMRange">ssn-system:Range</a></h5>
+        <p class="crossreference"><strong>IRI:</strong> http://www.w3.org/ns/ssn/systems/Range</p>
+        <p><strong>an OWL Class</strong></p>
+
+        <em property="rdfs:label">Range</em> -
+        <span property="rdfs:comment skos:definition">A primitive class to represent that the value is within a numerical range.</span>
+        <p>Both <code>xsd:minInclusive</code> and <code>xsd:maxInclusive</code> are used to record the upper and lower bound of
+        the range as simple properties. While SOSA/SSN only specifies the use of these properties to list bounding values, individual
+        implementations may add additional axioms to restrict observation values or deployment conditions.</p>
+        <table>
+            <tbody>
+                <tr>
+                    <th>is Defined By</th>
+                    <td>
+                        <span rel="rdfs:isDefinedBy"><a
+                                href="http://www.w3.org/ns/ssn/systems/">http://www.w3.org/ns/ssn/systems/</a></span>
+                    </td>
+                </tr>
+            </tbody>
+        </table>
+        <div class="buttonpanel">
+            <span>
+                <span class="sosa" style="display: none;">[<a href="#"
+                        onclick="hide_ssn(false,this.parentElement.parentElement.parentElement.parentElement);return false;">Show
+                        additional SSN axioms</a>]</span>
+                <span class="ssn">[<a href="#"
+                        onclick="hide_ssn(true,this.parentElement.parentElement.parentElement.parentElement);return false;">Hide
+                        additional SSN axioms</a>]</span>
+            </span>
+            <span class="back">[<a href="#System-capabilities">Back to module overview and examples</a>]</span>
+            <span class="back">[<a href="#overview-of-classes-and-properties">Back to top</a>]</span>
+        </div>
+    </section>
+
+
     <section class="specterm sosa" id="SSNSYSTEMResponseTime" about="ssn-system:ResponseTime" typeof="owl:Class">
         <h5><a href="#SSNSYSTEMResponseTime">ssn-system:ResponseTime</a></h5>
         <p class="crossreference"><strong>IRI:</strong> http://www.w3.org/ns/ssn/systems/ResponseTime</p>
@@ -1134,7 +1173,8 @@ <h5><a href="#SSNSYSTEMOperatingRange">ssn-system:OperatingRange</a></h5>
                     <th>Sub class of</th>
                     <td>
                         <span rel="rdfs:subClassOf" resource="sosa:Property"><a
-                                href="#SOSAProperty">sosa:Property</a></span>
+                                href="#SOSAProperty">sosa:Property</a>, <a
+                                href="#SSNSYSTEMRange">ssn-system:Range</a></span>
                     </td>
                 </tr>
                 <tr class="ssn">
@@ -1367,7 +1407,8 @@ <h5><a href="#SSNSYSTEMOperatingPowerRange">ssn-system:OperatingPowerRange</a></
                     <th>Sub class of</th>
                     <td>
                         <span rel="rdfs:subClassOf" resource="ssn-system:OperatingProperty"><a
-                                href="#SSNSYSTEMOperatingProperty">ssn-system:OperatingProperty</a></span>
+                                href="#SSNSYSTEMOperatingProperty">ssn-system:OperatingProperty</a>, <a
+                                href="#SSNSYSTEMRange">ssn-system:Range</a></span>
                     </td>
                 </tr>
                 <tr>
@@ -1462,7 +1503,8 @@ <h5><a href="#SSNSYSTEMSurvivalRange">ssn-system:SurvivalRange</a></h5>
                     <th>Sub class of</th>
                     <td>
                         <span rel="rdfs:subClassOf" resource="sosa:Property"><a
-                                href="#SOSAProperty">sosa:Property</a></span>
+                                href="#SOSAProperty">sosa:Property</a>, <a
+                                href="#SSNSYSTEMRange">ssn-system:Range</a></span>
                     </td>
                 </tr>
                 <tr class="ssn">

diff --git a/ssn/index.html b/ssn/index.html
@@ -531,6 +531,36 @@ <h3>IP68 Smart Sensor</h3>
         <pre class="example" data-include="./rdf/examples/2017ex25.ttl" data-include-format="text"></pre>
       </div>
     </section>
+
+    <section id="InkBird-IBS-TH2">
+      <h3>InkBird IBS TH2 Sensor</h3>
+      <div>
+        <p>These examples describe a commercially available platform, the IBS TH2, marketed under the InkBird brand.</p>
+
+        <h4>Recording survival and operating ranges for a sensor</h4>
+
+        <p>In this example we represent the capability of the platform temperature sensor to measure ambient air and the physical
+        survival limits of its plastic construction. Note that this should apply to the platform as well, but in SOSA/SSN survival ranges only
+        apply to sensors and systems, not platforms.</p>
+
+        <p>xsd:minInclusive and xsd:maxInclusive are used to report the maximum and minimum operating and survival ranges for the
+        sensor.  These are simple properties that are not encoded here as ontological restrictions on observation results.  Besides the fact that these
+        ranges apply to the sensor type and not the sensor instance, it is often necessary to report
+        out-of-range values to record the occurrence of an operating condition leading to failure.  It should also be noted that
+        system lifespan can exceed the specification.  The Voyager 2 spacecraft is a well know example: designed to function for 5
+        years, it is still partially operational after 43 years.</p>
+
+        <p>An RDF file containing a <a
+            href="https://github.com/w3c/sdw/blob/gh-pages/sdw-sosa-ssn/ssn/rdf/examples/InkBird-IBS-TH2-Range.ttl">graph
+            corresponding to this example is available</a>. </p>
+        <pre class="example" data-include="./rdf/examples/InkBird-IBS-TH2-Range.ttl" data-include-format="text"></pre>
+      </div>
+    </section>
+
+
+
+
+
   </section>
 
   <section class="appendix" id="origins" data-include="./chapters/Origins.html"></section>

diff --git a/ssn/rdf/examples/2017ex21.ttl b/ssn/rdf/examples/2017ex21.ttl
@@ -57,15 +57,15 @@
 
 <NormalOperatingCondition> a ssn-system:Condition , schema:PropertyValue ;
   rdfs:comment "A temperature range of -40 to 80 Celsius."@en ;
-  schema:minValue -40.0 ;
-  schema:maxValue 80.0 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive -40.0 ;
+  xsd:maxInclusive 80.0 ;
+  qudt:unit unit:DegreeCelsius .
 
 <NormalHumidityCondition> a ssn-system:Condition , schema:PropertyValue ;
   rdfs:comment "A relative humidity range of 5 to 85 %."@en ;
-  schema:minValue 5.0 ;
-  schema:maxValue 85.0 ;
-  schema:unitCode unit:PERCENT .
+  xsd:minInclusive 5.0 ;
+  xsd:maxInclusive 85.0 ;
+  qudt:unit unit:PERCENT .
 
 
 
@@ -76,25 +76,25 @@
 
 <DHT22/4578#TemperatureSensorAccuracy> a sosa:Property , ssn-system:Accuracy , schema:PropertyValue ;
   rdfs:comment "The accuracy of the temperature sensor is +-0.5 °C in normal temperature and humidity conditions."@en ;
-  schema:minValue -0.5 ;
-  schema:maxValue 0.5 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive -0.5 ;
+  xsd:maxInclusive 0.5 ;
+  qudt:unit unit:DegreeCelsius .
 
 <DHT22/4578#TemperatureSensorSensitivity> a sosa:Property , ssn-system:Sensitivity , ssn-system:Resolution , schema:PropertyValue ;
   rdfs:comment "The sensitivity and resolution of the temperature sensor is 0.1 °C in normal temperature and humidity conditions."@en ;
   schema:value 0.1 ;
-  schema:unitCode unit:DegreeCelsius .
+  qudt:unit unit:DegreeCelsius .
 
 <DHT22/4578#TemperatureSensorPrecision> a sosa:Property , ssn-system:Precision , schema:PropertyValue ;
   rdfs:comment "The precision (= repeatability) of the temperature sensor is +-0.2 °C in normal temperature and humidity conditions."@en ;
-  schema:minValue 0.2 ;
-  schema:maxValue 0.2 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive 0.2 ;
+  xsd:maxInclusive 0.2 ;
+  qudt:unit unit:DegreeCelsius .
 
 <DHT22/4578#TemperatureSensorFrequency> a sosa:Property , ssn-system:Frequency , schema:PropertyValue ;
   rdfs:comment "The smallest possible time between one observation and the next is 2 s on average."@en ;
   schema:value 2 ;
-  schema:unitCode unit:Second .
+  qudt:unit unit:Second .
 
 
 <observation/1087> rdf:type sosa:Observation ;

diff --git a/ssn/rdf/examples/2017ex25.ttl b/ssn/rdf/examples/2017ex25.ttl
@@ -34,9 +34,9 @@
 
 <IP68_Outdoor_Temperature_Sensor#normalOperatingCondition> a ssn-system:Condition , schema:PropertyValue ;
   rdfs:comment "A temperature range of -20 to 70 Celsius."@en ;
-  schema:minValue -20.0 ;
-  schema:maxValue 70.0 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive -20.0 ;
+  xsd:maxInclusive 70.0 ;
+  qudt:unit unit:DegreeCelsius .
 
 <IP68_Outdoor_Temperature_Sensor#systemCapability> a sosa:Property , ssn-system:SystemCapability ;
   rdfs:comment "The sensor capability in normal operating conditions."@en ;
@@ -45,23 +45,23 @@
 
 <IP68_Outdoor_Temperature_Sensor#RFSensitivity> a sosa:Property , ssn-system:Sensitivity , schema:PropertyValue ;
   schema:value -137 ;
-  schema:unitCode unit:DecibelReferredToOneMilliwatt .
+  qudt:unit unit:DecibelReferredToOneMilliwatt .
 
 <IP68_Outdoor_Temperature_Sensor#TemperatureAccuracy> a sosa:Property , ssn-system:Accuracy , schema:PropertyValue ;
   sosa:forProperty <Air?lat=45.75&long=4.85#temperature> ;
-  schema:minValue -0.2 ;
-  schema:maxValue 0.2 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive -0.2 ;
+  xsd:maxInclusive 0.2 ;
+  qudt:unit unit:DegreeCelsius .
 
 <IP68_Outdoor_Temperature_Sensor#TemperatureResolution> a sosa:Property , ssn-system:Resolution , schema:PropertyValue ;
   sosa:forProperty <Air?lat=45.75&long=4.85#temperature> ;
   schema:value 0.0625 ;
-  schema:unitCode unit:DegreeCelsius .
+  qudt:unit unit:DegreeCelsius .
 
 <IP68_Outdoor_Temperature_Sensor#BatteryResolution> a sosa:Property , ssn-system:Resolution , schema:PropertyValue ;
   sosa:forProperty <Sensor/SL-T-P1#battery> ;
   schema:value 3.937e-3 ;
-  schema:unitCode unit:PERCENT .
+  qudt:unit unit:PERCENT .
 
 <Air?lat=45.75&long=4.85> a sosa:Sample ;
   rdfs:label "The air at lat 45.75 and long 4.85."@en ;

diff --git a/ssn/rdf/examples/InkBird-IBS-TH2-Range.ttl b/ssn/rdf/examples/InkBird-IBS-TH2-Range.ttl
@@ -0,0 +1,43 @@
+@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#>.
+@prefix xsd:  <http://www.w3.org/2001/XMLSchema#> .
+@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
+@prefix qudt: <http://qudt.org/schema/qudt/> .
+@prefix unit: <http://qudt.org/vocab/unit/> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix schema: <http://schema.org/> .
+@prefix gs1: <https://gs1.org/voc/> .
+@prefix equipment: <https://rdf.ag/o/equipment/> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix sosa: <http://www.w3.org/ns/sosa/> .
+@prefix ssn: <http://www.w3.org/ns/ssn/> .
+@prefix ssn-system: <http://www.w3.org/ns/ssn/systems/> .
+@base <https://rdf.ag/o/equipment/> .
+
+# This example is a partial specification for a common over-the-shelf temperature and humidity sensor.  Different instantions can
+# be derived for each specific physical the product. 
+
+<InkBird-IBS-TH2> a owl:Class;
+    rdfs:label "Inkbird IBS-TH2"@en ;
+    rdfs:subClassOf gs1:Product, sosa:Platform, equipment:Equipment, <https://w3id.org/seas/BluetoothCommunicationDevice>;
+    gs1:pip <https://inkbird.com/products/hygrometer-ibs-th2> ;
+    sosa:hosts <IBSTH2TemperatureSensor> .
+
+<IBSTH2TemperatureSensor> rdfs:subClassOf sosa:Sensor ;
+    rdfs:label "Inkbird IBS-TH2 built-in Temperature Sensor"@en ;
+    sosa:observes <airTemperature> ;
+    ssn-system:hasOperatingRange <IBSTH2TemperatureSensorLimits> ;
+    ssn-system:hasSurvivalRange <IBSTH2SurvivalRange> .
+
+<IBSTH2TemperatureSensorLimits> a ssn-system:OperatingRange ;
+    qudt:unit qudt-unit:DEG_C ;
+    xsd:maxInclusive "60" ;
+    xsd:minInclusive "-40" ;
+    rdfs:label "Inkbird IBS-TH2 Temperature Sensor Limits"@en .
+
+# Physical limits of the sensor (and platform) where structural failure occurs.
+<IBSTH2SurvivalRange> a ssn-system:SurvivalRange ;
+    qudt:unit qudt-unit:DEG_C ;
+    xsd:maxInclusive "80" ;
+    xsd:minInclusive "-273" ;
+    rdfs:label "Inkbird IBS-TH2 Failiure limits"@en .
diff --git a/ssn/rdf/examples/InkBird.ttl b/ssn/rdf/examples/InkBird.ttl
@@ -19,12 +19,12 @@
         sosa:observes qk:Temperature ;
         system:hasSystemProperty [
             a system:MeasurementRange ;
-            schema:maxValue "60"^^unit:DEG_C ;
-            schema:minValue "-40"^^unit:DEG_C ;
+            xsd:maxInclusive "60"^^unit:DEG_C ;
+            xsd:minInclusive "-40"^^unit:DEG_C ;
         ] ;
         system:hasSystemProperty [
             a system:Accuracy ;
-            schema:value "0.5"^^unit:DEG_C ;
+            qudt:value "0.5"^^unit:DEG_C ;
         ] ;
 
     ] ;
@@ -33,12 +33,12 @@
         sosa:observes qk:RelativeHumidity ;
         system:hasSystemProperty [
             a system:MeasurementRange ;
-            schema:maxValue "100"^^unit:PERCENT ;
-            schema:minValue "0"^^unit:PERCENT ;
+            xsd:maxInclusive "100"^^unit:PERCENT ;
+            xsd:minInclusive "0"^^unit:PERCENT ;
         ] ;
         system:hasSystemProperty [
             a system:Resolution ;
-            schema:value "2"^^unit:PERCENT ;
+            qudt:value "2"^^unit:PERCENT ;
         ] ;
 
     ] ;

diff --git a/ssn/rdf/examples/dht22.ttl b/ssn/rdf/examples/dht22.ttl
@@ -57,15 +57,15 @@
 
 <NormalOperatingCondition> a schema:PropertyValue ;
   rdfs:comment "A temperature range of -40 to 80 Celsius."@en ;
-  schema:minValue -40.0 ;
-  schema:maxValue 80.0 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive -40.0 ;
+  xsd:maxInclusive 80.0 ;
+  qudt:unit unit:DegreeCelsius .
 
 <NormalHumidityCondition> a schema:PropertyValue ;
   rdfs:comment "A relative humidity range of 5 to 85 %."@en ;
-  schema:minValue 5.0 ;
-  schema:maxValue 85.0 ;
-  schema:unitCode unit:PERCENT .
+  xsd:minInclusive 5.0 ;
+  xsd:maxInclusive 85.0 ;
+  qudt:unit unit:PERCENT .
 
 
 
@@ -76,25 +76,25 @@
 
 <DHT22/4578#TemperatureSensorAccuracy> a sosa:Property , ssn-system:Accuracy , schema:PropertyValue ;
   rdfs:comment "The accuracy of the temperature sensor is +-0.5 °C in normal temperature and humidity conditions."@en ;
-  schema:minValue -0.5 ;
-  schema:maxValue 0.5 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive -0.5 ;
+  xsd:maxInclusive 0.5 ;
+  qudt:unit unit:DegreeCelsius .
 
 <DHT22/4578#TemperatureSensorSensitivity> a sosa:Property , ssn-system:Sensitivity , ssn-system:Resolution , schema:PropertyValue ;
   rdfs:comment "The sensitivity and resolution of the temperature sensor is 0.1 °C in normal temperature and humidity conditions."@en ;
-  schema:value 0.1 ;
-  schema:unitCode unit:DegreeCelsius .
+  qudt:value 0.1 ;
+  qudt:unit unit:DegreeCelsius .
 
 <DHT22/4578#TemperatureSensorPrecision> a sosa:Property , ssn-system:Precision , schema:PropertyValue ;
   rdfs:comment "The precision (= repeatability) of the temperature sensor is +-0.2 °C in normal temperature and humidity conditions."@en ;
-  schema:minValue 0.2 ;
-  schema:maxValue 0.2 ;
-  schema:unitCode unit:DegreeCelsius .
+  xsd:minInclusive 0.2 ;
+  xsd:maxInclusive 0.2 ;
+  qudt:unit unit:DegreeCelsius .
 
 <DHT22/4578#TemperatureSensorFrequency> a sosa:Property , ssn-system:Frequency , schema:PropertyValue ;
   rdfs:comment "The smallest possible time between one observation and the next is 2 s on average."@en ;
-  schema:value 2 ;
-  schema:unitCode unit:Second .
+  qudt:value 2 ;
+  qudt:unit unit:Second .
 
 
 <observation/1087> rdf:type sosa:Observation ;

diff --git a/ssn/rdf/examples/house134.ttl b/ssn/rdf/examples/house134.ttl
@@ -96,14 +96,14 @@
 
 <normalTemp> a schema:PropertyValue ;
 	rdfs:comment "A temperature range of -40 to 80 Celsius."@en ;
-	schema:minValue -40.0 ;
-	schema:maxValue 80.0 ;
-	schema:unitCode unit:DegreeCelsius .
+	xsd:minInclusive -40.0 ;
+	xsd:maxInclusive 80.0 ;
+	qudt:unit unit:DegreeCelsius .
 
 <DHT22TempSensitivity> a sosa:Property, ssn-system:Sensitivity, ssn-system:Resolution, schema:PropertyValue ;
 	rdfs:comment "The sensitivity and resolution of the temperature sensor is 0.1 °C in normal temperature and humidity conditions."@en ;
 	schema:value 0.1 ;
-	schema:unitCode unit:DegreeCelsius .
+	qudt:unit unit:DegreeCelsius .
 
 <house/134/deployment> a sosa:Deployment ;
 	rdfs:comment "Deployment of PCB Board 1 and 2 in the kitchen for the purpose of observing the temperature."@en ;
@@ -149,7 +149,7 @@
 <observation/235716> a sosa:Observation ;
 	sosa:hasResult [
 		a qudt:QuantityValue ;
-		qudt:hasUnit unit:DegreeCelsius ;
+		qudt:unit unit:DegreeCelsius ;
 		qudt:numericValue "22.9"^^xsd:double
 	] .