HAWK 1.2 beta Release

Readme file for version 1.2 beta

SWAT Lab, Lehigh University

Overview

HAWK is a repository framework and toolkit that supports OWL. It provides APIs as well as implementations for parsing, editing, manipulating and preservation of OWL ontologies. The design philosophy of HAWK is to separate the generic interfaces and various underlying implementations. Thus, different applications can reuse HAWK and tailor it into the specific domain. For example, an ontology editor may use the in-memory storage model to create an ontology model and serialize it into a physical document, while a knowledge base system may use the database based model to preserve and query the ontologies and instance data. The architecture of HAWK consists of three packages: core, owl and storage. The core package defines the generic interfaces of the data structures of ontology and ontology objects, e.g. class and property. The core package, that is independent of underlying model the application will use, provides an API for constructing and manipulating ontology models. The owl package provides the utilities for parsing and serializing ontologies in OWL language. Again, no assumptions are made as to which storage model will be used. The storage package then supplies the actual data structures in different types, but they all share the same interfaces defined in core package. Moreover, the simpleMeomory package within the storage provides an in-memory implementation of the data model for ontologies.

This HAWK toolkit includes a number of components:

OWL-RDF parser
OWL-RDF writer
Storage models, both memory based and database based
Query API
Support for inference with DIG-interfaced reasoners

Contacts

Zhengxiang Pan

Installation

unzip the distribution file into a convenient directory, HAWKROOT.
set the class path to include:
```
  HAWKROOT/lib/hawk.jar
```

Getting started with HAWK

Read HAWK's javadoc.

For the core java OWL API, the key package to look at is edu.lehigh.swat.hawk.core. This package defines all of the key interfaces which the different implementations conform to.

In this version, HAWK provides the following storage models:

edu.lehigh.swat.hawk.storage.simplememory - simple memory based model

edu.lehigh.swat.hawk.storage.dlmemory - memory based model with inference capability (need a DIG-interfaced reasoner, such as RACER)

edu.lehigh.swat.hawk.storage.simpledb - simple database based model (currently works on Microsoft Access, but can work on any RDBMS that support standard SQL with minor changes)

edu.lehigh.swat.hawk.storage.dldb - database based model with inference capability

Note: When you use dlmemory or dldb storage model, the reasoner should be started before the running of HAWK. You may want to download RACER.

Sample code: read in an ontology to a simple memory storage model.


import edu.lehigh.swat.hawk.core.*;

import edu.lehigh.swat.hawk.owl.OwlRdfReader;

import edu.lehigh.swat.hawk.storage.simplememory.SimpleMemoryStorage;

...

...


    String url = args[0]; 

    String xmlBase = args[1]; 

    SimpleMemoryStorage storage = new SimpleMemoryStorage(); 

    OwlRdfReader reader = new OwlRdfReader(storage); 

    Document doc = reader.read(url);  

    if(doc instanceof Ontology){  

    	......

    }

License

HAWK is distributed under a GNU General PublicLicense.

It includes software developed by the Apache Software Foundation. (http://www.apache.org/)

Acknowledgements

HAWK is built on top of other sub-systems which we gratefully acknowledge:

Jena
DIG