Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated documentation about recommended reasoner. #229

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
3c2bcf7
Readded doc/emmodoc/pandoc-template.tex
jesper-friis Feb 28, 2021
0a64bc3
Revert "Readded doc/emmodoc/pandoc-template.tex"
jesper-friis Feb 28, 2021
b822650
Updated how the test is run
jesper-friis Feb 28, 2021
52df65b
Added C++ as an exception in test_class_label
jesper-friis Mar 1, 2021
a08d31a
Added a section about domain ontologies in the README file
jesper-friis Mar 3, 2021
2781e36
Updated ci workflow to ubuntu-20.04
jesper-friis Mar 3, 2021
6030a43
Tested to downgrade to ubuntu-16.04 in github workflow
jesper-friis Mar 3, 2021
4516e92
Trying to fix failing test
jesper-friis Mar 3, 2021
f67230a
Updated test
jesper-friis Mar 3, 2021
1dee10d
Merge pull request #169 from emmo-repo/fix-test
jesper-friis Mar 3, 2021
74af381
Merge branch 'master' into list-domain-ontologies
jesper-friis Mar 3, 2021
43d3cee
typo
francescalb Mar 3, 2021
d4bf53a
Added examples in the domain/ folder to the table.
jesper-friis Mar 3, 2021
de281a1
Merge branch 'list-domain-ontologies' of github.com:emmo-repo/EMMO in…
jesper-friis Mar 3, 2021
3e3b421
Merge pull request #170 from emmo-repo/list-domain-ontologies
jesper-friis Apr 25, 2021
a4d62a2
Merge branch 'master' into name-and-logo
jesper-friis Aug 17, 2021
4e32917
Merge pull request #176 from emmo-repo/name-and-logo
jesper-friis Aug 17, 2021
6549e25
Update README.md
jesper-friis Aug 17, 2021
41317b9
Updated list of domain ontologies
jesper-friis Aug 17, 2021
7a7630c
Corrected physical dimension of CelsiusTemperature
jesper-friis Aug 18, 2021
c795e5b
Updated name of EMMO
jesper-friis Sep 4, 2021
8dcc9ad
Merge branch 'master' of github.com:emmo-repo/EMMO
jesper-friis Sep 4, 2021
46e024e
Updated name of EMMO
jesper-friis Sep 4, 2021
9ef30fc
Fixed broken link in README
jesper-friis Nov 26, 2021
c0e42c6
Fixed issue #180 - change contacts
jesper-friis Nov 26, 2021
6f744d8
Issue #173 - corrected mispelled preflabel: AqueousSolution
jesper-friis Nov 26, 2021
47b9ed9
Added links to GPO and BCV domain ontologies
jesper-friis Jan 5, 2022
7a4b825
Added link to release table
jesper-friis May 29, 2022
0dab6ff
Updated documentation about recommended reasoner.
jesper-friis May 9, 2023
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .github/emmocheck_conf.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
test_namespace:
exceptions:
- manufacturing.EngineeredMaterial

test_quantity_dimension:
exceptions:
- emmo.ModelledQuantitativeProperty
Expand Down
8 changes: 4 additions & 4 deletions .github/pages-index.html.in
Original file line number Diff line number Diff line change
Expand Up @@ -7,21 +7,21 @@
<meta name="author" content="Jesper Friis, SINTEF">
<meta name="author" content="Adham Hashibon, Fraunhofer IWM">
<meta name="author" content="Georg Schmitz, ACCESS">
<meta name="institution" content="European Materials &#38 Modelling Council (EMMC)">
<meta name="institution" content="Elemental Multiperspective Material Council (EMMC)">
<meta name="keywords" content="EMMO, materials science, modelling, characterisation, materials, ontology">
<meta name="dcterms.date" content="${date}">
<link rel="stylesheet" type="text/css" href="css/style.css">
<link rel="icon" type="image/png" href="https://avatars1.githubusercontent.com/u/51194521?s=400&u=d9e0bbceb9a6e4901077e92b2426c8bca46b1009&v=4">
<title>Europeean Materials &#38 Modelling Ontology</title>
<title>Elemental Multiperspective Material Ontology (EMMO)</title>
</head>
<body>

