Skip to content

Commit

Permalink
[SWECommon] Updated conformance section
Browse files Browse the repository at this point in the history
  • Loading branch information
alexrobin committed Jun 26, 2024
1 parent 297da54 commit 593fd4c
Show file tree
Hide file tree
Showing 3 changed files with 47 additions and 26 deletions.
2 changes: 1 addition & 1 deletion swecommon/standard/sections/annex-history.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,5 @@
| 2023-03-16 | 2.1 draft | Alexandre Robin | Clause 7,8,9 | Added Geometry class
| 2023-03-21 | 2.1 draft | Alexandre Robin | Clause 9 | Added JSON datastream encoding rules
| 2023-03-21 | 2.1 draft | Alexandre Robin | Clause 9 | Clarified use of media types
| 2024-04-29 | 3.0 draft | Alexandre Robin | All | Refactored to v3.0, removed XML encoding sections
| 2024-04-29 | 3.0 draft | Alexandre Robin | All | Refactored to v3.0, added JSON encoding, removed XML encoding sections
|===
4 changes: 2 additions & 2 deletions swecommon/standard/sections/clause_0_front_material.adoc
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
.Preface

The OGC SWE Common Data Model Encoding Standard is the result of worked done by the Connected Systems Working Group of the OGC, with the aim of modernizing the Sensor Wen Enablement (SWE) suite of Standards.
The OGC SWE Common Data Model Encoding Standard is the result of worked done by the Connected Systems Working Group of the OGC, with the aim of modernizing the Sensor Web Enablement (SWE) suite of Standards.

To increase the brevity and readability of this Standard, many OGC document titles are shortened and/or abbreviated. Therefore, in the context of this document, the following phrases are defined:

- “this Standard” shall be interpreted as equivalent to “OGC SWE Common Data Model Encoding Standard”.
- “SensorML” or “SensorML Standard” shall be interpreted as equivalent to “OGC Sensor Modeling Language Encoding Standard”
- “SensorML” or “SensorML Standard” shall be interpreted as equivalent to “OGC SensorML Encoding Standard”
[abstract]
Expand Down
67 changes: 44 additions & 23 deletions swecommon/standard/sections/clause_2_conformance.adoc
Original file line number Diff line number Diff line change
@@ -1,25 +1,46 @@
== Conformance

This standard has been written to be compliant with the OGC Specification Model – A Standard for Modular Specification (OGC 08-131r3). Extensions of this standard shall themselves be conformant to the OGC Specification Model.

Conformance with this specification shall be checked using all the relevant tests specified in Annex A. The framework, concepts, and methodology for testing, and the criteria to be achieved to claim conformance are specified in ISO 19105: Geographic information — Conformance and Testing. In order to conform to this OGC™ encoding standard, a standardization target shall implement the core conformance class, and choose to implement any one of the other conformance classes.

Additionally, it is highly recommended that JSON based implementations of the conceptual models do implement requirement classes from clause 8 and clause 9 of this standard, respectively, and pass the corresponding conformance classes instead of defining new encodings.

#TODO#

This standard defines XXXX.

Requirements for N standardization target types are considered:

* AAAA
* BBBB
Conformance with this standard shall be checked using all the relevant tests specified in Annex A (normative) of this document. The framework, concepts, and methodology for testing, and the criteria to be achieved to claim conformance are specified in the OGC Compliance Testing Policies and Procedures and the OGC Compliance Testing web site.

In order to conform to this OGC® interface standard, a software implementation shall choose to implement:

* Any one of the conformance levels specified in Annex A (normative).
* Any one of the Distributed Computing Platform profiles specified in Annexes TBD through TBD (normative).
All requirements-classes and conformance-classes described in this document are owned by the standard(s) identified.
This Standard was written to be compliant with the OGC Specification Model – A Standard for Modular Specification (OGC 08-131r3). Extensions of this Standard shall themselves be conformant to the OGC Specification Model.

This Standard defines the following requirements classes and standardization targets:

[#datastream-attributes,reftext='{table-caption} {counter:table-num}']
.Requirements Classes
[width="100%",cols="2,1",options="header"]
|====
| *Requirements Class* | *Standardization Target*
| *Core* .2+| Derived Models and Software Implementations
| <<core_concepts,style=full%>>
| *UML Models* .8+| Software Implementation or Encoding of the Conceptual Models
| <<uml_simple_components,style=full%>>
| <<uml_record_components,style=full%>>
| <<uml_choice_components,style=full%>>
| <<uml_block_components,style=full%>>
| <<uml_geom_components,style=full%>>
| <<uml_simple_encodings,style=full%>>
| <<uml_advanced_encodings,style=full%>>
| *JSON Encodings* .8+| JSON Document
| <<json_simple_components,style=full%>>
| <<json_record_components,style=full%>>
| <<json_choice_components,style=full%>>
| <<json_block_components,style=full%>>
| <<json_geom_components,style=full%>>
| <<json_simple_encodings,style=full%>>
| <<json_advanced_encodings,style=full%>>
| *Datastream Encoding Rules* .4+| Encoded Values Instance
| <<encoding_rules_text,style=full%>>
| <<encoding_rules_binary,style=full%>>
| <<encoding_rules_json,style=full%>>
|====

Different types of implementations can seek conformance with this OGC® Standard:

* An implementation that defines a new data model shall at least conform with the core requirements class.
* An encoding of the conceptual models (e.g. a protobuf encoding) shall implement at least one of the requirements classes listed in the "UML Models" section of the table.
* An implementation that produces or consumes SWE Common data components encoded in JSON shall implement at least one of the requirements classes listed in the "JSON Encodings" section of the table.
* An implementation that produces or consumes datastreams encoded according to a schema defined using SWE Common components shall implement at least one of the requirements classes listed in the "Datastream Encoding Rules" section of the table.
The conformance classes corresponding to these requirements classes are presented in <<annex_ats,Annex A (normative)>>. Conformance with this Standard shall be checked using all the relevant tests specified in Annex A. The framework, concepts, and methodology for testing, and the criteria to be achieved to claim conformance are specified in the OGC Compliance Testing Policies and Procedures and the OGC Compliance Testing web site.

0 comments on commit 593fd4c

Please sign in to comment.