Ontology Management Base

Central repository for the ENVITED-X Ecosystem of the Automotive Solution Center for Simulation e.V. It serves as the single source of truth for Gaia-X 25.11 compliant ontologies, including those developed within the Gaia-X 4 PLC-AAD project.

Note: This repository is the active development home, forked from GAIA-X4PLC-AAD/ontology-management-base (archived after v0.1.0).

Getting Started

New to this project? Start with the install, test, build guide.

Looking for ontologies? Browse the ontology catalog.

Need technical details? See concepts and validation strategy.

Quick Links

• Full Documentation - Complete guides and references
• Validation - Run checks on your data
• Contributing - How to add or modify ontologies
• Gaia-X 4 PLC-AAD - Federated catalog upload flow

What's in This Repository

• Ontologies - OWL definitions with SHACL validation shapes
• Validation Tools - Python scripts to validate instances
• Test Data - Examples and regression tests
• Documentation - Guides, APIs, and specifications

Requirements

• Python ≥ 3.12 (required — older versions will fail with syntax errors)
• Git
• Make (included with Git Bash on Windows; install via choco install make or scoop install make for PowerShell)

Installation

git clone https://github.com/ASCS-eV/ontology-management-base.git
cd ontology-management-base

# One-command setup (creates .venv, installs dev dependencies, and pre-commit hooks)
make setup

Activate the environment in your current shell when needed:

# Linux / macOS / Git Bash
source .venv/bin/activate

# Windows PowerShell
.venv\Scripts\Activate.ps1

# Windows CMD
.venv\Scripts\activate.bat

Validation

# Validate test data
make test

# See validation options
python3 -m src.tools.validators.validation_suite --help

# Validate specific domain
make test domain DOMAIN=hdmap

# See grouped test subcommands
make test help

Local Docs Build

# Preview locally
DOCS_SITE_URL=http://127.0.0.1:8000/ontology-management-base make docs serve

# Build static docs site
make docs build

Notes:

Hook flow (via hooks/copy_artifacts.py):

