Physical-Ontology tier

Audience: ontology engineers, SHACL implementers, SPARQL consumers, RDF tool authors, regulators interpreting machine-readable artefacts. Fluent in OWL / SHACL / SKOS / Turtle.

This tier documents the OWL / SHACL / SKOS Turtle artefacts that OPDA’s generator emits. Every claim here is backed by a Turtle block copied verbatim from a source TTL at source/03-standards/ontology/.

Ontology version pin

Source: foundation.ttl.

Load order

Per ADR-0011 (module TBox emission) + ADR-0010 (SKOS vocabulary emission) + ADR-0013 (overlay profile emission), consumers loading the full ontology should follow this order so owl:imports resolves:

1. foundation.ttl — ontology header (<https://opda.org.uk/pdtf/>, owl:versionIRI <https://opda.org.uk/pdtf/harness/release/1.0.0/>)
2. opda-classes.ttl — foundation class graph (6 classes + opda:hasSpecialCategoryData)
3. opda-vocabularies.ttl — 23 SKOS concept schemes (137 concepts)
4. opda-<module>.ttl × 6 (per-module class graphs):
   • opda-property.ttl (imports <https://opda.org.uk/pdtf/harness/release/1.0.0/> + <https://opda.org.uk/pdtf/scheme/>)
   • opda-agent.ttl
   • opda-transaction.ttl
   • opda-claim.ttl
   • opda-descriptive.ttl
   • opda-governance.ttl
5. opda-shapes.ttl — foundation meta-shapes + cross-cutting SHACL-AF rules
6. opda-<module>-shapes.ttl × 6 — per-module SHACL shapes (Cat 1/2 identity-key, IC-breach, succession rules)
7. opda-annotations.ttl — foundation annotations (header-only)
8. opda-<module>-annotations.ttl × 6 — DPV co-annotations
9. profiles/baspi5.ttl — BASPI5 overlay profile (imports <https://opda.org.uk/pdtf/harness/release/1.0.0/> + <https://opda.org.uk/pdtf/scheme/>)

Profiles are loaded after the base ontology + shapes; they compose without modifying upstream graphs.

See also: Modelling section

The Ontology (OWL), SHACL shapes, and Concept taxonomy (SKOS) pages in the Modelling section describe the design intent and authoring approach for the artefacts documented in this tier. This tier is the generator-emitted realisation (verbatim Turtle from source TTLs); those pages are the editorial framing and design rationale.

Tier overview

File layout

docs/manual/physical-ontology/
├── README.md                       Tier overview + class/property/scheme catalogue (this file)
├── three-graph-separation.md       Per ODR-0004 §3a — discipline + 5-part CI test
├── severity-tiers.md               Per ODR-0013 §Q1 — 4-tier framework + 5 sh:Violation categories
├── shacl-af-rules.md               Per ODR-0017 — 11 non-blocking quality rules + citing sites
├── foundation/                     6 foundation classes + 5 meta-shapes + 2 SHACL-AF rules
├── property/                       7 classes + 6 shapes + 2 SHACL-AF rules
├── agent/                          7 classes + 5 shapes + 2 SHACL-AF rules
├── transaction/                    3 classes + 4 shapes + 2 SHACL-AF rules
├── claim/                          10 classes + 5 shapes + 2 SHACL-AF rules
├── descriptive/                    5 classes + 5 shapes
├── governance/                     2 classes + 1 shape
├── vocabularies/                   23 SKOS schemes (137 concepts)
├── profiles/                       BASPI5 overlay (3-rule interface contract)
└── exemplars/                      15 diagnostic exemplars + 15 paired expected reports

Class + property + scheme catalogue

Machine-derivable index of every minted term in OPDA’s emitted ontology.

Classes (40 total)

Foundation (6)

Property (7)

Agent (7)

Transaction (3)

Claim (10)

Descriptive (5)

Governance (2)

SHACL shapes (30 total)

Foundation (5 meta-shapes)

• opda:NoIdentityOverride_MetaShape (Cat 3)
• opda:ShInSemantics_MetaShape (Cat 5)
• opda:ShViolationFloor_MetaShape (Cat 5)
• opda:MetaShapeOverShapeGraphMetaShape (Cat 5)
• opda:DeprecationChainRule, opda:PIIWithoutDPVCoAnnotationRule (SHACL-AF rules — see below)

Per-module identity-key + IC-breach shapes

See severity-tiers.md for severity classification.

SHACL-AF rules (11 total)

11 non-blocking quality rules per ODR-0017 §1a. Detailed in shacl-af-rules.md.

SKOS schemes (23 total)

See vocabularies/README.md for the 7-category UFO framework.

Total members: 137.

Overlay profiles

• opda:Baspi5OverlayProfile — BASPI5 v5.0.3 overlay (7 per-Kind profile shapes; 9 property groups; DASH UI predicates)

Diagnostic exemplars (15 paired with expected reports)

See exemplars/README.md for the full catalogue.

Property + identity (S005 + S015):

• registered-freehold-house, unregistered-pre-first-registration-house, flat-with-split-uprn
• flat-no-uprn-newly-converted, listed-building-divergent-addresses, rural-plot-inspire-no-uprn

Agent (S006):

• person-with-name-change, organisation-with-merger, proprietorship-relator-multi-proprietor

Claim (S009):

• claim-with-document-evidence, claim-with-electronic-record-evidence, claim-with-vouch-evidence

Transaction (S007):

• simple-transaction-with-milestones, chain-of-transactions, lease-extension-transaction

Three-graph separation

Every module emits three files (classes / shapes / annotations) with strict isolation. See three-graph-separation.md for the discipline + the 5-part CI test.

CRITICAL — content authors MUST NOT:

• Add sh:* or DPV triples to opda-<module>.ttl (classes file)
• Add owl:Class or owl:imports to opda-<module>-shapes.ttl (shapes file)
• Add sh:* or owl:Class to opda-<module>-annotations.ttl (annotations file)

CI-enforced by opda-gen ci-three-graph (ODR-0004 §3a).

Severity tiers

Per ODR-0013 §Q1, every shape carries explicit sh:severity. See severity-tiers.md for the 4-tier framework + the 5 sh:Violation subcategories + each emitted shape grouped by severity.

SHACL-AF rules

11 non-blocking quality rules per ODR-0017 §1a. See shacl-af-rules.md for the citing sites + each rule.

Cross-tier mapping

Physical-Ontology consolidates per-class blocks into one classes.md per module rather than per-entity files (because Turtle blocks are short and the section structure is uniform).

Source ADR + ODR

• ADR-0007 — Ontology generator specification
• ADR-0008 — Generator implementation infrastructure
• ADR-0010 — SKOS vocabulary emission
• ADR-0011 — Module TBox emission
• ADR-0012 — SHACL + DPV annotation emission
• ADR-0013 — Overlay profile emission
• ADR-0014 — BASPI5 round-trip MVP harness
• ODR-0004 — PDTF ontology foundation (3a three-graph separation)
• ODR-0010 — Overlay profile mechanism (three-rule interface contract)
• ODR-0011 — Enumeration vocabularies (7-category UFO framework)
• ODR-0013 — SHACL validation and severity (4-tier severity framework)
• ODR-0017 — SHACL-AF quality rules pattern (11 citing sites)