Skip to content

Commit

Permalink
Update clause_07b_sensing_entities.adoc
Browse files Browse the repository at this point in the history
  • Loading branch information
humaidkidwai authored Feb 23, 2024
1 parent 9c70bae commit b1de6f1
Showing 1 changed file with 24 additions and 9 deletions.
33 changes: 24 additions & 9 deletions sections/clause_07b_sensing_entities.adoc
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
[[sensing-entities]]
== The SensorThings API (2.0) Sensing Entities
=== Sensing Entities

All data model requirements classes are grouped in the following requirements class:

[requirements_class]

This comment has been minimized.

Copy link
@humaidkidwai

humaidkidwai Feb 23, 2024

Author Collaborator

@hylkevds not sure why is this rendered as Example 1

.Sensing Entities

====
[%metadata]
identifier:: {identifier}/req-class/datamodel/sensing

This comment has been minimized.

Copy link
@humaidkidwai

humaidkidwai Feb 23, 2024

Author Collaborator

@hylkevds what should be the placeholder for identifier?

This comment has been minimized.

Copy link
@hylkevds

hylkevds Feb 23, 2024

Contributor

{identifier} is the placeholder for the document URI. It will be automatically replaced by metanorma when the document is built.

This comment has been minimized.

Copy link
@humaidkidwai

humaidkidwai Feb 23, 2024

Author Collaborator

I believe that would be the replaced inside the curly braces only? What about the "identifier::" key?

This comment has been minimized.

Copy link
@hylkevds

hylkevds Feb 24, 2024

Contributor

I don't understand the question.

obligation:: requirement

subject:: Target Type: Data Model
requirement:: {identifier}/req-class/datamodel/sensing/thing
requirement:: {identifier}/req-class/datamodel/sensing/location
Expand All @@ -17,9 +19,9 @@ requirement:: {identifier}/req-class/datamodel/sensing/sensor
requirement:: {identifier}/req-class/datamodel/sensing/observed-property
requirement:: {identifier}/req-class/datamodel/sensing/observation
requirement:: {identifier}/req-class/datamodel/sensing/feature
====


=== Sensing Entities
The OGC SensorThings API (2.0) standard depicts the Core Sensing entities in Figure 1
[#img-sta-core,link=../images/GRP0001.png]
image::../images/GRP0001.png[Sensing Core]
Expand All @@ -29,11 +31,10 @@ image::../images/GRP0001.png[Sensing Core]

In this section, we define each entity depicted in Figure 1 and its relationships with other entities. Additionally, we also provide examples to model the entities in different contexts.

[requirements_class]

==== Thing
==== Requirement Class: Thing

Requirements Class
[requirements_class]
.Thing

====
[%metadata]
Expand All @@ -45,14 +46,29 @@ requirement:: {identifier}/req/datamodel/sensing/thing/relations
====

The SensorThings API follows the ITU-T definition, i.e., with regard to the Internet of Things, a thing is an object of the physical world (physical things) or the information world (virtual things) that is capable of being identified and integrated into communication networks [ITU-T Y.2060].

[example%unnumbered]
====
*Thing Examples*
- A weather forecasting facility that houses multiple weather sensors deployed across several sites
- A drone that mounts a LiDAR sensor for mapping purposes
- An upstream oil well that is equipped with compound gas detection devices
====

[additional-notes]
====
*NOTE*: The Thing entity draws from the Host interface from the Conceptual Observation Schema in OMS
====

[requirement]
====
[%metadata]
identifier:: {identifier}/req/datamodel/sensing/thing/properties
Each Thing entity SHALL have the mandatory properties and MAY have the optional properties listed in Table 1.
====

[#thing-properties,reftext='{table-caption} {counter:table-num}']
.Properties of a Thing entity
[width="100%",cols="5,17,3,3,3",options="header"]
Expand All @@ -68,7 +84,6 @@ Each Thing entity SHALL have the mandatory properties and MAY have the optional
====
[%metadata]
identifier:: {identifier}/req/datamodel/sensing/thing/relations
Each Thing entity SHALL have the direct relation between a Thing entity and other entity types listed in Table 2.
====

Expand Down

3 comments on commit b1de6f1

@humaidkidwai
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hylkevds can you have a look at this?

@hylkevds
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently it doesn't build at all:

Images: (ID img-sta-core): Image not found: ../images/GRP0001.png

Images are relative to the base document file, not to the section files.

Fixing that, the document looks fine to me.

@humaidkidwai
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll fix that

Please sign in to comment.