Wandora application is launched running start-up scripts in bin folder. Folder contains bat scripts for Windows and sh scripts for Linux and similar systems. Default bin script is Wandora.bat and default Linux script Wandora.sh. Default script gives Wandora a maximum memory amount of 1 GB.
After you have launched Wandora application, you should see initial Wandora window with six different GUI areas. These GUI area are Button bar, Topic tree, Finder, Layer stack, Topic panel and Info fields. Next image views the Wandora window. Window has also a menu bar containing Wandora tools. Available menus are
- File menu contains options to Open and Save Wandora projects, options to import and export topic maps and RDF documents for example.
- Edit menu contains usual Select, Cut, Copy and Paste options.
- View menu is used to control how topic panel views current topic.
- Topics menu contains tools to create and modify topics and associations.
- Layers menu contains options to control topic map layers and layer stack.
- Shortcuts are topic map bookmarks easing topic map navigation.
- Tools menu contains tool manager and special user selected tools.
- Server menu is used to control Wandora's embedded HTTP server.
- Help menu contains few info dialogs and a shortcut to Wandora Wiki.
Button bar at the top of the window contains at least Open and arrow buttons. Arrow buttons behave like WWW browser's back and forward except that history contains topics. Back button recalls previous topic in the Topic panel and right button restores next topic in the history. If there is no topic in the history to restore the arrow button is disabled. Right clicking the arrow button reveals context menu of history topics. Selecting a topic in menu opens the topic in Topic panel.
Button bar contains also Open button. Button opens a Select topic window with Topics, Finder, and Select tabs used to specify the topic to be opened. Topics tab contains topic tree. To open a topic with topic tree, find and select the topic and click OK. Select tab contains simple search fields to locate a topic with topic's subject identifier, subject locator or basename. To open a topic with the select tab, enter topic's identifier into the search field, press find, and click OK if search result field indicates successful match. Unfortunately you can't use wild cards or other advanced match operations within the search field of Select topic window.
Select topic window is very common GUI element in Wandora. It is generally used to request a topic. For example adding a class topic tool requests the class topic with Select topic window. Below is an example of Select topic window.
Addition to Open and arrow buttons bar may contain also other buttons. Set of additional buttons vary over Wandora releases and Wandora user can even change the button set with Tool manager. At the moment default additional buttons are
- Open project is used to load a project file to Wandora. Wandora's project file is a zip package including XTM topic maps and an option file.
- Save project saves topic maps in Wandora into a Wandora project file.
- Import TM imports topic map serialization to Wandora. Wandora reads in topic map in XTM 1.0, XTM 2.0, LTM and JTM format.
- Import RDF imports RDF serialization in RDF XML format. Imported RDF is converted to a topic map.
- Import OBO imports OBO serialization to Wandora.
- New topic creates new topic.
- Search opens a search dialog. Search is used to locate topics.
- Server starts Wandora's internal server and tries to open current topic in external HTML browser. Wandora's internal server is used to serve Wandora's topic map as a HTML site or as a web service. Wandora's browser plugin also uses Wandora's server.
- Print topic opens a print dialog for a topic open in Wandora.
Topic tree is one of the most convenient and most used GUI element in Wandora. Topic tree is used to browse and select topics. Topic tree is similar to file and folder hierarchy but contains topics instead of files, and the arranging principle is based to topic relations.
When you open the application there is a default topic tree in top-left corner. Tree's root node is Wandora class and there is only one branch below. By default topics are arranged in the tree along type-of and super-sub-class relation. The "hollow triangle" icon represents super-sub-class relation between topics. "Filled rectangle" icon represents type-of relation between topics.
Clicking the handle opens subtree of the topic. Double clicking a topic in the tree opens the topic into the topic panel. Right clicking a topic in the topic tree reveals a context menu with a large number of topic tools. Below is an example of topic tree with Wandora class and Schema type topics open. Notice that Schema type is a subclass of Wandora class. Visible topics are part of Wandora's base ontology. Base ontology contains Wandora's schema topics for example.
Although topic tree offers very efficient method to browse and select topics there may be topics in the topic map that can not be reached with the topic tree. Finder offers more fuzzy manner to find topics. Finder tab locates beside the Topics tab.
Finder is simply a free text search to the topic map. You may search with any topic element or element combination. Search result appears below the search field. Double clicking a topic in the search result opens the topic into the topic panel. Right clicking a topic opens context menu with a large number of topic tools. Below is an example of finder where user has searched with word title. Search results locate below the search word field. Search result contains topics including word title in their base name. To open search result topic for detailed inspection you can double click the topic for example. Wandora contains also more sophisticated search dialog you can open with menu Edit > Find.
Image below views Wandora's finder tab.
Layer stack locates below the topic tree and finder. It contains all topic maps loaded into Wandora application. Layer stack keeps all topic maps separate but views a merged map.
Whenever Wandora starts, layer stack contains one layer with the predefined schema map called Base. You should be careful in changing the Base layer. Especially deleting topics or subject identifiers in the Base may break some features in Wandora application.
You can add new layer to the layer stack by right mouse clicking empty space in the stack area and selecting menu option New layer. New layer is created once the user has selected layer type and entered a name for the layer. To create a database topic map you have to enter database's connection information also.
Layer stack has one layer selected. Selected layer is colored light blue. Layer is selected by clicking the layer with left mouse button. All "write" operations to the layer stack are changing selected layer only.
A layer can also be hidden and locked. Near layer name locates two icons, an eye and a lock. Clicking the eye icon toggles layer visibility. Clicking the lock icon toggles layer lock. If layer is invisible you can not see or edit topics and associations in the layer. If layer is locked all changes to topics and associations in that layer are rejected.
Below is an example image of layer stack with three separate layers i.e. topic maps. Topic maps have been labeled Base, Last.fm, and Art of noise. Last.fm layer is light blue indicating the layer is selected. The icon at the right edge indicates the layer is a memory topic maps. All layers are visible. Layers Last.fm and Base are locked i.e. write-protected.
Topic panel covers the right column of Wandora window. Topic panel is an user interface used to view topics more detailed. To open a topic to the topic panel, double click a topic in the topic tree, for example. Topic panel is changed with menu option View > Topic panels. Available topic panels include Traditional topic panel, Tabbed topic panel, Graph topic panel, Custom topic panel, Treemap topic panel, Processing topic panel and R topic panel. By default topic is viewed with Traditional topic panel.
Traditional topic panel collects and views topic's internal structure:
- Base name
- Subject locator
- Subject identifiers
- Variant names
- Associations (where topic is a player or a role)
- Associations where type
Traditional topic panel contains edit fields for base name, subject locator, and variant names. Subject identifiers, classes, instances, occurrences, and associations are edited with tools found in context menus. To open class, instance or association player topic double click table cell with topic's base name. Thus, topic panel is a kind of topic browser. You can open a topic in topic panel by double clicking it.
Tabbed topic panel is similar to traditional topic panel but views topic elements in separate tabs. Graph topic panel is used to view topic map graphs. Each graph node represents topic and edge single association. Custom topic panel allows Wandora user to write simple scripts that searches for topics viewed in the panel. Processing and R topic panels are programmable panels for advanced topic visualizations. Treemap topic panel is used for association visualizations. Image below views Wandora's Traditional topic panel.
Last but not least there is a info field strip in the bottom of the Wandora window. The leftmost information snippet is a base name of the current open topic. Second field contains topic's layer distribution of the current topic. Topic distribution 1:0:0 indicates how the inspected topic merges between layers. Third field contains name of current layer. Two icons on the right edge indicate current topic panel type and embedded server status. Clicking the topic panel type icon reveals a pop-up menu used to change the type of topic panel. Clicking on the server status icon starts and stops the embedded HTTP server.
To start using Wandora
- Try to right click topics and UI elements in Wandora. Many important tools locate in context pop-up menus.
- Try to double click table cells and tree nodes to open topics for inspection.
- Try to drag and drop stuff. In Wandora you can drag topics and text snippets.