environment-model.shacl.ttl

@prefix environment-model: <https://w3id.org/ascs-ev/envited-x/environment-model/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/environment-model/v5/shapes>
    a owl:Ontology ;
    # The Shapes Graph must import the Domain Ontology
    owl:imports <https://w3id.org/ascs-ev/envited-x/environment-model/v5> .

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

    # 2) hasDomainSpecification: Maintaining the mandatory domain-specific extension.
    [
        sh:path environment-model:hasDomainSpecification ;
        sh:node environment-model:DomainSpecificationShape ;
        sh:minCount 1 ;
        sh:maxCount 1 ;
        sh:message "Each environment model must have one associated DomainSpecification object with format, content, quantity, quality, and georeference."@en ;
    ],

    # 3) hasManifest: Updated to reuse the ManifestLinkReferenceShape for linked manifests.
    [
        sh:path environment-model: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
            [ sh:node envited-x:ManifestLinkReferenceShape ]
        ) ;
        sh:message "Each environment model 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:targetClass environment-model:EnvironmentModel .


environment-model:DomainSpecificationShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [
        sh:maxCount 1 ;
        sh:minCount 1 ;
        sh:node environment-model:ProjectShape ;
        sh:name "project object"@en ;
        sh:description "Contains properties to describe the project of the environment-model asset."@en ;
        sh:order 0 ;
        sh:path environment-model:hasProject
    ],[
        sh:maxCount 1 ;
        sh:minCount 1 ;
        sh:node environment-model:FormatShape ;
        sh:name "format object"@en ;
        sh:description "Contains properties to describe the format of the environment-model asset."@en ;
        sh:order 1 ;
        sh:path environment-model:hasFormat
    ],
    [
        sh:maxCount 1 ;
        sh:minCount 1 ;
        sh:node environment-model:ContentShape ;
        sh:name "content object"@en ;
        sh:description "Contains properties to describe the content (elements, use cases) of the environment-model asset."@en ;
        sh:order 2 ;
        sh:path environment-model:hasContent
    ],
    [
        sh:maxCount 1 ;
        sh:minCount 1 ;
        sh:node environment-model:QuantityShape ;
        sh:name "quantity object"@en ;
        sh:description "Contains properties to describe the quantity (number of geometries, triangles, texture) of the environment-model asset."@en ;
        sh:order 3 ;
        sh:path environment-model:hasQuantity
    ],
    [
        sh:maxCount 1 ;
        sh:minCount 1 ;
        sh:node environment-model:QualityShape ;
        sh:name "quality object"@en ;
        sh:description "Contains properties to describe the quality (detail level, features) of the environment-model asset."@en ;
        sh:order 4 ;
        sh:path environment-model:hasQuality
    ],
    [
        sh:maxCount 1 ;
        sh:minCount 1 ;
        sh:node georeference:GeoreferenceShape ;
        sh:name "georeference object"@en ;
        sh:message "Each environment model must link to a georeference dataset defining the location/projection of the environment-model asset."@en ;
        sh:order 5 ;
        sh:path environment-model:hasGeoreference
    ] ;
    sh:targetClass environment-model:DomainSpecification .

environment-model:FormatShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [
        skos:example "Unreal Datasmith, Autodesk FBX, OpenSceneGraph, glTF" ;
        sh:datatype xsd:string ;
        sh:description "Defines the data type of the environment-model asset."@en ;
        sh:in ("Autodesk FBX" "glTF" "OpenSceneGraph" "Unreal Datasmith") ;
        sh:maxCount 1 ;
        sh:message "Validation of type failed!"@en ;
        sh:name "format type"@en ;
        sh:order 0 ;
        sh:path environment-model:formatType
    ],
    [
        skos:example "SDK v4.25" ;
        sh:datatype xsd:string ;
        sh:description "Defines the version of the environment-model asset's data type."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of version failed!"@en ;
        sh:name "version"@en ;
        sh:order 1 ;
        sh:path environment-model:version
    ] ;
    sh:targetClass environment-model:Format .

environment-model:ContentShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [
        skos:example "profile roads, extrude buildings, forests, trees, river, powerlines"@en ;
        sh:maxCount 1 ;
        sh:datatype xsd:string ;
        sh:description "Provides a description of the visual elements contained in the environment-model asset."@en ;
        sh:message "Validation of elements failed!"@en ;
        sh:name "elements"@en ;
        sh:order 0 ;
        sh:path environment-model:elements
    ],
    [
        skos:example "driving, offroad, flight"@en ;
        sh:maxCount 1 ;
        sh:datatype xsd:string ;
        sh:description "Defines the potential use case of the environment-model asset."@en ;
        sh:message "Validation of useCase failed!"@en ;
        sh:name "use case"@en ;
        sh:order 1 ;
        sh:path environment-model:useCase
    ] ;
    sh:targetClass environment-model:Content .

