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.

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
Show file tree
Hide file tree
Changes from 2 commits
Commits
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
50 changes: 45 additions & 5 deletions ssn/chapters/System-capabilities.html
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,40 @@ <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>The use of <code>schema:minValue</code> and <code>schema:maxValue</code> are suggested to record the bounds of the numerical range.</p>
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
<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 +1171,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 +1405,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 +1501,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
22 changes: 22 additions & 0 deletions ssn/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -612,6 +612,28 @@ <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's temperature sensor to measure ambient air and the physical
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
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>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
43 changes: 43 additions & 0 deletions ssn/rdf/examples/InkBird-IBS-TH2-Range.ttl
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
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
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 ;
schema:unitCode qudt-unit:DEG_C ;
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
schema:maxValue "60" ;
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
schema:minValue "-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
schema:unitCode qudt-unit:DEG_C ;
schema:maxValue "80" ;
schema:minValue "-273" ;
rdfs:label "Inkbird IBS-TH2 Failiure limits"@en .
8 changes: 4 additions & 4 deletions ssn/rdf/ontology/alignments/sdo-sosa-schema.rdfa.html
Original file line number Diff line number Diff line change
Expand Up @@ -196,10 +196,10 @@ <h1>Schema.org SOSA schema</h1>
For example, if variableMeasured is: molecule concentration, measurementTechnique could be: "mass spectrometry" or "nmr spectroscopy" or "colorimetry" or "immunofluorescence".</span>
<span property="rdfs:comment">If the variableMeasured is "depression rating", the measurementTechnique could be "Zung Scale" or "HAM-D" or "Beck Depression Inventory".</span>
<span property="rdfs:comment">If there are several variableMeasured properties recorded for some given data object, use a PropertyValue for each variableMeasured and attach the corresponding measurementTechnique.</span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.or/DataCatalog">DataCatalog</a></span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.or/DataDownload">DataDownload</a></span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.or/Dataset">Dataset</a></span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.or/PropertyValue">PropertyValue</a></span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/DataCatalog">DataCatalog</a></span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/DataDownload">DataDownload</a></span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/Dataset">Dataset</a></span>
<span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/PropertyValue">PropertyValue</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://pending.schema.org/Text">Text</a></span>
<span>Range: <a property="http://schema.org/rangeIncludes" href="http://pending.schema.org/URL">URL</a></span>
<link property="rdfs:subPropertyOf" href="http://www.w3.org/ns/sosa/usedProcedure"/>
Expand Down
12 changes: 12 additions & 0 deletions ssn/rdf/ontology/extensions/ssn-system.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,13 @@ ssn-system: a owl:Ontology , voaf:Vocabulary ;
vann:preferredNamespaceUri "http://www.w3.org/ns/ssn/systems/" ;
owl:imports ssn-act: , ssn-obs: , ssn-dep: .

# Range

ssn-system:Range a owl:Class ;
rdfs:label "Range"@en ;
skos:definition "A primitive class to represent that the value is within a numerical range."@en ;
skos:definition "A primitive class to represent that the value is within a numerical range."@en ;
oldskeptic marked this conversation as resolved.
Show resolved Hide resolved
rdfs:isDefinedBy ssn-system: .

# Quality of Observation

Expand Down Expand Up @@ -138,6 +145,7 @@ ssn-system:hasSystemCapability a owl:ObjectProperty ;
rdfs:label "Measurement Range"@en ;
skos:definition "The set of values that the Sensor can return as the Result of an Observation under the defined Conditions."@en ;
rdfs:comment "The set of values that the Sensor can return as the Result of an Observation under the defined Conditions."@en ;
rdfs:subClassOf ssn-system:Range;
rdfs:subClassOf ssn-system:SystemProperty ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty [ owl:inverseOf ssn-system:hasSystemProperty ] ; owl:allValuesFrom [ a owl:Restriction ; owl:onProperty [ owl:inverseOf ssn-system:hasSystemCapability ] ; owl:allValuesFrom sosa:Sensor ] ] ;
rdfs:isDefinedBy ssn-system: .
Expand All @@ -146,6 +154,7 @@ ssn-system:hasSystemCapability a owl:ObjectProperty ;
rdfs:label "Actuation Range"@en ;
skos:definition "The set of values that the Actuator can return as the Result of an Actuation under the defined Conditions with the defined system properties."@en ;
rdfs:comment "The set of values that the Actuator can return as the Result of an Actuation under the defined Conditions with the defined system properties."@en ;
rdfs:subClassOf ssn-system:Range;
rdfs:subClassOf ssn-system:SystemProperty ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty [ owl:inverseOf ssn-system:hasSystemProperty ] ; owl:allValuesFrom [ a owl:Restriction ; owl:onProperty [ owl:inverseOf ssn-system:hasSystemCapability ] ; owl:allValuesFrom sosa:Actuator ] ] ;
rdfs:isDefinedBy ssn-system: .
Expand Down Expand Up @@ -267,6 +276,7 @@ ssn-system:hasOperatingRange a owl:ObjectProperty ;
In the absence of OperatingProperties, simply describes the Conditions in which a System is expected to operate.

The System continues to operate as defined using SystemCapability. If, however, the SurvivalRange is violated, the System is 'damaged' and SystemCapability specifications may no longer hold."""@en ;
rdfs:subClassOf ssn-system:Range ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty ssn-system:inCondition ; owl:minCardinality "1"^^xsd:nonNegativeInteger ] ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty ssn-system:inCondition ] ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty [ owl:inverseOf ssn-system:hasOperatingRange ] ; owl:allValuesFrom ssn:System ] ;
Expand Down Expand Up @@ -301,6 +311,7 @@ ssn-system:hasOperatingRange a owl:ObjectProperty ;
rdfs:label "Operating Power Range"@en ;
skos:definition "Power range in which a System is expected to operate in the specified Conditions."@en ;
rdfs:comment "Power range in which a System is expected to operate in the specified Conditions."@en ;
rdfs:subClassOf ssn-system:Range;
rdfs:subClassOf ssn-system:OperatingProperty ;
rdfs:isDefinedBy ssn-system: .

Expand All @@ -326,6 +337,7 @@ ssn-system:hasSurvivalRange a owl:ObjectProperty ;
In the absence of SurvivalProperties, simply describes the Conditions a System can be exposed to without damage. For example, the temperature range a System can withstand before being considered damaged.

The System continues to operate as defined using SystemCapability. If, however, the OperatingProperty is violated, the System is operating 'out of operating range' and SystemCapability specifications may no longer hold."""@en ;
rdfs:subClassOf ssn-system:Range ;
rdfs:subClassOf ssn:Property ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty ssn-system:inCondition ; owl:minCardinality "1"^^xsd:nonNegativeInteger ] ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty ssn-system:hasSurvivalProperty ; owl:allValuesFrom ssn-system:SurvivalProperty ] ;
Expand Down