fix(ontology): fix semantic bugs in hdmap/scenario OpenLABEL v1 integration (#72)

The hdmap and scenario domains had several modelling bugs exposed during
SHACL validation with the corrected context generator:

- scenario:Scenario used rdfs:subClassOf openlabel:Scenario, causing every
  Scenario instance to be inferred as an RDF class under RDFS entailment;
  replaced with rdfs:seeAlso
- ContentOrTag union was too narrow (only openlabel:Tag); renamed to
  ContentOrDynamicAnnotation with proper ODD members (OddEnvironment,
  OddDynamicElements, Behaviour, RoadUser)
- hdmap SHACL used generic OddShape with ill-formed sh:node xsd:boolean
  (violates SHACL §4.7.1); replaced with specific OddSceneryShape
- Missing owl:imports for openlabel in both hdmap.owl.ttl and scenario.owl.ttl

Also:
- Add OddSceneryShape, OddEnvironmentShape, OddDynamicElementsShape to
  openlabel.shacl.ttl for granular ODD validation in domain union shapes
- Add Safety Pool DB v1.6 scenario tagging ontology import
- Update test data to use bare enum values and openlabel: prefix for @type
- Retain openlabel prefix in existing invalid tests for prefix-style coverage
- Add flat-context invalid tests (no explicit prefix) for both scenario
  (wrong enum value) and hdmap (false boolean with value present)

Signed-off-by: Carlo van Driesten <carlo.van-driesten@bmw.de>

Author: jdsika

artifacts/hdmap/hdmap.context.jsonld

@@ -16,6 +16,7 @@
       "skos": "http://www.w3.org/2004/02/skos/core#",
       "schema": "https://schema.org/",
       "hdmap": "https://w3id.org/ascs-ev/envited-x/hdmap/v6/",
+      "openlabel": "https://openlabel.asam.net/V1-0-0/ontologies/",
       "envited-x": "https://w3id.org/ascs-ev/envited-x/envited-x/v3/",
       "georeference": "https://w3id.org/ascs-ev/envited-x/georeference/v5/",
       "accuracyLaneModel2d": {

artifacts/hdmap/hdmap.owl.ttl

@@ -46,7 +46,8 @@
 
     # Imports strict dependencies
     owl:imports <https://w3id.org/ascs-ev/envited-x/envited-x/v3> ,
-                <https://w3id.org/ascs-ev/envited-x/georeference/v5> ;
+                <https://w3id.org/ascs-ev/envited-x/georeference/v5> ,
+                <https://openlabel.asam.net/V1-0-0/ontologies> ;
 
     # Reference to SHACL validation rules
     dcterms:conformsTo <https://w3id.org/ascs-ev/envited-x/hdmap/v6/shapes> ;

artifacts/hdmap/hdmap.shacl.ttl

@@ -209,10 +209,9 @@ hdmap:ContentOrOddSceneryShape a sh:NodeShape ;
     sh:description "HDMap Content or OpenLABEL ODD Scenery Union Shape"@en ;
     sh:or (
         [ sh:node hdmap:ContentShape ]
-        [ sh:node openlabel:OddShape ] # Validates against the external OpenLABEL shape
-        [ sh:node xsd:boolean ]
+        [ sh:node openlabel:OddSceneryShape ]
     ) ;
-    sh:message "Each item of hasContent must conform to either Scenario Content or OpenLABEL Tag."@en .
+    sh:message "Each item of hasContent must conform to either HDMap Content or OpenLABEL OddScenery."@en .
 
 hdmap:ContentShape a sh:NodeShape ;
     sh:closed false ;

artifacts/openlabel/openlabel.shacl.ttl

@@ -446,6 +446,30 @@ openlabel:BehaviourShape a sh:NodeShape ;
 # ODD Shape
 ##############################################################################
 
+##############################################################################
+# ODD Sub-Shapes (for use in domain union shapes)
+# Property validation is inherited from OddShape via rdfs:subClassOf inference.
+##############################################################################
+
+openlabel:OddSceneryShape a sh:NodeShape ;
+    sh:targetClass openlabel:OddScenery ;
+    sh:closed false ;
+    sh:description "Shape for ODD Scenery data (BSI PAS-1883 §5.2: road geometry, lane specs, signs, junctions, structures)."@en .
+
+openlabel:OddEnvironmentShape a sh:NodeShape ;
+    sh:targetClass openlabel:OddEnvironment ;
+    sh:closed false ;
+    sh:description "Shape for ODD Environment data (BSI PAS-1883 §5.3: weather, illumination, connectivity, particulates)."@en .
+
+openlabel:OddDynamicElementsShape a sh:NodeShape ;
+    sh:targetClass openlabel:OddDynamicElements ;
+    sh:closed false ;
+    sh:description "Shape for ODD Dynamic Elements data (BSI PAS-1883 §5.4: traffic density, flow, subject vehicle speed)."@en .
+
+##############################################################################
+# ODD Shape (flat, validates all Odd properties)
+##############################################################################
+
 openlabel:OddShape a sh:NodeShape ;
     sh:targetClass openlabel:Odd ;
     sh:property

artifacts/scenario/PROPERTIES.md

@@ -11,7 +11,7 @@ class Class_definition_for_Format
 class Class_definition_for_Quality
 class Class_definition_for_Quantity
 class Class_definition_for_Scenario
-class Content_or_OpenLabel_Tag
+class Content_or_OpenLABEL_Dynamic_Annotation
 ```
 
 ### Class Hierarchy
@@ -23,7 +23,7 @@ class Content_or_OpenLabel_Tag
 - Class definition for Quality (https://w3id.org/ascs-ev/envited-x/scenario/v6/Quality)
 - Class definition for Quantity (https://w3id.org/ascs-ev/envited-x/scenario/v6/Quantity)
 - Class definition for Scenario (https://w3id.org/ascs-ev/envited-x/scenario/v6/Scenario)
-- Content or OpenLabel Tag (https://w3id.org/ascs-ev/envited-x/scenario/v6/ContentOrTag)
+- Content or OpenLABEL Dynamic Annotation (https://w3id.org/ascs-ev/envited-x/scenario/v6/ContentOrDynamicAnnotation)
 
 ### Class Definitions
 
@@ -35,8 +35,8 @@ class Content_or_OpenLabel_Tag
 |Class definition for Format|https://w3id.org/ascs-ev/envited-x/scenario/v6/Format|Contains properties that describe the format of the scenario asset.|Format|
 |Class definition for Quality|https://w3id.org/ascs-ev/envited-x/scenario/v6/Quality|Contains properties that describe the accuracy of objects and the calibration of the scenario asset.|Quality|
 |Class definition for Quantity|https://w3id.org/ascs-ev/envited-x/scenario/v6/Quantity|Contains properties that describe the quantity of the scenario asset (e.g., number of traffic objects, controllers).|Quantity|
-|Class definition for Scenario|https://w3id.org/ascs-ev/envited-x/scenario/v6/Scenario|General properties for defining a scenario asset, including format, content, data sources, quantity, and quality attributes.|Scenario, SimulationAsset|
-|Content or OpenLabel Tag|https://w3id.org/ascs-ev/envited-x/scenario/v6/ContentOrTag|Combines Scenario content with OpenLABEL's Tag.||
+|Class definition for Scenario|https://w3id.org/ascs-ev/envited-x/scenario/v6/Scenario|General properties for defining a scenario asset, including format, content, data sources, quantity, and quality attributes.|SimulationAsset|
+|Content or OpenLABEL Dynamic Annotation|https://w3id.org/ascs-ev/envited-x/scenario/v6/ContentOrDynamicAnnotation|Combines Scenario content with OpenLABEL's dynamic annotation types: OddEnvironment, OddDynamicElements, Behaviour, and RoadUser.||
 
 ## Prefixes
 

artifacts/scenario/scenario.context.jsonld

@@ -16,6 +16,7 @@
       "skos": "http://www.w3.org/2004/02/skos/core#",
       "schema": "https://schema.org/",
       "scenario": "https://w3id.org/ascs-ev/envited-x/scenario/v6/",
+      "openlabel": "https://openlabel.asam.net/V1-0-0/ontologies/",
       "envited-x": "https://w3id.org/ascs-ev/envited-x/envited-x/v3/",
       "georeference": "https://w3id.org/ascs-ev/envited-x/georeference/v5/",
       "abstractionLevel": {
@@ -133,7 +134,7 @@
          "@id": "scenario:weatherSummary"
       },
       "Content": "scenario:Content",
-      "ContentOrTag": "scenario:ContentOrTag",
+      "ContentOrDynamicAnnotation": "scenario:ContentOrDynamicAnnotation",
       "DataSource": "scenario:DataSource",
       "DomainSpecification": "scenario:DomainSpecification",
       "Format": "scenario:Format",

artifacts/scenario/scenario.owl.ttl

@@ -53,7 +53,8 @@
 
     # Imports strict dependencies
     owl:imports <https://w3id.org/ascs-ev/envited-x/envited-x/v3> ,
-                <https://w3id.org/ascs-ev/envited-x/georeference/v5> ;
+                <https://w3id.org/ascs-ev/envited-x/georeference/v5> ,
+                <https://openlabel.asam.net/V1-0-0/ontologies> ;
 
     # Reference to SHACL validation rules
     dcterms:conformsTo <https://w3id.org/ascs-ev/envited-x/scenario/v6/shapes> ;
@@ -67,8 +68,8 @@
 scenario:Scenario a owl:Class ;
     rdfs:label "Class definition for Scenario"@en ;
     rdfs:comment "General properties for defining a scenario asset, including format, content, data sources, quantity, and quality attributes."@en ;
-    rdfs:subClassOf envited-x:SimulationAsset ,
-                    openlabel:Scenario ;
+    rdfs:subClassOf envited-x:SimulationAsset ;
+    rdfs:seeAlso openlabel:Scenario ;
     rdfs:subClassOf [
         a owl:Restriction ;
         owl:onProperty scenario:hasDomainSpecification ;
@@ -185,18 +186,19 @@ scenario:hasManifest a owl:ObjectProperty ;
         owl:unionOf ( envited-x:Manifest manifest:Link )
     ] .
 
-# Declare a union class combining scenario:Content and openlabel:Tag
-scenario:ContentOrTag a owl:Class ;
-    rdfs:label "Content or OpenLabel Tag"@en ;
-    rdfs:comment "Combines Scenario content with OpenLABEL's Tag."@en ;
-    owl:unionOf (scenario:Content openlabel:Tag) .
+# Union class for scenario content and OpenLABEL dynamic annotations.
+# Excludes OddScenery (belongs to hdmap) and AdminTag (covered by Gaia-X ResourceDescription).
+scenario:ContentOrDynamicAnnotation a owl:Class ;
+    rdfs:label "Content or OpenLABEL Dynamic Annotation"@en ;
+    rdfs:comment "Combines Scenario content with OpenLABEL's dynamic annotation types: OddEnvironment, OddDynamicElements, Behaviour, and RoadUser."@en ;
+    owl:unionOf (scenario:Content openlabel:OddEnvironment openlabel:OddDynamicElements openlabel:Behaviour openlabel:RoadUser) .
 
 scenario:hasContent a owl:ObjectProperty ;
     rdfs:label "Object property: hasContent"@en ;
     rdfs:comment "Links a DomainSpecification to an instance of scenario:Content that describes the scenario's content."@en ;
     rdfs:subPropertyOf envited-x:hasContent ;
     rdfs:domain scenario:DomainSpecification ;
-    rdfs:range scenario:ContentOrTag .
+    rdfs:range scenario:ContentOrDynamicAnnotation .
 
 scenario:hasDataSource a owl:ObjectProperty ;
     rdfs:label "Object property: hasDataSource"@en ;

artifacts/scenario/scenario.shacl.ttl

@@ -103,7 +103,7 @@ scenario:DomainSpecificationShape a sh:NodeShape ;
     sh:property 
         [ 
           sh:minCount 1 ;
-          sh:node scenario:ContentOrTagShape ;
+          sh:node scenario:ContentOrDynamicAnnotationShape ;
           sh:name "content"@en ;
           sh:description "Attributes describing the content of the scenario."@en ;
           sh:order 1 ;
@@ -156,15 +156,17 @@ scenario:DomainSpecificationShape a sh:NodeShape ;
         ] ;
     sh:targetClass scenario:DomainSpecification .
 
-### New Union Shape for Content
-scenario:ContentOrTagShape a sh:NodeShape ;
-    sh:description "Scenario Content or OpenLABEL Tag Union Shape"@en ;
+### Union Shape for Content or Dynamic Annotations
+scenario:ContentOrDynamicAnnotationShape a sh:NodeShape ;
+    sh:description "Scenario Content or OpenLABEL Dynamic Annotation Union Shape"@en ;
     sh:or (
         [ sh:node scenario:ContentShape ]
-        [ sh:node openlabel:TagShape ]
-        [ sh:node xsd:boolean ]
+        [ sh:node openlabel:OddEnvironmentShape ]
+        [ sh:node openlabel:OddDynamicElementsShape ]
+        [ sh:node openlabel:BehaviourShape ]
+        [ sh:node openlabel:RoadUserShape ]
     ) ;
-    sh:message "Each item of hasContent must conform to either Scenario Content, an OpenLABEL Tag, or a boolean."@en .
+    sh:message "Each item of hasContent must conform to Scenario Content, OddEnvironment, OddDynamicElements, Behaviour, or RoadUser."@en .
 
 ### Detailed Shapes (Expanded based on Instance Data)
 scenario:FormatShape a sh:NodeShape ;

config/ontoenv.toml

@@ -47,6 +47,11 @@ local = "imports/rdf/rdf.owl.ttl"
 uri = "http://www.w3.org/2000/01/rdf-schema#"
 local = "imports/rdfs/rdfs.owl.ttl"
 
+[dependencies.safetypooldb]
+uri = "https://live.safetypooldb.ai/api/ontologies/v1.6/"
+local = "imports/safetypooldb/safetypooldb.owl.ttl"
+description = "Safety Pool DB V1.6 Scenario Tagging Ontology"
+
 [dependencies.schema]
 uri = "https://schema.org/"
 local = "imports/schema/schema.owl.ttl"

imports/catalog-v001.xml

@@ -13,6 +13,7 @@
   <uri name="http://www.w3.org/ns/prov#" uri="prov/prov.owl.ttl"/>
   <uri name="http://www.w3.org/ns/shacl#" uri="sh/sh.owl.ttl"/>
   <uri name="http://xmlns.com/foaf/0.1/" uri="foaf/foaf.owl.ttl"/>
+  <uri name="https://live.safetypooldb.ai/api/ontologies/v1.6/" uri="safetypooldb/safetypooldb.owl.ttl"/>
   <uri name="https://schema.org" uri="schema/schema.context.jsonld"/>
   <uri name="https://schema.org/" uri="schema/schema.owl.ttl"/>
   <uri name="https://w3id.org/security#" uri="sec/sec.owl.ttl"/>