Skip to content
ignazio1977 edited this page Jul 27, 2013 · 15 revisions

Javadoc

Javadoc for the API is available online and included in the distribution.

HOWTO

In order to use the API in your own applications, you should download the latest binary release and ensure that all of the jar files are in the application classpath.

Alternatively, use a Maven dependency (this example is for 3.4.5) <dependency> <groupId>net.sourceforge.owlapi</groupId> <artifactId>owlapi-distribution</artifactId> <version>3.4.5</version> </dependency>

Java version: 6 or newer.

The latest OWL API requires Java 6 or newer. It has been compiled and tested on Oracle JDK 7. If you find it not working on any JRE 6 or newer, please let us know in the bug section.

Build your own

If you want to check out the source code and build the binaries yourself, you can either use ANT (build file is in the antbuild folder) or Maven. Maven is the build system currently used for official builds, and it includes OSGI compatibility in the builds (experimental feature).

Programming with the OWL API

The central point of access is the OWLOntologyManager, which is used to load, create and access ontologies. The examples below show how to create an instance of this class and how to use it.

Code examples

  1. How to load an ontology.
  2. How to save an ontology.
  3. How to obtain references to entities (classes, properties, individuals etc.).
  4. How to work with data types and other data ranges.
  5. How to work with user defined data ranges (e.g. int > 10).
  6. How to work with string, data values and language tags.
  7. How to create an empty ontology, add axioms and save.
  8. How to specify that an individual is an instance of a class.
  9. How to specify that two individuals are related to each other.
  10. How to add an object property assertion (triple) to an ontology.
  11. How to delete entities (classes, properties and individuals) from an ontology.
  12. How to create restrictions and ''add them to classes'' as superclasses.
  13. How to create an ontology and add some rules.
  14. How to interact with a reasoner.
  15. How to collect the properties that are used in restrictions on a given class.
  16. How to work with annotations such as labels and comments.
  17. How to save *inferred axioms into a new ontology, or back into an existing ontology.
  18. How two (or more) ontologies can be merged in a simple way.
  19. How to 'walk' over the asserted structure of an ontology.
  20. How to use OWLOntologyIRIMapper to redirect loading and loading of imports.
  21. How to extract a locality based module from an ontology.

More Code Examples

Simple Hierarchy

This example shows how we can calculate and display a basic ontology hierarchy. The example makes use of an OWLReasoner to calculate the class hierarchy, then navigates the structure obtained, printing out basic information for each of the classes. The example uses a StructuralReasoner, which returns information about the hierarchy based solely on the assertions that are made in the ontology.

Rendering example

This example shows the definition of a simple renderer. The renderer provided an HTML page describing the entities in the ontology.

Closure Axioms

This example illustrates manipulation of axioms in an ontology.

Debugging

This example illustrates the use of the debugger. The debugger identifies axioms causing inconsistencies in OWL ontologies.