1. The hook runs properties_updater and class_page_generator (DOCS_SITE_URL is optional and only affects local diagram links).
2. properties_updater writes tracked artifacts/<domain>/PROPERTIES.md, generates docs/ontologies/properties/<domain>.md (ignored by git), builds the docs/ontologies/properties.md domains overview, and refreshes docs/ontologies/catalog.md.
3. class_page_generator writes docs/ontologies/classes/<domain>/*.md and uses DOCS_SITE_URL to build local diagram links.
4. The hook copies artifacts/<domain>/ into docs/artifacts/<domain>/<versionInfo>/ and adds example instances from tests/data/.

Maintained Ontologies

Ontology / Resource IRI	Local Artifact File
https://openlabel.asam.net/V1-0-0/ontologies/	openlabel/openlabel.owl.ttl
https://openlabel.asam.net/V1-0-0/ontologies/context	openlabel/openlabel.context.jsonld
https://openlabel.asam.net/V1-0-0/ontologies/shapes	openlabel/openlabel.shacl.ttl
https://w3id.org/ascs-ev/envited-x/environment-model/v5	environment-model/environment-model.owl.ttl
https://w3id.org/ascs-ev/envited-x/environment-model/v5/context	environment-model/environment-model.context.jsonld
https://w3id.org/ascs-ev/envited-x/environment-model/v5/shapes	environment-model/environment-model.shacl.ttl
https://w3id.org/ascs-ev/envited-x/envited-x/v3	envited-x/envited-x.owl.ttl
https://w3id.org/ascs-ev/envited-x/envited-x/v3/context	envited-x/envited-x.context.jsonld
https://w3id.org/ascs-ev/envited-x/envited-x/v3/shapes	envited-x/envited-x.shacl.ttl
https://w3id.org/ascs-ev/envited-x/georeference/v5	georeference/georeference.owl.ttl
https://w3id.org/ascs-ev/envited-x/georeference/v5/context	georeference/georeference.context.jsonld
https://w3id.org/ascs-ev/envited-x/georeference/v5/shapes	georeference/georeference.shacl.ttl
https://w3id.org/ascs-ev/envited-x/hdmap/v6	hdmap/hdmap.owl.ttl
https://w3id.org/ascs-ev/envited-x/hdmap/v6/context	hdmap/hdmap.context.jsonld
https://w3id.org/ascs-ev/envited-x/hdmap/v6/shapes	hdmap/hdmap.shacl.ttl
https://w3id.org/ascs-ev/envited-x/manifest/v5	manifest/manifest.owl.ttl
https://w3id.org/ascs-ev/envited-x/manifest/v5/context	manifest/manifest.context.jsonld
https://w3id.org/ascs-ev/envited-x/manifest/v5/shapes	manifest/manifest.shacl.ttl
https://w3id.org/ascs-ev/envited-x/openlabel/v2	openlabel-v2/openlabel-v2.owl.ttl
https://w3id.org/ascs-ev/envited-x/openlabel/v2/context	openlabel-v2/openlabel-v2.context.jsonld
https://w3id.org/ascs-ev/envited-x/openlabel/v2/shapes	openlabel-v2/openlabel-v2.shacl.ttl
https://w3id.org/ascs-ev/envited-x/ositrace/v6	ositrace/ositrace.owl.ttl
https://w3id.org/ascs-ev/envited-x/ositrace/v6/context	ositrace/ositrace.context.jsonld
https://w3id.org/ascs-ev/envited-x/ositrace/v6/shapes	ositrace/ositrace.shacl.ttl
https://w3id.org/ascs-ev/envited-x/scenario/v6	scenario/scenario.owl.ttl
https://w3id.org/ascs-ev/envited-x/scenario/v6/context	scenario/scenario.context.jsonld
https://w3id.org/ascs-ev/envited-x/scenario/v6/shapes	scenario/scenario.shacl.ttl
https://w3id.org/ascs-ev/envited-x/surface-model/v6	surface-model/surface-model.owl.ttl
https://w3id.org/ascs-ev/envited-x/surface-model/v6/context	surface-model/surface-model.context.jsonld
https://w3id.org/ascs-ev/envited-x/surface-model/v6/shapes	surface-model/surface-model.shacl.ttl
https://w3id.org/ascs-ev/envited-x/tzip21/v1	tzip21/tzip21.owl.ttl
https://w3id.org/ascs-ev/envited-x/tzip21/v1/context	tzip21/tzip21.context.jsonld
https://w3id.org/ascs-ev/envited-x/tzip21/v1/shapes	tzip21/tzip21.shacl.ttl
https://w3id.org/gaia-x/development#	gx/gx.owl.ttl
https://w3id.org/gaia-x/development#context	gx/gx.context.jsonld
https://w3id.org/gaia-x/development#shapes	gx/gx.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/automotive-simulator/v2	automotive-simulator/automotive-simulator.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/automotive-simulator/v2/context	automotive-simulator/automotive-simulator.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/automotive-simulator/v2/shapes	automotive-simulator/automotive-simulator.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/description/v1	description/description.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/description/v1/context	description/description.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/description/v1/shapes	description/description.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/example/v1	example/example.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/example/v1/context	example/example.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/example/v1/shapes	example/example.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/general/v3	general/general.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/general/v3/context	general/general.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/general/v3/shapes	general/general.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/leakage-test/v3	leakage-test/leakage-test.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/leakage-test/v3/context	leakage-test/leakage-test.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/leakage-test/v3/shapes	leakage-test/leakage-test.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/service/v2	service/service.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/service/v2/context	service/service.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/service/v2/shapes	service/service.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/simulated-sensor/v2	simulated-sensor/simulated-sensor.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/simulated-sensor/v2/context	simulated-sensor/simulated-sensor.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/simulated-sensor/v2/shapes	simulated-sensor/simulated-sensor.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/simulation-model/v3	simulation-model/simulation-model.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/simulation-model/v3/context	simulation-model/simulation-model.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/simulation-model/v3/shapes	simulation-model/simulation-model.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/survey/v6	survey/survey.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/survey/v6/context	survey/survey.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/survey/v6/shapes/result-data-offering	survey/survey-result-data-offering.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/survey/v6/shapes/service-offering	survey/survey-service-offering.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/vv-report/v2	vv-report/vv-report.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/vv-report/v2/context	vv-report/vv-report.context.jsonld
https://w3id.org/gaia-x4plcaad/ontologies/vv-report/v2/shapes	vv-report/vv-report.shacl.ttl

Acknowledgements

Funded by the European Union. Views and opinions expressed are however those of the author(s) only and do not necessarily reflect those of the European Union or European Climate, Infrastructure and Environment Executive Agency (CINEA). Neither the European Union nor the granting authority can be held responsible for them.

License

See LICENSE for details.