ositrace.shacl.ttl

@prefix ositrace: <https://w3id.org/ascs-ev/envited-x/ositrace/v5/> .
@prefix envited-x: <https://w3id.org/ascs-ev/envited-x/envited-x/v3/> .
@prefix manifest: <https://w3id.org/ascs-ev/envited-x/manifest/v5/> .
@prefix georeference: <https://w3id.org/ascs-ev/envited-x/georeference/v5/> .
@prefix sh: <http://www.w3.org/ns/shacl#> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .

# The Shapes Graph URI appends "/shapes" to the Ontology URI
<https://w3id.org/ascs-ev/envited-x/ositrace/v5/shapes>
    a owl:Ontology ;
    # The Shapes Graph must import the Domain Ontology
    owl:imports <https://w3id.org/ascs-ev/envited-x/ositrace/v5> .

### OSITrace SHACL Shape
ositrace:OSITraceShape a sh:NodeShape ;
    sh:closed false ;
    
    # 1) hasResourceDescription: Aligning with the flexible logic in envited-x:SimulationAssetShape
    sh:property [
        sh:path ositrace:hasResourceDescription ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        sh:or (
            [ sh:node envited-x:ResourceDescriptionShape ]
            [ sh:and ( manifest:LinkShape envited-x:ExtendedLinkShape ) ]
        ) ;
        sh:message "Each OSI trace must have exactly one associated ResourceDescription (either inline conforming to envited-x:ResourceDescriptionShape or a valid manifest:Link)."@en ;
        sh:order 2 ;
    ],

    # 2) hasDomainSpecification: Mandatory domain-specific extension for OSI traces.
    [
        sh:path ositrace:hasDomainSpecification ;
        sh:node ositrace:DomainSpecificationShape ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        sh:message "Each OSI trace must have one associated DomainSpecification object with content, format, quality, quantity, and dataSource."@en ;
        sh:order 1 ;
    ],

    # 3) hasManifest: Updated to reuse the ManifestLinkReferenceShape for linked manifests.
    [
        sh:path ositrace:hasManifest ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        sh:or (
            # Case 1: Inline manifest node
            [ sh:and ( manifest:ManifestShape envited-x:ManifestShape ) ]
            
            # Case 2: Linked manifest reference (improved logic from Point A)
            [ sh:node envited-x:ManifestLinkReferenceShape ]
        ) ;
        sh:message "Each OSI trace must have exactly one manifest. If linked, it must be a valid envited-x link specifically of category envited-x:isManifest and include a manifest:iri."@en ;
        sh:order 3 ;
    ] ;
    sh:targetClass ositrace:OSITrace .

### DomainSpecification SHACL Shape
ositrace:DomainSpecificationShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property 
        [ sh:maxCount 1 ;
          sh:minCount 1 ;
          sh:node ositrace:ContentShape ;
          sh:name "content"@en ;
          sh:description "Attributes describing the content of the OSI trace."@en ;
          sh:order 1 ;
          sh:path ositrace:hasContent ],
        [ sh:maxCount 1 ;
          sh:minCount 1 ;
          sh:node ositrace:FormatShape ;
          sh:name "format"@en ;
          sh:description "File format details of the OSI trace."@en ;
          sh:order 2 ;
          sh:path ositrace:hasFormat ],
        [ sh:maxCount 1 ;
          sh:minCount 1 ;
          sh:node ositrace:QualityShape ;
          sh:name "quality"@en ;
          sh:description "Quality metrics of the OSI trace."@en ;
          sh:order 3 ;
          sh:path ositrace:hasQuality ],
        [ sh:maxCount 1 ;
          sh:minCount 1 ;
          sh:node ositrace:QuantityShape ;
          sh:name "quantity"@en ;
          sh:description "Quantitative metrics describing the OSI trace."@en ;
          sh:order 4 ;
          sh:path ositrace:hasQuantity ],
        [ sh:maxCount 1 ;
          sh:minCount 1 ;
          sh:node ositrace:DataSourceShape ;
          sh:name "data source"@en ;
          sh:description "Data sources used to create the OSI trace."@en ;
          sh:order 5 ;
          sh:path ositrace:hasDataSource ],
        [ sh:maxCount 1 ;
          sh:node georeference:GeoreferenceShape ;
          sh:name "georeference"@en ;
          sh:description "Georeferencing information for the OSI trace."@en ;
          sh:order 6 ;
          sh:path ositrace:hasGeoreference ] ;
    sh:targetClass ositrace:DomainSpecification .

