A module for ontology-oriented programming in Python: load OWL 2.0 ontologies as Python objects, modify them, save to OWL XML, and perform reasoning via HermiT. It can also generate dialog boxes for editing instances.
Project description
Owlready (previously named Ontopy) is a module for ontology-oriented programming in Python 3.
Note: Owlready is deprecated in favor to the new version, Owlready2:
http://bitbucket.org/jibalamy/owlready2 (development version)
https://pypi.python.org/pypi/Owlready2 (stable version)
Owlready can:
Import and export OWL 2.0 ontologies in the OWL/XML format (other file formats are not yet supported).
Manipulates ontology classes, instances and properties transparently, as if they were normal Python objects.
Add Python methods to ontology classes.
Perform automatic classification of classes and instances, using the HermiT reasoner.
Automatically generate dialog boxes for editing ontology instances, using Editobj3.
Owlready has been created by Jean-Baptiste Lamy at the LIMICS reseach lab. It is available under the GNU LGPL licence v3. If you use Owlready in scientific works, please cite the following article:
Lamy JB. Owlready: Ontology-oriented programming in Python with automatic classification and high level constructs for biomedical ontologies. Artificial Intelligence In Medicine 2017;80C:11-28
In case of troubles, questions or comments, please use this Forum/Mailing list: http://owlready.8326.n8.nabble.com
What can I do with Owlready?
Load an ontology from a local repository, or from Internet:
>>> from owlready import *
>>> onto_path.append("/path/to/your/local/ontology/repository")
>>> onto = get_ontology("http://www.lesfleursdunormal.fr/static/_downloads/pizza_onto.owl")
>>> onto.load()
Create new classes in the ontology, possibly mixing OWL restrictions and Python methods:
>>> class NonVegetarianPizza(onto.Pizza):
... equivalent_to = [
... onto.Pizza
... & ( restriction("has_topping", SOME, onto.MeatTopping)
... | restriction("has_topping", SOME, onto.FishTopping)
... ) ]
... def eat(self): print("Beurk! I'm vegetarian!")
Access ontology class, and create new instances / individuals:
>>> onto.Pizza
pizza_onto.Pizza
>>> test_pizza = onto.Pizza("test_pizza_owl_identifier")
>>> test_pizza.has_topping = [ onto.CheeseTopping(),
... onto.TomatoTopping(),
... onto.MeatTopping () ]
Export to OWL/XML file:
>>> test_onto.save()
Perform reasoning, and classify instances and classes:
>>> test_pizza.__class__ onto.Pizza >>> # Execute HermiT and reparent instances and classes >>> onto.sync_reasoner() >>> test_pizza.__class__ onto.NonVegetarianPizza >>> test_pizza.eat() Beurk! I'm vegetarian !
For more documentation, look at the doc/ and doc/examples/ directories in the source.
Changelog
0.2
Fix sync_reasonner and Hermit call under windows (thanks Clare Grasso)
0.3
Add warnings
Accepts ontologies files that do not ends with ‘.owl’
Fix a bug when loading ontologies including concept without a ‘#’ in their IRI
0.3.1
Add link to Owlready2 and Nabble forum/mailing list
Add load_ontology_from_file()
Add unload_all_ontologies()
Remove debug file /tmp/sortie_hermit.txt
Add Artificial Intelligence In Medicine scientific article in doc and Readme
Links
Owlready on BitBucket (development repository): https://bitbucket.org/jibalamy/owlready
Owlready on PyPI (Python Package Index, stable release): https://pypi.python.org/pypi/Owlready
Documentation: http://pythonhosted.org/Owlready
Forum/Mailing list: http://owlready.8326.n8.nabble.com
Contact “Jiba” Jean-Baptiste Lamy:
<jean-baptiste.lamy *@* univ-paris13 *.* fr> LIMICS University Paris 13, Sorbonne Paris Cité Bureau 149 74 rue Marcel Cachin 93017 BOBIGNY FRANCE
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
