Metadata-Version: 2.4
Name: celine-ontologies
Version: 1.1.0
Summary: CELINE Ontologies support libraries
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: jsonschema>=4.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: all
Requires-Dist: httpx>=0.28.1; extra == 'all'
Requires-Dist: pyshacl>=0.26.0; extra == 'all'
Requires-Dist: rdflib>=7.5.0; extra == 'all'
Requires-Dist: typer>=0.21.1; extra == 'all'
Provides-Extra: cli
Requires-Dist: httpx>=0.28.1; extra == 'cli'
Requires-Dist: rdflib>=7.5.0; extra == 'cli'
Requires-Dist: typer>=0.21.1; extra == 'cli'
Provides-Extra: mapper
Requires-Dist: pyshacl>=0.26.0; extra == 'mapper'
Requires-Dist: rdflib>=7.5.0; extra == 'mapper'
Description-Content-Type: text/markdown

# CELINE Ontology

This directory contains the **semantic artifacts** used in the CELINE project to support:

- semantic interoperability across datasets
- Digital Twins (WP3)
- Demonstrators, KPIs, and evaluation (WP5)
- mapping from tabular data to RDF / JSON-LD

The CELINE ontology is **not a standalone domain ontology**, but a **unified ontology profile** that aligns and connects established standards (SAREF, SOSA, BIGG, SEAS, EM-KPI) into a coherent semantic target for the CELINE ecosystem.

---

## Contents

### Core ontology artifacts


- **[CELINE ontology documentation](https://celine-eu.github.io/ontologies/)**  
  Documentation of the CELINE ontology

- **[CELINE ontology (Turtle)](releases/current/celine.ttl)**  
  The formal OWL/RDF definition of the CELINE Unified Ontology Profile.  
  Defines CELINE classes and properties and aligns them with PECO, SAREF, SOSA, BIGG, SEAS, and EM-KPI.

- **[CELINE SHACL shapes](releases/current/celine.shacl.ttl)**  
  SHACL shapes defining semantic constraints on the RDF graph after JSON-LD expansion.  
  Used to validate observations, time series, meters, energy communities, scenarios and KPIs.

- **[CELINE JSON-LD context](releases/current/celine.jsonld)**  
  JSON-LD `@context` defining prefixes, aliases, and mappings used by CELINE APIs and data pipelines.  
  This is the primary entry point for developers producing JSON-LD payloads.

- **[CELINE JSON Schema](releases/current/celine.schema.json)**  
  JSON Schema used at API boundaries to validate incoming JSON-LD payloads before semantic expansion.


---

### Repository & mapping configuration

- **[Open repository configuration](open-repository.yaml)**  
  YAML configuration listing datasets, governance metadata, and extension points for ontology mapping.

- **[Open repository JSON Schema](open-repository.schema.json)**  
  JSON Schema defining the structure of the dataset catalogue and repository configuration used by CELINE tooling.

---

## How these artifacts work together

The CELINE semantic stack follows a layered validation and mapping approach:

1. **Tabular data** is exposed via dataset APIs  
2. **Mapping definitions** bind dataset schemas to ontology classes and properties  
3. **JSON-LD** is generated using `celine.jsonld`  
4. **JSON Schema** (`celine.schema.json`) validates payload structure at the API level  
5. **JSON-LD expansion** produces RDF  
6. **SHACL validation** (`celine.shacl.ttl`) enforces semantic correctness  
7. Validated data is ingested into the **CELINE Digital Twin / Knowledge Graph**

This separation ensures:
- developer-friendly APIs
- strict semantic validation
- long-term interoperability

---

## Design principles

- **Standards first**: reuse ETSI SAREF, W3C SOSA/SSN, BIGG, SEAS, EM-KPI
- **Thin CELINE layer**: only project-specific glue concepts are defined
- **Modular & versionable**: artifacts can evolve independently
- **Tool-friendly**: compatible with rdflib, JSON-LD, SHACL engines

---

## Intended audience

- CELINE developers integrating data sources
- WP3 Digital Twin engineers
- WP5 demonstrator and KPI designers
- Data governance and interoperability stakeholders

---

## Versioning & publication

These ontology artifacts are published via **GitHub Pages** to provide stable, resolvable URLs suitable for:

- JSON-LD contexts
- ontology references in catalogues
- external integrations

Always prefer **versioned URLs** when referencing ontology artifacts in mappings or production systems.

---

## Questions & contributions

For questions, discussions, or proposed changes to the CELINE ontology profile, please refer to the main CELINE repository or open an issue in the relevant project repository.