ositrace:ContentShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [ skos:example "[motorway, rural]" ;
            sh:description "Covered/used road types, defined over ODR element t_road_type, see ODR spec section 8.3"@en ;
            sh:in ("bicycle" "lowSpeed" "motorway" "pedestrian" "rural" "townArterial" "townCollector" "townExpressway" "townLocal" "townPlayStreet" "townPrivate" "town" "unknown") ;
            sh:message "Validation of roadTypes failed!"@en ;
            sh:name "road types"@en ;
            sh:order 0 ;
            sh:path ositrace:roadTypes ],
        [ skos:example "shoulder, curb, ..." ;
            sh:description "Covered lane types, see ODR spec section 9.5.3."@en ;
            sh:in ("biking" "border" "connectingRamp" "curb" "driving" "entry" "exit" "median" "none" "offRamp" "onRamp" "parking" "restricted" "shoulder" "slipLane" "stop" "walking") ;
            sh:message "Validation of laneTypes failed!"@en ;
            sh:name "lane types"@en ;
            sh:order 1 ;
            sh:path ositrace:laneTypes ],
        [ skos:example "trees, street lamps, road patches..." ;
            sh:description "Covered object classes, see ODR spec section 11"@en ;
            sh:in ("barrier" "bike" "building" "bus" "car" "crosswalk" "gantry" "motorbike") ;
            sh:message "Validation of levelOfDetail failed!"@en ;
            sh:name "level of detail"@en ;
            sh:order 2 ;
            sh:path ositrace:levelOfDetail ], 
        [ skos:example "right-hand traffic"@en ;
            sh:description "Traffic direction, i.e. right-hand or left-hand traffic"@en ;
            sh:in ("left-hand" "right-hand") ;
            sh:maxCount 1 ;
            sh:message "Validation of trafficDirection failed!"@en ;
            sh:name "traffic direction"@en ;
            sh:order 3 ;
            sh:path ositrace:trafficDirection ],
        [ skos:example "object list, detection list"@en ;
            sh:description "Level of granularity of sensor data"@en ;
            sh:in ("object list" "detection list") ;
            sh:message "Validation of granularity failed!"@en ;
            sh:minCount 1 ;
            sh:name "granularity"@en ;
            sh:order 4 ;
            sh:path ositrace:granularity ],
        [ skos:example "119" ;
            sh:datatype xsd:string ;
            sh:description "Identifier of scenario performed in the trace file"@en ;
            sh:message "Validation of scenarioIdentifier failed!"@en ;
            sh:name "scenario identifier"@en ;
            sh:order 5 ;
            sh:path ositrace:scenarioIdentifier ],
        [ skos:example "2024-05-11T13:20:03.250320Z" ;
            sh:datatype xsd:dateTime ;
            sh:pattern ".*(Z|[+-]\\d{2}:\\d{2})$" ;
            sh:message "Value must be a valid timestamp with a timezone (ending in 'Z' or '+/-HH:MM')."@en ;
            sh:description "Exact start timestamp of the recorded trace"@en ;
            sh:maxCount 1 ;
            sh:message "Validation of startTime failed!"@en ;
            sh:minCount 1 ;
            sh:name "start time"@en ;
            sh:order 6 ;
            sh:path ositrace:startTime ],
        [ skos:example "2024-05-11T13:20:05.250120Z" ;
            sh:datatype xsd:dateTime ;
            sh:pattern ".*(Z|[+-]\\d{2}:\\d{2})$" ;
            sh:message "Value must be a valid timestamp with a timezone (ending in 'Z' or '+/-HH:MM')."@en ;
            sh:description "Exact stop timestamp of the recorded trace"@en ;
            sh:maxCount 1 ;
            sh:message "Validation of stopTime failed!"@en ;
            sh:minCount 1 ;
            sh:name "stop time"@en ;
            sh:order 7 ;
            sh:path ositrace:stopTime ],
        [ sh:description "Host moving object in trace file"@en ;
            sh:maxCount 1 ;
            sh:minCount 1 ;
            sh:name "host moving object"@en ;
            sh:node ositrace:MovingObjectShape ;
            sh:order 8 ;
            sh:path ositrace:hasHostMovingObject ],
        [ sh:description "Target moving object(s) in trace file"@en ;
            sh:name "target moving object(s)"@en ;
            sh:node ositrace:MovingObjectShape ;
            sh:order 9 ;
            sh:path ositrace:hasTargetMovingObject ],
        [ sh:description "Description of events of interest in trace file"@en ;
            sh:minCount 0 ;
            sh:name "events"@en ;
            sh:node ositrace:EventShape ;
            sh:order 10 ;
            sh:path ositrace:hasEvent ] ;
    sh:targetClass ositrace:Content .

