Differences between revisions 9 and 10
Revision 9 as of 2014-01-29 09:07:47
Size: 16239
Editor: GregorThiele
Comment:
Revision 10 as of 2014-01-29 10:22:37
Size: 18080
Editor: GregorThiele
Comment:
Deletions are marked like this. Additions are marked like this.
Line 116: Line 116:
Query: {{attachment:search_query-0D.png||align="middle"}}
Text Query: [lemma=be [relation=VC, pos=VBN]]
Result Toolbar: {{attachment:search_result-tb-0D.png}}
 * Query: {{attachment:search_query-0D.png||align="middle"}}
 * Text Query: [lemma=be [relation=VC, pos=VBN]]
 * Result Toolbar: {{attachment:search_result-tb-0D.png}}
Line 122: Line 122:
Query: {{attachment:search_query-1D.png||align="middle"}}
Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN]]
Result Toolbar: {{attachment:search_result-tb-1D.png}}
 * Query: {{attachment:search_query-1D.png||align="middle"}}
 * Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN]]
 * Result Toolbar: {{attachment:search_result-tb-1D.png}}
Line 126: Line 126:
 * Options: {{attachment:search_result-option-1D.png}}
  * {{attachment:search_numeric_switch.png}} = Switch between numeric/percentage result numbers (total)
  * {{attachment:search_sort.png}} = Sort by wordform or by occurence (ascending/descending)
  * {{attachment:search_reset_sort.png}} = Reset sorting
Line 128: Line 133:
Query: {{attachment:search_query-2D.png||align="middle"}}
Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]]]]
Result Toolbar: {{attachment:search_result-tb-2D.png}}
The result is presented as a list of sentences. Every occurence that matches the query is colored blue. Results (2D) [[attachment:search_result_2D.png|{{attachment:search_result_2D.png|attachment:search_result_2D.png|width="300"}}]]
 * Query: {{attachment:search_query-2D.png||align="middle"}}
 * Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]]]]
 * Result Toolbar: {{attachment:search_result-tb-2D.png}}
The result is presented as a table. Grouping operator one (red) is on the y-axis and grouping operator two (green) on the x-axis (Note: The x-/y-axis may be fliped clicking on {{attachment:search_flip-table.png}}). Every occurence that matches the query is colored blue. Results (2D) [[attachment:search_result_2D.png|{{attachment:search_result_2D.png|attachment:search_result_2D.png|width="300"}}]]
 * Options: {{attachment:search_result-option-2D.png}}
  * {{attachment:search_numeric_switch.png}} = Switch between numeric/percentage result numbers (total)
  * {{attachment:search_sort.png}} = Sort y-axis by wordform or by occurence (ascending/descending)
  * {{attachment:search_sort_x-axis.png}} = Sort x-axis by wordform or by occurence (ascending/descending)
  * {{attachment:search_flip-table.png}} = Flip the x-/y-axis (e.g.: x-axis = y-axis and vice versa)
  * {{attachment:search_reset_sort.png}} = Reset sorting
Line 134: Line 145:
Query: {{attachment:search_query-3D.png||align="middle"}}
Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]][relation=OBJ, lemma<*>3]]]
Result Toolbar: {{attachment:search_result-tb-3D.png}}
 * Query: {{attachment:search_query-3D.png||align="middle"}}
 * Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]][relation=OBJ, lemma<*>3]]]
 * Result Toolbar: {{attachment:search_result-tb-3D.png}}
Line 138: Line 149:
 * Options: {{attachment:search_result-option-3D.png}}
  * {{attachment:search_numeric_switch.png}} = Switch between numeric/percentage result numbers (total)
  * {{attachment:search_sort.png}} = Sort by wordform or by occurence (ascending/descending)
  * {{attachment:search_reset_sort.png}} = Reset sorting
  * {{attachment:search_sort.png}} = Sort y-axis by wordform or by occurence (ascending/descending)
  * {{attachment:search_sort_x-axis.png}} = Sort x-axis by wordform or by occurence (ascending/descending)
  * {{attachment:search_flip-table.png}} = Flip the x-/y-axis (e.g.: x-axis = y-axis and vice versa)
  * {{attachment:search_reset_sort.png}} = Reset sorting
  * {{attachment:search_reorder-graph.png}} = Change the grouping operor ([0] = list, [1] and [2] = table)

