Skip to content

Proposed implementation of #106 #126

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

Merged
merged 7 commits into from
Dec 8, 2023
Merged

Proposed implementation of #106 #126

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
eb03ff8
Proposed implementation of #106
maximelefrancois86 Nov 30, 2023
6e9967a
added PropertyOfInterest to the toc of Section 4.6
maximelefrancois86 Nov 30, 2023
0a925a4
also started to simplify the 'common modeling questions' section
maximelefrancois86 Nov 30, 2023
351438d
clarified ns sosa/ssn for Property and Property of Interest
maximelefrancois86 Dec 3, 2023
ea905de
Merge branch 'gh-pages' into property-of-interest
dr-shorthair Dec 5, 2023
c774b67
fix label of PropertyOfInterest
maximelefrancois86 Dec 7, 2023
215a899
Merge branch 'property-of-interest' of github.com:w3c/sdw-sosa-ssn in…
maximelefrancois86 Dec 7, 2023
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
122 changes: 80 additions & 42 deletions ssn/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1790,6 +1790,7 @@ <h4>Specification</h4>
<a href="#SOSAhasFeatureOfInterest">sosa:hasFeatureOfInterest</a>,
<a href="#SOSAisFeatureOfInterestOf">sosa:isFeatureOfInterestOf</a>,
<span class="ssn"> <a href="#SSNProperty">ssn:Property</a>, </span>
<span class="ssn"> <a href="#SSNPropertyOfInterest">ssn:PropertyOfInterest</a>, </span>
<span class="ssn"> <a href="#SSNhasProperty">ssn:hasProperty</a>,</span>
<span class="ssn"> <a href="#SSNisPropertyOf">ssn:isPropertyOf</a>, </span>
<span class="ssn"> <a href="#SSNforProperty">ssn:forProperty</a></span>
Expand Down Expand Up @@ -1915,36 +1916,80 @@ <h5><a href="#SOSAisFeatureOfInterestOf">sosa:isFeatureOfInterestOf</a></h5>
</section>

<section class="specterm ssn" id="SSNProperty" about="ssn:Property" typeof="owl:Class">
<h5><a href="#SSNProperty">ssn:Property</a></h5>
<p class="crossreference"><strong>IRI:</strong> http://www.w3.org/ns/ssn/Property</p>
<p><strong>a OWL Class</strong></p>
<h5><a href="#SSNProperty">ssn:Property</a></h5>
<p class="crossreference"><strong>IRI:</strong> http://www.w3.org/ns/ssn/Property</p>
<p><strong>a OWL Class</strong></p>