ositrace:DataSourceShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [ skos:example "PMSF DroneTracker; ARS 548 Sensor Output" ;
            sh:datatype xsd:string ;
            sh:description "Main acquisition device"@en ;
            sh:maxCount 1 ;
            sh:message "Validation of measurementSystem failed!"@en ;
            sh:name "measurement system"@en ;
            sh:order 1 ;
            sh:path ositrace:measurementSystem ],
        [ skos:example "scanner, camera, osm network, aerial images, ..."@en ;
            sh:datatype xsd:string ;
            sh:description "Basic data for the creation of the trace."@en ;
            sh:message "Validation of usedDataSources failed!"@en ;
            sh:name "used data sources"@en ;
            sh:order 0 ;
            sh:path ositrace:usedDataSources ] ;
    sh:targetClass ositrace:DataSource .

ositrace:FormatShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [ skos:example "3.7.0" ;
            sh:datatype xsd:string ;
            sh:description "Version of data format"@en ;
            sh:maxCount 1 ;
            sh:message "Validation of version failed!"@en ;
            sh:name "version"@en ;
            sh:order 1 ;
            sh:path ositrace:version ],
        [ skos:example "ASAM OSI GroundTruth; ASAM OSI SensorView; ASAM OSI SensorData" ;
            sh:description "Format type definition."@en ;
            sh:in ("ASAM OSI GroundTruth" "ASAM OSI SensorView" "ASAM OSI SensorData") ;
            sh:maxCount 1 ;
            sh:message "Validation of type failed!"@en ;
            sh:name "type"@en ;
            sh:order 0 ;
            sh:path ositrace:formatType ] ;
    sh:targetClass ositrace:Format .

