## page was renamed from ICARUS-Treebank_Manager
= ICARUS Treebank Manager Perspective: =
The {{attachment:treebank_manager_perspective.png}} perspective is used to create/edit treebanks. Treebanks configured here may be used within the [[ICARUS-Search-Perspective]].

The latest implementation supports the following input types:

 * Tokenized Text
 * CoNLL 2009
 * CoNLL 2006
 * [[http://weblicht.sfs.uni-tuebingen.de/weblichtwiki/index.php/The_TCF_Format|TextCorpusFormat (TCF) 0.4]]

'''Treebank Overview:''' {{attachment:treebank_explorer.png||align="bottom"}} Note the "New Treebank" is marked with an {{attachment:treebank_explorer_error-icon.png}} this indicates that there was no location set. The ICARUS example treebank is loaded {{attachment:treebank_explorer_loaded_icon.png}}.

[[ICARUS|{{attachment:navi_up.png|Back to ICARUS Main Page}}]][[extern/ICARUS|Back to ICARUS Main Page]]

<<Anchor(icarus-treebank-index)>>
== Index: ==
 I. [[#how-to-add-treebank|How to add a new treebank]]
 I. [[#tb-graph-list-outline|Graph-List Outline]]
 I. [[#tb-properties-outline|Treebank Properties Outline]]

<<Anchor(new-treebank)>>
=== I. How to add a new treebank ===

Video Download: 
 * [[http://clarin01.ims.uni-stuttgart.de/icarus/tutorial_add_tb.mp4|tutorial_add_tb.mp4]]
 * [[http://clarin01.ims.uni-stuttgart.de/icarus/tutorial_add_tb.ogv|tutorial_add_tb.ogv]]

 1. Adding a new Treebank by clicking the {{attachment:add_treebank.png}} button. You may use the "management-buttons" {{attachment:treebank_edit-del-buttons.png}} to delete, rename or edit selected treebank.
 1. After clicking the "Add new Treebank Button" {{attachment:add_treebank.png}} the treebank explorer dialog shows up: {{attachment:treebank_explorer_dialog.png||align="middle"}}
  * Name: specify the treebank name that will show up in the treebank overview list.
  * Location: treebank location on the file system (local/network).
  * Reader: Set the reader for the new treebank. E.g.: CONLL09(gold), CONLL09(system) or TCF 0.4.
  * Properties: (currently not used)
 1. Use the {{attachment:treebank_load.png}} button to load the treebank. Afterwards it can be inspected by clicking on {{attachment:treebank_inspect.png}}. The unload button {{attachment:treebank_unload.png}} will unload the treebank from the main memory.

[[#icarus-treebank-index|{{attachment:navi_up.png|Back to index}}]][[#icarus-treebank-index|Back to index]]

<<Anchor(tb-graph-list-out)>>
=== II. Graph-List Outline ===

{{attachment:treebank_graph-outline.png}} This tab is used to show the sentence data when inspecting a treebank {{attachment:treebank_inspect.png}}:

'''Graph-List Outline Toolbar:''' {{attachment:treebank_graph-outline-tb.png}}

 * {{attachment:preferences.png}} = Open the preferences
 * {{attachment:arc-layout.png}} = Change the current graph layout. There are three different layout types available {{attachment:qe_layouts.png||align="middle"}}
  1. Arc layout {{attachment:qe_arc-layout.png||align="middle"}}
  1. No layout {{attachment:qe_no-layout.png||align="middle"}}
  1. Tree {{attachment:qe_tree-layout.png||align="middle"}}

 * {{attachment:clear.png}} = Clear graph panel - every nodes/edges are deleted
 * {{attachment:export.png}} = Save the current search graph to XML file (may be imported later)
 * {{attachment:import.png}} = Import a search graph XML file
 * {{attachment:print.png}} = Print the current graph

 * {{attachment:add-node.png}} = Add a new node to the current search graph
 * {{attachment:add-edge.png}} = Connects two nodes (two nodes must be selected before this action can be performed)
 * {{attachment:add-pedge.png}} = Connects two nodes with a precedence relation (two nodes must be selected before this action can be performed)
 * {{attachment:delete.png}} = Delete selected node/edge (multi selection possible)

 * {{attachment:edit.png}} = Open the edit node/edge dialog (Instead of using this button you may doubleclick a node/edge to open the edit dialog)

 * {{attachment:clone.png}} = Duplicate (copy and insert) the selected nodes/edges. Quick way to duplicate a graph. Note: edges are only copied when their source and target node is selected.
 * {{attachment:copy_button.png}} = Copy and the selected nodes/edges. Note: edges are only copied when their source and target node is selected.  (strg+c)
 * {{attachment:paste_button.png}} = Paste previously copied nodes/edges.  (strg+p)

 * {{attachment:reorder-graph.png}} = Redraw the graph, can be useful while adding new nodes, edges or constraints may mess up the graph layout. Example (arc-layout): (left nodes/edges unsorted; right nodes/edges reorderes) {{attachment:graph-redraw.png||align="middle"}}

 * {{attachment:undo.png}} = Undo the last graph editor operation
 * {{attachment:redo.png}} = Redo the last graph editor operation

 * {{attachment:zin.png}} = Increase zoom level
 * {{attachment:zdefault.png}} = Switch back to the default zoom level
 * {{attachment:zout.png}} = Decrease zoom level

 * {{attachment:zauto.png}} = Autofit zoom level to the current graph panel size (default off)
 * {{attachment:zcompress.png}} = Compress graph (right-left). Merge node/edge information into a node. Search annotation highlight is never merged and always visible. (default off)

 * {{attachment:hl_inedge.png}} = Highlight the incoming edge of the selected node (multiselection possible) (default off)
 * {{attachment:hl_outedge.png}} = Highlight the outgoing edge/edges of the selected node (multiselection possible)  (default off)
  * Example where the node "son" is selected and highlight is switched on for incoming and outgoing edges {{attachment:hl_example.png||align"middle"}} Note: It is possible to navigate through a graph (after selecting at least one node/edge) using the "arrow keys"

 * {{attachment:treebank_tb-unused.png}} = unused right now


At the lower part of the graph panel is the text outline. The list contains all sentences of the treebank. The selected sentence is shown in the graph panel.

'''Toolbar:''' {{attachment:text-tb.png}}

 * {{attachment:text_outline.png}} = Toggle a textpanel to copy the selected sentence. (see below)
  * {{attachment:text_outline-on.png}}

 * {{attachment:item-first.png}} = First sentence
 * {{attachment:item-previous.png}} = Previous sentence
 * {{attachment:sentence-nr.png}} = Shows the current selected sentence (first number) and the total sentences (last number). In the example figure sentence 2 of 3 is selected. The user may navigate using the arrows to the left/right. It is possible to enter the sentence no. in this field by pressing "return" the sentence pops up. Note that the sentence numbers belong to the the internal index (the corpus index may differ for example if one sentence number have been skipped)
 * {{attachment:item-next.png}} = Next sentence
 * {{attachment:item-last.png}} = Last sentence

[[#icarus-treebank-index|{{attachment:navi_up.png|Back to index}}]][[#icarus-treebank-index|Back to index]]

<<Anchor(tb-properties-outline)>>
=== III. Treebank Properties Outline ===

At the very right is the "properties" outline. It consists of two different tabs.

 1. Properties: The properties show some additional treebank information. For example, name, status (loaded). Also some Meta-Data is provided that includes the minimum, maximum and average sentence lengt as well as the total length (equal total token count) ([[attachment:treebank_properties-tab.png|{{attachment:treebank_properties-tab.png||height=100}}]] 
 1. Table Outline: A table representation of the graph shown in the Graph-List outline. [[attachment:treebank_table-outline.png|{{attachment:treebank_table-outline.png||height=100}}]] 

[[#icarus-treebank-index|{{attachment:navi_up.png|Back to index}}]][[#icarus-treebank-index|Back to index]]