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: After release v0.1.0, this repository will be archived (read-only). Ongoing maintenance continues at ASCS-eV/ontology-management-base.

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

Installation

git clone https://github.com/gaia-x4plc-aad/ontology-management-base.git
cd ontology-management-base

# Create and activate virtual environment
python3 -m venv .venv # Windows: python -m venv .venv
source .venv/bin/activate # Windows: source .venv/Scripts/activate

# Install dependencies
pip install -e .

Validation

# Validate test data
make test

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

# Validate specific domain
python3 -m src.tools.validators.validation_suite --run check-data-conformance --domain hdmap

Local Docs Build

python3 -m pip install -e ".[docs]"

DOCS_SITE_URL=http://127.0.0.1:8000/ontology-management-base mkdocs serve

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/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/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/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/shapes	georeference/georeference.shacl.ttl
https://w3id.org/ascs-ev/envited-x/hdmap/v5	hdmap/hdmap.owl.ttl
https://w3id.org/ascs-ev/envited-x/hdmap/v5/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/shapes	manifest/manifest.shacl.ttl
https://w3id.org/ascs-ev/envited-x/ositrace/v5	ositrace/ositrace.owl.ttl
https://w3id.org/ascs-ev/envited-x/ositrace/v5/shapes	ositrace/ositrace.shacl.ttl
https://w3id.org/ascs-ev/envited-x/scenario/v5	scenario/scenario.owl.ttl
https://w3id.org/ascs-ev/envited-x/scenario/v5/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/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/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/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/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/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/shapes	general/general.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/leakage-test/v2	leakage-test/leakage-test.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/leakage-test/v2/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/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/shapes	simulated-sensor/simulated-sensor.shacl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/simulation-model/v2	simulation-model/simulation-model.owl.ttl
https://w3id.org/gaia-x4plcaad/ontologies/simulation-model/v2/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/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/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.