Repository: OpenEnergyPlatform/ontology
Pull request #2023: create shortcut relations for oekg #2013
Author: login: stap-m
Labels: name: oeo-shared
description: changes the oeo-shared module
name: oeo-shared-axioms
Created: 2025-02-27T13:10:25Z | Merged: 2025-03-06T10:30:21Z

## Summary of the discussion

For the restructuring of oekg, a couple of shortcut relations are needed, see #2013. To annotate the respective sparql queries, a new annotation property is added as well.

## Type of change (CHANGELOG.md)
### Add
annotation property: `has associated axiom(sparql)` (OEO_00020434)

**scenario factsheet:**
`has information output (shortcut)` (OEO_00020436)
`has information input (shortcut)` (OEO_00020437)

**scenario bundle:**
`covers enrgy carrier (shortcut)` (OEO_00020432)
`covers technology (shortcut)` (OEO_00020438)
`covers sector (shortcut)` (OEO_00020439)



### PR-Assignee
- [ ] 🐙 Follow the [Pull Request Workflow](https://github.com/OpenEnergyPlatform/ontology/wiki/Pull-request-workflow)
- [ ] 📝 Update the [CHANGELOG.md](https://github.com/OpenEnergyPlatform/ontology/blob/dev/CHANGELOG.md)
- [ ] 📙 Add #'s to `term tracker annotation`

### Reviewer
- [ ] 🐙 Follow the [Reviewer Guide](https://github.com/OpenEnergyPlatform/ontology/wiki/Pull-request-workflow#reviewer-guide-check-changes-introduced-by-a-pull-request)
- [ ] 🐙 Provided feedback and show sufficient appreciation for the work done



Diff:
diff --git a/CHANGELOG.md b/CHANGELOG.md
index dc94e2abd..67ce0c4b9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -150,6 +150,7 @@ and the versioning adheres to [Semantic Versioning](http://semver.org/spec/v2.0.
 - has unit numerator, has unit denominator and subproperties (#1816)
 - compressor, compressor station and subclasses (#1818)
 - new units and prefixes from UO (#1820)
+- has associated axiom(sparql), shortcut relations for has information input/output, covers energy carrier, covers technology, covers sector (#2023)
 
 ### Changed
 - energy transfer function, energy transformation function and subclasses (#1785)
diff --git a/src/ontology/edits/oeo-shared-axioms.omn b/src/ontology/edits/oeo-shared-axioms.omn
index 35aa9c46a..0cafd89b2 100644
--- a/src/ontology/edits/oeo-shared-axioms.omn
+++ b/src/ontology/edits/oeo-shared-axioms.omn
@@ -35,6 +35,12 @@ AnnotationProperty: <http://purl.obolibrary.org/obo/IAO_0000118>
 AnnotationProperty: <http://purl.obolibrary.org/obo/IAO_0000119>
 
     
+AnnotationProperty: <http://purl.obolibrary.org/obo/IAO_0000600>
+
+    
+AnnotationProperty: <http://purl.obolibrary.org/obo/IAO_0000601>
+
+    
 AnnotationProperty: <http://purl.org/dc/terms/license>
 
     
@@ -44,9 +50,15 @@ AnnotationProperty: <http://purl.org/dc/terms/title>
 AnnotationProperty: <http://www.geneontology.org/formats/oboInOwl#hasExactSynonym>
 
     
+AnnotationProperty: <https://www.commoncoreontologies.org/ont00001754>
+
+    
 AnnotationProperty: OEO_00020426
 
     
+AnnotationProperty: OEO_00020434
+
+    
 AnnotationProperty: OEO_00110012
 
     
@@ -287,6 +299,134 @@ ObjectProperty: OEO_00020189
 ObjectProperty: OEO_00020190
 
     
+ObjectProperty: OEO_00020432
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "SELECT ?scenariobundle ?energycarrier WHERE {
+?scenariobundle IAO:0000136 _:1.
+_:1 OEO:00000523 ?energycarrier.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario bundle and an energy carrier that is covered by the study the scenario bundle is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio bundle' to 'energy carrier'. The original relation 'covers energy carrier' relates 'study' (process) to 'energy carrier'. 
+The shortcut relation should be used to represents these statements:
+('scenario bundle 'is about' some 'scenario study'`) and ('scenario study' 'covers energy carrier' some 'energy carrier')",
+        rdfs:label "covers energy carrier (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00020227
+    
+    Range: 
+        OEO_00020039
+    
+    
+ObjectProperty: OEO_00020436
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "select ?scenariofactsheet ?dataset where {
+?scenariofactsheet IAO:0000136 _:1.
+_:2 OEO:00020226 _:1.
+_:2 OEO_00140094 ?dataset.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario factsheet and a dataset, where the dataset is an output of the scenario projection process the scenario factsheet is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio factsheet' to 'data set'. The original relation 'has information output' relates 'scenario projection' (process) to 'data set'. 
+The shortcut relation should be used to represents these statements:
+('scenario factsheet' 'is about' some scenario) and
+('scenario projection' 'is based on' some scenario) and
+('scenario projection' 'has information output' some dataset)",
+        rdfs:label "has information output (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00000365
+    
+    Range: 
+        <http://purl.obolibrary.org/obo/IAO_0000100>
+    
+    
+ObjectProperty: OEO_00020437
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "select ?scenariofactsheet ?dataset where {
+?scenariofactsheet IAO:0000136 _:1.
+_:2 OEO:00020226 _:1.
+_:2 OEO_00140093 ?dataset.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio factsheet' to 'data set'. The original relation 'has information input' relates 'scenario projection' (process) to 'data set'. 
+The shortcut relation should be used to represents these statements:
+('scenario factsheet' 'is about' some scenario) and
+('scenario projection' 'is based on' some scenario) and
+('scenario projection' 'has information input' some dataset)",
+        rdfs:label "has information input (shortcut)"@en,
+        <https://www.commoncoreontologies.org/ont00001754> "A relation between a scenario factsheet and a dataset, where the dataset is an input to the scenario projection process the scenario factsheet is about. It is a shortcut relation, see elucidation and associated sparql axiom."
+    
+    Domain: 
+        OEO_00000365
+    
+    Range: 
+        <http://purl.obolibrary.org/obo/IAO_0000100>
+    
+    
+ObjectProperty: OEO_00020438
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "SELECT ?scenariobundle ?technology WHERE {
+?scenariobundle IAO:0000136 _:1.
+_:1 OEO:00390101 ?technology.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario bundle and a technology that is covered by the study the scenario bundle is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio bundle' to 'technology'. The original relation 'covers technology' relates 'study' (process) to 'technology'. 
+The shortcut relation should be used to represents these statements:
+('scenario bundle 'is about' some 'scenario study'`) and ('scenario study' 'covers technology' some 'technology')",
+        rdfs:label "covers technology (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00020227
+    
+    Range: 
+        OEO_00000407
+    
+    
+ObjectProperty: OEO_00020439
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "SELECT ?scenariobundle ?sector WHERE {
+?scenariobundle IAO:0000136 _:1.
+_:1 OEO:00000505 ?sector.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario bundle and a sector that is covered by the study the scenario bundle is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio bundle' to 'sector'. The original relation 'covers sector' relates 'study' (process) to 'sector'. 
+The shortcut relation should be used to represents these statements:
+('scenario bundle 'is about' some 'scenario study'`) and ('scenario study' 'covers sector' some 'sector')",
+        rdfs:label "covers sector (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00020227
+    
+    Range: 
+        OEO_00000367
+    
+    
 ObjectProperty: OEO_00040010
 
     
@@ -474,6 +614,9 @@ Class: OEO_00000350
 Class: OEO_00000364
 
     
+Class: OEO_00000365
+
+    
 Class: OEO_00000367
 
     
@@ -698,6 +841,9 @@ Class: OEO_00020202
         (<http://purl.obolibrary.org/obo/RO_0000057> some OEO_00010116) or (<http://purl.obolibrary.org/obo/RO_0002410> some OEO_00140124)
     
     
+Class: OEO_00020227
+
+    
 Class: OEO_00020248
 
     
diff --git a/src/ontology/edits/oeo-shared.omn b/src/ontology/edits/oeo-shared.omn
index 568fda87f..d2ce7b8c0 100644
--- a/src/ontology/edits/oeo-shared.omn
+++ b/src/ontology/edits/oeo-shared.omn
@@ -95,6 +95,12 @@ pull request: https://github.com/OpenEnergyPlatform/ontology/pull/1923",
         <http://purl.obolibrary.org/obo/IAO_0000116>
     
     
+AnnotationProperty: OEO_00020434
+
+    Annotations: 
+        rdfs:label "has associated axiom(sparql)"@en
+    
+    
 AnnotationProperty: OEO_00040001
 
     Annotations: 


Reviews:
user: login: madbkr
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-03T09:41:20Z
user: login: madbkr
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-03T09:49:41Z
user: login: madbkr
body: That one range needs to be changed and then there is the known issue with the import. Everything else looks fine.
state: CHANGES_REQUESTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-03T09:54:56Z
user: login: madbkr
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T11:07:55Z

Review comments:
path: src/ontology/edits/oeo-shared.omn
user: login: madbkr
body: As none of these seam to have a definition I assume this doesn't need one either.
created_at: 2025-03-03T09:41:20Z
author_association: CONTRIBUTOR
diff_hunk: @@ -287,6 +299,134 @@ ObjectProperty: OEO_00020189
 ObjectProperty: OEO_00020190
 
     
+ObjectProperty: OEO_00020432
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "SELECT ?scenariobundle ?energycarrier WHERE {
+?scenariobundle IAO:0000136 _:1.
+_:1 OEO:00000523 ?energycarrier.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario bundle and an energy carrier that is covered by the study the scenario bundle is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio bundle' to 'energy carrier'. The original relation 'covers energy carrier' relates 'study' (process) to 'energy carrier'. 
+The shortcut relation should be used to represents these statements:
+('scenario bundle 'is about' some 'scenario study'`) and ('scenario study' 'covers energy carrier' some 'energy carrier')",
+        rdfs:label "covers energy carrier (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00020227
+    
+    Range: 
+        OEO_00020039
+    
+    
+ObjectProperty: OEO_00020436
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "select ?scenariofactsheet ?dataset where {
+?scenariofactsheet IAO:0000136 _:1.
+_:2 OEO:00020226 _:1.
+_:2 OEO_00140094 ?dataset.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario factsheet and a dataset, where the dataset is an output of the scenario projection process the scenario factsheet is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio factsheet' to 'data set'. The original relation 'has information output' relates 'scenario projection' (process) to 'data set'. 
+The shortcut relation should be used to represents these statements:
+('scenario factsheet' 'is about' some scenario) and
+('scenario projection' 'is based on' some scenario) and
+('scenario projection' 'has information output' some dataset)",
+        rdfs:label "has information output (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00000365
+    
+    Range: 
+        <http://purl.obolibrary.org/obo/IAO_0000100>
+    
+    
+ObjectProperty: OEO_00020437
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "select ?scenariofactsheet ?dataset where {
+?scenariofactsheet IAO:0000136 _:1.
+_:2 OEO:00020226 _:1.
+_:2 OEO_00140093 ?dataset.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio factsheet' to 'data set'. The original relation 'has information input' relates 'scenario projection' (process) to 'data set'. 
+The shortcut relation should be used to represents these statements:
+('scenario factsheet' 'is about' some scenario) and
+('scenario projection' 'is based on' some scenario) and
+('scenario projection' 'has information input' some dataset)",
+        rdfs:label "has information input (shortcut)"@en,
+        <https://www.commoncoreontologies.org/ont00001754> "A relation between a scenario factsheet and a dataset, where the dataset is an input to the scenario projection process the scenario factsheet is about. It is a shortcut relation, see elucidation and associated sparql axiom."
+    
+    Domain: 
+        OEO_00000365
+    
+    Range: 
+        <http://purl.obolibrary.org/obo/IAO_0000100>
+    
+    
+ObjectProperty: OEO_00020438
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "SELECT ?scenariobundle ?technology WHERE {
+?scenariobundle IAO:0000136 _:1.
+_:1 OEO:00390101 ?technology.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario bundle and a technology that is covered by the study the scenario bundle is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio bundle' to 'technology'. The original relation 'covers technology' relates 'study' (process) to 'technology'. 
+The shortcut relation should be used to represents these statements:
+('scenario bundle 'is about' some 'scenario study'`) and ('scenario study' 'covers technology' some 'technology')",
+        rdfs:label "covers technology (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00020227
+    
+    Range: 
+        OEO_00000407
+    
+    
+ObjectProperty: OEO_00020439
+
+    Annotations: 
+        OEO_00020426 "issue: https://github.com/OpenEnergyPlatform/ontology/issues/2013
+pull request: https://github.com/OpenEnergyPlatform/ontology/pull/2023",
+        OEO_00020434 "SELECT ?scenariobundle ?sector WHERE {
+?scenariobundle IAO:0000136 _:1.
+_:1 OEO:00000505 ?sector.
+}",
+        <http://purl.obolibrary.org/obo/IAO_0000115> "A relation between a scenario bundle and a sector that is covered by the study the scenario bundle is about. It is a shortcut relation, see elucidation and associated sparql axiom.",
+        <http://purl.obolibrary.org/obo/IAO_0000600> "This is a shortcut relation to relate 'scenatio bundle' to 'sector'. The original relation 'covers sector' relates 'study' (process) to 'sector'. 
+The shortcut relation should be used to represents these statements:
+('scenario bundle 'is about' some 'scenario study'`) and ('scenario study' 'covers sector' some 'sector')",
+        rdfs:label "covers sector (shortcut)"@en
+    
+    SubPropertyOf: 
+        owl:topObjectProperty
+    
+    Domain: 
+        OEO_00020227
+    
+    Range: 
+        OEO_00000407
path: src/ontology/edits/oeo-shared-axioms.omn
user: login: madbkr
body: ```suggestion
        OEO_00000367
```

This is technology and should be sector.
created_at: 2025-03-03T09:49:40Z
author_association: CONTRIBUTOR

PR comments:
user: login: stap-m
created_at: 2025-02-28T11:11:20Z
body: @madbkr FYI: I label the shortcuts for "input" and "output" `has information input/output (shortcut)`, since the relations will shortcut  `has information input/output`.
author_association: CONTRIBUTOR
user: login: madbkr
created_at: 2025-03-03T09:38:59Z
body: It seems like the problem with the import is still in this branch - I can't open any submodule in Protege. I assume this needs to be fixed before merging.
author_association: CONTRIBUTOR
user: login: stap-m
created_at: 2025-03-03T11:42:33Z
body: > That one range needs to be changed and then there is the known issue with the import. Everything else looks fine.

The import issue is solved in another PR.
author_association: CONTRIBUTOR