CoSWoT Core Functions and Commands odule

Metadata

URI
https://w3id.org/coswot/core/functions_commands
Contributor (s)
Maxime Lefrançois Orcid logo ( maxime.lefrancois@emse.fr ) of MINES Saint-Étienne
Fatma-Zohra Hannou Orcid logo ( fatma-zohra.hannou@edf.fr ) of EDF R&D
Catherine Roussey Orcid logo ( catherine.roussey@inrae.fr ) of INRAE MISTEA
Imports
https://w3id.org/coswot/core/devices
https://w3id.org/coswot/core/procedures
Ontology RDF
RDF (turtle)

Description

Ce modelet décrit les fonctions que supportent des dispositifs, et qui sont des groupements logiques de commandes.

Table of Contents

  1. Classes
  2. Object Properties
  3. Annotation Properties
  4. Namespaces
  5. Legend

Overview

Ce modelet décrit les commandes comme des fonctionnalités de plus bas niveau que supportent les dispositifs, et leur regroupement logique en fonctions.

Questions de compétence

ID Question en langage naturel Example
q1 Quels sont les fonctions supportées par le capteur F418 ? Observation de température, contrôle de fenêtre, ...
q2 Quelle fonction du capteur F418 contrôle une fenêtre ? contrôle de fenêtre.
q3 Quels sont les commandes obligatoires de la fonction contrôle de fenêtre ? Ouvrir, Fermer, ...
q4 Quels sont les commandes optionnelles de la fonction contrôle de fenêtre ? Ouvrir à un pourcentage, ...
q5 Quels sont les commandes de la fonction contrôle de fenêtre supportées par le dispositif F429 ? Ouvrir, Fermer, Ouvrir à un pourcentage, ...

Références

Les classes proches dans les ontologies de référence sont:

Choix de modélisation

Nous adoptons la façon de modéliser de SAREF, que l'on adapte avec le patron de conception architectural de CoSWoT ( X , XKind , XOfInterest ).

Illustration du module Functions and Commands
Illustration du module functions_commands

Recommandations d'usage

Classes

Concept c # Classes

URI http://www.w3.org/2004/02/skos/core#Concept
Sub-classes Function Kind c
Command Kind c

Command c # Classes

URI https://w3id.org/coswot/Command
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

The lowest-level directives a function exposes to some network. Commands can target (OP coswot:targets and its sub-properties) features, properties, or states. An instance of coswot:CommandKind is independent of any device, while an instance of coswot:CommandOfInterest is specific to a device.

Example(s)
Observe property, control property, observe state, control state, invoke action, cancel action, turn on or off, change color, subscribe, publish, etc. are all commands.

Super-classes coswot:Procedure c
Sub-classes Command Kind c
Command Of Interest c
In domain of is command of op
In range of has command op

Command Execution c # Classes

URI https://w3id.org/coswot/CommandExecution
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Describes the execution of a command. Typically, its inputs and outputs are human understandable and relate to some feature of interest, such as its state (e.g., ex:On), or the value of its temperature (e.g., property value 21.0 °C).

Super-classes coswot:ProcedureExecution c
Restrictions coswot:isExecutionOf only Command c

Command Kind c # Classes

URI https://w3id.org/coswot/CommandKind
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

The lowest-level directives a function exposes to some network. Commands can target (OP coswot:targets and its sub-properties) features, properties, or states. An instance of coswot:CommandKind is independent of any device.

Example(s)
Observe property, control property, observe state, control state, invoke action, cancel action, turn on or off, change color, subscribe, publish, etc. are all commands.

Super-classes Command c
skos:Concept c
Restrictions skos:broader only Command Kind c
coswot:hasKind only owl:Nothing c
skos:narrower only Command Kind c
In domain of is command kind of op
In range of has optional command op
has mandatory command op
has command kind op

Command Of Interest c # Classes

URI https://w3id.org/coswot/CommandOfInterest
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

The lowest-level directives a device supports and exposes to some network. Commands can target (OP coswot:targets and its sub-properties) features, properties, or states. A coswot:CommandOfInterest is a directives actually supported by a device and exposed to some network.

Example(s)
The smart fridge supports a command of kind “observe temperature”, which observes the temperature of the fridge.

The corridor smart light switch supports a command of kind “turn on/off”, which controls the state of the outdoor light.

Super-classes Command c
Restrictions is command of interest of op exactly 1
coswot:hasKind some Command Kind c
coswot:hasKind only Command Kind c
In domain of is command of interest of op
In range of has command of interest op

Function c # Classes

URI https://w3id.org/coswot/Function
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Logical groups of commands that devices support to accomplish their tasks. Function can target (OP coswot:targets and its sub-properties) features, properties, or states. While an instance of coswot:FunctionKind can apply to different devices, an instance of coswot:FunctionOfInterest is specific to a device.

Super-classes coswot:ProcedureCollection c
Sub-classes Function Kind c
Function of Interest c
In domain of is function of op
has command kind op
has command op
In range of is command kind of op
is command of op
has function op

Function Kind c # Classes

URI https://w3id.org/coswot/FunctionKind
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Logical groups of commands that devices support to accomplish their tasks. Function kinds can target (OP coswot:targets and its sub-properties) feature kinds, property kinds, or state kinds. An instance of coswot:FunctionKind can apply to different devices.

Super-classes Function c
skos:Concept c
Restrictions coswot:hasKind only owl:Nothing c
has command op only Command Kind c
skos:narrower only Function Kind c
skos:broader only Function Kind c
In domain of has optional command op
has mandatory command op
is function kind of op
In range of has function kind op

