-
Notifications
You must be signed in to change notification settings - Fork 23
Best Practice Principles
Based on the book Building Ontologies with Basic Formal Ontology by Robert Arp, Barry Smith and Andrew D. Spear, MIT Press 2015, some best practice principles are derived for the OpenEnergyOntology OEO. The collection is a guideline for OEO developers and reviewers to achieve and maintain a high quality of the ontology.
The OEO is an ontology of the energy system modelling domaine.
The OEO is an ontology of the energy system modelling domaine. Regarding the selection of terms, stay as close as possible to the usage of actual domain experts. The goal is to achieve maximal consensus within the relevant discipline.
...
There are already plenty of terminologies and ontologies which might be useful for the OEO. Employ them.
Provide all (nonroot) terms with definitions! ALL.
An Aristotelian definition is built like that:
'S' is a 'G' that 'Ds',
where 'S' (species) ist the term to be defined and 'G' (genus) is the direct parent term of 'S' in the ontology. 'D' (differencia) is the specification, which makes a certain member of 'G' an 'S' (difference to other children of 'G').
For example a definition for wind turbine which may be an immediate child of generator: 'A wind turbine ('S') is a generator ('G') that converts the wind's kinetic energy into electrical energy ('D').'
Use simpler terms than the term you are defining, the improve the intelligibility of the definition.
You already know what to do? Perfect, make sure that you miss no step by using checklists
Symbols used in this wiki:
🐙➔ github | 🔶➔ git | 📙➔ protégé | 📝➔ text editor | 🤖➔ robot
-
Home
- Welcome! How to participate
- Use Cases
- Best Practice Principles
- Structure of the OEO
-
Tutorials: How to...
- ...Get Involved (First Steps)
- ...Contribute
- ...Use Protégé to Change the Ontology
- ...Test the Ontology
- ...Write Competency Questions
- ...Choose a Class Type
- ...Deal with Ambiguous Terms
- ...Use Term Tracker Annotations
- ...Use the GitHub Labels
- ...Set up OwlViz for Visualisation
- ...Use Automation of Recurring Text Entries
- ...Manually Merge Terms from Other Ontologies 🤖
- ...Release a New Ontology Version
- ...Translate Into Turtle RDF
- Setup your Work Environment and Get Involved
- ...Maintain automated Workflows for GitHub Issues and PRs
- Get to Know the Workflow This sections will contain the full workflow in the future
- Tools and Utilities
- Community