Difference between revisions of "OWLViz"

From Protege Wiki
Jump to: navigation, search
(fleshed out documentation)
(added installation info for Protege 5.5.0)
 
(27 intermediate revisions by 8 users not shown)
Line 1: Line 1:
 
{{Plugin
 
{{Plugin
 +
|Description=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.
 
|PluginType=Tab Widget
 
|PluginType=Tab Widget
 
|ForApplication1=Protege-OWL
 
|ForApplication1=Protege-OWL
Line 5: 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
|LastUpdated=July 26, 2007
+
|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
|Description=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.
 
 
}}
 
}}
 
 
<div style="float:left;">
 
<div style="float:left;">
 
== More Details ==
 
== More Details ==
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.
+
* [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.
* 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:
+
 
 +
* 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:
 +
 
 +
 
 +
 
 +
 
 +
 
  
 
[[Image:OwlViz-configure-path-to-dot.jpg|frame|none|OWLViz Options dialog]]
 
[[Image:OwlViz-configure-path-to-dot.jpg|frame|none|OWLViz Options dialog]]
Line 30: Line 41:
 
All of the OWLViz documentation is located on the [http://www.co-ode.org/ CO-ODE Website].  The [http://www.co-ode.org/downloads/owlviz/OWLVizGuide.pdf OWLVizGuide] is somewhat outdated, but still very helpful.  Also, you may refer to the home pages for the OWLViz plugin for additional information:
 
All of the OWLViz documentation is located on the [http://www.co-ode.org/ CO-ODE Website].  The [http://www.co-ode.org/downloads/owlviz/OWLVizGuide.pdf 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: http://www.co-ode.org/downloads/owlviz/.<br />
+
Home page for build 17 (Protege3.x): http://www.co-ode.org/downloads/owlviz/.<br />
Home page for build 18: http://www.co-ode.org/downloads/protege-x/plugins.php#owlviz.
+
Home page for build 18 (Protege4.x): http://code.google.com/p/co-ode-owl-plugins/wiki/OWLViz.
  
 
=== Level of Support ===
 
=== Level of Support ===
OWLViz build 17 is no longer under active development.  If you need help with this version of OWLViz, please try posting your questions on the [http://mailman.stanford.edu/mailman/listinfo/protege-owl protege-owl mailing list], and someone from the Protege user community may be able to help you.
+
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 [http://mailman.stanford.edu/mailman/listinfo/protege-owl protege-owl mailing list], and someone from the Protege user community may be able to help you.
  
OWLViz build 18 is under active development and all comments, suggestions, and/or feature requests are appreciated! Please post questions and requests on the [http://mailman.stanford.edu/mailman/listinfo/p4-feedback p4-feedback mailing list].
+
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 [http://mailman.stanford.edu/mailman/listinfo/p4-feedback p4-feedback mailing list].
  
 
=== Troubleshooting ===
 
=== 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:
 
Many people report the following error the first time they try to use the OWLViz plugin:
  
[[Image:OwlViz-dot-error.jpg|none]]
 
  
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.
+
[[Image: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 [[OWLViz#Installation|Installation]] section.
 
<br /><br />
 
<br /><br />
 
</div>
 
</div>

Latest revision as of 14: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.