Skip to content

Plan, apply and roll back changes to a production ontology, with a blast radius report and a proof an auditor can re-check.

feat: add full IES ecosystem support — ies-top, ies-core, ecosystem demo (32 ontologies)

FABIOTESS31f445e4e342
diff --git a/README.md b/README.md
index fb416708..9d05f6ee 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@
---
-Open Ontologies is a **Rust MCP server** and **desktop Studio** for AI-native ontology engineering. It exposes **48 tools** that let Claude build, validate, query, diff, lint, version, reason over, align, and persist RDF/OWL ontologies using an in-memory Oxigraph triple store — with Terraform-style lifecycle management, a marketplace of 30 standard ontologies, clinical crosswalks, semantic embeddings, and a full lineage audit trail.
+Open Ontologies is a **Rust MCP server** and **desktop Studio** for AI-native ontology engineering. It exposes **48 tools** that let Claude build, validate, query, diff, lint, version, reason over, align, and persist RDF/OWL ontologies using an in-memory Oxigraph triple store — with Terraform-style lifecycle management, a marketplace of 32 standard ontologies, clinical crosswalks, semantic embeddings, and a full lineage audit trail.
The **Studio** wraps the engine in a visual desktop environment: 3D force-directed graph, AI chat panel, Protégé-style property inspector, and lineage viewer.
@@ -295,42 +295,60 @@ Full benchmark writeup: [docs/benchmarks.md](docs/benchmarks.md)
## IES Support
-[IES (Information Exchange Standard)](https://github.com/IES-Org/ont-ies) is the UK National Digital Twin Programme's core ontology. It uses a 4D extensionalist (BORO) approach for modelling entities, events, states, and relationships. Open Ontologies includes first-class IES support:
+[IES (Information Exchange Standard)](https://github.com/IES-Org) is the UK National Digital Twin Programme's core ontology framework. It uses a 4D extensionalist (BORO) approach for modelling entities, events, states, and relationships. Open Ontologies supports the **full IES stack** — all three layers, SHACL shapes, and 42+ example datasets.
-### Quick Start
+### The IES Layers
-```bash
-# Install IES from the marketplace
-open-ontologies marketplace install ies
+The marketplace includes all three tiers of the IES framework:
-# Or pull directly
-open-ontologies pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/specification/ies-common.ttl
+```text
+onto_marketplace install ies-top # ToLO — BORO foundations (~22 classes)
+onto_marketplace install ies-core # Core — persons, states, events (~131 classes)
+onto_marketplace install ies # Common — full ontology (513 classes, 206 properties)
```
-### Full Workflow
+### Benchmark
+
+| Metric | IES Common |
+| --- | --- |
+| Classes | 513 |
+| Object properties | 206 |
+| Triples loaded | 4,040 |
+| + RDFS inferred | **+3,094 (+77%)** |
+| Fetch time | 911ms |
+| RDFS reasoning | 63ms |
+| Lint issues | 0 |
+
+IES is the second-largest ontology in the marketplace by class count (after Schema.org). RDFS reasoning produces the richest inference gain of any non-general ontology — 241 State subclasses, 117 ClassOfEntity subclasses, and 102 Event subclasses all generating transitive chains.
+
+### Example Data
+
+Load any of the 42+ IES example datasets directly:
```text
-onto_marketplace install ies # fetch IES v5 ontology
-onto_stats # verify class/property/triple counts
-onto_lint # check for missing labels, domains, ranges
-onto_reason --profile owl-rl # materialise inferred triples
-onto_stats # verify inferred counts
-onto_query "..." # run IES-specific SPARQL queries
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/examples/sample-data/event-participation.ttl
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/examples/sample-data/hospital.ttl
+onto_pull https://raw.githubusercontent.com/telicent-oss/ies-examples/main/additional_examples/ship_movement.ttl
```
-### IES:Building Alignment
-
-The repo includes an [IES Building Extension](benchmark/generated/ies-building-extension.ttl) that models buildings, dwellings, energy performance, and retrofit interventions using IES 4D patterns. Use `onto_align` to map it to other domain ontologies:
+### SHACL Validation
```text
-onto_align --source ies-building.ttl --target schema-org.ttl
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/specification/ies-common.shacl
+onto_shacl
```
-This mirrors NDTP's active work transforming energy performance data into RDF aligned with IES:Building. See the full walkthrough in [docs/ies-alignment.md](docs/ies-alignment.md).
+### IES:Building Alignment
+
+The repo includes an [IES Building Extension](benchmark/generated/ies-building-extension.ttl) that models buildings, dwellings, energy performance, and retrofit interventions using IES 4D patterns. Use `onto_align` to map it to other domain ontologies — this mirrors NDTP's active work transforming energy performance data into RDF aligned with IES:Building.
-### SPARQL Examples
+### Further Reading
-5 ready-to-use IES queries covering Person subclasses, EventParticipant relationships, 4D temporal patterns, Location hierarchies, and the ClassOfEntity type-instance pattern. See [docs/ies-examples.md](docs/ies-examples.md).
+| Topic | Link |
+| --- | --- |
+| IES Ecosystem Demo | [docs/ies-ecosystem.md](docs/ies-ecosystem.md) |
+| SPARQL Examples | [docs/ies-examples.md](docs/ies-examples.md) |
+| Building Alignment | [docs/ies-alignment.md](docs/ies-alignment.md) |
---
@@ -508,6 +526,7 @@ flowchart TD
| OWL2-DL Reasoning | [docs/reasoning.md](docs/reasoning.md) |
| Semantic Embeddings | [docs/embeddings.md](docs/embeddings.md) |
| Clinical Crosswalks | [docs/clinical.md](docs/clinical.md) |
+| IES Ecosystem | [docs/ies-ecosystem.md](docs/ies-ecosystem.md) |
| IES SPARQL Examples | [docs/ies-examples.md](docs/ies-examples.md) |
| IES:Building Alignment | [docs/ies-alignment.md](docs/ies-alignment.md) |
| Benchmarks | [docs/benchmarks.md](docs/benchmarks.md) |
diff --git a/docs/ies-ecosystem.md b/docs/ies-ecosystem.md
new file mode 100644
index 00000000..2806ae2d
--- /dev/null
+++ b/docs/ies-ecosystem.md
@@ -0,0 +1,159 @@
+# IES Ecosystem Demo
+
+The [Information Exchange Standard (IES)](https://github.com/IES-Org) is a layered ontology framework used by the UK National Digital Twin Programme (NDTP). Open Ontologies supports the full IES stack through its marketplace.
+
+## The IES Layers
+
+IES is split into three tiers, each building on the last:
+
+```
+ies-top (ToLO) ~22 classes BORO foundations, 4D extensionalism
+ |
+ies-core ~131 classes Persons, states, events, identifiers
+ |
+ies-common ~513 classes Full ontology — everything above + domain patterns
+```
+
+## Quick Start: Load the Full Stack
+
+```text
+# Load all three layers individually
+onto_marketplace install ies-top
+onto_stats
+onto_clear
+
+onto_marketplace install ies-core
+onto_stats
+onto_clear
+
+# Or load the full IES Common (includes everything)
+onto_marketplace install ies
+onto_stats
+```
+
+## Full Pipeline Demo
+
+### Step 1: Load and Validate
+
+```text
+onto_marketplace install ies
+onto_stats
+onto_lint
+```
+
+Expected output:
+- 513 classes, 206 object properties, 4,040 triples
+- 0 lint issues (IES v5 is well-formed)
+
+### Step 2: Reason
+
+```text
+onto_reason --profile rdfs
+onto_stats
+```
+
+RDFS materialises **+3,094 inferred triples** (77% growth) — transitive subclass chains across 241 State subclasses, 117 ClassOfEntity subclasses, and 102 Event subclasses.
+
+### Step 3: Explore with SPARQL
+
+See [ies-examples.md](ies-examples.md) for 5 ready-to-use queries. Quick taste:
+
+```text
+# Count State subclasses (the 4D temporal pattern)
+onto_query "SELECT (COUNT(DISTINCT ?c) AS ?count) WHERE {
+ ?c rdfs:subClassOf* <http://informationexchangestandard.org/ont/ies/common/State> .
+ FILTER(?c != <http://informationexchangestandard.org/ont/ies/common/State>)
+}"
+# Result: 241
+```
+
+### Step 4: Load Example Data
+
+IES has ~42 example Turtle files across its repos. Pull them directly:
+
+```text
+# Event participation patterns
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/examples/sample-data/event-participation.ttl
+
+# Hospital scenario
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/examples/sample-data/hospital.ttl
+
+# Movement tracking
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/examples/sample-data/movement.ttl
+
+# GeoSPARQL integration
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/examples/sample-data/geosparql.ttl
+```
+
+Additional examples from telicent-oss:
+
+```text
+# Ship movement (4D spatiotemporal)
+onto_pull https://raw.githubusercontent.com/telicent-oss/ies-examples/main/additional_examples/ship_movement.ttl
+
+# Aircraft observation
+onto_pull https://raw.githubusercontent.com/telicent-oss/ies-examples/main/additional_examples/observing_moving_aircraft.ttl
+
+# Countries reference data
+onto_pull https://raw.githubusercontent.com/telicent-oss/ies-examples/main/regions_of_the_world/countries.ttl
+```
+
+### Step 5: SHACL Validation
+
+IES provides SHACL shapes for data validation:
+
+```text
+# Validate against IES Common shapes
+onto_pull https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/specification/ies-common.shacl
+onto_shacl
+```
+
+Core-level shapes for specific patterns:
+
+```text
+# Person state validation
+onto_pull https://raw.githubusercontent.com/IES-Org/ies-core/main/spec/validation_artefacts/PersonState.shacl.ttl
+
+# Birth/death state validation
+onto_pull https://raw.githubusercontent.com/IES-Org/ies-core/main/spec/validation_artefacts/BirthStateShape.shacl.ttl
+onto_pull https://raw.githubusercontent.com/IES-Org/ies-core/main/spec/validation_artefacts/DeathStateShape.shacl.ttl
+```
+
+### Step 6: Alignment
+
+Map IES to other domain ontologies:
+
+```text
+# Save IES, load target, align
+onto_save /tmp/ies.ttl
+onto_clear
+onto_marketplace install schema-org
+onto_save /tmp/schema-org.ttl
+onto_clear
+onto_align --source /tmp/ies.ttl --target /tmp/schema-org.ttl
+```
+
+See [ies-alignment.md](ies-alignment.md) for the full IES:Building alignment walkthrough.
+
+## IES Ecosystem Map
+
+| Resource | Repo | What's There |
+| --- | --- | --- |
+| **IES Top (ToLO)** | `IES-Org/ies-top` | Foundational ontology + 2 SHACL shapes |
+| **IES Core** | `IES-Org/ies-core` | Core patterns + 6 SHACL shapes + 7 test data files |
+| **IES Common** | `IES-Org/ont-ies` | Full ontology (4 formats) + SHACL shapes + 15 examples + user guides + 70 diagrams |
+| **IES Examples** | `telicent-oss/ies-examples` | 28 Turtle example files + regions reference data |
+| **IES Tool** | `telicent-oss/ies-tool` | Python library + bundled v4.3 ontology + SHACL shapes |
+| **RDF Transform** | `telicent-oss/telicent-rdf-transform` | IES4 to IES-Next migration mappings |
+| **NDTP AI Extension** | `National-Digital-Twin/ndtp-ai-ontology-extension` | LLM-driven ontology extension tooling |
+| **IES4 (archived)** | `dstl/IES4` | Legacy v4 ontology + examples + full spec PDF |
+
+## Benchmark Results
+
+| Layer | Classes | Properties | Triples | + RDFS | Fetch | RDFS |
+| --- | ---: | ---: | ---: | ---: | ---: | ---: |
+| IES Top (ToLO) | ~22 | TBD | TBD | TBD | TBD | TBD |
+| IES Core | ~131 | TBD | TBD | TBD | TBD | TBD |
+| **IES Common** | **513** | **206** | **4,040** | **+3,094** | **911ms** | **63ms** |
+
+IES Common is the second-largest ontology in the marketplace by class count (after Schema.org's 1,009). RDFS reasoning adds 77% more triples — the richest inference gain of any non-general ontology, driven by the deep 4D State/Event/ClassOfEntity hierarchies.
diff --git a/src/marketplace.rs b/src/marketplace.rs
index 7db59e79..d96a4212 100644
--- a/src/marketplace.rs
+++ b/src/marketplace.rs
@@ -10,7 +10,7 @@ pub struct MarketplaceEntry {
pub format: RdfFormat,
}
-/// Curated catalogue of 30 standard W3C/ISO/industry ontologies.
+/// Curated catalogue of 32 standard W3C/ISO/industry ontologies.
pub static CATALOGUE: &[MarketplaceEntry] = &[
// ── Foundational ──────────────────────────────────────────────
MarketplaceEntry {
@@ -39,10 +39,26 @@ pub static CATALOGUE: &[MarketplaceEntry] = &[
},
// ── Upper ontology / Information Exchange ─────────────────────
+ MarketplaceEntry {
+ id: "ies-top",
+ name: "IES Top Level Ontology (ToLO)",
+ description: "BORO foundational ontology — extensional 4-dimensionalism and pluralities, the upper layer of the IES framework",
+ domain: "upper-ontology",
+ url: "https://raw.githubusercontent.com/IES-Org/ies-top/main/spec/ies-top.ttl",
+ format: RdfFormat::Turtle,
+ },
+ MarketplaceEntry {
+ id: "ies-core",
+ name: "IES Core Ontology",
+ description: "Core IES patterns — persons, states, events, identifiers, periods. The middle layer of the IES framework",
+ domain: "upper-ontology",
+ url: "https://raw.githubusercontent.com/IES-Org/ies-core/main/spec/ies-core.ttl",
+ format: RdfFormat::Turtle,
+ },
MarketplaceEntry {
id: "ies",
- name: "IES (Information Exchange Standard)",
- description: "UK NDTP core ontology for information exchange — 4D extensionalist (BORO) patterns for entities, events, states, and relationships",
+ name: "IES Common (Information Exchange Standard)",
+ description: "UK NDTP core ontology for information exchange — 513 classes, 206 properties, 4D extensionalist (BORO) patterns for entities, events, states, and relationships",
domain: "upper-ontology",
url: "https://raw.githubusercontent.com/IES-Org/ont-ies/main/docs/specification/ies-common.ttl",
format: RdfFormat::Turtle,