environment-model:ProjectShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [
        skos:example "Unreal" ;
        sh:datatype xsd:string ;
        sh:description "Defines the name of the visualisation tool for which the environment-model was created."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of visualisationToolName failed!"@en ;
        sh:name "visualisation tool name"@en ;
        sh:order 0 ;
        sh:path environment-model:visualisationToolName
    ],
    [
        skos:example "Epic Games" ;
        sh:datatype xsd:string ;
        sh:description "Defines the vendor name of the visualisation tool."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of visualisationToolVendor failed!"@en ;
        sh:name "visualisation tool vendor"@en ;
        sh:order 1 ;
        sh:path environment-model:visualisationToolVendor
    ],
    [
        skos:example "4.27" ;
        sh:datatype xsd:string ;
        sh:description "Defines the version of the visualisation tool."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of visualisationToolVersion failed!"@en ;
        sh:name "visualisation tool version"@en ;
        sh:order 2 ;
        sh:path environment-model:visualisationToolVersion
    ],
    [
        skos:example "Trian3DBuilder" ;
        sh:datatype xsd:string ;
        sh:description "Defines the name of the creation tool used to create the environment-model."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of creationToolName failed!"@en ;
        sh:name "creation tool name"@en ;
        sh:order 3 ;
        sh:path environment-model:creationToolName
    ],
    [
        skos:example "TrianGraphics GmbH" ;
        sh:datatype xsd:string ;
        sh:description "Defines the vendor name of the creation tool."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of creationToolVendor failed!"@en ;
        sh:name "creation tool vendor"@en ;
        sh:order 4 ;
        sh:path environment-model:creationToolVendor
    ],
    [
        skos:example "7.7" ;
        sh:datatype xsd:string ;
        sh:description "Defines the version of the creation tool."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of creationToolVersion failed!"@en ;
        sh:name "creation tool version"@en ;
        sh:order 5 ;
        sh:path environment-model:creationToolVersion
    ] ;
    sh:targetClass environment-model:Project .

environment-model:QualityShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [
        skos:example "PBR, highly detailed specific 3D buildings."@en ;
        sh:datatype xsd:string ;
        sh:description "Describes the features that influence the quality of the environment-model."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of features failed!"@en ;
        sh:minCount 0 ;
        sh:name "features"@en ;
        sh:order 2 ;
        sh:path environment-model:features
    ],
    [
        skos:example "High"@en ;
        sh:datatype xsd:string ;
        sh:description "Defines the category of the level of detail. High: the highest level with additional object enrichment; Medium: derived directly from data sources with environmental context; Low: a simple topological representation."@en ;
        sh:in ("High" "Medium" "Low") ;
        sh:maxCount 1 ;
        sh:message "Validation of detailLevel failed!"@en ;
        sh:name "detail level"@en ;
        sh:order 0 ;
        sh:path environment-model:detailLevel
    ],
    [
        skos:example "0.1"@en ;
        sh:datatype xsd:float ;
        sh:description "Specifies the maximum real texture resolution in metres."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of textureResolution failed!"@en ;
        sh:minCount 0 ;
        sh:name "texture resolution"@en ;
        sh:order 1 ;
        sh:path environment-model:textureResolution
    ] ;
    sh:targetClass environment-model:Quality .

environment-model:QuantityShape a sh:NodeShape ;
    sh:closed false ;
    
    sh:property [
        skos:example "12000" ;
        sh:datatype xsd:integer ;
        sh:minInclusive 0 ;
        sh:description "Defines the total number of geometries (all triangles with a material assignment), counting each instance only once."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of geometryCount failed!"@en ;
        sh:name "geometry count"@en ;
        sh:order 2 ;
        sh:path environment-model:geometryCount
    ],
    [
        skos:example "16000000" ;
        sh:datatype xsd:integer ;
        sh:minInclusive 0 ;
        sh:description "Defines the total number of triangles, counting each instance only once."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of triangleCount failed!"@en ;
        sh:name "triangle count"@en ;
        sh:order 1 ;
        sh:path environment-model:triangleCount
    ],
    [
        skos:example "179" ;
        sh:datatype xsd:integer ;
        sh:minInclusive 0 ;
        sh:description "Specifies the total number of textures used."@en ;
        sh:maxCount 1 ;
        sh:message "Validation of textureMaterialCount failed!"@en ;
        sh:name "texture material count"@en ;
        sh:order 0 ;
        sh:path environment-model:textureMaterialCount
    ] ;
    sh:targetClass environment-model:Quantity .