Getting started Creating an application User interface
Documentation Basic text analysis Pattern search Creating a corpus
Advanced topics Custom properties
This page documents the general aspects of the tOKo user interface. The screendumps were created using Linux, on other operating systems they may look slightly different.
An example of the user interface is selectingfrom the menubar. The words in the corpus are shown in the second browser. Next click on a word in the second browser, the documents in which the word appears are shown in the first browser and case variations are shown in the third browser. Now click on a document in the first browser, the contents of the document is shown in the right tab-window.
The menubar works in the familiar way.
The five browsers at the top are filled with the ordered results of
a user action. In the documentation the browsers are called the first
browser (left most) through the fifth browser (right most).
The label above a browser describes what is being shown. Layout of the items is one of:
Term [ Frequency ]
Frequency is the frequency of the term and score a value computed on criteria other than frequency. The popup menu in a browser has options to change the default order in which items are sorted.
The dialog box in the middle of the screen contains a row of tool buttons and a row for entering a selection and setting modes. The second row, perhaps, takes some getting used to.
In general, there are two ways of issuing an action. The first way is to enter a term into the selection box and then select an action from either the tool buttons or the drop-down menu. The second method is to enter a term and then hit the RETURN key. The latter executes the previous action, which is shown in the button (Pattern search in the example).
Setting and editing the selection
The selection is set by one of several methods:
Modes for ontology and language
Currently functions can be executed in one of two modes: ontology (O) and language (L) mode. In O-mode it is assumed the user is developing an ontology and words or terms that are unlikely to be ontology concepts are not shown. In L-mode no results are filtered out, a mode suitable for linguistic analysis.
An example of the difference is. In L-mode it shows the frequency of all words, including small words like the, in etc. In O-mode these words or not shown and the most frequent terms are then likely related to the subject matter of the corpus.
Restricting searches to part of the corpus
By default all search operations consider the entire corpus (C). Searches can be restricted to a document and all its sub-documents by selecting a document in the corpus hierarchy and setting the mode to documents (D).
Interpretation of the selection
The interpretation of the selection can be one of term (T) and pattern (P). When T-interpretation is active, the selection is taken literally, whereas with P-interpretation the selection is the set of all phrases in the corpus that match the pattern.
With T-interpretation the selection minute applied to KWIC (drop-down menu) shows the context of the literal term minute. With P-interpretation the KWIC function first expands the selection to all matches in the corpus and then shows the context for all expansions. For example, the pattern (minute) takes minute as a lemma and applies KWIC to both minute and the plural minutes. (See Pattern search for a full description of the specification of patterns.)
The left tab-window contains three tabs for the corpus hierarchy, the ontology hierarchy, and resources associated with the application. Which tab is on top is controlled by the user.
The right tab-window is dynamically filled with tabs. A tab displaying the current document is always present, other tabs are displayed (and first created when necessary) when a function requiring the tab is executed.
In some cases the results of a function can be shown in a browser and in a tab. In such cases, the user must first put the appropriate tab on top.
The feedback line at the bottom display status information (in black) and error messages (in red).