05 - About the Open Energy Ontology#
Part 1 - How to become an OEO developer#
For whom is this training and what can you learn?#
This course is aimed at (energy system) researchers who
- want to understand the OEO design choices,
- want to get to know the OEO development processes,
- want to participate in ontology development and
- want to collaborate developping a powerful open-source tool to enhance data management in the energy domain under the FAIR principles.
After reading the sections of this module, you will know
- which skills are needed for OEO development,
- how the OEO development process works and
- how to participate in OEO development.
What are prerequisit skills for ontology development?#
The following skills will help you understand the OEO better and enable you to participate in its development:
- BFO basics
- Protégé and OWL basics
- GitHub and git
- OEO specific knowledge
1. BFO basics#
The OEO uses the formal structure and design principles of the Basic Formal Ontology (BFO). The more familiar you are with BFO, the better you can contribute to the development process.
This video tutorial (78 min) provides an overview and introduction to BFO. Building Ontologies with Basic Formal Ontology
The standard literature on BFO is Arp, Smith and Spear (2015): Building Ontologies with Basic Formal Ontology. If you decide to become an OEO developer, you should read this book. It is also a helpful work of reference.
2. Protégé and OWL basics#
OEO is based on the Web Ontology Language OWL and uses Manchester Syntax. Protégé is the tool used for OEO development.
To become familiar with Protégé and OWL, we recommend studying the Pizza tutorial by Micheal DeBellis, especially chapter 1 to 7. For the tutorial, as well as OEO development, you will have to install Protégé on your computer.
You can find the OWL2 and Manchester Syntax documentation here for further reading.
3. GitHub and git basics#
The documentations of the OEO development, its discussion and version control all take place on GitHub. Therefore, it is necesarry to be familiar with versioning control via git and GitHub as a platform.
- GitHub provides a helpful guide for the first steps with your GitHub account.
- There, you can also learn, how to set up git.
- An introductory tutorial on how to use git is available here.
Which OEO specific knowledge do I need?#
We published an introductory paper about the OEO in the journal Energy and AI in 2021. It provides a good overview over the domain, the structure and the workflow of OEO development.
The OEO wiki provides details on how best practice principles of ontology development are applied to OEO development: https://github.com/OpenEnergyPlatform/ontology/wiki/Best-Practice-Principles
Energy is a complex physical phenomenon and challenging to describe ontologically. We published another OEO specific paper that describes, how we decided to represent energy and energy carriers in the OEO.
- to be completed -
I have read everything - how can I join the developer team now?#
- Get in touch with us!
- We always welcome new members to the development team in our regular oeo-dev-meetings, where we discuss organizational things and content related issues.
- To participate in the OEO development and discussion process on GitHub, you need to be part of the OpenEnergyFamily organization.
- Afterwards, you can follow all instructions and explainations of the general workflow in the CONTRIBUTING.md on GitHub.
- In all discussions, whether in an online meeting or on GitHub, we follow our Code of Conduct.
About this course#
- Authors: Mirjam Stappel, Christian Hofmann, Hannah Förster, Christian Winger, Ulf Mueller
- Copyright: Otto-von-Guericke-Universität, Fraunhofer IEE, Öko-Institut, Reiner Lemoine Institut
- Contact: SIROP@iee.fraunhofer.de. License: CC BY 4.0
- Attribution: Fraunhofer IEE, Otto-von-Guericke-Universität, Öko-Institut (2023): Contribute to the OEO. Last update: 2023-05-17
- You can provide feedback to this course on github: https://github.com/OpenEnergyPlatform/academy/issues/167