Wandora

From WandoraWiki
(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
 +
This page collects Wandora documentation. Documentation is a work in progress and incomplete. Also note some documentation may be out of date as the application is developed intensely. If you need specific help, leave a question in the [http://www.wandora.net/wandora/forum/index.php discussion forum]. Additional help may be available on [http://www.wandora.org/wandora/tv/ wandoratv] (Flash required). If you would like to edit this wiki, send an email to {{wandora email address}} with your name and information about how you'd like to contribute. Remember to add keyword WANDORA to the title of your email.
 +
 +
 +
== Introduction ==
 +
 +
Wandora is a general purpose information management application. Wandora is written in Java programming language. Wandora's internal data model is based on Topic Maps. Wandora is a desktop application with a graphical user interface, layered data storage, huge collection of data extraction, import and export options and embedded HTTP server. Wandora's license is GNU GPL version 3.
 +
 +
* [[General FAQ]]
 +
 +
== Starting with Wandora ==
 +
 +
Wandora is a desktop application written in Java version 6. You need Java Runtime Environment (JRE) to execute the application. Wandora has two distribution packages. Binary distribution package contains runnable version of the application. Wandora's source code is available as a source code distribution package. Both packages are zip compressed file repositories. Use one of the startup scripts in '''bin''' folder to run Wandora application. Wandora project is developed with [http://netbeans.org/ Netbeans IDE]. Source code distribution package contains a Netbeans IDE project.
 +
 +
* [[System requirements]]
 +
* [[Download|Download Wandora]] (build date {{build date}})
 +
* [[How to install Wandora|Installing Wandora]]
 +
* [[Running Wandora]]
 +
* [[Tuning Wandora for Mac OS]]
 +
 +
== Topic Maps ==
 +
 +
Wandora's internal datamodel is based on Topic Maps. Wikipedia defines Topic Maps as a standard for the representation and interchange of knowledge, with an emphasis on the findability of information. A topic map represents information using ''topics'', ''associations'' and ''occurrences''. Topic represents any concept, from people, countries, and organizations to software modules, individual files, and events. Associations are hypergraph relationships between topics. Occurrence is an information resource relevant to a particular topic. Wandora's topic map model is limited. These model limitations are explained in [[Reduced Topic Maps|Topic maps in Wandora]] page.
 +
 +
* [[Topic Maps|About topic maps]]
 +
* [[Reduced Topic Maps|Topic maps in Wandora]]
 +
 +
See also Topic map layers section below. [[Topic map gallery]] contains actual downloadable topic maps that you can try with Wandora.
 +
 +
== Using Wandora ==
 +
 +
This section contains some basic tutorials for Wandora. If you are a novice Wandora user, please start here. See also tutorial videos on [http://www.wandora.org/wandora/tv/ wandoratv] (Flash required).
 +
 +
* [[Quickstart]]
 +
* [[Opening a topic]]
 +
* [[Finding a topic]]
 +
* [[Topic shortcuts]]
 +
* [[Create new topic]]
 +
* [[Delete topic]]
 +
* [[Create new association]]
 +
* [[Delete association]]
 +
* [[Working with topic tables]]
 +
* [[Drag and drop topics]]
 +
* [[Working with topic trees]]
 +
* [[Creating custom topic trees]]
 +
* [[View all variant names of a topic]]
 +
* [[Transform variant names to topics and associations]]
 +
* [[Undo and redo]]
 +
 +
== Editing topics ==
 +
 +
Wandora has a rich set of topic, association and occurrence editing features. Wandora user may edit single topic in a topic panel. Modifying an association takes place in separate dialog window, association editor. Similarly, modifying an occurrence takes place in a separate editor. See also tutorial videos on [http://www.wandora.org/wandora/tv/ wandoratv].
 +
 +
* [[Modifying base name]]
 +
* [[Modifying subject locator]]
 +
* [[Modifying subject identifiers]]
 +
* [[Modifying variant names]]
 +
* [[Modifying topic classes]]
 +
* [[Modifying associations]]
 +
* [[Modifying occurrences]]
 +
 +
== Topic panels ==
 +
 +
Topic panel is Wandora's UI element to view and edit topics. Wandora supports several different topic panel types. Topic panels are managed with menu options under '''View'''. Wandora can view several topic panels simultaneously. Traditional topic panel views all topic elements in a table while tabbed panel views topic details in separate tabs. Graph topic panel is used for graph visualizations. Custom topic panel is based on user specific queries related to the current topic.
 +
 +
* [[Traditional topic panel]]
 +
* [[Tabbed topic panel]]
 +
* [[Graph topic panel]]
 +
* [[Custom topic panel]]
 +
* [[Treemap topic panel]]
 +
* [[R topic panel]]
 +
* [[Processing topic panel]]
 +
 +
== Topic map layers ==
 +
 +
Wandora supports layered topic maps. Layered topic map contains one or more topic maps stacked into an ordered array. Wandora views all layered topic maps as a single topic map but allows layer specific operations too. It really matters what layer is active. As user can focus on one layer at a time or replace any layer at any time, the composition of information is flexible. User can easily try different scenarios. Layer specific application options and tools locate in '''Layers''' menu.
 +
 +
* [[Introduction to Layered Topic Maps]]
 +
* [[Creating new layers]]
 +
* [[Deleting layer]]
 +
* [[Layer order and arranging layers]]
 +
* [[Merging layers]]
 +
* [[Topic's layer distribution]]
 +
 +
'''Different layer types'''
 +
* [[Layered topic map]]
 +
* [[Memory topic map]]
 +
* [[Database topic map]]
 +
* [[Linked topic map]]
 +
* [[Query topic map]]
 +
<!-- * [[Remote topic map]] -->
 +
* [[Web service topic map]]
 +
 +
'''Other'''
 +
* [[Compare topic maps]]
 +
* [[Topic map patcher]]
 +
 +
== Import and Export ==
 +
 +
Wandora has been designed for easy aggregation of information and features a wide range of import and export tools. Wandora imports not just different Topic Maps formats such as XTM1, XTM2, and LTM but also RDF as XML, N3, and Turtle. Also, Wandora imports bio-ontologies in OBO flat file format. To get an up-to-date overview of Wandora's import options see menu '''File > Import'''. Addition to import options, Wandora features a wide range of export options from different Topic Maps formats to different graph formats. See menu options in '''File > Export'''. Wandora's native file format is Wandora project, with a file suffix WPR, which is a collection of XTM2 topic maps and a configuration file within a zip package.
 +
 +
* [[How to save and load project]]
 +
* [[How to import existing topic map to Wandora]]
 +
* [[How to export topic map in Wandora]]
 +
* [[Maiana import and export]]
 +
* [[Transferring data with clipboard]]
 +
* [[Importing RDF]] (see also extractors below)
 +
* [[OBO flat file import|Importing OBO flat file ontologies]]
 +
* [[Gene Ontology Annotation file import]]
 +
* [[Importing XML with XSL]]
 +
* [[Generic SQL database import]]
 +
* [[Exporting WWW site]]
 +
* [[Lucene search index export]]
 +
* [[SQL Dump Export]]
 +
 +
'''Graph and matrix imports'''
 +
* [[Adjacency list import]]
 +
* [[Adjacency matrix import]]
 +
* [[Incidence matrix import]]
 +
 +
'''Graph and matrix exports'''
 +
* [[Graph Modeling Language export]]
 +
* [[GraphML export]]
 +
* [[GraphXML export]]
 +
* [[GXL graph export]]
 +
* [[Export adjacency matrix]]
 +
* [[Export incidence matrix]]
 +
 +
For additional information about Wandora's export capabilities see also '''Wandora as a server''' section below. For additional information about Wandora's import capabilities see also '''Extractors''' section below. <!-- [[Image:import_export_diagram.gif|center]] -->
 +
 +
== Extractors ==
 +
 +
Wandora is great for information mashups. With Wandora you can easily mashup information from various sources. Extractors are specific Wandora tools used to extract topics and associations out of different file formats and sources. For example, Wandora can extract data from MP3 and JPG files. To see what extractors your Wandora has installed see menu options in '''File > Extract'''. To start an extractor select the extractor in the menu or use drag and drop extractor. Wandora also features an add-on for Mozilla Firefox WWW browser. With this add-on you can perform extractions directly in Firefox www browser or in Thunderbird email client.
 +
 +
* [[Drag and drop extractor]]
 +
* [[Wandora Firefox plugin|Firefox plugin]] to extract directly from Firefox WWW browser and Thunderbird email client.
 +
 
{| cellspacing="0" cellpadding="0" width="100%" background-color="transparent"  
 
{| cellspacing="0" cellpadding="0" width="100%" background-color="transparent"  
−
| style="border:none; margin:none; padding:0px;" valign="top" width="50%" | <!-- LEFT COLUMN -->
+
| style="border:none; margin:none; padding:0px;" valign="top" | <!-- LEFT COLUMN -->
−
Wandora is a general purpose information extraction, management and publishing application based on [[Topic Maps]] and [http://www.oracle.com/technetwork/java/index.html Java]. Wandora has graphical user interface, layered and merging information model, multiple visualization models, huge collection of information extraction, import and export options, embedded HTTP server with several output modules and open plug-in architecture. Wandora is a [http://en.wikipedia.org/wiki/FOSS FOSS] application with [http://www.gnu.org/licenses/gpl-3.0.txt GNU GPL] license.
+
 
 +
'''Search engine extractors'''
 +
* [[Bing extractor]]
 +
* [[Yahoo! BOSS extractor]]
 +
'''Simple files extractors'''
 +
* [[JPG binary metadata extractor]]
 +
* [[PDF extractor]]
 +
* [[File system extractor]]
 +
* [[Simple Text Document Extractor|Convert simple text documents to topic map occurrences]]
 +
* [[Simple CSV association extractor]]
 +
'''Media extractors'''
 +
* [[Europeana extractor]]
 +
* [[MP3 ID3v1 and ID3v2 extractor]]
 +
* [[IMDB extractor]]
 +
* [[FreeDB extractor]]
 +
* [[Last.fm extractors|Convert Last.fm XML feeds to a topic map]]
 +
* [[Flickr extractors]]
 +
* <strike>[[Ovi shared media extractors]]</strike>
 +
* [[YouTube extractor]]s
 +
'''Social and Bookmark extractors'''
 +
* [[Facebook Graph extractor]]
 +
* [[Twitter extractor]]
 +
* [[Digg extractors]]
 +
* [[Delicious extractors]]
 +
* [[Diigo bookmark extractor]]
 +
* [[Twine RDF extractor]]
 +
'''Bibliographical extractors'''
 +
* [[MARCXML extractor]]
 +
* [[Dublin Core XML extractor]]
 +
* [[Bibtex extractor|Convert BibTeX files to a topic map]]
 +
* [[RIS extractor]]
 +
* [[HelMet library data extractor]]
 +
'''Classifications'''
 +
* [[GATE/ANNIE integration|GATE/ANNIE]]
 +
* [[Stanford Named Entity Recognizer integration|Stanford Named Entity Recognizer (NER)]]
 +
* [[OpenCalais classifier]]
 +
* [[AlchemyAPI extractors]]
 +
* [[Yahoo! YQL term extractor]]
 +
* [[Tagthe extractor]]
 +
* [[SemanticHacker classifier]]
 +
* [[Zemanta extractor]]
 +
* [[UClassify integration]]
 +
'''Knowledge extractors'''
 +
* [[OpenCyc extractor]]
 +
* <strike>[[Subj3ct record extractor]]</strike>
 +
* [[DBpedia extractor]]
 +
* [[Freebase extractor]]
 +
 
 +
| style="border: 1; margin:5; padding-left: 20px;" valign="top"| <!-- RIGHT COLUMN -->
 +
 
 +
'''HTML structures extractors'''
 +
* [[HTML superclass-subclass list extractor]]
 +
* [[HTML instance list extractor]]
 +
* [[HTML property table extractor]]
 +
* [[HTML association table extractor]]
 +
* [[HTML link extractor]]
 +
'''News and syndication extractors'''
 +
* [[RSS 2.0 Extractor]] and [[RSS 1.0 RDF Extractor]]
 +
* [[Atom extractor]]
 +
* [[New York Times Article Search API extractor]]
 +
* [[New York Times Event API extractor]]
 +
* [[Guardian open platform extractor]]
 +
'''Microformat extractors'''
 +
* [[Any23 extractor]]
 +
* [[Geo microformat extractor|Convert geo microformat snippets to topic maps]]
 +
* [[Adr microformat extractor|Convert adr microformat snippets to topic maps]]
 +
* [[HCalendar microformat extractor|Convert hcalendar microformat snippets to topic maps]]
 +
* [[HCard microformat extractor|Convert hcard microformat snippets to topic maps]]
 +
'''Wiki extractors'''
 +
* [[Wikipedia extractor]]
 +
* More general [[MediaWiki extractor]]
 +
'''Simple RDF extractors'''
 +
* [[SKOS RDF extractor]]
 +
* [[Dublin Core RDF extractor]]
 +
* [[FOAF RDF extractor]]
 +
'''Language'''
 +
* [[Big Huge Thesaurus API extractor]]
 +
* [[VerbOcean extractor]]
 +
* [[Moby thesaurus extractor]]
 +
* [[Stands4 word describer]]
 +
'''Databases'''
 +
* [[Generic SQL database import | Importing SQL database]]
 +
* [[SQL query result set extractor]]
 +
'''Other'''
 +
* [[Email extractor]]
 +
* [[Geonames extractors]]
 +
* [[Gellish ontology extractor]]
 +
* [[GEDCOM extractor]]
 +
* [[SPARQL extractor]]
 +
* [[Oma kaupunki extractor]]
 +
* [[iCal calendar format extractor]]
 +
|}
 +
 
 +
See [[Refining occurrences]] for some practical examples of how to extract associations and topics out of occurrences.
 +
 
 +
== Generators ==
 +
 
 +
Generators are special tools that generate topics and associations algorithmically. Generators help you construct basic building blocks for your topic maps. Generators are also a nice test suite for Wandora and topic maps in general. Generators locate in Wandora's '''File > Generate''' menu. Available generators are
 +
 
 +
* [[Random graph generator]]
 +
* [[Fully connected graph generator]]
 +
* [[Tree graph generator]]
 +
* [[Linear list graph generator]]
 +
* [[Finite group graph generator]]
 +
* [[Platonic solid graph generator]]
 +
* [[Hypercube graph generator]]
 +
* [[Tiling graph generator]] (square, triangular, and hexagonal tilings)
 +
* [[Edge generator]]
 +
* [[L-system generator]]
 +
* [[Cylinder graph generator]]
 +
* [[Lattice graph generator]]
 +
 
 +
== Schema ==
 +
 
 +
Schema is a collection of specific topics and associations that Wandora uses to construct the user interface of association editor, occurrence editor and topic name panel. Schema eases many topic map operations such as association and occurrence construction. Schema also defines the language support of Wandora application.
 +
 
 +
* [[Schema]] to ease association and occurrence creation and modification
 +
 
 +
== Language support ==
 +
 
 +
Wandora supports only one base name per topic. However, a topic may contain several different variant names. Each variant name has a type and a language. Similarly, a topic may contain several different occurrences, text fragments. Each occurrence has a type and a language also. Wandora supports both Microsoft Translator and Google translate API and can convert both variant names and occurrences to other languages.
 +
 
 +
* [[How to add a language to Wandora]]
 +
* [[How to add a name type to Wandora]]
 +
* [[Translating variant names with Google]]
 +
* [[Translating occurrences with Google]]
 +
* [[Translating variant names with Microsoft Translator]]
 +
* [[Translating occurrences with Microsoft Translator]]
 +
* [[View all variant names of a topic]]
 +
 
 +
== Analyzing topic maps ==
 +
 
 +
Generally these tools locate in '''Layers > Statistics''' menu. As an exception SOM classifier is found in association table menu and topic map comparison in '''File''' menu. Wandora provides also a bridge to R language. R language is a comprehensive statistical and graphing environment. With Wandora's R integration, the user can access Wandora's information structures in R environment. This opens up interesting possibilities if used together with information extractors.
 +
 
 +
* [[Topic map info]]
 +
* [[Topic map connection statistics]]
 +
* [[Topic map diameter]]
 +
* [[Merge ratio matrix]]
 +
* [[Clustering coefficient]] of topic map
 +
* [[SOM classifier]] (Self Organizing Maps classifier)
 +
* [[Asset weight of a topic]]
 +
* [[Compare topic maps]]
 +
* [[R in Wandora]]
 +
* [[Query language]]
 +
 
 +
See the '''Extract''' section and especially the subsection '''Classifications''' above also.
 +
 
 +
== Tools and tool manager ==
 +
 
 +
Almost every feature in Wandora is implemented with a tool. A tool packs certain Wandora functionality into a single software component. Wandora's user may customize the available tool set and even add third party tools to Wandora.
 +
 
 +
* [[Tool manager]]
 +
* [[:Category:Tools|Available tools]]
 +
* [[Writing your own tool]]
 +
* [[Installing your own tool]]
 +
* [[Tool locks]]
 +
* [[Configuring tools]]
 +
* [[Additional tool help]]
 +
* [[Developing Wandora]]
 +
 
 +
== Wandora as a server ==
 +
 
 +
Wandora application contains an HTTP server. Embedded HTTP server generates various output formats and interactive visualizations out of information stored in Wandora. Embedded server hosts service modules. A service module is software component that serves some information out of Wandora. For example, '''HTML service module''' generates a navigable HTML site out of topics in Wandora. '''D3 graph service module''' generates an interactive graph out of all topics in Wandora. On the other hand, '''XTM topic map service module''' outputs current topic in Wandora in XTM format. It provides a data access point for external applications, or for other instance of Wandora application. Some service modules rely on extracted information. Such service modules are '''Timeline service module''' and '''Google Maps service module'''.
 +
 
 +
* [[Embedded HTTP server]]
 +
** [[HTML service module]]
 +
** [[Mobile HTML service module]]
 +
** [[RSS feed service module]]
 +
** [[SOAP web service module]]
 +
** [[Drupal service module]]
 +
** [[Firefox and Thunderbird plugin service module]]
 +
** [[XTM topic map service module]]
 +
** [[JTM topic map service module]]
 +
** [[RDF service module]]
 +
** [[GRAPHML service module]]
 +
** [[Screencast service module]]
 +
** [[Flash graph service module]]
 +
** [[Timeline service module]]
 +
** [[Google Maps service module]]
 +
** [[D3 graph service module]]
 +
** [[D3 word cloud service module]]
 +
** [[D3 partition service module]]
 +
** [[D3 tree service module]]
 +
** [[D3 matrix service module]]
 +
** [[D3 layer visualization]]
 +
 
 +
Wandora team has also built several service modules for Drupal content management system and an extra for Joomla content management system. These modules can be used to publish Wandora stored information in these CMSes.
  
−
Wandora is well suited for constructing ontologies and information mashups. Wandora is capable of extracting and converting a wide range of open data feeds to topic map formats (see image below). Beyond topic map conversion, this feature allows Wandora user to aggregate multidimensional information mashups where information from Flickr interleaves with information from GeoNames and YouTube, for example.
+
* [[Wandora Drupal extras]]
 +
* [[Wandora's Joomla Topic Reader]]
 +
* [[JQuery Mobile based topic map browser]]
  
−
[[Image:Wandoras_extractors.gif|center]]
+
Wandora's embedded HTTP server contains a service module for SOAP web service. There is additional information available for Wandora's web service.  
  
−
This website, WandoraWiki, is a home of Wandora software application. To contribute Topic Maps community, Wandora Team has converted several well known ontologies to Topic Maps format. These ontologies: WordNet, OpenCyc, Gene Ontology, Gellish, and Finnish General Upper Ontology (YSO) are available at [[Topic map gallery]].
+
* [[Wandora Web Service]]
  
−
To contact developers of the Wandora application, please use [http://www.wandora.net/wandora/forum/index.php Wandora Forum] or contact us as described in [[General FAQ|FAQ]].
+
For additional information, see also '''Export''' section above.
  
−
You'll find Wandora news [http://www.wandora.org/www/news here]. See also [[past news]]. If you are interested in Topic Maps and information technology related news see [http://planet.topicmaps.org/ Planet Topic Maps] and [http://planetrdf.com/ Planet RDF].
+
== Miscellaneous documentation ==
  
 +
* [[Wandora's configuration file]]
 +
* [http://www.wandora.org/api/ Wandora Javadocs], [http://www.wandora.org/api/wandora-javadoc.zip download]
  
−
| style="border: 1; margin:5; padding-left: 20px;" valign="top" width="50%" | <!-- RIGHT COLUMN -->
+
== See also ==
−
<div style="font-size:105%; line-height:120%; padding: 0.2em; background-color:#eeeeee;">
+
−
[[Image:icon_download.gif]] Download Wandora
+
−
</div>
+
−
* [[Change log]]
+
−
* [[Download]] (build date {{build date}})
+
−
* [[License of Wandora|License]]
+
  
 +
As said in the very beginning, the documentation is a work in progress and incomplete. If the available documentation didn't answer your question, please drop a line to Wandora forum and we'll try to find an answer for you.
  
−
<div style="font-size:105%; line-height:120%; padding: 0.2em; background-color:#eeeeee;">
 
−
[[Image:icon_docs.gif]] Wandora documentation
 
−
</div>
 
−
* [[Features]]
 
−
* [[Documentation]]
 
−
* [[Open bugs]]
 
 
* [[General FAQ]]
 
* [[General FAQ]]
−
* [[FAQ for Wandora user]]
+
* [[FAQ for Wandora user]] reveals some nifty details of Wandora application.
−
* [http://www.wandora.org/forum/index.php Wandora Forum]
+
* [http://www.wandora.org/tv Wandora tv]
−
* [http://www.wandora.org/tv Wandora Tv]
+
* [http://www.wandora.org/forum/ Wandora forum]
−
* [[Upcoming features]]
+
  
 +
== Other papers and presentations ==
  
−
<div style="font-size:105%; line-height:120%; padding: 0.2em; background-color:#eeeeee;">
 
−
[[Image:icon_folder.gif]] Misc documents and papers
 
−
</div>
 
 
* [http://tmra.de/2010/ TMRA 2010] tutorial slides: [http://www.wandora.org/download/other/tmra10/wandora_workshop_tmra2010.pdf Converting information to Topic Maps using Wandora].
 
* [http://tmra.de/2010/ TMRA 2010] tutorial slides: [http://www.wandora.org/download/other/tmra10/wandora_workshop_tmra2010.pdf Converting information to Topic Maps using Wandora].
 
* [http://tmra.de/2009/ TMRA 2009] workshop presentation [http://www.slideshare.net/tmra/semantic-mashups-with-wandora Semantic Mashups with Wandora]. [http://www.wandora.org/wandora/download/other/tmra09/wandora_tutorial_leipzig.zip Example data set] is available for brave experimenters.
 
* [http://tmra.de/2009/ TMRA 2009] workshop presentation [http://www.slideshare.net/tmra/semantic-mashups-with-wandora Semantic Mashups with Wandora]. [http://www.wandora.org/wandora/download/other/tmra09/wandora_tutorial_leipzig.zip Example data set] is available for brave experimenters.
Line 48: Line 360:
 
* Kivelä A., Lyytinen O.: [http://www.wandora.net/wiki/images/Topic_map_aided_publishing.pdf Topic Map Aided Publishing – A Case Study of Assembly Media Archive]. ''Web Intelligence. STeP 2004 - The 11th Finnish Artificial Intelligence Conference Proceedings - Vol. 2'', 2004.
 
* Kivelä A., Lyytinen O.: [http://www.wandora.net/wiki/images/Topic_map_aided_publishing.pdf Topic Map Aided Publishing – A Case Study of Assembly Media Archive]. ''Web Intelligence. STeP 2004 - The 11th Finnish Artificial Intelligence Conference Proceedings - Vol. 2'', 2004.
  
 +
== Wandora @ World ==
  
−
<div style="font-size:105%; line-height:120%; padding: 0.2em; background-color:#eeeeee;">
 
−
[[Image:icon_link.gif]] You can find Wandora also at
 
−
</div>
 
 
* [http://twitter.com/#!/wandora_app Twitter]
 
* [http://twitter.com/#!/wandora_app Twitter]
 
* [http://freecode.com/projects/wandora/ Freecode]
 
* [http://freecode.com/projects/wandora/ Freecode]

Revision as of 21:21, 8 May 2013

This page collects Wandora documentation. Documentation is a work in progress and incomplete. Also note some documentation may be out of date as the application is developed intensely. If you need specific help, leave a question in the discussion forum. Additional help may be available on wandoratv (Flash required). If you would like to edit this wiki, send an email to support character.gif wandora.org with your name and information about how you'd like to contribute. Remember to add keyword WANDORA to the title of your email.


Contents

Introduction

Wandora is a general purpose information management application. Wandora is written in Java programming language. Wandora's internal data model is based on Topic Maps. Wandora is a desktop application with a graphical user interface, layered data storage, huge collection of data extraction, import and export options and embedded HTTP server. Wandora's license is GNU GPL version 3.

Starting with Wandora

Wandora is a desktop application written in Java version 6. You need Java Runtime Environment (JRE) to execute the application. Wandora has two distribution packages. Binary distribution package contains runnable version of the application. Wandora's source code is available as a source code distribution package. Both packages are zip compressed file repositories. Use one of the startup scripts in bin folder to run Wandora application. Wandora project is developed with Netbeans IDE. Source code distribution package contains a Netbeans IDE project.

Topic Maps

Wandora's internal datamodel is based on Topic Maps. Wikipedia defines Topic Maps as a standard for the representation and interchange of knowledge, with an emphasis on the findability of information. A topic map represents information using topics, associations and occurrences. Topic represents any concept, from people, countries, and organizations to software modules, individual files, and events. Associations are hypergraph relationships between topics. Occurrence is an information resource relevant to a particular topic. Wandora's topic map model is limited. These model limitations are explained in Topic maps in Wandora page.

See also Topic map layers section below. Topic map gallery contains actual downloadable topic maps that you can try with Wandora.

Using Wandora

This section contains some basic tutorials for Wandora. If you are a novice Wandora user, please start here. See also tutorial videos on wandoratv (Flash required).

Editing topics

Wandora has a rich set of topic, association and occurrence editing features. Wandora user may edit single topic in a topic panel. Modifying an association takes place in separate dialog window, association editor. Similarly, modifying an occurrence takes place in a separate editor. See also tutorial videos on wandoratv.

Topic panels

Topic panel is Wandora's UI element to view and edit topics. Wandora supports several different topic panel types. Topic panels are managed with menu options under View. Wandora can view several topic panels simultaneously. Traditional topic panel views all topic elements in a table while tabbed panel views topic details in separate tabs. Graph topic panel is used for graph visualizations. Custom topic panel is based on user specific queries related to the current topic.

Topic map layers

Wandora supports layered topic maps. Layered topic map contains one or more topic maps stacked into an ordered array. Wandora views all layered topic maps as a single topic map but allows layer specific operations too. It really matters what layer is active. As user can focus on one layer at a time or replace any layer at any time, the composition of information is flexible. User can easily try different scenarios. Layer specific application options and tools locate in Layers menu.

Different layer types

Other

Import and Export

Wandora has been designed for easy aggregation of information and features a wide range of import and export tools. Wandora imports not just different Topic Maps formats such as XTM1, XTM2, and LTM but also RDF as XML, N3, and Turtle. Also, Wandora imports bio-ontologies in OBO flat file format. To get an up-to-date overview of Wandora's import options see menu File > Import. Addition to import options, Wandora features a wide range of export options from different Topic Maps formats to different graph formats. See menu options in File > Export. Wandora's native file format is Wandora project, with a file suffix WPR, which is a collection of XTM2 topic maps and a configuration file within a zip package.

Graph and matrix imports

Graph and matrix exports

For additional information about Wandora's export capabilities see also Wandora as a server section below. For additional information about Wandora's import capabilities see also Extractors section below.

Extractors

Wandora is great for information mashups. With Wandora you can easily mashup information from various sources. Extractors are specific Wandora tools used to extract topics and associations out of different file formats and sources. For example, Wandora can extract data from MP3 and JPG files. To see what extractors your Wandora has installed see menu options in File > Extract. To start an extractor select the extractor in the menu or use drag and drop extractor. Wandora also features an add-on for Mozilla Firefox WWW browser. With this add-on you can perform extractions directly in Firefox www browser or in Thunderbird email client.

Search engine extractors

Simple files extractors

Media extractors

Social and Bookmark extractors

Bibliographical extractors

Classifications

Knowledge extractors

HTML structures extractors

News and syndication extractors

Microformat extractors

Wiki extractors

Simple RDF extractors

Language

Databases

Other

See Refining occurrences for some practical examples of how to extract associations and topics out of occurrences.

Generators

Generators are special tools that generate topics and associations algorithmically. Generators help you construct basic building blocks for your topic maps. Generators are also a nice test suite for Wandora and topic maps in general. Generators locate in Wandora's File > Generate menu. Available generators are

Schema

Schema is a collection of specific topics and associations that Wandora uses to construct the user interface of association editor, occurrence editor and topic name panel. Schema eases many topic map operations such as association and occurrence construction. Schema also defines the language support of Wandora application.

  • Schema to ease association and occurrence creation and modification

Language support

Wandora supports only one base name per topic. However, a topic may contain several different variant names. Each variant name has a type and a language. Similarly, a topic may contain several different occurrences, text fragments. Each occurrence has a type and a language also. Wandora supports both Microsoft Translator and Google translate API and can convert both variant names and occurrences to other languages.

Analyzing topic maps

Generally these tools locate in Layers > Statistics menu. As an exception SOM classifier is found in association table menu and topic map comparison in File menu. Wandora provides also a bridge to R language. R language is a comprehensive statistical and graphing environment. With Wandora's R integration, the user can access Wandora's information structures in R environment. This opens up interesting possibilities if used together with information extractors.

See the Extract section and especially the subsection Classifications above also.

Tools and tool manager

Almost every feature in Wandora is implemented with a tool. A tool packs certain Wandora functionality into a single software component. Wandora's user may customize the available tool set and even add third party tools to Wandora.

Wandora as a server

Wandora application contains an HTTP server. Embedded HTTP server generates various output formats and interactive visualizations out of information stored in Wandora. Embedded server hosts service modules. A service module is software component that serves some information out of Wandora. For example, HTML service module generates a navigable HTML site out of topics in Wandora. D3 graph service module generates an interactive graph out of all topics in Wandora. On the other hand, XTM topic map service module outputs current topic in Wandora in XTM format. It provides a data access point for external applications, or for other instance of Wandora application. Some service modules rely on extracted information. Such service modules are Timeline service module and Google Maps service module.

Wandora team has also built several service modules for Drupal content management system and an extra for Joomla content management system. These modules can be used to publish Wandora stored information in these CMSes.

Wandora's embedded HTTP server contains a service module for SOAP web service. There is additional information available for Wandora's web service.

For additional information, see also Export section above.

Miscellaneous documentation

See also

As said in the very beginning, the documentation is a work in progress and incomplete. If the available documentation didn't answer your question, please drop a line to Wandora forum and we'll try to find an answer for you.

Other papers and presentations

Wandora @ World

Retrieved from "http://wandora.org/w/index.php?title=Wandora&oldid=10420"