ositrace:QualityShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [ skos:example "0.1" ;
            sh:datatype xsd:float ;
            sh:description "Accuracy of traffic relevant objects, signs and signals."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of accuracySignals failed!"@en ;
            sh:minCount 0 ;
            sh:name "accuracy signals"@en ;
            sh:order 3 ;
            sh:path ositrace:accuracySignals ],
        [ skos:example "0.1" ;
            sh:datatype xsd:float ;
            sh:description "Accuracy of objects in the traffic space, which do not directly affect the traffic."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of accuracyObjects failed!"@en ;
            sh:minCount 0 ;
            sh:name "accuracy objects"@en ;
            sh:order 4 ;
            sh:path ositrace:accuracyObjects ],
        [ skos:example "0.1" ;
            sh:datatype xsd:float ;
            sh:description "Accuracy lane modell height"@en ;
            sh:maxCount 1 ;
            sh:message "Validation of accuracyLaneModelHeight failed!"@en ;
            sh:minCount 0 ;
            sh:name "accuracy lane model height"@en ;
            sh:order 2 ;
            sh:path ositrace:accuracyLaneModelHeight ],
        [ skos:example "0.01" ;
            sh:datatype xsd:float ;
            sh:description "Precision of measured road network (relative accuracy)."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of precision failed!"@en ;
            sh:minCount 0 ;
            sh:name "precision"@en ;
            sh:order 0 ;
            sh:path ositrace:precision ],
        [ skos:example "0.1" ;
            sh:datatype xsd:float ;
            sh:description "Accuracy of lane modell 2d."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of accuracyLaneModel2d failed!"@en ;
            sh:minCount 0 ;
            sh:name "accuracy lane model 2d"@en ;
            sh:order 1 ;
            sh:path ositrace:accuracyLaneModel2d ],
        [ skos:example "Calibration performed at origin" ;
            sh:datatype xsd:string ;
            sh:description "Description of any calibration steps performed prior to measurement."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of calibration failed!"@en ;
            sh:minCount 0 ;
            sh:name "calibration"@en ;
            sh:order 5 ;
            sh:path ositrace:calibration ],
        [ skos:example "https://github.com/mygroup/myproject/osi_trace_validation_report.xqar" ;
            sh:datatype xsd:anyURI ;
            sh:description "Link to OSI trace file validation report, if any exists. The report should be of type 'vv-report:VvReport' according to https://w3id.org/gaia-x4plcaad/ontologies/vv-report/v2."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of validationReport failed!"@en ;
            sh:minCount 0 ;
            sh:name "validation report"@en ;
            sh:order 6 ;
            sh:path ositrace:validationReport ],
        [ skos:example "application/xqar" ;
            sh:datatype xsd:string ;
            sh:description "Type of OSI trace validation report, if any exists. As mime-type."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of validationReportType failed!"@en ;
            sh:minCount 0 ;
            sh:name "validation report type"@en ;
            sh:order 7 ;
            sh:path ositrace:validationReportType ] ;
    sh:targetClass ositrace:Quality .

ositrace:QuantityShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [ skos:example "1000" ;
            sh:datatype xsd:integer ;
            sh:minInclusive 0 ;
            sh:description "Number of frames/messages in the trace file."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of numberFrames failed!"@en ;
            sh:name "number frames"@en ;
            sh:order 0 ;
            sh:path ositrace:numberFrames ] ;
    sh:targetClass ositrace:Quantity .

ositrace:MovingObjectShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [ skos:example "42" ;
            sh:datatype xsd:integer ;
            sh:minInclusive 0 ;
            sh:description "Moving object identifier in trace file."@en ;
            sh:minCount 1 ;
            sh:maxcount 1 ;
            sh:message "Validation of identifier failed!"@en ;
            sh:name "identifier"@en ;
            sh:order 1 ;
            sh:path ositrace:identifier ],
        [ skos:example "PMSF Mercedes CLS Ego Vehicle" ;
            sh:datatype xsd:string ;
            sh:description "Description of moving object in the trace file."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of description failed!"@en ;
            sh:name "description"@en ;
            sh:order 2 ;
            sh:path ositrace:description ] ;
    sh:targetClass ositrace:MovingObject .

ositrace:EventShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [ skos:example "2024-05-11T13:20:03.250320Z" ;
            sh:datatype xsd:dateTime ;
            sh:pattern ".*(Z|[+-]\\d{2}:\\d{2})$" ;
            sh:message "Value must be a valid timestamp with a timezone (ending in 'Z' or '+/-HH:MM')."@en ;
            sh:description "Exact timestamp of the event in the recorded trace."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of time failed!"@en ;
            sh:minCount 1 ;
            sh:name "time"@en ;
            sh:order 1 ;
            sh:path ositrace:time ],
        [ skos:example "42" ;
            sh:datatype xsd:string ;
            sh:description "Unique tag of the event in trace file."@en ;
            sh:minCount 1 ;
            sh:maxcount 1 ;
            sh:message "Validation of tag failed!"@en ;
            sh:name "tag"@en ;
            sh:order 2 ;
            sh:path ositrace:tag ],
        [ skos:example "Beginning of cut-in manoever."@en ;
            sh:datatype xsd:string ;
            sh:description "Description of event in the trace file."@en ;
            sh:maxCount 1 ;
            sh:message "Validation of description failed!"@en ;
            sh:name "description"@en ;
            sh:order 3 ;
            sh:path ositrace:description ] ;
    sh:targetClass ositrace:Event .