Skip to content

sdsc-ordes/bedretto-ontology

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛠️ Bedretto Ontology

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/


🧠 Overview

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.


📁 Repository Structure

.
├── .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

🧪 Continuous Integration

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.


✍️ How to Contribute

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

About

Bedretto lab ontology for boreholes and geo-experiments

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages