GLOW Visualization - User contributions [en]

Main Page

2015-10-28T20:43:35Z

Walter:

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies with many relations, leading to visual clutter and inefficient use of space.

In our paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data, such as concept structures formed by `subclass-of' and `type-of' relations. The displayed adjacency relations can be selected from an ontology using a set of common configurations, allowing for intuitive discovery of information.

We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor. Our evaluation demonstrates that the GLOW visualization provides better visual clarity, and displays relations and complex ontologies better than the existing Protégé visualization plug-in Jambalaya.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/fhogenboom/ Frederik Hogenboom]
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

This page hosted by [http://slik.eu/ Slik Internetbureau Rotterdam]

Main Page

2015-10-28T20:43:27Z

Walter:

<div style="float:right; padding-left: 20px"> <iframe width="420" height="315" src="https://www.youtube.com/embed/aydEb0g55eg" frameborder="0" allowfullscreen></iframe> </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies with many relations, leading to visual clutter and inefficient use of space.

In our paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data, such as concept structures formed by `subclass-of' and `type-of' relations. The displayed adjacency relations can be selected from an ontology using a set of common configurations, allowing for intuitive discovery of information.

We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor. Our evaluation demonstrates that the GLOW visualization provides better visual clarity, and displays relations and complex ontologies better than the existing Protégé visualization plug-in Jambalaya.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/fhogenboom/ Frederik Hogenboom]
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

This page hosted by [http://slik.eu/ Slik Internetbureau Rotterdam]

Main Page

2013-08-16T09:44:38Z

Walter:

<div style="float:right; padding-left: 20px"> {{#ev:youtube|aydEb0g55eg|320|240}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies with many relations, leading to visual clutter and inefficient use of space.

In our paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data, such as concept structures formed by `subclass-of' and `type-of' relations. The displayed adjacency relations can be selected from an ontology using a set of common configurations, allowing for intuitive discovery of information.

We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor. Our evaluation demonstrates that the GLOW visualization provides better visual clarity, and displays relations and complex ontologies better than the existing Protégé visualization plug-in Jambalaya.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/fhogenboom/ Frederik Hogenboom]
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Main Page

2012-03-18T15:21:22Z

Walter: YT url update

<div style="float:right; padding-left: 20px"> {{#ev:youtube|srMcyKQ8m3A|320|240}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies with many relations, leading to visual clutter and inefficient use of space.

In our paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data, such as concept structures formed by `subclass-of' and `type-of' relations. The displayed adjacency relations can be selected from an ontology using a set of common configurations, allowing for intuitive discovery of information.

We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor. Our evaluation demonstrates that the GLOW visualization provides better visual clarity, and displays relations and complex ontologies better than the existing Protégé visualization plug-in Jambalaya.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/fhogenboom/ Frederik Hogenboom]
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Main Page

2011-10-18T09:28:12Z

Walter: /* Authors */

<div style="float:right; padding-left: 20px"> {{#ev:youtube|e0f3VGGfsg0|320|240}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies with many relations, leading to visual clutter and inefficient use of space.

In our paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data, such as concept structures formed by `subclass-of' and `type-of' relations. The displayed adjacency relations can be selected from an ontology using a set of common configurations, allowing for intuitive discovery of information.

We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor. Our evaluation demonstrates that the GLOW visualization provides better visual clarity, and displays relations and complex ontologies better than the existing Protégé visualization plug-in Jambalaya.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/fhogenboom/ Frederik Hogenboom]
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Building in Eclipse

2011-05-26T10:23:04Z

Walter: /* org.glowvis.protege */

==Install Eclipse==

Any modern Eclipse release can be used; it can be downloaded from http://www.eclipse.org/

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

First, see [[dependencies for building GLOW]] and install all the dependencies.

While GLOW will run on JDK 1.6, it is advised to compile using JDK 1.5. This ensures that the same class libs are available that are bundled with Protege. To add the JDK 1.5 to Eclipse, do the following:
* Preferences > Java > Installed JREs > Add...
** JRE home: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
** JRE name: J2SE 1.5.0
** Finish

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

This project requires Log4j, so do the following:
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Java Build Path
** Add JARs, expand the "org.protege.common" bundle, and select the log4j .jar file.

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T19:57:12Z

Walter: /* Install Eclipse */

==Install Eclipse==

Any modern Eclipse release can be used; it can be downloaded from http://www.eclipse.org/

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

First, see [[dependencies for building GLOW]] and install all the dependencies.

While GLOW will run on JDK 1.6, it is advised to compile using JDK 1.5. This ensures that the same class libs are available that are bundled with Protege. To add the JDK 1.5 to Eclipse, do the following:
* Preferences > Java > Installed JREs > Add...
** JRE home: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
** JRE name: J2SE 1.5.0
** Finish

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T19:56:42Z

Walter: /* Install the necessary software and libraries */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

First, see [[dependencies for building GLOW]] and install all the dependencies.

While GLOW will run on JDK 1.6, it is advised to compile using JDK 1.5. This ensures that the same class libs are available that are bundled with Protege. To add the JDK 1.5 to Eclipse, do the following:
* Preferences > Java > Installed JREs > Add...
** JRE home: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
** JRE name: J2SE 1.5.0
** Finish

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Dependencies for building GLOW

2011-05-17T19:55:59Z

Walter: /* Get the JDK */

To build GLOW, the following software and libraries are needed.

===Get the JDK===
Get a Java JDK for your system. For development, JDK 1.5 is recommended. To simply use GLOW, a higher version works too.

* Snow Leopard includes JDK 1.6, but it is possible to install the old JDK using this [http://chxor.chxo.com/post/183013153/installing-java-1-5-on-snow-leopard JDK 1.5 tutorial].
* Other systems: http://java.sun.com/javase/downloads/index.jsp

===Get Apache Ant===
Mac OS X includes Ant; for other platforms:

* URL: http://ant.apache.org/
* Put Ant's <tt>bin</tt> directory in the system's PATH, so that typing 'ant' from the command line starts Ant.

===Get Protege 4.0.x===
* URL: http://protege.stanford.edu/download/download.html
* Install it, for example: C:\Program Files\Protege
* Verify that Protege starts up correctly.

===Get Prefuse beta===
* URL: http://prefuse.org/download/
* Download Prefuse-beta (release 2007.10.21) source zip
* Unpack it, for example: C:\Program Files\prefuse-beta
* Doublecheck: sources should now be in: C:\Program Files\prefuse-beta\src\prefuse
* Build it:
** Go to the prefuse-beta directory
** Patch the build.xml script in order to make it cross-compile to JDK 1.5 class files. Add the following attributes to <tt>javac</tt> tags (two times): <tt>source="1.5" target="1.5"</tt>.
** Run the 'build' script, e.g. build.sh or build.bat. This script requires Ant.
* Doublecheck: the follwing directory should now have been created: C:\Program Files\prefuse-beta\build\

===Get JOGL===
* URL: http://kenai.com/projects/jogl/pages/Home
* Download URL: http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/
* Currently using 2.0-beta10
* Unpack it, for example: C:\Program Files\JOGL
* Doublecheck: lots of jar files should now be in: C:\Program Files\JOGL\lib
* Put its 'lib' folder in the system PATH environment variable, e.g.: C:\Program Files\JOGL\lib

===Get a version of GLOW===
* URL: http://www.glowvis.org/latest/
* Save the .jar files to your Protege 'plugins' directory, e.g. C:\Program Files\Protege\plugins
* Verify that Protege starts up correctly and that the GLOW visualization can be selected under Views -> Class Views

Dependencies for building GLOW

2011-05-17T19:55:19Z

Walter: /* Get the JDK */

To build GLOW, the following software and libraries are needed.

===Get the JDK===
Get a Java JDK for your system. JDK 1.5 is the lowest version supported.
* URL: http://java.sun.com/javase/downloads/index.jsp
* Snow Leopard includes JDK 1.6, but it is possible to install the old JDK using this [http://chxor.chxo.com/post/183013153/installing-java-1-5-on-snow-leopard JDK 1.5 tutorial].

===Get Apache Ant===
Mac OS X includes Ant; for other platforms:

* URL: http://ant.apache.org/
* Put Ant's <tt>bin</tt> directory in the system's PATH, so that typing 'ant' from the command line starts Ant.

===Get Protege 4.0.x===
* URL: http://protege.stanford.edu/download/download.html
* Install it, for example: C:\Program Files\Protege
* Verify that Protege starts up correctly.

===Get Prefuse beta===
* URL: http://prefuse.org/download/
* Download Prefuse-beta (release 2007.10.21) source zip
* Unpack it, for example: C:\Program Files\prefuse-beta
* Doublecheck: sources should now be in: C:\Program Files\prefuse-beta\src\prefuse
* Build it:
** Go to the prefuse-beta directory
** Patch the build.xml script in order to make it cross-compile to JDK 1.5 class files. Add the following attributes to <tt>javac</tt> tags (two times): <tt>source="1.5" target="1.5"</tt>.
** Run the 'build' script, e.g. build.sh or build.bat. This script requires Ant.
* Doublecheck: the follwing directory should now have been created: C:\Program Files\prefuse-beta\build\

===Get JOGL===
* URL: http://kenai.com/projects/jogl/pages/Home
* Download URL: http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/
* Currently using 2.0-beta10
* Unpack it, for example: C:\Program Files\JOGL
* Doublecheck: lots of jar files should now be in: C:\Program Files\JOGL\lib
* Put its 'lib' folder in the system PATH environment variable, e.g.: C:\Program Files\JOGL\lib

===Get a version of GLOW===
* URL: http://www.glowvis.org/latest/
* Save the .jar files to your Protege 'plugins' directory, e.g. C:\Program Files\Protege\plugins
* Verify that Protege starts up correctly and that the GLOW visualization can be selected under Views -> Class Views

Building in Eclipse

2011-05-17T19:54:14Z

Walter: /* Install the necessary software and libraries */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

First, see [[dependencies for building GLOW]] and install all the dependencies.

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Dependencies for building GLOW

2011-05-17T19:53:49Z

Walter: /* Get Apache Ant */

To build GLOW, the following software and libraries are needed.

===Get the JDK===
* Get a Java JDK for your system. JDK 1.5 is the lowest version supported.
* URL: http://java.sun.com/javase/downloads/index.jsp

===Get Apache Ant===
Mac OS X includes Ant; for other platforms:

* URL: http://ant.apache.org/
* Put Ant's <tt>bin</tt> directory in the system's PATH, so that typing 'ant' from the command line starts Ant.

===Get Protege 4.0.x===
* URL: http://protege.stanford.edu/download/download.html
* Install it, for example: C:\Program Files\Protege
* Verify that Protege starts up correctly.

===Get Prefuse beta===
* URL: http://prefuse.org/download/
* Download Prefuse-beta (release 2007.10.21) source zip
* Unpack it, for example: C:\Program Files\prefuse-beta
* Doublecheck: sources should now be in: C:\Program Files\prefuse-beta\src\prefuse
* Build it:
** Go to the prefuse-beta directory
** Patch the build.xml script in order to make it cross-compile to JDK 1.5 class files. Add the following attributes to <tt>javac</tt> tags (two times): <tt>source="1.5" target="1.5"</tt>.
** Run the 'build' script, e.g. build.sh or build.bat. This script requires Ant.
* Doublecheck: the follwing directory should now have been created: C:\Program Files\prefuse-beta\build\

===Get JOGL===
* URL: http://kenai.com/projects/jogl/pages/Home
* Download URL: http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/
* Currently using 2.0-beta10
* Unpack it, for example: C:\Program Files\JOGL
* Doublecheck: lots of jar files should now be in: C:\Program Files\JOGL\lib
* Put its 'lib' folder in the system PATH environment variable, e.g.: C:\Program Files\JOGL\lib

===Get a version of GLOW===
* URL: http://www.glowvis.org/latest/
* Save the .jar files to your Protege 'plugins' directory, e.g. C:\Program Files\Protege\plugins
* Verify that Protege starts up correctly and that the GLOW visualization can be selected under Views -> Class Views

Dependencies for building GLOW

2011-05-17T19:53:21Z

Walter: /* Get Prefuse beta */

To build GLOW, the following software and libraries are needed.

===Get the JDK===
* Get a Java JDK for your system. JDK 1.5 is the lowest version supported.
* URL: http://java.sun.com/javase/downloads/index.jsp

===Get Apache Ant===
* URL: http://ant.apache.org/
* Put Ant's <tt>bin</tt> directory in the system's PATH, so that typing 'ant' from the command line starts Ant.

===Get Protege 4.0.x===
* URL: http://protege.stanford.edu/download/download.html
* Install it, for example: C:\Program Files\Protege
* Verify that Protege starts up correctly.

===Get Prefuse beta===
* URL: http://prefuse.org/download/
* Download Prefuse-beta (release 2007.10.21) source zip
* Unpack it, for example: C:\Program Files\prefuse-beta
* Doublecheck: sources should now be in: C:\Program Files\prefuse-beta\src\prefuse
* Build it:
** Go to the prefuse-beta directory
** Patch the build.xml script in order to make it cross-compile to JDK 1.5 class files. Add the following attributes to <tt>javac</tt> tags (two times): <tt>source="1.5" target="1.5"</tt>.
** Run the 'build' script, e.g. build.sh or build.bat. This script requires Ant.
* Doublecheck: the follwing directory should now have been created: C:\Program Files\prefuse-beta\build\

===Get JOGL===
* URL: http://kenai.com/projects/jogl/pages/Home
* Download URL: http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/
* Currently using 2.0-beta10
* Unpack it, for example: C:\Program Files\JOGL
* Doublecheck: lots of jar files should now be in: C:\Program Files\JOGL\lib
* Put its 'lib' folder in the system PATH environment variable, e.g.: C:\Program Files\JOGL\lib

===Get a version of GLOW===
* URL: http://www.glowvis.org/latest/
* Save the .jar files to your Protege 'plugins' directory, e.g. C:\Program Files\Protege\plugins
* Verify that Protege starts up correctly and that the GLOW visualization can be selected under Views -> Class Views

Building in Eclipse

2011-05-17T19:52:51Z

Walter: /* Install the necessary software and libraries */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

First, see [[dependencies for building GLOW]] and install all the dependencies.

While GLOW will run on JDK 1.6, it is advised to compile using JDK 1.5. This ensures that the same class libs are available that are bundled with Protege. Install a JDK 1.5 ([http://chxor.chxo.com/post/183013153/installing-java-1-5-on-snow-leopard OS X tutorial]), then add it to Eclipse:
* Eclipse > Preferences > Java > Installed JREs > Add...
** JRE home: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
** JRE name: J2SE 1.5.0
** Finish

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T19:52:34Z

Walter: /* Install the necessary software and libraries */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

While GLOW will run on JDK 1.6, it is advised to compile using JDK 1.5. This ensures that the same class libs are available that are bundled with Protege. Install a JDK 1.5 ([http://chxor.chxo.com/post/183013153/installing-java-1-5-on-snow-leopard OS X tutorial]), then add it to Eclipse:
* Eclipse > Preferences > Java > Installed JREs > Add...
** JRE home: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
** JRE name: J2SE 1.5.0
** Finish

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T19:51:10Z

Walter: /* Install the necessary software and libraries */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

To build with a JDK 1.5 on Mac OS X, first install J2SE 1.5 ([http://chxor.chxo.com/post/183013153/installing-java-1-5-on-snow-leopard tutorial]), then add it to Eclipse:
* Eclipse > Preferences > Java > Installed JREs > Add...
** JRE home: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
** JRE name: J2SE 1.5.0
** Finish

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T19:40:33Z

Walter: /* Create the projects */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Execution Environment: J2SE-1.5
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

JOGL

2011-05-17T18:17:38Z

Walter:

'''JOGL''' is a library that allows Java programs to use advanced OpenGL graphics capabilities. The newest version is currently still in development, but is already very stable for general use.

Since there are no easy installers yet, we provide installers for Windows here:

* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-i586.exe JOGL 2.0b10 for Windows 32 bit]
* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-amd64.exe JOGL 2.0b10 for Windows 64 bit]

'' '''Note:''' The architecture (32 bit or 64 bit) should match the Java JVM you are using for Protégé!''

After installation of the libraries, reboot your system.

For other platforms, choose one of the [http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/ JOGL downloads]. If you only want to build JOGL OSGI's rather than run GLOW, and your platform is not listed, you can usually pick the Linux version.

Installation instructions

2011-05-17T18:17:24Z

Walter: /* Install JOGL 2.0 */

==Install Java==
GLOW requires Java (JDK version 1.5 or higher).

Protégé comes bundled with Java. If you don't have Java, you can download a Protégé version including VM and skip this step.

<blockquote>
Do you want to know if you have Java 1.5? Open a command prompt and type <tt>java -version</tt>. The version should read at least <tt>"1.5.0"</tt>. To install or update your Java installation, download and run the Java installer at the [http://java.com/en/download/index.jsp Java download site].
</blockquote>

==Install Protégé 4.0==
'''Protégé''' is an ontology editor. GLOW runs as a plug-in for Protégé. Only Protégé 4.0.x is supported at this point.

Download a Protégé 4.0.x installer here:
* [http://protege.stanford.edu/download/download.html Protégé download site]

==Install JOGL 2.0==


'''JOGL''' is a library that allows Java programs to use advanced OpenGL graphics capabilities. The newest version is currently still in development, but is already very stable for general use.

Since there are no easy installers yet, we provide installers for Windows here:

* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-i586.exe JOGL 2.0b10 for Windows 32 bit]
* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-amd64.exe JOGL 2.0b10 for Windows 64 bit]

'' '''Note:''' The architecture (32 bit or 64 bit) should match the Java JVM you are using for Protégé!''

After installation of the libraries, reboot your system.

For other platforms, choose one of the [http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/ JOGL downloads]. If you only want to build JOGL OSGI's rather than run GLOW, and your platform is not listed, you can usually pick the Linux version.

==Install GLOW==
Download and run the GLOW installer:

* [http://www.glowvis.org/download/glowvis-1.0.exe GLOW for Windows]

For other platforms, see the [http://www.glowvis.org/download/snapshot/ latest snapshot] and place the JAR files in Protégé's <tt>plugins</tt> directory. Protégé will detect them automatically.

==Open GLOW in Protégé==
You should now be able to run the GLOW plug-in from Protégé.

* Start Protégé.
* Open an ontology of your choice.
* Go to the '''Classes''' tab.
* Go to the '''View | Class Views''' menu and choose '''GLOW Visualization'''.
* Choose a position for the visualization window, for instance on the bottom right.

Note: please check here for [[Running GLOW on Unix]] systems, such as Mac OS X, Linux and FreeBSD.

Installation instructions

2011-05-17T16:52:07Z

Walter: /* Install Java 6 */

==Install Java==
GLOW requires Java (JDK version 1.5 or higher).

Protégé comes bundled with Java. If you don't have Java, you can download a Protégé version including VM and skip this step.

<blockquote>
Do you want to know if you have Java 1.5? Open a command prompt and type <tt>java -version</tt>. The version should read at least <tt>"1.5.0"</tt>. To install or update your Java installation, download and run the Java installer at the [http://java.com/en/download/index.jsp Java download site].
</blockquote>

==Install Protégé 4.0==
'''Protégé''' is an ontology editor. GLOW runs as a plug-in for Protégé. Only Protégé 4.0.x is supported at this point.

Download a Protégé 4.0.x installer here:
* [http://protege.stanford.edu/download/download.html Protégé download site]

==Install JOGL 2.0==


'''JOGL''' is a library that allows Java programs to use advanced OpenGL graphics capabilities. The newest version is currently still in development, but is already very stable for general use.

Since there are no easy installers yet, we provide installers for Windows here:

* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-i586.exe JOGL 2.0b10 for Windows 32 bit]
* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-amd64.exe JOGL 2.0b10 for Windows 64 bit]

'' '''Note:''' The architecture (32 bit or 64 bit) should match the Java JVM you are using for Protégé!''

After installation of the libraries, reboot your system.

For other platforms, choose one of the [http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/ JOGL downloads].

==Install GLOW==
Download and run the GLOW installer:

* [http://www.glowvis.org/download/glowvis-1.0.exe GLOW for Windows]

For other platforms, see the [http://www.glowvis.org/download/snapshot/ latest snapshot] and place the JAR files in Protégé's <tt>plugins</tt> directory. Protégé will detect them automatically.

==Open GLOW in Protégé==
You should now be able to run the GLOW plug-in from Protégé.

* Start Protégé.
* Open an ontology of your choice.
* Go to the '''Classes''' tab.
* Go to the '''View | Class Views''' menu and choose '''GLOW Visualization'''.
* Choose a position for the visualization window, for instance on the bottom right.

Note: please check here for [[Running GLOW on Unix]] systems, such as Mac OS X, Linux and FreeBSD.

Installation instructions

2011-05-17T16:50:30Z

Walter: /* Install Protégé 4.0 */

==Install Java 6==
GLOW requires Java (JDK version 1.5 or higher).

Protégé comes bundled with Java. If you don't have Java, you can download a Protégé version including VM and skip this step.

Do you want to know if you have Java 1.5? Open a command prompt and type <tt>java -version</tt>. The version should read at least <tt>"1.5.0"</tt>.

To install or update your Java installation, download and run the Java installer:
* [http://java.com/en/download/index.jsp Java download site]

==Install Protégé 4.0==
'''Protégé''' is an ontology editor. GLOW runs as a plug-in for Protégé. Only Protégé 4.0.x is supported at this point.

Download a Protégé 4.0.x installer here:
* [http://protege.stanford.edu/download/download.html Protégé download site]

==Install JOGL 2.0==


'''JOGL''' is a library that allows Java programs to use advanced OpenGL graphics capabilities. The newest version is currently still in development, but is already very stable for general use.

Since there are no easy installers yet, we provide installers for Windows here:

* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-i586.exe JOGL 2.0b10 for Windows 32 bit]
* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-amd64.exe JOGL 2.0b10 for Windows 64 bit]

'' '''Note:''' The architecture (32 bit or 64 bit) should match the Java JVM you are using for Protégé!''

After installation of the libraries, reboot your system.

For other platforms, choose one of the [http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/ JOGL downloads].

==Install GLOW==
Download and run the GLOW installer:

* [http://www.glowvis.org/download/glowvis-1.0.exe GLOW for Windows]

For other platforms, see the [http://www.glowvis.org/download/snapshot/ latest snapshot] and place the JAR files in Protégé's <tt>plugins</tt> directory. Protégé will detect them automatically.

==Open GLOW in Protégé==
You should now be able to run the GLOW plug-in from Protégé.

* Start Protégé.
* Open an ontology of your choice.
* Go to the '''Classes''' tab.
* Go to the '''View | Class Views''' menu and choose '''GLOW Visualization'''.
* Choose a position for the visualization window, for instance on the bottom right.

Note: please check here for [[Running GLOW on Unix]] systems, such as Mac OS X, Linux and FreeBSD.

Installation instructions

2011-05-17T16:50:14Z

Walter: /* Install Java 6 */

==Install Java 6==
GLOW requires Java (JDK version 1.5 or higher).

Protégé comes bundled with Java. If you don't have Java, you can download a Protégé version including VM and skip this step.

Do you want to know if you have Java 1.5? Open a command prompt and type <tt>java -version</tt>. The version should read at least <tt>"1.5.0"</tt>.

To install or update your Java installation, download and run the Java installer:
* [http://java.com/en/download/index.jsp Java download site]

==Install Protégé 4.0==
'''Protégé''' is an ontology editor. GLOW runs as a plug-in for Protégé. Only Protégé 4.0.x is supported at this point.

Download a Protégé 4.0.x installer ''without'' a Java VM (you should already have Java 1.6 installed by now) and install it on your system:
* [http://protege.stanford.edu/download/download.html Protégé download site]

==Install JOGL 2.0==


'''JOGL''' is a library that allows Java programs to use advanced OpenGL graphics capabilities. The newest version is currently still in development, but is already very stable for general use.

Since there are no easy installers yet, we provide installers for Windows here:

* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-i586.exe JOGL 2.0b10 for Windows 32 bit]
* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-amd64.exe JOGL 2.0b10 for Windows 64 bit]

'' '''Note:''' The architecture (32 bit or 64 bit) should match the Java JVM you are using for Protégé!''

After installation of the libraries, reboot your system.

For other platforms, choose one of the [http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/ JOGL downloads].

==Install GLOW==
Download and run the GLOW installer:

* [http://www.glowvis.org/download/glowvis-1.0.exe GLOW for Windows]

For other platforms, see the [http://www.glowvis.org/download/snapshot/ latest snapshot] and place the JAR files in Protégé's <tt>plugins</tt> directory. Protégé will detect them automatically.

==Open GLOW in Protégé==
You should now be able to run the GLOW plug-in from Protégé.

* Start Protégé.
* Open an ontology of your choice.
* Go to the '''Classes''' tab.
* Go to the '''View | Class Views''' menu and choose '''GLOW Visualization'''.
* Choose a position for the visualization window, for instance on the bottom right.

Note: please check here for [[Running GLOW on Unix]] systems, such as Mac OS X, Linux and FreeBSD.

Installation instructions

2011-05-17T16:47:30Z

Walter: /* Install Java 6 */

==Install Java 6==
GLOW requires Java (JDK version 1.5 or higher).

Do you want to know if you have Java 1.5? Open a command prompt and type <tt>java -version</tt>. The version should read at least <tt>"1.5.0"</tt>.

To install or update your Java installation, download and run the Java installer:
* [http://java.com/en/download/index.jsp Java download site]

==Install Protégé 4.0==
'''Protégé''' is an ontology editor. GLOW runs as a plug-in for Protégé. Only Protégé 4.0.x is supported at this point.

Download a Protégé 4.0.x installer ''without'' a Java VM (you should already have Java 1.6 installed by now) and install it on your system:
* [http://protege.stanford.edu/download/download.html Protégé download site]

==Install JOGL 2.0==


'''JOGL''' is a library that allows Java programs to use advanced OpenGL graphics capabilities. The newest version is currently still in development, but is already very stable for general use.

Since there are no easy installers yet, we provide installers for Windows here:

* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-i586.exe JOGL 2.0b10 for Windows 32 bit]
* [http://www.glowvis.org/download/jogl-installer/jogl-installer-2.0b10-amd64.exe JOGL 2.0b10 for Windows 64 bit]

'' '''Note:''' The architecture (32 bit or 64 bit) should match the Java JVM you are using for Protégé!''

After installation of the libraries, reboot your system.

For other platforms, choose one of the [http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/ JOGL downloads].

==Install GLOW==
Download and run the GLOW installer:

* [http://www.glowvis.org/download/glowvis-1.0.exe GLOW for Windows]

For other platforms, see the [http://www.glowvis.org/download/snapshot/ latest snapshot] and place the JAR files in Protégé's <tt>plugins</tt> directory. Protégé will detect them automatically.

==Open GLOW in Protégé==
You should now be able to run the GLOW plug-in from Protégé.

* Start Protégé.
* Open an ontology of your choice.
* Go to the '''Classes''' tab.
* Go to the '''View | Class Views''' menu and choose '''GLOW Visualization'''.
* Choose a position for the visualization window, for instance on the bottom right.

Note: please check here for [[Running GLOW on Unix]] systems, such as Mac OS X, Linux and FreeBSD.

Dependencies for building GLOW

2011-05-17T16:47:00Z

Walter: /* Get JDK 1.6 */

To build GLOW, the following software and libraries are needed.

===Get the JDK===
* Get a Java JDK for your system. JDK 1.5 is the lowest version supported.
* URL: http://java.sun.com/javase/downloads/index.jsp

===Get Apache Ant===
* URL: http://ant.apache.org/
* Put Ant's <tt>bin</tt> directory in the system's PATH, so that typing 'ant' from the command line starts Ant.

===Get Protege 4.0.x===
* URL: http://protege.stanford.edu/download/download.html
* Install it, for example: C:\Program Files\Protege
* Verify that Protege starts up correctly.

===Get Prefuse beta===
* URL: http://prefuse.org/download/
* Download Prefuse-beta (release 2007.10.21) source zip
* Unpack it, for example: C:\Program Files\prefuse-beta
* Doublecheck: sources should now be in: C:\Program Files\prefuse-beta\src\prefuse
* Build it:
** Go to the prefuse-beta directory
** Patch the build.xml script in order to make it cross-compile to JDK 1.5 class files. Add the following attributes to <tt>javac</tt> tags (two times): <tt>source="1.5" target="1.5"</tt>.
** Run one of the 'build' scripts. These scripts require Ant.
* Doublecheck: the follwing directory should now be created: C:\Program Files\prefuse-beta\build\

===Get JOGL===
* URL: http://kenai.com/projects/jogl/pages/Home
* Download URL: http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/
* Currently using 2.0-beta10
* Unpack it, for example: C:\Program Files\JOGL
* Doublecheck: lots of jar files should now be in: C:\Program Files\JOGL\lib
* Put its 'lib' folder in the system PATH environment variable, e.g.: C:\Program Files\JOGL\lib

===Get a version of GLOW===
* URL: http://www.glowvis.org/latest/
* Save the .jar files to your Protege 'plugins' directory, e.g. C:\Program Files\Protege\plugins
* Verify that Protege starts up correctly and that the GLOW visualization can be selected under Views -> Class Views

Dependencies for building GLOW

2011-05-17T16:46:23Z

Walter: /* Get Prefuse beta */ JDK 1.5

To build GLOW, the following software and libraries are needed.

===Get JDK 1.6===
* Get a JDK for your system. JDK 1.6 is the lowest version supported.
* URL: http://java.sun.com/javase/downloads/index.jsp

===Get Apache Ant===
* URL: http://ant.apache.org/
* Put Ant's <tt>bin</tt> directory in the system's PATH, so that typing 'ant' from the command line starts Ant.

===Get Protege 4.0.x===
* URL: http://protege.stanford.edu/download/download.html
* Install it, for example: C:\Program Files\Protege
* Verify that Protege starts up correctly.

===Get Prefuse beta===
* URL: http://prefuse.org/download/
* Download Prefuse-beta (release 2007.10.21) source zip
* Unpack it, for example: C:\Program Files\prefuse-beta
* Doublecheck: sources should now be in: C:\Program Files\prefuse-beta\src\prefuse
* Build it:
** Go to the prefuse-beta directory
** Patch the build.xml script in order to make it cross-compile to JDK 1.5 class files. Add the following attributes to <tt>javac</tt> tags (two times): <tt>source="1.5" target="1.5"</tt>.
** Run one of the 'build' scripts. These scripts require Ant.
* Doublecheck: the follwing directory should now be created: C:\Program Files\prefuse-beta\build\

===Get JOGL===
* URL: http://kenai.com/projects/jogl/pages/Home
* Download URL: http://download.java.net/media/jogl/builds/archive/jsr-231-2.0-beta10/
* Currently using 2.0-beta10
* Unpack it, for example: C:\Program Files\JOGL
* Doublecheck: lots of jar files should now be in: C:\Program Files\JOGL\lib
* Put its 'lib' folder in the system PATH environment variable, e.g.: C:\Program Files\JOGL\lib

===Get a version of GLOW===
* URL: http://www.glowvis.org/latest/
* Save the .jar files to your Protege 'plugins' directory, e.g. C:\Program Files\Protege\plugins
* Verify that Protege starts up correctly and that the GLOW visualization can be selected under Views -> Class Views

Building in Eclipse

2011-05-17T14:56:02Z

Walter: /* Install Eclipse */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T14:52:18Z

Walter: /* org.glowvis.protege */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

'''Unix/Mac OS X only:''' The linker must know where the JOGL native libraries (.so files) are.
* In the Package Explorer, rightclick on the project "org.glowvis.protege" and choose Properties
** Click: Run/Debug Settings.
** Go to the "Environment" tab.
** Add a "New" environment variable.
*** Name: <tt>LD_LIBRARY_PATH</tt> (for Unix) or <tt>DYLD_LIBRARY_PATH</tt> (for OS X)
*** Value: <tt>/path/to/JOGL/lib</tt>, e.g. /Applications/JOGL/lib or /usr/local/jogl/lib

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T14:05:39Z

Walter: /* Install Eclipse */

==Install Eclipse==

Any vanilla Eclipse can be used.

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T13:39:38Z

Walter: /* Run the Protege plug-in from Eclipse */

==Install Eclipse==

Any vanilla Eclipse can be used (version used: 20090920-1017)

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer; select "Properties" from the pop-up menu.
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T13:39:08Z

Walter: /* org.glowvis */

==Install Eclipse==

Any vanilla Eclipse can be used (version used: 20090920-1017)

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.owlapi===

"org.glowvis.owlapi" contains an adapter between OWLAPI and GLOW.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.owlapi
* Location: checkout_dir\dev\org.glowvis.owlapi (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW OWLAPI plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T13:38:27Z

Walter: /* org.glowvis.protege */

==Install Eclipse==

Any vanilla Eclipse can be used (version used: 20090920-1017)

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Location: checkout_dir\dev\org.glowvis.protege (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "Overview" tab. Select the checkbox "This plug-in is a singleton".

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T13:36:47Z

Walter: /* Create the projects */

==Install Eclipse==

Any vanilla Eclipse can be used (version used: 20090920-1017)

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse at the bottom of this file. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T13:35:07Z

Walter: /* Import necessary OSGI bundles as dependencies */

==Install Eclipse==

Any vanilla Eclipse can be used (version used: 20090920-1017)

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

===Import Protege plug-ins===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\plugins
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor.owl
** org.semanticweb.owl.owlapi
** jogl-osgi
** prefuse-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse here. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse here. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Building in Eclipse

2011-05-17T12:38:45Z

Walter: /* Install Eclipse */

==Install Eclipse==

Any vanilla Eclipse can be used (version used: 20090920-1017)

Add the "plugin development" package:
* Help -> Install new software
** Work with: select the current Eclipse release codename, e.g. Galileo, Helios (depending on installed Eclipse version)
*** General Purpose Tools
**** Eclipse Plug-in Development Environment

==Install the necessary software and libraries==

See [[dependencies for building GLOW]].

==Make a new Eclipse workbench==

* Check out the repository in e.g. a dir 'glow'
* File -> Switch Workbench -> Other... -> Create a new Eclipse workbench in glow/workspace

==Import necessary OSGI bundles as dependencies==

===Import Protege's own plug-ins===

You need this to develop Protege plugins. If you 'run' a plug-in project, Eclipse will start Protege. For more info, see [http://protegewiki.stanford.edu/index.php/CompileProtege4InEclipse].

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.editor
** org.semanticweb.owl.owlapi
** jogl-osgi
* Finish

NOTE:
* Remove 'org.glowvis' and 'org.glowvis.protege' plug-ins if they are present. We want to use them as real source projects and not as dependencies, because they are expected to change a lot.

===Import Protege core bundles===

File -> Import -> Plug-in Development -> Plug-ins and Fragments

* Directory: C:\Program Files\Protege\bundles
* Plug-ins and Fragments to Import: Select from all plug-ins
* Import as: binary projects
* Next
* Select:
** org.protege.common
** org.protege.editor.core.application
* Finish

==Create the projects==

===org.glowvis===

"org.glowvis" is the main library.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis
* Location: checkout_dir\dev\org.glowvis (browse to the checked-out source directory)
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse here. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in overview (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin

===org.glowvis.protege===

"org.glowvis.protege" contains the Protege plugin.

Go to: File -> New Project -> Plug-in Development -> Plug-in Project

First page:
* Project name: org.glowvis.protege
* Target Platform: an OSGi framework: Equinox
* Next

Second page:
* Version: 1.0.0.qualifier
* Name: GLOW Protege plugin
* Don't generate activators
* Next

Third page:
* Don't use templates
* Finish

In the plug-in overview (main screen), go to the "build.properties" tab. Add your paths to Protege, JOGL, and Prefuse here. On Windows, make sure that backslashes are escaped.
Example:
prefuse.home=C:\\Program Files\\prefuse-beta
jogl.home=C:\\Program Files\\JOGL
protege.home=C:\\Program Files\\Protege

Configure building. In the plug-in view (main screen), go to the "Build" tab.
* Binary Build: select the following items and deselect the others:
** META-INF
** bin
** plugin.xml

==Run the Protege plug-in from Eclipse==

Open the org.glowvis.protege project.

Go to: Run -> Run (Ctrl-F11)
* Choose 'OSGi Framework'
* This should start Protege.

If the plug-in does not work and you receive an error message about 64 bit vs 32 bit architecture, it might be that Eclipse is using a JVM that does not match the installed JOGL libraries. In this case:

* Right click on the 'org.glowvis.protege' project in the Package Explorer
* go to Run/Debug Settings
* go to the Settings tab
* choose the correct JRE here, for example, a 64 bit JRE; if Eclipse does not know it, add it.

==Build the plug-ins==

* Right click on a project (e.g., 'org.glowvis.protege') in the Package Explorer
* Export
* Deployable plug-ins and fragments
* This produces a single .jar file for the component, which you can place in your Protege plugins directory (e.g., C:\Program Files\Protege\Plugins)

Troubleshooting

2010-06-24T19:39:15Z

Walter:

This page contains some common mistakes/problems and their solutions.<br /> If your issue is not listed here, see the [[known issues]] page.

==Could not start bundle org.glowvis ... Missing Constraint: Bundle Required Execution Environment: JavaSE-1.6==
GLOW requires Java 6 (JRE 1.6). First install a new version of Java 6 on your system. Then, download a version of Protégé that does not include a Java VM. The full procedure is covered in the [[installation instructions]].

==UnsatisfiedLinkError: no nativewindow_jvm in java.library.path==
If you receive this error, it means that the JOGL libraries (<tt>.dll</tt> or <tt>.so</tt> files) could not be found.

* Windows: Please install the [[JOGL]] installer, and reboot your system afterwards.
* Mac OS X, Unix: Please see [[Running GLOW on Unix]] for how to start Protégé properly.

==No such method: org.semanticweb.owl.model.OWLPropertyAxiom.getAxiomType()==
You are likely using a version of Protégé that is not supported by GLOW. GLOW currently supports the ''release'' versions (not the ''alpha'' versions) of Protégé 4.0. GLOW has been tested on Protégé 4.0.1 and Protégé 4.0.2.

Known issues

2010-06-24T19:38:20Z

Walter: add an issue

{{warning|As is expected with pre-release software, there are bound to be some bugs. We will try our best to resolve them as quickly as possible. If your issue is not listed here, see the [[troubleshooting]] page.}}

==ATI Radeon HD freezes on Inverted Radial Tree layout==
Some newer ATI Radeon HD cards exhibit problems when choosing the "Inverted Radial Tree" layout. The problem causes spurious textures to be drawn, and may cause the GLOW user interface to "freeze" for seconds.

'''Workaround:''' If this problem happens, do not use the Inverted Radial Tree layout. Select another layout using the "layout" drop-down at the bottom of the plug-in. It may take some time for the interface to become responsive.

==Duplicated leaf nodes==
There is a known issue with spurious duplication of leaf nodes, if multiple inheritance exists higher up in the class hierarchy. Under a certain parent, a leaf node might appear multiple times.

'''Workaround:''' There is no workaround. When counting individuals, enable the display of labels for leaves in order to spot duplicates.

==Switching ontologies in Protégé causes instability==
From time to time, closing an ontology and opening a new ontology in Protégé causes graph drawing to stop. An error message may appear.

'''Workaround:''' Close Protégé before opening a new ontology.

==FaCT++ returns empty results==
When using FaCT++ as a reasoner, no OWL objects are returned, creating an empty graph.

'''Workaround:''' Use another reasoner, such as Pellet.

==Modifier buttons cause spurious panning==
Laptops may not have a middle/right mouse button which are used to perform zooming and rotation of the graph. ''Option'' and ''Command'' keys are modifiers that can be combined with a left-click to do zooming and rotation, but in this case, the graph pans simultaneously.

'''Workaround:''' Connect a mouse, or pan the graph back to its oroginal location using only the left mouse button, after it has been incorrectly moved.

Main Page

2010-04-11T20:56:07Z

Walter:

<div style="float:right; padding-left: 20px"> {{#ev:youtube|e0f3VGGfsg0|320|240}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies with many relations, leading to visual clutter and inefficient use of space.

In our paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data, such as concept structures formed by `subclass-of' and `type-of' relations. The displayed adjacency relations can be selected from an ontology using a set of common configurations, allowing for intuitive discovery of information.

We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor. Our evaluation demonstrates that the GLOW visualization provides better visual clarity, and displays relations and complex ontologies better than the existing Protégé visualization plug-in Jambalaya.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Main Page

2010-04-08T20:10:27Z

Walter:

<div style="float:right; padding-left: 20px"> {{#ev:youtube|e0f3VGGfsg0|320|240}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies with many relations, leading to visual clutter and inefficient use of space.

In our paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data, such as concept structures formed by `subclass-of' and `type-of' relations. The displayed adjacency relations can be selected from an ontology using a set of common configurations, allowing for intuitive discovery of information.

We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor. Our evaluation demonstrates that the GLOW visualization provides better visual clarity, and displays relations and complex ontologies better than the existing \protege visualization plug-in Jambalaya.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Main Page

2010-04-08T20:05:05Z

Walter:

<div style="float:right; padding-left: 20px"> {{#ev:youtube|e0f3VGGfsg0|320|240}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies, leading to visual clutter and ineffecient use of space.

Many ontologies contain hierarchical concept structures, such as those formed by `subclass-of' relations, as well as separate adjacency relations. In this paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data.

The displayed relations can be selected from an ontology using a set of common configurations, allowing for discovery of information. We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Main Page

2010-04-08T20:04:04Z

Walter:

<div style="float:right; padding-left: 20px"> {{#ev:youtube|e0f3VGGfsg0|300|225}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies, leading to visual clutter and ineffecient use of space. Many ontologies contain hierarchical concept structures, such as those formed by `subclass-of' relations, as well as separate adjacency relations. In this paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data. The displayed relations can be selected from an ontology using a set of common configurations, allowing for discovery of information. We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Main Page

2010-04-08T20:03:41Z

Walter:

<div style="float:right; padding-left: 20px"> {{#ev:youtube|e0f3VGGfsg0|280|210}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies, leading to visual clutter and ineffecient use of space. Many ontologies contain hierarchical concept structures, such as those formed by `subclass-of' relations, as well as separate adjacency relations. In this paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data. The displayed relations can be selected from an ontology using a set of common configurations, allowing for discovery of information. We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Main Page

2010-04-08T20:03:26Z

Walter:

<div style="float:right; padding-left: 20px"> {{#ev:youtube|e0f3VGGfsg0|260|195}} </div>

'''GLOW is a visualization for OWL ontologies, based on ''Hierarchical Edge Bundles''.'''

In the past decade, a lot of effort has been put into the visual representation of ontologies. However, present visualization strategies are not equipped to handle complex ontologies, leading to visual clutter and ineffecient use of space. Many ontologies contain hierarchical concept structures, such as those formed by `subclass-of' relations, as well as separate adjacency relations. In this paper, we propose GLOW, a method for ontology visualization based on Hierarchical Edge Bundles. Hierarchical Edge Bundles is a new visually attractive technique for displaying adjacency relations in hierarchical data. The displayed relations can be selected from an ontology using a set of common configurations, allowing for discovery of information. We have developed a visualization library based on OWL API, as well as a plug-in for Protégé, a well-known ontology editor.

<br clear="all" />

<center>
[[File:Invertedradial.png|640px]]
</center>
* [[Screenshots|More screenshots...]]

==Getting started==
* [[Downloads]] - Getting the GLOW plug-in for Protégé
* [[Documentation]] - Information, help pages, and publications
* [[Development]] - Information about developing GLOW

==Authors==
* [http://www.lifeforms.nl/ Walter Hop]
* Sven de Ridder
* [http://people.few.eur.nl/frasincar/ Flavius Frasincar]

To contact the authors, please e-mail info@glowvis.org.

Troubleshooting

2010-04-07T11:16:09Z

Walter: /* No such method: org.semanticweb.owl.model.OWLPropertyAxiom.GetAxiomType() */

{{warning|This page contains some common mistakes/problems and their solutions. If your issue is not listed here, see the [[known issues]] page.}}

==Could not start bundle org.glowvis ... Missing Constraint: Bundle Required Execution Environment: JavaSE-1.6==
GLOW requires Java 6 (JRE 1.6). First install a new version of Java 6 on your system. Then, download a version of Protégé that does not include a Java VM. The full procedure is covered in the [[installation instructions]].

==UnsatisfiedLinkError: no nativewindow_jvm in java.library.path==
If you receive this error, it means that the JOGL libraries (<tt>.dll</tt> or <tt>.so</tt> files) could not be found.

* Windows: Please install the [[JOGL]] installer, and reboot your system afterwards.
* Mac OS X, Unix: Please see [[Running GLOW on Unix]] for how to start Protégé properly.

==No such method: org.semanticweb.owl.model.OWLPropertyAxiom.getAxiomType()==
You are likely using a version of Protégé that is not supported by GLOW. GLOW currently supports the ''release'' versions (not the ''alpha'' versions) of Protégé 4.0. GLOW has been tested on Protégé 4.0.1 and Protégé 4.0.2.

Known issues

2010-04-07T11:15:48Z

Walter: /* Modifier buttons cause spurious panning */

{{warning|As is expected with pre-release software, there are bound to be some bugs. We will try our best to resolve them as quickly as possible. If your issue is not listed here, see the [[troubleshooting]] page.}}

==ATI Radeon HD problems with Inverted Radial Tree layout==
Some newer ATI Radeon HD cards exhibit problems when choosing the "Inverted Radial Tree" layout. The problem causes spurious textures to be drawn, and may cause the GLOW user interface to "freeze" for seconds.

'''Workaround:''' If this problem happens, do not use the Inverted Radial Tree layout. Select another layout using the "layout" drop-down at the bottom of the plug-in. It may take some time for the interface to become responsive.

==Duplicated leaf nodes==
There is a known issue with spurious duplication of leaf nodes, if multiple inheritance exists higher up in the class hierarchy. Under a certain parent, a leaf node might appear multiple times.

'''Workaround:''' There is no workaround. When counting individuals, enable the display of labels for leaves in order to spot duplicates.

==Modifier buttons cause spurious panning==
Laptops may not have a middle/right mouse button which are used to perform zooming and rotation of the graph. OPTION and COMMAND are modifiers that can be combined with a left-click to do zooming and rotation, but while this functions, the graph pans simultaneously.

'''Workaround:''' Connect a mouse, or pan the graph back to its oroginal location using only the left mouse button, after it has been incorrectly moved.

==FaCT++ returns empty results==
When using FaCT++ as a reasoner, no OWL objects are returned, creating an empty graph.

'''Workaround:''' Use another reasoner, such as Pellet.

Known issues

2010-04-06T21:24:06Z

Walter:

{{warning|As is expected with pre-release software, there are bound to be some bugs. We will try our best to resolve them as quickly as possible. If your issue is not listed here, see the [[troubleshooting]] page.}}

==ATI Radeon HD problems with Inverted Radial Tree layout==
Some newer ATI Radeon HD cards exhibit problems when choosing the "Inverted Radial Tree" layout. The problem causes spurious textures to be drawn, and may cause the GLOW user interface to "freeze" for seconds.

'''Workaround:''' If this problem happens, do not use the Inverted Radial Tree layout. Select another layout using the "layout" drop-down at the bottom of the plug-in. It may take some time for the interface to become responsive.

==Duplicated leaf nodes==
There is a known issue with spurious duplication of leaf nodes, if multiple inheritance exists higher up in the class hierarchy. Under a certain parent, a leaf node might appear multiple times.

'''Workaround:''' There is no workaround. When counting individuals, enable the display of labels for leaves in order to spot duplicates.

==Modifier buttons cause spurious panning==
Laptops may not have a middle/right mouse button which are used to perform zooming and rotation of the graph. OPTION and COMMAND are modifiers that can be combined with a left-click to do zooming and rotation, but while this functions, the graph pans simultaneously.

'''Workaround:''' Connect a mouse, or pan the graph back to its oroginal location using only the left mouse button, after it has been incorrectly moved.

Troubleshooting

2010-04-06T21:22:48Z

Walter:

{{warning|This page contains some common mistakes/problems and their solutions. If your issue is not listed here, see the [[known issues]] page.}}

==Could not start bundle org.glowvis ... Missing Constraint: Bundle Required Execution Environment: JavaSE-1.6==
GLOW requires Java 6 (JRE 1.6). First install a new version of Java 6 on your system. Then, download a version of Protégé that does not include a Java VM. The full procedure is covered in the [[installation instructions]].

==UnsatisfiedLinkError: no nativewindow_jvm in java.library.path==
If you receive this error, it means that the JOGL libraries (<tt>.dll</tt> or <tt>.so</tt> files) could not be found.

* Windows: Please install the [[JOGL]] installer, and reboot your system afterwards.
* Mac OS X, Unix: Please see [[Running GLOW on Unix]] for how to start Protégé properly.

==No such method: org.semanticweb.owl.model.OWLPropertyAxiom.GetAxiomType()==
You are likely using a version of Protégé that is not supported by GLOW. GLOW currently supports the ''release'' versions (not the ''alpha'' versions) of Protégé 4.0. GLOW has been tested on Protégé 4.0.1 and Protégé 4.0.2.

Troubleshooting

2010-04-06T21:22:18Z

Walter:

This page contains some common problems and their solutions.

==Could not start bundle org.glowvis ... Missing Constraint: Bundle Required Execution Environment: JavaSE-1.6==
GLOW requires Java 6 (JRE 1.6). First install a new version of Java 6 on your system. Then, download a version of Protégé that does not include a Java VM. The full procedure is covered in the [[installation instructions]].

==UnsatisfiedLinkError: no nativewindow_jvm in java.library.path==
If you receive this error, it means that the JOGL libraries (<tt>.dll</tt> or <tt>.so</tt> files) could not be found.

* Windows: Please install the [[JOGL]] installer, and reboot your system afterwards.
* Mac OS X, Unix: Please see [[Running GLOW on Unix]] for how to start Protégé properly.

==No such method: org.semanticweb.owl.model.OWLPropertyAxiom.GetAxiomType()==
You are likely using a version of Protégé that is not supported by GLOW. GLOW currently supports the ''release'' versions (not the ''alpha'' versions) of Protégé 4.0. GLOW has been tested on Protégé 4.0.1 and Protégé 4.0.2.

{{warning|If your issue is not listed here, see the [[known issues]] page.}}

Troubleshooting

2010-04-06T21:21:32Z

Walter: /* UnsatisfiedLinkError: no nativewindow_jvm in java.library.path */

This page contains some common errors and their solutions.

==Could not start bundle org.glowvis ... Missing Constraint: Bundle Required Execution Environment: JavaSE-1.6==
GLOW requires Java 6 (JRE 1.6). First install a new version of Java 6 on your system. Then, download a version of Protégé that does not include a Java VM. The full procedure is covered in the [[installation instructions]].

==UnsatisfiedLinkError: no nativewindow_jvm in java.library.path==
If you receive this error, it means that the JOGL libraries (<tt>.dll</tt> or <tt>.so</tt> files) could not be found.

* Windows: Please install the [[JOGL]] installer, and reboot your system afterwards.
* Mac OS X, Unix: Please see [[Running GLOW on Unix]] for how to start Protégé properly.

==No such method: org.semanticweb.owl.model.OWLPropertyAxiom.GetAxiomType()==
You are likely using a version of Protégé that is not supported by GLOW. GLOW currently supports the ''release'' versions (not the ''alpha'' versions) of Protégé 4.0. GLOW has been tested on Protégé 4.0.1 and Protégé 4.0.2.

Troubleshooting

2010-04-06T21:20:12Z

Walter:

Troubleshooting

2010-04-06T21:20:03Z

Walter: