The Bedretto Ontology provides structured semantic definitions for boreholes, core samples, sensors, monitoring systems, and geological metadata, as used at the Bedretto Underground Laboratory for Geosciences and Geoenergies, which are also applicable to other underground facilites.
📄 Documentation: https://sdsc-ordes.github.io/bedretto-ontology/
This ontology models geoscientific infrastructure and observations. It supports data integration, documentation, and interoperability for subsurface research, particularly in the context of experimental test beds and monitoring boreholes.
Key concepts include:
- Boreholes: Physical shafts drilled into the ground.
- Core & Core Samples: Extracted geological materials and their descriptions.
- Downhole Logging: Recorded physical and geological data from within boreholes.
- Sensors: Including seismic, hydraulic, hydromechanical, and fibre-optic types.
- Monitoring & Configuration: Observation setups and sensor parameterization.
- Geology: Descriptive metadata for geological structures.
- Test Beds: Experimental sites and their purpose.
The ontology is modular and extendable, with a focus on real-world operational workflows and sensor installations.
.
├── .github/workflows # GitHub Actions: CI for checks and docs
│ ├── checks.yaml
│ └── docs.yaml
├── README.md # You're reading it
├── docs/ # Rendered documentation & diagrams
│ ├── index.html
├── external/ # Source vocabularies and domain references
│ ├── BoreholeDB_v0.1.accdb
│ ├── BoreholeIE_consolidated_vocab_ed.xlsx
│ └── Borehole_consolidated_vocab_02.xlsx
│ └── BoreholeDB_v0.1_relationships.PNG
├── src/ontology/ # Core ontology (Turtle format)
│ └── bedretto-ontology.ttl
│ └── README.md # Ontology editing docs
├── src/quality-checks/ # SHACL shapes for validation
│ └── shacl-shacl.ttl
└── tools/python/ # Python tools for SHACL and SPARQL
│ └──checks/shacl.py
│ └──docs/sparql.py
│ └──requirements.txt
This repository includes a GitHub Actions pipeline that automatically:
- ✅ Validates the ontology with SHACL (
checks.yaml
) - 🧾 Regenerates HTML documentation from the ontology (
docs.yaml
)
All changes to the ontology file or shapes will trigger these checks automatically when committed.
Want to propose changes or additions to the ontology? Check out the README.md inside /ontology. After comitting and pushing changes:
CI Will Run Automatically
GitHub will validate the ontology and regenerate the documentation. Once merged, the updated docs are available at: 👉 https://sdsc-ordes.github.io/bedretto-ontology/
👥 Contributors
- Liliana Vargas
- Robin Franken (With contributions and stewardship by the Bedretto Lab, ETH Zurich)