Difference between revisions of "OWLViz"

From Protege Wiki
Jump to: navigation, search
(added installation info for Protege 5.5.0)
 
(13 intermediate revisions by 6 users not shown)
Line 6: Line 6:
 
|HomepageURL=http://www.co-ode.org/downloads/plugins-3.x.php
 
|HomepageURL=http://www.co-ode.org/downloads/plugins-3.x.php
 
|DeveloperID1=Matthew Horridge
 
|DeveloperID1=Matthew Horridge
|DeveloperID2=Timothy Redmond
 
 
|LastUpdated=March 4, 2010
 
|LastUpdated=March 4, 2010
 
|Topic1=Visualization
 
|Topic1=Visualization
|License=Lesser GNU Public License
+
|License=LGPL
 
|Affiliation1=The University Of Manchester
 
|Affiliation1=The University Of Manchester
 
|Affiliation2=The CO-ODE Project
 
|Affiliation2=The CO-ODE Project
Line 22: Line 21:
 
OWLViz is bundled with the [http://protege.stanford.edu/download/download.html "full" installation of Protege].  After you have installed Protege, there are two additional steps you need to perform for this plugin to work properly:
 
OWLViz is bundled with the [http://protege.stanford.edu/download/download.html "full" installation of Protege].  After you have installed Protege, there are two additional steps you need to perform for this plugin to work properly:
  
* [http://www.graphviz.org Download and install] a recent version of Graphviz, which is a free, open source graph visualization software from AT&T Research. <span style="color: red">Mac users please see Troubleshooting below.</span>
+
* [https://www.graphviz.org/download/ Download and install] a recent version of Graphviz, which is a free, open source graph visualization software from AT&T Research.
  
 
* Protege will make an educated guess about where to find graphviz depending on your operating system, but if it does not get it right you will need to configure this yourself:
 
* Protege will make an educated guess about where to find graphviz depending on your operating system, but if it does not get it right you will need to configure this yourself:
 +
 +
** '''Protege 5.5.0 (and onwards)''' these settings are in the Preferences menu -> OWLViz. On MacOSX, install graphviz using Homebrew or Macport as suggested on the [https://www.graphviz.org/download/ GraphViz donwload page]. Then, no additional configuration is necessary, as graphviz (i.e., the ''dot'' executable) is installed in the default location where OWLViz will be able to find it.
 +
 +
** '''Protege4.x (build 105 onwards)''' these settings have moved into the OWLViz preferences panel. Again, specify the path to the dot executable in the appropriate place.
  
 
** '''Protege3.x''' and '''Protege4.0 (pre build 105)''' on the OWLViz tab, click the Options button to bring up the Options dialog. On the Layout Options panel, specify the path to the location of the DOT executable (dot.exe).  The Options dialog will look something like the following, after performing this step:
 
** '''Protege3.x''' and '''Protege4.0 (pre build 105)''' on the OWLViz tab, click the Options button to bring up the Options dialog. On the Layout Options panel, specify the path to the location of the DOT executable (dot.exe).  The Options dialog will look something like the following, after performing this step:
  
** '''Protege4.x (build 105 onwards)''' these settings have moved into the OWLViz preferences panel. Again, specify the path to the dot executable in the appropriate place.
+
 
 +
 
 +
 
  
  
Line 61: Line 66:
  
 
Instructions for doing both of these things is located above in the [[OWLViz#Installation|Installation]] section.
 
Instructions for doing both of these things is located above in the [[OWLViz#Installation|Installation]] section.
 
==== Mac users - finding the right version of Graphviz ====
 
 
The current status of Graphviz for the Mac OS is very unclear.
 
 
The latest binaries they point to directly (the pixelglow implementation) no longer contain the dot application required by OWLViz. According to their [http://www.graphviz.org/Download..php download page] this distribution is out of date and not maintained.
 
 
Install version 2.14 from [http://www.ryandesign.com/graphviz/ one of their alternatives] and point to that instead (it gets installed in '''/usr/local/graphviz-2.14/'''). This contains the necessary binaries in the bin/ folder.
 
 
<br /><br />
 
<br /><br />
 
</div>
 
</div>

Latest revision as of 15:46, March 29, 2019

OWLViz

by Matthew Horridge

Screenshot

Type Tab Widget
Author(s) Matthew Horridge
Last Update March 4, 2010
License LGPL
Homepage OWLViz website
For Application
Topic(s)
Affiliation

Enables class hierarchies in an OWL ontology to be viewed and incrementally navigated, allowing comparison of the asserted class hierarchy and the inferred class hierarchy.

Versions & Compatibility

This section lists available versions of OWLViz.

VersionCompatible withDependencies
OWLViz 5.0.3Protege 5.0.0
OWLViz 4.1.2Protege-OWL 4.3
Protege-OWL 4.2
Graphviz
OWLViz 4.1.1Protege-OWL 4.2
Protege-OWL 4.1
Graphviz
OWLViz 3.0Protege-OWL 3.4.4
Protege Client-Server 3.4.4
Graphviz

If you click on the button below to add a new version of OWLViz, you will be asked to define a page title for the new version. Please adhere to the naming convention of OWLViz X.X.X when you define the new page!

Changelog

VersionChanges in this version
OWLViz 5.0.3see page for more details
OWLViz 4.1.2Bug fix to allow OWLViz to work with Graphviz 2.30
OWLViz 4.1.1Recompiled to work with Protege 4.1.
OWLViz 3.0Fix for edges not showing up when using Graphviz 2.22 or newer.


More Details

Description

OWLViz is designed to be used with the Protege-OWL editor. It enables class hierarchies in an OWL Ontology to be viewed and incrementally navigated, allowing comparison of the asserted class hierarchy and the inferred class hierarchy. OWLViz integrates with the Protege-OWL editor, using the same color scheme so that primitive and defined classes can be distinguished, computed changes to the class hierarchy may be clearly seen, and inconsistent concepts are highlighted in red. OWLViz has the facility to save both the asserted and inferred views of the class hierarchy to various concrete graphics formats including PNG, JPEG, and SVG.

Installation

OWLViz is bundled with the "full" installation of Protege. After you have installed Protege, there are two additional steps you need to perform for this plugin to work properly:

  • Download and install a recent version of Graphviz, which is a free, open source graph visualization software from AT&T Research.
  • Protege will make an educated guess about where to find graphviz depending on your operating system, but if it does not get it right you will need to configure this yourself:
    • Protege 5.5.0 (and onwards) these settings are in the Preferences menu -> OWLViz. On MacOSX, install graphviz using Homebrew or Macport as suggested on the GraphViz donwload page. Then, no additional configuration is necessary, as graphviz (i.e., the dot executable) is installed in the default location where OWLViz will be able to find it.
    • Protege4.x (build 105 onwards) these settings have moved into the OWLViz preferences panel. Again, specify the path to the dot executable in the appropriate place.
    • Protege3.x and Protege4.0 (pre build 105) on the OWLViz tab, click the Options button to bring up the Options dialog. On the Layout Options panel, specify the path to the location of the DOT executable (dot.exe). The Options dialog will look something like the following, after performing this step:




OWLViz Options dialog

Documentation

All of the OWLViz documentation is located on the CO-ODE Website. The OWLVizGuide is somewhat outdated, but still very helpful. Also, you may refer to the home pages for the OWLViz plugin for additional information:

Home page for build 17 (Protege3.x): http://www.co-ode.org/downloads/owlviz/.
Home page for build 18 (Protege4.x): http://code.google.com/p/co-ode-owl-plugins/wiki/OWLViz.

Level of Support

OWLViz build 17, which is distributed with Protege-OWL 3.3.1 is no longer under active development. If you need help with this version of OWLViz, please try posting your questions on the protege-owl mailing list, and someone from the Protege user community may be able to help you.

OWLViz build 18, which is bundled with Protege-OWL 4.0 is under active development and all comments, suggestions, and/or feature requests are appreciated! Please post questions and requests on the p4-feedback mailing list.

Troubleshooting

Resolving the "An error related to DOT..." message

Many people report the following error the first time they try to use the OWLViz plugin:


OwlViz-dot-error.jpg


This error message indicates that

a) you need to install Graphviz and/or

b) you need to tell OWLViz where you installed Graphviz.

Instructions for doing both of these things is located above in the Installation section.