1. About Tamana

Tamana is a tool to view and refine topic maps. It provides a Maiana-like viewer, a refine view and a TMQL console to test TMQL Queries or to access a topic map via TMQL.

2. Getting Started

First, you need to download Tamana from the google code project via the following link: http://code.google.com/a/eclipselabs.org/p/tamana/downloads/list .

Choose the file for your system, download it and unzip it to a folder of your choice.

In the tamana folder you can find a executable called tamana. Open it and you’ll see the welcome page of Tamana.

You can get a (very) short description of the different views by pressing on Overview. To open a specific view with the Topic Maps Lab’s toytm press Samples and choose the view you want to see.

If you want to open your own topic map, just press on Workbench.

The welcome view is only shown when the program is executed for the first time. You can always reopen the welcome view in the help menu.

3. Open a Topic Map

The workbench has three buttons in its toolbar, which are used to open the different views. After pressing one of these buttons, a dialog opens which provides an input mask to either connect to a MaJorToM-Server or load a topic map into memory.

Choose a provider and enter the needed data. For local Topic Maps a filename and a base locator is needed.

The base locator is used to identify the topic map. Topic Maps will be not unloaded in this version, so if you load another topic map be sure to use a different base locator or simply restart the application.

If you use the MaJorToM-Server TopicMap Provider you need to enter the base locator used in the server, the server url and an apikey which let you load a topic map.

After entering the needed information the view openes. This might take a while for big topic maps, so please be patient.

4. The Maiana View

The Maiana View can be used to get a structured overview of the topic map. Its layout is based on the old Maiana layout. Open A topic map and browse through the topics and their associations.

5. The TMQL Console

With the TMQL Console you can test your queries using the topic map you load. The view is split into two parts. The upper part is the text field where you enter the query. The lower part represents the results. It’s a table which will be generated based on the query results. In between you see the execute button. Next to it the duration of the query execution will be shown.

The duration counts the time to execute the query. Depending on the size of the results, the generation of the result table may take longer. This time is not included in the timing.

6. The Refine View

The Refine View is used to get an overview of the data in your topic map. The main view is a table which has for each occurrence and name type a column in a table. Each row represents a topic in the topic map. Each row of a topic shows the value of the characteristic with the column type or an empty string. You can select the columns which should be shown via the context menu.

Characteristics are names or occurrences.

The refine view provides some filter mechanisms for characteristics to filter topics which have occurrences of specific types or values. Click the right mouse button over the column header of a characteristic and choose the filter to add.

The refine view provides the following filter.

All filter have the same layout. A heading shows the kind of filter, the name of the characteristic type and a link to close the filter. Below are two helper links to select or deselect all elements in the table below. This table contains all values of characteristics of the filtered type.

Below the table are input fields to filter the values in the table. The different input fields will be explained below.

Select All and Deselect All work on the filtered values of the table.

6.1. String Filter

To filter the values in the table, just enter a text in the text field below. Only values which start with the entered text remain. Wildcards are not supported yet.

6.2. Number Filter

The number filter provides two slider to set a minimum and maximum for the filter. The interval of the slider is calculated based on the given values.

6.3. Coordinate Filter

The coordinate filter provides two fields. The first one is used to set a coordinate which is used as middle point. The second one specifies a radius around this point. If you don’t want to enter a coordinate you can double click on a value in the table.