Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

239 operating survival ranges, closes #239 #256

Merged
merged 14 commits into from
Jan 8, 2025
Merged

239 operating survival ranges, closes #239 #256

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
ccaf9d9
Fix minor typo
oldskeptic Oct 16, 2024
ea02618
Add new ssn-system:Range abstract class and subclass relevant ranging…
oldskeptic Oct 16, 2024
1238f89
Merge branch 'gh-pages' into 239-operating-surival-ranges
dr-shorthair Nov 27, 2024
322f2b8
Merge branch 'gh-pages' into 239-operating-surival-ranges
dr-shorthair Nov 27, 2024
ce17b0f
Merge branch 'gh-pages' into 239-operating-surival-ranges
dr-shorthair Nov 27, 2024
c2a0f3d
Merge branch 'gh-pages' into 239-operating-surival-ranges
dr-shorthair Nov 27, 2024
8956a62
Merge branch 'gh-pages' into 239-operating-surival-ranges
dr-shorthair Nov 28, 2024
9de8918
Merge branch 'gh-pages' into 239-operating-surival-ranges
dr-shorthair Dec 3, 2024
bd9a555
Merge branch 'gh-pages' into 239-operating-surival-ranges
dr-shorthair Dec 10, 2024
8c25f06
This resolves all concerns about xsd uses.
oldskeptic Dec 11, 2024
66bac62
Standardize all ranges in examples to xsd:maxInclusive / xsd:minInclu…
oldskeptic Dec 11, 2024
517ba17
Fix typo
oldskeptic Dec 11, 2024
1e4b47b
Move some examples to qudt:value
oldskeptic Dec 11, 2024
270d357
Missing semicolon InkBird-IBS-TH2-Range.ttl
oldskeptic Jan 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 47 additions & 5 deletions ssn/chapters/System-capabilities.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down Expand Up @@ -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">
Expand Down Expand Up @@ -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">
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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">
Expand Down Expand Up @@ -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>
Expand Down Expand Up @@ -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">
Expand Down
30 changes: 30 additions & 0 deletions ssn/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
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>
Expand Down
28 changes: 14 additions & 14 deletions ssn/rdf/examples/2017ex21.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 .



Expand All @@ -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 ;
Expand Down
18 changes: 9 additions & 9 deletions ssn/rdf/examples/2017ex25.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 ;
Expand All @@ -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 ;
Expand Down
43 changes: 43 additions & 0 deletions ssn/rdf/examples/InkBird-IBS-TH2-Range.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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> .
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved

<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 ;
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
qudt:unit qudt-unit:DEG_C ;
xsd:maxInclusive "80" ;
xsd:minInclusive "-273" ;
rdfs:label "Inkbird IBS-TH2 Failiure limits"@en .
12 changes: 6 additions & 6 deletions ssn/rdf/examples/InkBird.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 ;
] ;

] ;
Expand All @@ -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 ;
] ;

] ;
Expand Down
32 changes: 16 additions & 16 deletions ssn/rdf/examples/dht22.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 .



Expand All @@ -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 ;
Expand Down
10 changes: 5 additions & 5 deletions ssn/rdf/examples/house134.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 ;
Expand Down Expand Up @@ -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
] .

Expand Down
Loading