forked from w3c/wot-thing-description
-
Notifications
You must be signed in to change notification settings - Fork 0
/
tm.html
112 lines (101 loc) · 8.79 KB
/
tm.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8'>
<title>Web of Things (WoT) Thing Model (TM) Ontology</title>
<script src='https://www.w3.org/Tools/respec/respec-w3c' class='remove'></script>
<script class='remove'>
var respecConfig = {
specStatus: "ED",
latestVersion: null,
// publishDate: "2023-12-05",
group: "wg/wot",
editors: [{
name: "Mahda Noura"
, company: "Siemens AG"
, companyURL: "http://www.siemens.com/"
}, {
name: "Sebastian Käbisch"
, company: "Siemens AG"
, companyURL: "http://www.siemens.com/"
}],
edDraftURI: "https://www.w3.org/2019/wot/td",
shortName: "wot-tm-ontology",
otherLinks: [{
key: "Ontology in RDF",
data: [
{
value: "Web of Things (WoT) Thing Model (TM) Ontology in RDF",
href: "tm.ttl",
}
]
}
]
};
</script>
<style>
span.indent {
margin-left: 2em;
}
</style>
</head>
<body>
<section id='abstract'>
<p>
The Thing Model (TM) ontology is an RDF axiomatization of the TM concepts,
one of the building blocks of the Web of Things (WoT). Besides providing an alternative
to the standard JSON representation format for TM documents, the TM ontology can also
be used to process contextual information on Things and for alignments with other
WoT-related ontologies.
</p>
</section>
<section id='sotd'>
</section>
<section>
<h2>Introduction</h2>
<p>
The TM ontology is an idiomatic RDF axiomatization of the <a href="https://www.w3.org/TR/wot-thing-description11/#thing-model">TM concepts</a>
, which can be used as a template for instantiating Thing Descriptions (TD)s. The TM ontology imports
the <a href="https://www.w3.org/2019/wot/td">TD</a> ontology.
</p>
<p>
Please note that the Turtle version of the ontology can be always obtained by doing content negotiation as explained in
<a href="https://www.w3.org/TR/2023/REC-wot-thing-description11-20231205/#json-ld-ctx-usage">Appendix D of the Thing
Description Recommendation</a>.
You can include <code>Accept: text/turtle</code> in the request to obtain the Turtle version of this ontology.
</p>
</section>
<section id="conformance"></section>
<section id="terminology">
<h2>Terminology</h2>
<p>The fundamental WoT terminology such as
<dfn class="lint-ignore">Thing</dfn>,
<dfn class="lint-ignore">Consumer</dfn>,
<dfn class="lint-ignore">Thing Description</dfn> (<dfn class="lint-ignore">TD</dfn>),
<dfn class="lint-ignore">Interaction Model</dfn>,
<dfn class="lint-ignore">Interaction Affordance</dfn>,
<dfn class="lint-ignore">Property</dfn>,
<dfn class="lint-ignore">Action</dfn>,
<dfn class="lint-ignore">Event</dfn>,
<dfn class="lint-ignore">Protocol Binding</dfn>,
<dfn class="lint-ignore">Servient</dfn>,
etc. is defined in <a href="https://www.w3.org/TR/wot-architecture/#terminology">Section 3</a>
of the WoT Architecture specification [[WOT-ARCHITECTURE]].
</p>
<p>
The Thing Description terminology such as
<dfn class="lint-ignore">TD Information Model</dfn>,
<dfn class="lint-ignore">TD Document</dfn>,
<dfn class="lint-ignore">Term</dfn> (<dfn class="lint-ignore">Vocabulary Term</dfn>),
etc. is defined in <a href="https://www.w3.org/TR/wot-thing-description/#terminology">Section 3</a>
of the WoT Thing Description specification [[WOT-THING-DESCRIPTION]].
</p>
</section>
<!-- axioms rendered from RDF definitions -->
<section><h2>Axiomatization</h2><section><h3>Classes</h3><section id="ThingModel"><h4>ThingModel</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#ThingModel</code></p><span>A Thing Model is a description for a class of Things that have the same capabilities. It describes the Properties, Actions, and Events and common metadata that are shared for an entire group of Things. Compared to a Thing Description, a Thing Model does not contain enough information to identify or interact with a Thing instance.</span><table class="def numbered"><tbody><tr><td>In the domain of</td><td><code><a href="https://www.w3.org/2019/wot/td#description">td:description</a></code><br><code><a href="https://www.w3.org/2019/wot/td#hasLink">td:hasLink</a></code><br><code><a href="https://www.w3.org/2019/wot/td#title">td:title</a></code><br><code><a href="#hasVersion">tm:hasVersion</a></code><br><code><a href="#optional">tm:optional</a></code><br><code><a href="#required">tm:required</a></code></td></tr></tbody></table></section>
<section id="Version"><h4>Version</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#Version</code></p><span>The Version is a container that provides versioning information for the Thing Model definition.</span><table class="def numbered"><tbody><tr><td>In the domain of</td><td><code><a href="#model">tm:model</a></code></td></tr><tr><td>In the range of</td><td><code><a href="#hasVersion">tm:hasVersion</a></code></td></tr></tbody></table></section></section><section><h3>Object Properties</h3><section id="hasVersion"><h4>hasVersion</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#hasVersion</code></p><span>Provides the relation between a Thing Model and its version.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#ThingModel">tm:ThingModel</a></code></td></tr><tr><td>Range includes</td><td><code><a href="#Version">tm:Version</a></code></td></tr></tbody></table></section></section><section><h3>Datatype Properties</h3><section id="model"><h4>model</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#model</code></p><span>Provides a version indicator of the underlying TM.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#Version">tm:Version</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section>
<section id="optional"><h4>optional</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#optional</code></p><span>Constraint that provides references to declarations in the Thing Model that are optional and do not necessarily need to be implemented when Thing Description instances are derived from this Thing Model. The value of tm:optional MUST provide JSON Pointer [RFC6901] references to the required interaction model definitions.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#ThingModel">tm:ThingModel</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section>
<section id="ref"><h4>ref</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#ref</code></p><span>Provides a reference to an existing (external or local) definition that is copied into a newly defined definition. The reference value is based on three parts: an (optional) URI-reference (used for external reference), '#' sign, and JSON Pointer [RFC6901] value.</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="https://www.w3.org/2019/wot/td#InteractionAffordance">td:InteractionAffordance</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section>
<section id="required"><h4>required</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#required</code></p><span>Constraint that provides references to declarations in the Thing Model that are mandatory and must be present when Thing Description instances are derived from this Thing Model. The reference value is a JSON Pointer [RFC6901].</span><table class="def numbered"><tbody><tr><td>Domain includes</td><td><code><a href="#ThingModel">tm:ThingModel</a></code></td></tr><tr><td>Range includes</td><td><code><a href="http://schema.org/Text">schema:Text</a></code></td></tr></tbody></table></section></section><section><h3>Annotation Properties</h3><section id="versionInfo"><h4>versionInfo</h4><p>IRI: <code>https://www.w3.org/2019/wot/tm#versionInfo</code></p><span>Provides version information of the TM ontology.</span><table class="def numbered"><tbody></tbody></table></section></section></section>
</body>
</html>