<div class="header">
<img src="https://avatars1.githubusercontent.com/u/51194521?s=400&u=d9e0bbceb9a6e4901077e92b2426c8bca46b1009&v=4" class="logo" width="64" alt="EMMO">
<h1 class="logo">The Europeean Materials &#38 Modelling Ontology (EMMO)</h1>
<h1 class="logo">Elemental Multiperspective Material Ontology (EMMO)</h1>
<img src="https://i2.wp.com/emmc.info/wp-content/uploads/2018/10/emmc_logo-low.jpg?fit=1701%2C1701&ssl=1" class="emmclogo" width="64" alt="EMMC">
</div>
The European Materials Modelling Ontology (EMMO) is the result of a multidisciplinary effort within the EMMC, aimed at the development of a standard representational ontology framework based on current materials modelling and characterization knowledge. Instead of starting from general upper level concepts, as done by other ontologies, the EMMO development started from the very bottom level, using the actual picture of the physical world coming from applied sciences, and in particular from physics and material sciences.
The Elemental Multiperspective Material Ontology (EMMO) is the result of a multidisciplinary effort within the EMMC, aimed at the development of a standard representational ontology framework based on current materials modelling and characterization knowledge. Instead of starting from general upper level concepts, as done by other ontologies, the EMMO development started from the very bottom level, using the actual picture of the physical world coming from applied sciences, and in particular from physics and material sciences.
<p>
The EMMO has grown from the bottom (i.e. scientific application field) to the top (i.e. conceptualization), staying focused on the original scope while at the same time maintaining an approach as general as possible. The ontological framework has been built around concepts like elementary particles, wave-particle dualism, finiteness of space and time intervals coming from the perspective for experimental physics. The development of the middle and upper layers of the ontology has been functional to the respect of these low level concepts, to facilitate the understanding of the high level concepts to users with limited or no philosophical background.

Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/ci_emmocheck.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ on: [push]
jobs:

build:
runs-on: ubuntu-latest
runs-on: ubuntu-18.04
strategy:
max-parallel: 1
matrix:
Expand Down
34 changes: 26 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)
![CI tests](https://github.com/emmo-repo/EMMO/workflows/Check%20conventions/badge.svg)
[![GitHub release](https://img.shields.io/github/v/release/emmo-repo/emmo)](https://emmo-repo.github.io/)


# Elementary Multiperspective Material Ontology (EMMO)

Expand All @@ -13,7 +15,8 @@

## Table of content
* [About EMMO](#about-emmo)
* [Some words about the new name and logo](#some-words-about-the-new-name-and-logo)
* [Some words about the new name and logo](#some-words-about-the-new-name-and-logo)
* [Use of EMMO in domain ontologies](#use-of-emmo-in-domain-ontologies)
* [EMMO in a Nutshell](#emmo-in-a-nutshell)
* [Top Level](#top-level)
* [Middle Level](#middle-level)
Expand Down Expand Up @@ -45,6 +48,26 @@ A lot can be said about the logo:



### Use of EMMO in domain ontologies
Currently there are several domain ontologies in development that use EMMO as the top and middle level ontology.
Typically they import one of the versions of EMMO listed on [https://emmo-repo.github.io/](https://emmo-repo.github.io/).
The following table lists the public EMMO-based domain ontologies that we are aware of.
Please create an issue if you have a public domain ontology that you think should be listed here.

| Domain ontology | Link |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Battery Interface Ontology (BattINFO) | [https://github.com/BIG-MAP/BattINFO](https://github.com/BIG-MAP/BattINFO) |
| General Process Ontology (GPO) | [https://github.com/General-Process-Ontology/ontology](https://github.com/General-Process-Ontology/ontology) |
| Ontology for the Battery Value Chain (BVC) | [https://github.com/Battery-Value-Chain-Ontology/ontology](https://github.com/Battery-Value-Chain-Ontology/ontology) |
| Crystallography | [https://github.com/emmo-repo/domain-crystallography](https://github.com/emmo-repo/domain-crystallography) |
| Mechanical Testing | [https://github.com/emmo-repo/domain-mechanical-testing](https://github.com/emmo-repo/domain-mechanical-testing) |
| Microstructure domain ontology | [https://github.com/emmo-repo/domain-ontology](https://github.com/emmo-repo/domain-ontology) |
| Datamodel ontology | [https://github.com/emmo-repo/datamodel-ontology](https://github.com/emmo-repo/datamodel-ontology) |
| Mappings ontology | [https://github.com/emmo-repo/domain-mappings](https://github.com/emmo-repo/domain-mappings) |
| Atomistic and Electronic Modelling | [https://github.com/emmo-repo/domain-atomistic](https://github.com/emmo-repo/domain-atomistic) |
| EMMO example domain ontologies | [https://github.com/emmo-repo/EMMO/tree/master/domain](https://github.com/emmo-repo/EMMO/tree/master/domain) |


## EMMO in a Nutshell
The EMMO ontology is structured in shells, expressed by specific ontology fragments, that extends from fundamental concepts to the application domains, following the dependency flow.

Expand Down Expand Up @@ -114,7 +137,7 @@ The fastest way to access the EMMO is to open the ontology via Protégé via the

The EMMO hierarchy will be visible only after reasoning inference: use *ctrl-R* to start the reasoner and under the *Entities* tab, select the *Classes* subtab and *Inferred* in the scroll button.

It is recommended to use FaCT++ as reasoner. You can select it through the menu *Reasoner*. An instruction for how to install the FaCT++ plugin on Protege 5.5.0 on Windows can be found in the [doc subdirectory](doc/installing_factplusplus.md).
From EMMO 1.0.0-beta4 it is recommended to use HermiT as reasoner (distributed by default with Protege). For earlier EMMO versions is FaCT++ the recommended reasoner. You can select it through the menu *Reasoner*. An instruction for how to install the FaCT++ plugin on Protege 5.5.0 on Windows can be found in the [doc subdirectory](doc/installing_factplusplus.md).

To access EMMO from Python, we recommend [EMMO-python](https://github.com/emmo-repo/EMMO-python/).

Expand All @@ -125,13 +148,8 @@ Browsable documentation and pre-inferred versions of EMMO are available on [http
---

## Contacts:
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]
You can contact EMMO Authors via [email protected]

Gerhard Goldbeck
Goldbeck Consulting Ltd (UK)
email: [email protected]


### Acknowledgement
Expand Down
2 changes: 1 addition & 1 deletion doc/emmodoc/emmodoc-meta.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: 'Europeean Materials Modelling Ontology'
title: 'Elemental Multiperspective Material Ontology (EMMO)'
version: 1.0.0-alpha2
author:
- name: Emanuele Ghedini
Expand Down
4 changes: 4 additions & 0 deletions domain/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
Examples of how to extend EMMO in domain ontologies
===================================================
The owl files in this directory are intended as examples of how to extend EMMO in domain ontologies.
These examples are not intended to be full featured domain ontologies, but might still be useful to include or copy in actual application ontologiess.
2 changes: 1 addition & 1 deletion domain/commonmaterials.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

#################################################################
Expand Down
2 changes: 1 addition & 1 deletion domain/commonperceptual.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

#################################################################
Expand Down
2 changes: 1 addition & 1 deletion domain/domain.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

### Generated by the OWL API (version 4.5.9.2019-02-01T07:24:44Z) https://github.com/owlcs/owlapi
6 changes: 3 additions & 3 deletions emmo.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
owl:versionIRI <http://emmo.info/emmo/1.0.0-beta> ;
owl:imports <http://emmo.info/emmo/1.0.0-beta/middle> ,
<http://emmo.info/emmo/1.0.0-beta/top> ;
dcterms:abstract """European Materials & Modelling Ontology (EMMO)
dcterms:abstract """Elemental Multiperspective Material Ontology (EMMO)

EMMO is a multidisciplinary effort to develop a standard representational framework (the ontology) based on current materials modelling knowledge, including physical sciences, analytical philosophy and information and communication technologies.

Expand All @@ -31,7 +31,7 @@ EMMO is released under a Creative Commons license Attribution 4.0 International
"Jesper Friis" ;
dcterms:license "https://creativecommons.org/licenses/by/4.0/legalcode" ;
dcterms:publisher "EMMC ASBL" ;
dcterms:title "European Materials & Modelling Ontology"@en ;
dcterms:title "Elemental Multiperspective Material Ontology"@en ;
rdfs:comment """Contacts:
Gerhard Goldbeck
Goldbeck Consulting Ltd (UK)
Expand All @@ -40,7 +40,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

### Generated by the OWL API (version 4.5.9.2019-02-01T07:24:44Z) https://github.com/owlcs/owlapi
2 changes: 1 addition & 1 deletion middle/holistic.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

#################################################################
Expand Down
6 changes: 3 additions & 3 deletions middle/isq.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ University of Bologna (IT)
email: [email protected]"""@en ;
dcterms:license "https://creativecommons.org/licenses/by/4.0/legalcode" ;
owl:versionInfo "1.0.0-beta" ;
dcterms:abstract """European Materials & Modelling Ontology (EMMO)
dcterms:abstract """Elemental Multiperspective Material Ontology (EMMO)

EMMO is a multidisciplinary effort to develop a standard representational framework (the ontology) based on current materials modelling knowledge, including physical sciences, analytical philosophy and information and communication technologies.

Expand All @@ -52,7 +52,7 @@ EMMO is released under a Creative Commons license Attribution 4.0 International
dcterms:contributor "Access, DE" ;
dcterms:creator "Gerhard Goldbeck" ,
"Jesper Friis" ;
rdfs:comment "The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en .
rdfs:comment "The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en .

#################################################################
# Annotation properties
Expand Down Expand Up @@ -681,7 +681,7 @@ It defines the base unit mole in the SI system."""@en ;
:EMMO_967080e5_2f42_4eb2_a3a9_c58143e835f9 """An objective comparative measure of hot or cold.

Temperature is a relative quantity that can be used to express temperature differences. Unlike ThermodynamicTemperature, it cannot express absolute temperatures."""@en ;
:EMMO_de178b12_5d35_4bca_8efa_a4193162571d "T-1 L0 M0 I0 Θ0 N+1 J0" ;
:EMMO_de178b12_5d35_4bca_8efa_a4193162571d "T0 L0 M0 I0 Θ+1 N0 J0" ;
:EMMO_fe015383_afb3_44a6_ae86_043628697aa2 "https://doi.org/10.1351/goldbook.T06261" ;
skos:prefLabel "CelsiusTemperature"@en .

Expand Down
2 changes: 1 addition & 1 deletion middle/manufacturing.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

#################################################################
Expand Down
4 changes: 2 additions & 2 deletions middle/materials.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

#################################################################
Expand Down Expand Up @@ -313,7 +313,7 @@ e.g. you cannot remove H from H20 without changing the molecule type (essential)
:EMMO_5cb107ba_7daa_46dd_8f9f_da22a6eac676 rdf:type owl:Class ;
rdfs:subClassOf :EMMO_4b3e2374_52a1_4420_8e3f_3ae6b9bf7dff ;
:EMMO_967080e5_2f42_4eb2_a3a9_c58143e835f9 "A liquid solution in which the solvent is water."@en ;
skos:prefLabel "AcqueousSolution"@en .
skos:prefLabel "AqueousSolution"@en .


### http://emmo.info/emmo#EMMO_5d659e25_a508_43ed_903c_3707c7c7cd4b
Expand Down
2 changes: 1 addition & 1 deletion middle/math.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

#################################################################
Expand Down
2 changes: 1 addition & 1 deletion middle/metrology.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

#################################################################
Expand Down
2 changes: 1 addition & 1 deletion middle/middle.ttl
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ email: [email protected]
Emanuele Ghedini
University of Bologna (IT)
email: [email protected]"""@en ,
"The EMMO requires FacT++ reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
"The EMMO requires HermiT reasoner plugin in order to visualize all inferences and class hierarchy (ctrl+R hotkey in Protege)."@en ;
owl:versionInfo "1.0.0-beta" .

### Generated by the OWL API (version 4.5.9.2019-02-01T07:24:44Z) https://github.com/owlcs/owlapi
Loading