Function of Interest c # Classes

URI https://w3id.org/coswot/FunctionOfInterest
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Logical groups of commands that devices support to accomplish their tasks. Function can target (OP coswot:targets and its sub-properties) features, properties, or states. An instance of coswot:FunctionOfInterest is supported by exactly one device.

Super-classes Function c
Restrictions coswot:hasKind only Function Kind c
is function of interest of op exactly 1
coswot:hasKind some Function Kind c
In domain of is function of interest of op
has command of interest op
In range of has function of interest op
is command of interest of op

Object Properties

has command op # OPs

URI https://w3id.org/coswot/hasCommand
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function to one of the commands it supports.

Inverse properties is command of op
Domain(s) Function c
Range(s) coswot:Command c

has command kind op # OPs

URI https://w3id.org/coswot/hasCommandKind
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function to one of its command kinds.

Super-properties has command op
Inverse properties is command kind of op
Domain(s) Function c
Range(s) coswot:CommandKind c

has command of interest op # OPs

URI https://w3id.org/coswot/hasCommandOfInterest
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function of interest to one of its commands of interest.

Super-properties has command op
Inverse properties is command of interest of op
Domain(s) Function of Interest c
Range(s) coswot:CommandOfInterest c

has function op # OPs

URI https://w3id.org/coswot/hasFunction
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a device to one of its functions.

Inverse properties is function of op
Domain(s) coswot:Device c
Range(s) coswot:Function c

has function kind op # OPs

URI https://w3id.org/coswot/hasFunctionKind
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a device to one of its function kinds.

Super-properties has function op
Inverse properties is function kind of op
Domain(s) coswot:Device c
Range(s) coswot:FunctionKind c

has function of interest op # OPs

URI https://w3id.org/coswot/hasFunctionOfInterest
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a device of interest to one of its functions of interest.

Super-properties has function op
Inverse properties is function of interest of op
Domain(s) coswot:DeviceOfInterest c
Range(s) coswot:FunctionOfInterest c

has mandatory command op # OPs

URI https://w3id.org/coswot/hasMandatoryCommand
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function and one of its mandatory commands

Super-properties has command kind op
Domain(s) Function Kind c
Range(s) coswot:CommandKind c

has optional command op # OPs

URI https://w3id.org/coswot/hasOptionalCommand
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function and one of its optional commands

Super-properties has command kind op
Domain(s) Function Kind c
Range(s) coswot:CommandKind c

is command kind of op # OPs

URI https://w3id.org/coswot/isCommandKindOf
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a command kind to the function it is a command of.

Super-properties is command of op
Inverse properties has command kind op
Domain(s) Command Kind c
Range(s) coswot:Function c

is command of op # OPs

URI https://w3id.org/coswot/isCommandOf
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a command to a function that supports it.

Inverse properties has command op
Domain(s) Command c
Range(s) coswot:Function c

is command of interest of op # OPs

URI https://w3id.org/coswot/isCommandOfInterestOf
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a command of interest to the function of interest it is a command of.

Super-properties is command of op
Inverse properties has command of interest op
Domain(s) Command Of Interest c
Range(s) coswot:FunctionOfInterest c

is function kind of op # OPs

URI https://w3id.org/coswot/isFunctionKindOf
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function kind to the device it is a function of.

Super-properties is function of op
Inverse properties has function kind op
Domain(s) Function Kind c
Range(s) coswot:Device c

is function of op # OPs

URI https://w3id.org/coswot/isFunctionOf
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function to the device it is a function of.

Inverse properties has function op
Domain(s) Function c
Range(s) coswot:Device c

is function of interest of op # OPs

URI https://w3id.org/coswot/isFunctionOfInterestOf
Is Defined By https://w3id.org/coswot/core/functions_commands
Description

Links a function of interest to the device of interest it is a function of.

Super-properties is function of op
Inverse properties has function of interest op
Domain(s) Function of Interest c
Range(s) coswot:DeviceOfInterest c

Annotation Properties

license ap # APs

URI http://creativecommons.org/ns#license

contributor ap # APs

URI http://purl.org/dc/terms/contributor

description ap # APs

URI http://purl.org/dc/terms/description

issued ap # APs

URI http://purl.org/dc/terms/issued

modified ap # APs

URI http://purl.org/dc/terms/modified

title ap # APs

URI http://purl.org/dc/terms/title

preferredNamespacePrefix ap # APs

URI http://purl.org/vocab/vann/preferredNamespacePrefix

preferredNamespaceUri ap # APs

URI http://purl.org/vocab/vann/preferredNamespaceUri

example ap # APs

URI http://www.w3.org/2004/02/skos/core#example

note ap # APs

URI http://www.w3.org/2004/02/skos/core#note

Namespaces

default (coswot)
https://w3id.org/coswot/
cc
http://creativecommons.org/ns#
dct
http://purl.org/dc/terms/
owl
http://www.w3.org/2002/07/owl#
prov
http://www.w3.org/ns/prov#
rdf
http://www.w3.org/1999/02/22-rdf-syntax-ns#
rdfs
http://www.w3.org/2000/01/rdf-schema#
sdo
http://schema.org/
skos
http://www.w3.org/2004/02/skos/core#
vann
http://purl.org/vocab/vann/
xsd
http://www.w3.org/2001/XMLSchema#

Legend

c Classes
op Object Properties
fp Functional Properties
dp Data Properties
dp Annotation Properties
p Properties
ni Named Individuals