ICARUS-Search-Perspective

The search_perspective.png perspective provides the following search types:

  • Dependency-Search
  • * Coreference-Documents
  • * ErrorMining for Part-Of-Speech Tags

  • * ErrorMining for Dependency Structure

    • * under development will be available soon

How to set up a new search:
  1. Click on search_new.png to create a new search.

  2. Afterwards the search need to be configured:
  3. search_configuration.png

    • Type: Select one of the following search types described above.
    • Data-Set: The Treebank/Document used for the query.
    • Query: Clicking search_query.png opens the query editor. There may be different types of query editors depending on the search type.

    • Parameters: Search pararameters depending on the search type.
  4. Execute Search using the search_execute.png button

  5. View the Result by double-clicking the search result or use the inspect-button search_inspect.png

Search Parameters (Dependency-Search):
  • Search-Mode: Non-Exhaustive (stop after first hit), Exhaustive (add each sentence to the result at most one) and Exhaustive search with Grouping
  • Direction: Left-To-Right or Right-To-Left
  • Case-Sensitiv: On/Off
  • Result Limit: limit the search result (number of hits)

Result Outline(Dependency-Search):

attachment:search_result_1D.png

  • Aggregated result visualization depending on the number of grouping operators (dimensions) for up to three groups (3D)
  • Result highlighting for instances of query constraints
  • Fully customizable graph visualization
  • Easy navigation through results for up to three groups (3D)

Search Menu:

search_manager_menu.png

  • search_preferences.png = Open the preferences

  • search_new.png = Create a new search

  • search_execute.png = Executes the search. Note if no data-set was set the button is disabled search_execute_inactive.png

Search History Toolbar: search_history-tb.png . Every executed search is listed in the search history. The history is available until you close your ICARUS session. In this example we have three search history items. During the search process the icons to the left may change:

  • search_runing+loading.png Search is active (first icon) but the target data-set is not loaded yet (second icon)

  • search_runing+loaded.png Search is active (first icon) and target data-set is loaded (second icon)

  • search_finished+loaded.png Search finished successful (first icon) and target data-set is loaded (second icon)

  • search_icon_error.png Search was not successful.

  • search_clearhistory.png = Clear all search history items

  • search_remove1search.png = Remove the selected search result from the history

  • search_viewquery.png = Display the query of the selected search

  • search_inspect.png = Display the result of selected search

  • search_cancel.png Cancel selected search

Dependency Query Editor:

search_query-editor-tab.png Graph Editor Toolbar:

  • search_preferences.png = Open the preferences

  • search_arc-layout.png = Change the current graph layout. There are three different layout types available search_qe_layouts.png

    1. Arc layout search_qe_arc-layout.png

    2. No layout search_qe_no-layout.png

    3. Tree search_qe_tree-layout.png

  • search_clear.png = Clear graph panel - every nodes/edges are deleted

  • search_export.png = Save the current search graph to an XML file (may be imported later)

  • search_import.png = Import a XML file with an previously saved search graph

  • search_print.png = Print the current graph

  • search_add-node.png = Add a new node to the current search graph

  • search_add-disjunction.png = Adds a new disjunction to the current search graph

  • search_add-edge.png = Connects two nodes (two nodes must be selected before this action can be performed)

  • search_add-pedge.png = Connects two nodes with a precedence relation (two nodes must be selected before this action can be performed)

  • search_delete.png = Delete selected node/edge (multi selection possible)

  • search_edit.png = Opens the edit node/edge dialog (Instead of using this button you may doubleclick a node/edge to open the edit dialog)

  • search_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.

  • search_copy_button.png = Copy and the selected nodes/edges. Note: edges are only copied when their source and target node is selected. (strg+c)

  • search_paste_button.png = Paste previously copied nodes/edges. (strg+p)

  • search_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) search_graph-redraw.png

Note: The copy&paste nodes/edges can be used to copy graphs from/into other perspectives (e.g. Tutorial 1D,..)

  • search_undo.png = Undo the last graph editor operation

  • search_redo.png = Redo the last graph editor operation

  • search_zin.png = Increase zoom level

  • search_zdefault.png = Switch back to the default zoom level

  • search_zout.png = Decrease zoom level

  • search_zauto.png = Autofit zoom level to the current graph panel size (default off)

  • search_zcompress.png = Compress graph (right-left). Merge node/edge information into a node. Search annotation highlight is never merged and always visible even. (default off)

  • search_toggle_c-d.png = If there are different (unconnected) graphs A, B the search will use the following query (A v B).