<em property="rdfs:label">Property</em> -
<span property="rdfs:comment skos:definition">A quality of an entity. An aspect of an entity that is intrinsic to and cannot exist without the entity.</span>
<table>
<tbody>
<tr>
<th class="restrictions">Restrictions:</th>
<td>
<span about="ssn:Property" rel="rdfs:subClassOf" resource="[_:SSNProperty1]"></span>
<span about="[_:SSNProperty1]" typeof="owl:Restriction"></span>
<span about="[_:SSNProperty1]" rel="owl:onProperty" resource="ssn:isPropertyOf"><a href="#SSNisPropertyOf">ssn:isPropertyOf</a></span>
<span about="[_:SSNProperty1]" property="owl:allValuesFrom" resource="sosa:FeatureOfInterest"><em><b>ONLY</b></em> <a href="#SOSAFeatureOfInterest">sosa:FeatureOfInterest</a></span>
</td>
</tr>
<tr>
<th>is Defined By</th>
<td>
<span rel="rdfs:isDefinedBy"><a href="http://www.w3.org/ns/ssn/">http://www.w3.org/ns/ssn/</a></span>
</td>
</tr>
</tbody>
</table>
<div class="buttonpanel">
<span class="back">[<a href="#Features-of-Interest-and-Properties">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>
<em property="rdfs:label">Property</em> -
<span property="rdfs:comment skos:definition">An identifiable quality of a <a href="#SOSAFeatureOfInterest"><code></code>FeatureOfInterest</code></a> that can be observed or acted upon. A property can apply to different features of interest.</span>
<table>
<tbody>
<tr>
<th>Example</th>
<td><span about="ssn:Property" property="skos:example">Cars (a feature type) all have a characteristic colour, where "colour" is a property.</span></td>
</tr>
<tr>
<th>Note</th>
<td><span about="ssn:Property" property="skos:note">Concepts from existing code lists, vocabularies, and taxonomies, may be used as instances of <a href="#SOSAFeatureOfInterest"><code>Property</code></a>.</span></td>
</tr>
<tr>
<th>is Defined By</th>
<td>
<span rel="rdfs:isDefinedBy"><a href="http://www.w3.org/ns/ssn/">http://www.w3.org/ns/ssn/</a></span>
</td>
</tr>
</tbody>
</table>
<div class="buttonpanel">
<span class="back">[<a href="#Features-of-Interest-and-Properties">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 ssn" id="SSNPropertyOfInterest" about="ssn:PropertyOfInterest" typeof="owl:Class">
<h5><a href="#SSNPropertyOfInterest">ssn:PropertyOfInterest</a></h5>
<p class="crossreference"><strong>IRI:</strong> http://www.w3.org/ns/ssn/PropertyOfInterest</p>
<p><strong>a OWL Class</strong></p>

<em property="rdfs:label">Property Of Interest</em> -
<span property="rdfs:comment skos:definition">An identifiable quality of a <a href="#SOSAFeatureOfInterest"><code>FeatureOfInterest</code></a> that can be observed or acted upon. A property of interest is specific to a <a href="#SOSAFeatureOfInterest"><code>FeatureOfInterest</code></a>. It is inherent to and cannot exist without that feature of interest.</span>
<table>
<tbody>
<tr>
<th>Example</th>
<td><span about="ssn:PropertyOfInterest" property="skos:example">Abby's car has the colour red, where "colour red" is a property of interest of the car.</span></td>
</tr>
<tr>
<th>Note</th>
<td><span about="ssn:PropertyOfInterest" property="skos:note">Properties of interest need not always be explicitly identified. It depends on the use case.</span></td>
</tr>
<tr>
<th class="restrictions">Restrictions:</th>
<td>
<span about="ssn:PropertyOfInterest" rel="rdfs:subClassOf" resource="[_:SSNPropertyOfInterest1]"></span>
<span about="[_:SSNPropertyOfInterest1]" typeof="owl:Restriction"></span>
<span about="[_:SSNPropertyOfInterest1]" rel="owl:onProperty" resource="ssn:isPropertyOf"><a href="#SSNisPropertyOf">ssn:isPropertyOf</a></span>
<span about="[_:SSNPropertyOfInterest1]" property="owl:allValuesFrom" resource="sosa:FeatureOfInterest"><em><b>ONLY</b></em> <a href="#SOSAFeatureOfInterest">sosa:FeatureOfInterest</a></span>
<br/>
<span about="ssn:Property" rel="rdfs:subClassOf" resource="[_:SSNPropertyOfInterest2]"></span>
<span about="[_:SSNPropertyOfInterest2]" typeof="owl:Restriction"></span>
<span about="[_:SSNPropertyOfInterest2]" rel="owl:onProperty" resource="ssn:isPropertyOf"><a href="#SSNisPropertyOf">ssn:isPropertyOf</a></span>
<span about="[_:SSNPropertyOfInterest2]" property="owl:cardinality" resource="sosa:FeatureOfInterest"><em><b>EXACTLY 1</b></em></span>
</td>
</tr>
<tr>
<th>is Defined By</th>
<td>
<span rel="rdfs:isDefinedBy"><a href="http://www.w3.org/ns/ssn/">http://www.w3.org/ns/ssn/</a></span>
</td>
</tr>
</tbody>
</table>
<div class="buttonpanel">
<span class="back">[<a href="#Features-of-Interest-and-Properties">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 ssn" id="SSNhasProperty" about="ssn:hasProperty" typeof="owl:ObjectProperty">
<h5><a href="#SSNhasProperty">ssn:hasProperty</a></h5>
Expand Down Expand Up @@ -5886,19 +5931,12 @@ <h3>Quantity Values and Unit of Measures</h3>

<section id="SSNProperty-instances" class="informative">
<h3>Generic or Specific Instances of ssn:Property</h3>
<p>This specification does not specify whether an instance of <a href="#SSNProperty"><code>ssn:Property</code></a> should be generic to all features of interest (e.g., <code>ex:Temperature</code>,
<code>ex:OnOffStatus</code>), or specific to a single feature of interest (e.g., <code>&lt;myBodyTemperature&gt;</code>, <code>&lt;LightStatus&gt;</code>).
Implementers are free to choose one way of modeling things or the other.
</p>
<p>On the other hand, one SHOULD NOT use <a href="https://www.w3.org/TR/owl2-new-features/#F12:_Punning">OWL punning</a> to make <code>ex:Temperature</code> denote both a subclass of
<a href="#SSNProperty"><code>ssn:Property</code></a> and an instance of <a href="#SSNProperty"><code>ssn:Property</code></a>. In fact, merging the
two examples below in a single RDF Graph would make an OWL reasoner infer that <code>ex:Temperature</code>, <code>&lt;office/1/temperature&gt;</code>, and
<code>&lt;office/2/temperature&gt;</code>, denote the same individual.</p>
<p>This also holds for subclasses of <a href="#SSNProperty"><code>ssn:Property</code></a>: <a href="#SOSAObservableProperty"><code>sosa:ObservableProperty</code></a>, and <a href="#SOSAActuatableProperty"><code>sosa:ActuatableProperty</code></a>.</p>
<p>This first example is modeling instances of <a href="#SSNProperty"><code>ssn:Property</code></a> as generic to all features of interest:</p>
<pre class="example" data-include="./examples/2017ex4.ttl" data-include-format="text"></pre>
<p>This second example is modeling instances of <a href="#SSNProperty"><code>ssn:Property</code></a> as specific to a features of interest:</p>
<pre class="example" data-include="./examples/2017ex5.ttl" data-include-format="text"></pre>
<p>The previous version of SOSA/SSN left an ambiguity on whether an instance of <a href="#SSNProperty"><code>ssn:Property</code></a> should be generic to all features of interest (e.g., <code>ex:Temperature</code>,
<code>ex:OnOffStatus</code>), or specific to a single feature of interest (e.g., <code>&lt;myBodyTemperature&gt;</code>, <code>&lt;LightStatus&gt;</code>). This version solves the ambiguity by differentiating:</p>
<ul>
<li><a href="#SOSAProperty"><code>sosa:Property</code></a> for the former case</li>
<li><a href="#SOSAPropertyOfInterest"><code>sosa:PropertyOfInterest</code></a> for the latter case.</li>
</ul>
</section>


Expand Down
14 changes: 12 additions & 2 deletions ssn/integrated/sosa.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,10 +70,20 @@ sosa:FeatureOfInterest a rdfs:Class , owl:Class ;

sosa:Property a owl:Class ;
rdfs:label "Property"@en ;
skos:definition "A quality of an entity. An aspect of an entity that is intrinsic to and cannot exist without the entity."@en ;
rdfs:comment "A quality of an entity. An aspect of an entity that is intrinsic to and cannot exist without the entity."@en ;
skos:definition "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property can apply to different features of interest."@en ;
rdfs:comment "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property can apply to different features of interest."@en ;
skos:example "Cars (a feature type) all have a characteristic colour, where "colour" is a property."@en ;
skos:note "Concepts from existing code lists, vocabularies, and taxonomies, may be used as instances of Property"@en ;
rdfs:isDefinedBy sosa: .

sosa:PropertyOfInterest a owl:Class ;
rdfs:label "Property"@en ;
skos:definition "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property of interest is specific to a feature of interest. It is inherent to and cannot exist without that FeatureOfInterest."@en ;
rdfs:comment "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property of interest is specific to a feature of interest. It is inherent to and cannot exist without that FeatureOfInterest."@en ;
skos:example "Abby's car has the colour red, where \"colour red\" is a property of interest of the car."@en ;
skos:note "Properties of interest need not always be explicitly identified. It depends on the use case."@en ;
rdfs:isDefinedBy ssn: .

sosa:hasProperty a owl:ObjectProperty ;
rdfs:label "has property"@en ;
skos:definition "Relation between an entity and a Property of that entity."@en ;
Expand Down
16 changes: 14 additions & 2 deletions ssn/integrated/ssn.ttl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,9 +59,21 @@ sosa:FeatureOfInterest
ssn:Property a owl:Class ;
owl:equivalentClass sosa:Property ;
rdfs:label "Property"@en ;
skos:definition "A quality of an entity. An aspect of an entity that is intrinsic to and cannot exist without the entity."@en ;
rdfs:comment "A quality of an entity. An aspect of an entity that is intrinsic to and cannot exist without the entity."@en ;
skos:definition "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property can apply to different features of interest."@en ;
rdfs:comment "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property can apply to different features of interest."@en ;
skos:example "Cars (a feature type) all have a characteristic colour, where \"colour\" is a property."@en ;
skos:note "Concepts from existing code lists, vocabularies, and taxonomies, may be used as instances of Property."@en ;
rdfs:isDefinedBy ssn: .

ssn:PropertyOfInterest a owl:Class ;
owl:equivalentClass sosa:PropertyOfInterest ;
rdfs:label "Property"@en ;
skos:definition "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property of interest is specific to a feature of interest. It is inherent to and cannot exist without that FeatureOfInterest."@en ;
rdfs:comment "An identifiable quality of a FeatureOfInterest that can be observed or acted upon. A property of interest is specific to a feature of interest. It is inherent to and cannot exist without that FeatureOfInterest."@en ;
skos:example "Abby's car has the colour red, where \"colour red\" is a property of interest of the car."@en ;
skos:note "Properties of interest need not always be explicitly identified. It depends on the use case."@en ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty ssn:isPropertyOf ; owl:allValuesFrom sosa:FeatureOfInterest ] ;
rdfs:subClassOf [ a owl:Restriction ; owl:onProperty ssn:isPropertyOf ; owl:cardinality "1"^^xsd:nonNegativeInteger ] ;
rdfs:isDefinedBy ssn: .

ssn:hasProperty a owl:ObjectProperty ;
Expand Down