# EMMO-python
**Repository Path**: mirrors_lepy/EMMO-python
## Basic Information
- **Project Name**: EMMO-python
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-06-12
- **Last Updated**: 2023-08-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
EMMO - Python API for the European Materials & Modelling Ontology
=================================================================
[](https://badge.fury.io/py/EMMO)
This package is based on [Owlready2] and provides an intuitive
representation of [EMMO] in Python.
It is available on [GitHub][EMMO-python] and on [PyPI][PyPI:EMMO]
under the open source [BSD 3-Clause license](LICENSE.txt).
The European Materials & Modelling Ontology (EMMO) is an ongoing
effort to create an ontology that takes into account fundamental
concepts of physics, chemistry and materials science and is designed
to pave the road for semantic interoperability. The aim of EMMO is to
be generic and provide a common ground for describing materials,
models and data that can be adapted by all domains.
EMMO is formulated using OWL. EMMO-python is a Python API for using
EMMO to solving real problems. By using the excellent Python package
[Owlready2], EMMO-python provides a natural representation of
EMMO in Python. On top of that EMMO-python provides:
- Access by label (as well as by names, important since class and
property names in EMMO are based on UUIDs).
- Test suite for EMMO-based ontologies.
- Generation of graphs.
- Generation of documentation.
- Command-line tools:
- [emmocheck](docs/tools-instructions.md#emmocheck):
checks an ontology against EMMO conventions
- [ontoversion](docs/tools-instructions.md#ontoversion):
prints ontology version number
- [ontograph](docs/tools-instructions.md#ontograph):
vertasile tool for visualising (parts of) an ontology
- [ontodoc](docs/tools-instructions.md#ontodoc):
documents an ontology
- [ontoconvert](docs/tools-instructions.md#ontoconvert):
converts between ontology formats
Some examples of what you can do with EMMO-python includes:
- Access and query EMMO-based ontologies from your application.
- Extend EMMO with new domain or application ontologies. This can
be done both statically with easy readable Python code or
dynamically within your application.
- Generate graphs and documentation of your ontologies. EMMO-python
includes `ontodoc`, which is a dedicated command line tool for this.
You find it in the [tools/](tools) sub directory.
- Check that a EMMO-based domain or application ontology ahead to the
conventions of EMMO.
- Interactively explore an ontology in e.g. [IPython]. Tab completion
makes exploration easy and fast. Below is an example of an IPython
session where we check the relations of `Matter`:
```python
In [1]: from emmo import get_ontology
In [2]: emmo = get_ontology()
In [3]: emmo.load()
Out[3]: get_ontology("http://emmo.info/emmo/emmo-inferred#")
In [4]: emmo.Matter
Out[4]: physicalistic.Matter
In [5]: emmo.Matter.is_a
Out[5]:
[physicalistic.Physicalistic,
physical.Physical,
mereotopology.hasPart.some(physicalistic.Massive),
physical.hasTemporalPart.only(physicalistic.Matter)]
```
Documentation and examples
--------------------------
The [Owlready2 documentation][Owlready2-doc] is a good starting point.
In addition EMMO-python includes a few examples and demos:
- [demo/vertical](demo/vertical/README.md) shows an example of
how EMMO may be used to achieve vertical interoperability.
The file [define-ontology.py](demo/vertical/define-ontology.py)
provides a good example for how an EMMO-based application ontology
can be defined in Python.
- [demo/horizontal](demo/horizontal/README.md) shows an example of
shows an example of how EMMO may be used to achieve horizontal
interoperability. This demo also shows how you can use
EMMO-python to represent your ontology with the low-level metadata
framework [DLite]. In addition to achieve interoperability, as
shown in the demo, DLite also allow you to automatically generate
C or Fortran code base on your ontology.
- [examples/emmodoc](examples/emmodoc/README.md) shows how the
documentation of EMMO is generated using the `ontodoc` tool.
Installation
------------
Install with
pip install EMMO
### Required Dependencies
* [Python] 3.6 or later
* [Owlready2] v0.23 or later
### Optional Dependencies
* [Graphviz]: Needed for graph generation. With support for generation
pdf, png and svg figures for tests and generation of documentation
automatically (ontodoc).
* [pandoc]: Only used for generated documentation from markdown to
nicely formatted html or pdf. Tested with v2.1.2.
* [pdfLaTeX] or [XeLaTeX] and the `upgreek` latex
package (included in `texlive-was` on RetHat-based distributions
and `texlive-latex-extra` on Ubuntu) for generation of pdf
documentation. If your ontology contain exotic unicode characters, we
recommend XeLaTeX.
* Java. Needed for reasoning.
* Optional Python packages
- [graphviz]: Generation of documentation and graphs.
- [PyYAML]: Required for generating documentation with pandoc.
- [blessings]: Clean output for emmocheck
- [Pygments]: Coloured output for emmocheck
- [rdflib]: Required for ontoversion-tool
- [semver]: Required for ontoversion-tool
- [pydot]: Used for generating graphs. Will be deprecated.
See [docs/docker-instructions.md](#docs/docker-instructions.md)
for how to build a docker image.
Known issues
------------
* **Invalid serialising to turtle:** Due to rdflib issue
[#1043](https://github.com/RDFLib/rdflib/issues/1043) ontoconvert
may produce invalid turtle output (if your ontology contains real
literals using scientific notation without a dot in the mantissa).
This issue was fixed after the release of rdflib 5.0.0. Hence,
install rdflib from [github
master](https://github.com/RDFLib/rdflib) if you need to serialise
to turtle.
Attributions and credits
------------------------
EMMO-python is maintained by [EMMC-ASBL](https://emmc.eu/). So far it has mainly been developed by
[SINTEF](https://www.sintef.no/).
### Contributing projects
- [EMMC-CSA](https://emmc.info/about-emmc-csa/);
Grant Agreement No: 723867
- [MarketPlace](https://www.the-marketplace-project.eu/);
Grant Agreement No: 760173
- [OntoTrans](https://ontotrans.eu/project/);
Grant Agreement No: 862136
- [BIG-MAP](https://www.big-map.eu/);
Grant Agreement No: 957189
[EMMO-python]: https://github.com/emmo-repo/EMMO-python/
[EMMO-pypi]: https://pypi.org/project/EMMO/
[Owlready2]: https://pypi.org/project/Owlready2/
[Owlready2-doc]: https://pythonhosted.org/Owlready2/
[EMMO]: https://github.com/emmo-repo/EMMO/
[EMMO-python]: https://github.com/emmo-repo/EMMO-python/
[PyPI:EMMO]: https://pypi.org/project/EMMO/
[Python]: https://www.python.org/
[IPython]: https://ipython.org/
[DLite]: https://github.com/SINTEF/dlite/
[pydot]: https://pypi.org/project/pydot/
[Graphviz]: https://www.graphviz.org/
[pandoc]: http://pandoc.org/
[XeLaTeX]: https://www.overleaf.com/learn/latex/XeLaTeX/
[pdfLaTeX]: https://www.latex-project.org/
[graphviz]: https://pypi.org/project/
[PyYAML]: https://pypi.org/project/PyYAML/
[blessings]: https://pypi.org/project/blessings/
[Pygments]: https://pypi.org/project/Pygments/
[semver]: https://pypi.org/project/semver/
[rdflib]: https://pypi.org/project/rdflib/