Text Query Editor Toolbar: search_query-tb-text.png

  • search_undo.png = Undo the last text editor operation

  • search_redo.png = Redo the last text editor operation

  • search_copy_button.png = Copy and the selected text. (strg+c)

  • search_paste_button.png = Paste previously copied text. (strg+p)

  • search_select-all.png = Select the entire query text (strg+a)

  • search_clearhistory.png = Clear the text query panel.

  • search_save-graph-to-desc.png

  • search_sync-to-graph.png

  • search_sync-to-text.png

Result Outline:

search_result-tab.png In this view the search results are shown. The visialization may be seperated into four differnet presentation styles. We describe the different types in the following section.

0. No grouping operator search_grouping-operator.png is used.

  • Query: search_query-0D.png

  • Text Query: [lemma=be [relation=VC, pos=VBN]]
  • Result Toolbar: search_result-tb-0D.png

The result is presented as a list of sentences. Every occurence that matches the query is colored blue. Results (0D) attachment:search_result_0D.png

1. One grouping operator search_grouping-operator.png used.

  • Query: search_query-1D.png

  • Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN]]

  • Result Toolbar: search_result-tb-1D.png

All lemma types found are shown in the list (red) to the left. The user may select one lemma type to get all instances with matching query. Every occurence that matches the query is colored blue and the "grouped" lemma colored red. Results (1D) attachment:search_result_1D.png

  • Options: search_result-option-1D.png

    • search_numeric_switch.png = Switch between numeric/percentage result numbers (total)

    • search_sort.png = Sort by wordform or by occurence (ascending/descending)

    • search_reset_sort.png = Reset sorting

2. Two grouping operator search_grouping-operator.png used.

  • Query: search_query-2D.png

  • Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]]]]

  • Result Toolbar: search_result-tb-2D.png

The result is presented as a table. Grouping operator one (red) is on the y-axis and grouping operator two (green) on the x-axis (Note: The x-/y-axis may be fliped clicking on search_flip-table.png). Every occurence that matches the query is colored blue. Results (2D)

  • Options: search_result-option-2D.png

    • search_numeric_switch.png = Switch between numeric/percentage result numbers (total)

    • search_sort.png = Sort y-axis by wordform or by occurence (ascending/descending)

    • search_sort_x-axis.png = Sort x-axis by wordform or by occurence (ascending/descending)

    • search_flip-table.png = Flip the x-/y-axis (e.g.: x-axis = y-axis and vice versa)

    • search_reset_sort.png = Reset sorting

3. Two grouping operator search_grouping-operator.png used.

  • Query: search_query-3D.png

  • Text Query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]][relation=OBJ, lemma<*>3]]]

  • Result Toolbar: search_result-tb-3D.png

The result is presented as a list of sentences. Every occurence that matches the query is colored blue. Results (3D)

  • Options: search_result-option-3D.png

    • search_numeric_switch.png = Switch between numeric/percentage result numbers (total)

    • search_sort.png = Sort by wordform or by occurence (ascending/descending)

    • search_reset_sort.png = Reset sorting

    • search_sort.png = Sort y-axis by wordform or by occurence (ascending/descending)

    • search_sort_x-axis.png = Sort x-axis by wordform or by occurence (ascending/descending)

    • search_flip-table.png = Flip the x-/y-axis (e.g.: x-axis = y-axis and vice versa)

    • search_reset_sort.png = Reset sorting

    • search_reorder-graph.png = Change the grouping operor ([0] = list, [1] and [2] = table)

1) Tutorial Dependency Search (passive constructions) with one grouping operator:

If the the user doesn't exactly know the how passive constructions are annotated in a treebank. Then he can use e.g. mate-tools or weblicht to parse a sentence contains a passice construction and copy&paste the structure to the search graph.

  1. Parsed sentence "Mary was kissed by a boy." search_example_mt.png .

  2. Select the passice construction search_example_mt_selected.png

  3. Copy the selected cells and edges search_copy.png and switch to the search_perspective.png

  4. Paste selected cells and edges into the search query editor window search_paste.png

  5. The resulting graph when using the arc-layout (recommended) search_arc-layout.png search_cp-graph-arc.png

  6. In the following step the search graph (query) will be generalized (double clicking the edge / nodes to open the edge/node editor).
    1. Node 1 search_edit-node.png changed to search_edit-node-b.png

    2. Edge search_example-edge.png changed to search_example-edge-b.png

    3. Node 2 search_example-node2.png changed to (added grouping operator <*>) search_example-node2-b.png search_example-node2-c.png

    4. These changes result in a new more generalized version of the search graph (below is the textual query representation) search_example_sg+text.png This query matches passive constructions in English as annotated in the CoNLL08 Shared Task data set.

  7. Results (1D) attachment:search_result_1D.png

2) Tutorial Dependency Search (passive constructions with overt logical subjects):

We are interested in passive constructions with overt logical subjects, grouped by lemma of the verb and the lemma of the logical subject. We may use the search graph for passive constructions or build the query completly manually (shown here).

  1. First of all clear the graph editor panel (if there is any remaining graph) using search_clear.png

  2. Add four new nodes search_add-node.png you may "automatic reorder" them by clicking search_reorder-graph.png

  3. Your graph editor should look like search_t2_4nodes.png

  4. There are two ways connecting nodes / adding edges
    1. Select two nodes search_t2_addingedge-a.png and connect them clicking on search_add-edge.png

    2. Place the cursor in the middle of the desired (source) node. A green border will show up search_hl-node.png . Hold the left mousebutton and move to the (target) node. When you reached the target node again a green border shows up. Release the left mousebutton to draw an edge between those node search_t2_addingedge-b.png

  5. Double click on the nodes/edges to specify the constraints. (Note: Adding constraints may mess up the graph layout. You may use search_reorder-graph.png to redraw the graph)

    1. Node 1: Lemma = be search_t2-n1.png

    2. Node 2: Lemma = <*> (red grouping operator); Part-Of-Speech = VBN search_t2-n2.png

    3. Node 3: Form = by search_t2-n3.png

    4. Node 4: Lemma = <*> (green grouping operator) search_t2-n4.png

    5. Edge 1: Relation = VC search_t2-e1.png

    6. Edge 2: Relation = LGS search_t2-e2.png

    7. Edge 3: Relation = PMOD search_t2-e3.png

  6. When every node, edge was linked and there was no error setting the constraints above the search graph should look like this: search_t2-sg.png

    • (Textual query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]]]])

  7. Results (2D) attachment:search_result_2D-a.png attachment:search_result_2D-b.png

3) Tutorial Dependency Search (passive constructions with overt logical subjects and object):

In tutorial 1) we showed how to create a query using a copied graph from the parser. Tutorial 2) shows how to create a query from scratch. In tutorial 3) we will extend the search graph used in 2) with an additional grouping operator.

  1. We start with the following search graph search_t2-sg.png

  2. Add one new node search_add-node.png you may "automatic reorder" them by clicking search_reorder-graph.png

  3. Your graph editor should look like search_t3-n5added.png

  4. Connect the "red" node with the new node using one of the following options
    1. Select the node search_t3-addedge-c.png and connect them clicking on search_add-edge.png

    2. Place the cursor in the middle of node 2. A green border will show up search_t3-addedge-a.png . Hold the left mousebutton and move to the new node. When you reached the target node again a green border shows up search_hl-node.png . Release the left mousebutton to draw an edge between those node search_t3-addedge-b.png

  5. Double click on the new node/edge to specify the constraints. (Note: Adding constraints may mess up the graph layout. You may use search_reorder-graph.png to redraw the graph)

    1. Node 5: Lemma = <*> (browngrouping operator) search_t3-n5.png

    2. Edge 4: Relation = OBJ search_t3-e4.png

  6. When every node, edge was linked and there was no error setting the constraints above the search graph should look like this: search_t3-sg.png

    • (Textual query: [lemma=be [relation=VC, lemma<*>1, pos=VBN [relation=LGS, form=by [relation=PMOD, lemma<*>2]][relation=OBJ, lemma<*>3]]])

  7. Results (3D) attachment:search_result_3D-a.png attachment:search_result_3D-b.png

extern/ICARUS-Search-Perspective (last edited 2014-04-25 12:09:32 by GregorThiele)