Initial api for working with EMMO

README.md

@@ -1,2 +1,38 @@
-# EMMO
-The European Materials Modelling Ontology
+EMMO -- The European Materials Modelling Ontology
+=================================================
+This repository contains a reference implementation of an API and a set
+some tools for working with EMMO.  The tools are written in Python3.
+
+**WARNING**: This is work in progress...
+
+
+Requirements
+------------
+* [Python3](https://www.python.org/)
+* [Owlready2](https://bitbucket.org/jibalamy/owlready2).
+  The latest revision (Oct. 13, 2017 or later) from the Mercurial repository
+  on bitbucket is needed.  Clone it with the following command:
+
+      hg clone https://bitbucket.org/jibalamy/owlready2
+
+* Java Virtual Machine (for reasoning using [HermiT](http://www.hermit-reasoner.com/))
+
+
+Installation
+------------
+First thing is to install the requirements.  Then clone the repository
+
+```bash
+git clone https://github.com/EMMC-CSA/EMMO
+```
+
+
+Quickstart
+----------
+Take a look at the tests for examples on how to use this package.  It is
+possible to run them as scripts, like:
+
+```bash
+cd EMMO/emmo/tests
+python3 test_graph.py
+```

emmo/.gitignore

@@ -0,0 +1,6 @@
+*~
+*.pyc
+*.html
+emmodoc.md
+
+__pycache__

emmo/__init__.py

@@ -0,0 +1,3 @@
+# -*- coding: utf-8 -*-
+
+from .ontology import get_ontology