Web of Things (WoT) Thing Model (TM) Ontology

W3C Editor's Draft

More details about this document
This version:
https://www.w3.org/2019/wot/td
Latest published version:
none
Latest editor's draft:
https://www.w3.org/2019/wot/td
Editors:
Mahda Noura (Siemens AG)
Sebastian Käbisch (Siemens AG)
Ontology in RDF
Download
Open

Abstract

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.

Status of This Document

This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.

This document was published by the Web of Things Working Group as an Editor's Draft.

Publication as an Editor's Draft does not imply endorsement by W3C and its Members.

This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.

This document was produced by a group operating under the W3C Patent Policy. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.

This document is governed by the 03 November 2023 W3C Process Document.

1. Introduction

The TM ontology is an idiomatic RDF axiomatization of the TM concepts , which can be used as a template for instantiating Thing Descriptions (TD)s. The TM ontology imports the TD ontology.

Please note that the Turtle version of the ontology can be always obtained by doing content negotiation as explained in Appendix D of the Thing Description Recommendation. You can include Accept: text/turtle in the request to obtain the Turtle version of this ontology.

2. Conformance

As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.

The key word MUST in this document is to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.

3. Terminology

The fundamental WoT terminology such as Thing, Consumer, Thing Description (TD), Interaction Model, Interaction Affordance, Property, Action, Event, Protocol Binding, Servient, etc. is defined in Section 3 of the WoT Architecture specification [WOT-ARCHITECTURE].

The Thing Description terminology such as TD Information Model, TD Document, Term (Vocabulary Term), etc. is defined in Section 3 of the WoT Thing Description specification [WOT-THING-DESCRIPTION].

4. Axiomatization

4.1 Classes

4.1.1 ThingModel

IRI: https://www.w3.org/2019/wot/tm#ThingModel

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.
In the domain of td:description
td:hasLink
td:title
tm:hasVersion
tm:optional
tm:required

4.1.2 Version

IRI: https://www.w3.org/2019/wot/tm#Version

The Version is a container that provides versioning information for the Thing Model definition.
In the domain of tm:model
In the range of tm:hasVersion

4.2 Object Properties

4.2.1 hasVersion

IRI: https://www.w3.org/2019/wot/tm#hasVersion

Provides the relation between a Thing Model and its version.
Domain includes tm:ThingModel
Range includes tm:Version

4.3 Datatype Properties

4.3.1 model

IRI: https://www.w3.org/2019/wot/tm#model

Provides a version indicator of the underlying TM.
Domain includes tm:Version
Range includes schema:Text

4.3.2 optional

IRI: https://www.w3.org/2019/wot/tm#optional

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.
Domain includes tm:ThingModel
Range includes schema:Text

4.3.3 ref

IRI: https://www.w3.org/2019/wot/tm#ref

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.
Domain includes td:InteractionAffordance
Range includes schema:Text

4.3.4 required

IRI: https://www.w3.org/2019/wot/tm#required

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].
Domain includes tm:ThingModel
Range includes schema:Text

4.4 Annotation Properties

4.4.1 versionInfo

IRI: https://www.w3.org/2019/wot/tm#versionInfo

Provides version information of the TM ontology.

A. References

A.1 Normative references

[RFC2119]
Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
[RFC8174]
Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174
[WOT-ARCHITECTURE]
Web of Things (WoT) Architecture. Matthias Kovatsch; Ryuichi Matsukura; Michael Lagally; Toru Kawaguchi; Kunihiko Toumura; Kazuo Kajimoto. W3C. 9 April 2020. W3C Recommendation. URL: https://www.w3.org/TR/wot-architecture/
[WOT-THING-DESCRIPTION]
Web of Things (WoT) Thing Description. Sebastian Käbisch; Takuki Kamiya; Michael McCool; Victor Charpenay; Matthias Kovatsch. W3C. 9 April 2020. W3C Recommendation. URL: https://www.w3.org/TR/wot-thing-description/