Skip to content
/ ontoseer Public

OntoSeer is a tool to help users build better quality ontologies

License

Notifications You must be signed in to change notification settings

kracr/ontoseer

Repository files navigation

Ontoseer

This document provides documentation for the first version of OntoSeer.OntoSeer is a tool that monitors the ontology development process andprovides suggestions in real time to improve the quality of the ontology under development.

Table of Contents

  1. Introduction.

  2. Pre-Requisites.

  3. Installation Guide.

    3.1 Using Source Code

    3.2 Downloading .jar files

  4. User Manual.

    4.1 ODP Recommendation

    4.2 Vocab and Alternate Name Recommendation

    4.3 Naming Convention Recommendation

    4.4 Axiom Recommendation

    4.5 Class Hierarchy Validation

  5. Future Work.

  6. Sustainibility

  7. Google Form for User Study

1. Introduction

While building an ontology, there are several things to consider such as reusing concepts/properties from the existing ontologies, using ontology design patterns (ODPs), following the naming conventions for concepts/properties and designing a good class hierarchy. These are issues that beginner ontology engineers find hard and can be tricky for experienced ones as well. OntoSeer (https://github.com/kracr/ontoseer) is a Protege plugin that overlooks the ontology that is being built in Protege and offers different types of recommendations.

2.Prerequisites

  1. User should have Protege installed in the machine. Version should be >5.0.0.

    If one is not having protege or protege5.0.0 or higher installed they can download latest version of protege from https://protege.stanford.edu/products.php based on machine’s operating system:

  2. JRE should be installed in user machine and version should be >1.8.

3.Installation Guide

In this section we will discuss how one can download OntoSeer.

3.1 Using Source Code

This repository contains code for OntoSeer (versions 5.0.0 and higher). The Maven POM file in the top-level directory demonstrates all the dependencies to run the tool

Prerequisites

To build and run Ontoseer through code compilation , one must have the following items installed:

  • Apache's Maven.
  • A tool for checking out a Git repository.
  • A Protege distribution (5.0.0 or higher). The Protege 5.2.0 release is available from the main Protege website.

Installation Steps:

  1. Get a copy of the example code:

    git clone https://github.com/kracr/ontoseer

  2. Change into the OntoSeer directory.

  3. Type mvn clean package. On build completion, the "target" directory will contain a OntoSeer-${version}.jar file.

  4. Copy the JAR file from the target directory to the "plugins" folder.

    4.1.1 Click on the "plugins" folder subdirectory of your Protege distribution (for linux/windows). OntoSeer_jar_plugin

    4.1.2 Click on the "plugins" folder after "Show Package Contents" option in right click option on Protege application (for mac). OntoSeer_jar_plugin

    4.2 Copy OntoSeer.jar in the plugin folder. OntoSeer_jar_plugin_folder

  5. Restart Protege.

  6. Go to about Section of Protege and check whether the plugin has been correctly installed or not .It will be shown in the window.

OntoSeer_jar_plugin_About

  1. Click on Windows. Click on Tabs .Click on OntoSeer Tab.This window will appear.

OntoSeer_jar_plugin_Actual_Tab

3.2 Downloading .jar files

  1. One can download Ontoseer.jar file from the following link:

    https://github.com/kracr/ontoseer/releases

OntoSeer jar

The link to download the code repository and instruction manual is :

https://github.com/kracr/ontoseer
  1. Click on Assets->Ontoseer.jar

OntoSeer jar The jar file will get downloaded.

  1. Copy the jar file to the plugins folder of Protege.

    3.1.1 Click on the "plugins" folder subdirectory of your Protege distribution (for linux/windows). OntoSeer_jar_plugin

    3.1.2 Click on the "plugins" folder after "Show Package Contents" option in right click option on Protege application (for mac). OntoSeer_jar_plugin

    3.2 Copy OntoSeer.jar in the plugin folder. OntoSeer_jar_plugin_folder

  2. Restart Protege.

  3. Go to about Section of Protege and check whether the plugin has been correctly installed or not .It will be shown in the window.

OntoSeer_jar_plugin_About

  1. Click on Windows. Click on Tabs .Click on OntoSeer Tab.This window will appear.

OntoSeer_jar_plugin_Actual_Tab Now Start Building your Ontology.

For tutorial on ontology building one can refer to the Protege tutorial. This can be found in the following link:

https://cgi.csc.liv.ac.uk/~frank/teaching/comp08/protege_tutorial.pdf .

For more information for using OntoSeer please go through OntoSeer_Manual.pdf file present in master branch of OntoSeer.

4.User Manual

This section discusses how OntoSeer can be used along with Protege to get various recommendations.

  1. Click On OntoSeer tab button. This window will be shown.

Plugin Window

4.1 ODP Recommendation

  1. Click On ODP recommendation button. Two classes must be present for getting ODP recommendation. This window will be shown.

OntoSeer ODP

  1. Enter description of the ontology that one is trying to make .Alternatively domain name,name of class and properties one want to make or can additively provide with the competency questions.One can provide additional comments also. But one have to make sure that they are actually making at least two classes to get recommendation. But the recommendation will get better if one provide answer to as many questions as one can.

  2. Get Recommendation. The recommendation is based on the data that we have scraped from 223 ODPs that we collected from http://ontologydesignpatterns.org/wiki/Community:ListPatterns

OntoSeer_jar_ODP_reco_show

4.2 Vocab and Alternate Name Recommendation

  1. One should start buliding classes and properties in Protege .For example:- OntoSeer_jar_Vocab
  2. Click on VocabRecommendation button.
  3. Select the class or property for which you want the recommendations.Recommendations will be provided based on query results from LOV,Bioportal and our indexed files. 4.Get the recommendations. OntoSeer_jar_Vocab_reco_show

4.3 Naming Convention Recommendation

  1. One should start buliding classes and properties in Protege .For example:-

  2. Click on the NamingRecommendation button.

OntoSeer_jar_Name

  1. Select the class or property for which you want the recommendations.

  2. Get the class recommendations.

OntoSeer_jar_Name_reco_show

  1. Get the property recommendations.

OntoSeer_jar_Name_reco_show

4.4 Axiom Recommendation

  1. Start building the ontologies .

  2. Click on Axiom Recommendation button .

OntoSeer_jar_Name

  1. Select the class or property for which you want the recommendations.

  2. Get the recommendations.

Axiom Recommendation

4.5 Class Hierarchy Validation

Class hierarch validation actually validates the correctness of a subclass hierarchy based on properties like rigidity, identitiy and unity of the classes.

  1. Click on Class Hierarchy Validation button . OntoSeer_jar_Name

  2. Answer the questions in (Y/N) format. Answer to all the questions are mandatory to velidate the hierarchy.

  3. Validate the Hierarchy Class Hierarchy

5.Future Work

As part of future work, we plan to engage in a dialogue with the ontology developer to resolve confusing issues such as having some term as a class vs.property vs. instance. This confusion will be resolved by asking the ontology developer a series of questions such as does the term interact with other concepts, are the terms very specific or general, if a term is made into a class, what will be its instances?

6.Sustainability Plan

In the process of building OntoSeer, we have been able to collect only a few owl corpora and index them. The end-user can add other corpora according to their suitability by downloading them; OntoSeer will index them.

7.Google Form for User Study

Please find the link of Google form for user study here. Please give inputs so that we can make the tool better. https://docs.google.com/forms/d/1TlYaGaQYB2ewwAJbcIZDxXz2APyngvsvSbMRmizbf94/edit?usp=sharing