Differences between revisions 1 and 9 (spanning 8 versions)
⇤ ← Revision 1 as of 2014-02-04 10:29:35 →
Size: 75
Editor: GregorThiele
Comment:
← Revision 9 as of 2014-02-06 12:29:14 → ⇥
Size: 13712
Editor: GregorThiele
Comment:
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:

<<Anchor(icarus-coref-index)>>
== Index: ==
 I. [[#how-to-add-coref|How to add a new document-set]]
 I. [[#coreference-menu|Coreference Menu]]
 I. [[#coreference-document-outline|Document Outline]]

[[#icarus-coref-index|Back To Index]]


<<Anchor(how-to-add-coref)>>
== How to add a new document-set: ==
 1. Click {{attachment:coref_add.png}} to add a new document-set.
 1. The {{attachment:coref_document-set.png}} document-set editor shows up [[attachment:coref_document-set-editor.png|{{attachment:coref_document-set-editor.png||width=250}}]]
  * Name: specify the document-set that will show up in the Coref-Manager list.
  * Location: document-set location on the file system (local/network).
  * Reader: Set the reader for the new document-set. E.g.: CONLL12
  * Properties: (currently not used)

  * {{attachment:coref_document-set_example.png||align="top"}}
   * {{attachment:coref_document-set-loaded.png}} = Document-set loaded (location correct)
   * {{attachment:coref_document-set-error.png}} = No location set
   * {{attachment:coref_document-set.png}} = Document-set not loaded yet

 1. New allocations can be added clicking on {{attachment:coref_add-allocation.png}} which will open the allocation editor [[attachment:coref_editor-allocation.png|{{attachment:coref_editor-allocation.png||width=250}}]]
  * Name: specify the allocation name
  * Location: allocation location on the file system (local/network).
  * Reader: Reader for the new allocation
  * Properties: (currently not used)


  * {{attachment:coref_allocation_example.png||align="top"}} The icons show the allocation status {{attachment:error.png}} = No location set, {{attachment:loaded.png}} = Allocation loaded (location correct).

 1. To view the document-set with the specified allocation click {{attachment:coref_inspect.png}}
 1. Resulting document-outline for the document-set including coreference highlight (same color = same coreferent-set) [[attachment:coref_document-outline_example.png|{{attachment:coref_document-outline_example.png||width=250}}]]


[[#icarus-coref-index|Back To Index]]


<<Anchor(coreference-menu)>>
== Coreference Menu: ==


=== Coref-Manager ===

{{attachment:coref_manager.png}}

'''Coref-Manager Toolbar: {{attachment:coref_manager-tb.png}}'''
 * {{attachment:coref_add.png}} = Add new {{attachment:coref_document-set.png}} document-set
 * {{attachment:coref_delete.png}} = Delete selected {{attachment:coref_document-set.png}} document-set
 * {{attachment:coref_edit.png}} = Edit selected {{attachment:coref_document-set.png}} document-set
 * {{attachment:coref_inspect.png}} = Inspect selected {{attachment:coref_document-set.png}} document-set. Note {{attachment:coref_document-set-loaded.png}} indicates that the document-set was loaded successful.


 * {{attachment:coref_add-allocation.png}} = Add new allocation to selected document-set
 * {{attachment:coref_delete-allocation.png}} = Delete selected allocation
 * {{attachment:coref_edit-allocation.png}} = Edit selected allocation

 * {{attachment:coref_show-property.png}} = Open the Property Info dialog

 * {{attachment:coref_collapse-all.png}} = Collapse all document-sets in the list. Note: Document-set may be opened/closed clicking on {{attachment:open.png}} / {{attachment:close.png}}

----

=== Coref-Explorer ===

{{attachment:coref_explorer.png}} {{attachment:coref_explorer-loading.png}}


[[#icarus-coref-index|Back To Index]]

----

<<Anchor(coreference-document-outline)>>
== Document Outline: ==

The document outline supports three different presentation styles for document-sets:

 i. [[#coreference-document-outline-text|Document Outline Text]]
 i. [[#coreference-document-outline-graph|Document Outline Graph]]
 i. [[#coreference-document-outline-grid|Document Outline Grid]]



<<Anchor(coreference-document-outline-text)>>
=== Document Outline Text: ===
[[attachment:coref_document-outline-text.png|{{attachment:coref_document-outline-text.png||width=250}}]]

''' Document Outline Text Toolbar: ''' {{attachment:coref_document-outline-text-tb.png}}
 * {{attachment:coref_presenter-text.png}} = Selected presenter style (in this example text)
 * {{attachment:coref_selected_doc.png}} = Selected document
 * {{attachment:coref_show-property-outline.png}} = Show property outline
 * {{attachment:coref_show-context-outline-greyed.png}} = Text view is identical to the context outline. Therefore the context outline is shown greyed.
 * {{attachment:coref_show-property.png}} = Open the Property Info dialog
 * {{attachment:refresh.png}} = Refresh View
 * {{attachment:clear_view.png}} = Clear View

 * {{attachment:preferences.png}} = Open the preferences
 * {{attachment:coref_hl-type.png}} = Five different types to highlight spans.
  * Background: {{attachment:coref_hl_background.png}}
  * Foreground: {{attachment:coref_hl_foreground.png}}
  * Underlined: {{attachment:coref_hl_underlined.png}}
  * Italic: {{attachment:coref_hl_italic.png}}
  * Bold: {{attachment:coref_hl_bold.png}}

 * {{attachment:coref_hl-spans.png}} = Turn on/off the span highlight
 * {{attachment:coref_force-lb.png}} = Every sentence is in a new line. (default on)
 * {{attachment:coref_show-sindex.png}} = Show the sentence index (red border){{attachment:coref_show-index_example.png||align="middle"}} (default on)
 * {{attachment:coref_show-dh.png}} = Display the current document header (red border) {{attachment:coref_document-header_example.png||align="middle"}} (default on)
 * {{attachment:coref_show-offset.png}} = Show the sentence index (red border){{attachment:coref_show-offset_example.png}} (default off)
 * {{attachment:coref_show-cluster.png}} = Show the sentence index (red border){{attachment:coref_show-cluster_example.png}} (default off)

 * {{attachment:filter_apply.png}} = Filter selected span. (Only words within the selected span are highlighted. The filter may be removed clicking either {{attachment:filter_reset.png}} or {{attachment:refresh.png}} (Note this refresh the whole view). (Also accessible via rightlick mouse context menu)
 * {{attachment:filter_reset.png}} = Remove the selected span filter. (Also accessible via rightlick mouse context menu)

 * {{attachment:coref_hits.png}} =

 * {{attachment:coref_mode.png}} = Four different modes:
  * default =
  * Gold =
  * False positives =
  * False negatives =

 * {{attachment:refresh.png}} = Refresh View
 * {{attachment:coref_filter-singleton.png}} = Filter out all singletons (default on)
 * {{attachment:coref_filter-nonhl.png}} = Filter out all singletons
 * {{attachment:coref_hint_errortypes.png}} = ICARUS distinguish between five error types (figure below)
  * {{attachment:coref_errortypes.png}}



<<Anchor(coreference-document-outline-graph)>>
=== Document Outline Graph: ===
Pairwise links output by an automatic coreference system can be treated as arcs in a directed graph. Linking the first mention of each cluster to an artificial root node creates a tree structure that encodes the entire clustering in a document.

In the example solid nodes/arcs present the predicted annotation whereas dashed nodes/arcs present the gold annotation. Discrepancies between predicted and gold are marked with different colors that show the different types of errors.

[[attachment:coref_document-set-graph.png|{{attachment:coref_document-set-graph.png||width=250}}]]



''' Document Outline Graph Toolbar ''' {{attachment:coref_document-set-graph-tb.png}}

 * {{attachment:coref_presenter-graph.png}} = Selected presenter style (in this example graph)
 * {{attachment:coref_selected_doc.png}} = Selected document
 * {{attachment:coref_show-property-outline.png}} = Show property outline
 * {{attachment:coref_show-context-outline.png}} = Show sentences (red border) below the tree [[attachment:coref_document-set-graph_text-on.png|{{attachment:coref_document-set-graph_text-on.png||height=150}}]]
  * [[#coreference-context-outline-tb|Context Outline Toolbar]] {{attachment:coref_document-set-graph_text-tb.png}}
 * {{attachment:coref_show-property.png}} = Open the Property Info dialog
 * {{attachment:refresh.png}} = Refresh View
 * {{attachment:clear_view.png}} = Clear View


 * {{attachment:preferences.png}} = Open the preferences
 * {{attachment:clear.png}} = Clear View
 * {{attachment:export.png}} = Save the current graph to XML file (may be imported later)
 * {{attachment:import.png}} = Import graph from XML file
 * {{attachment:print.png}} = Print current graph
 * {{attachment:delete.png}} = Delete selectd node(s)/edge(s)
 * {{attachment:copy.png}} = Copy selectd node(s)/edge(s)
 * {{attachment:refresh.png}} = Refresh View

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

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

 * {{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)

 * {{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. (default off)

 * {{attachment:coref_show-sindex.png}} = Show the sentence index (red border) {{attachment:coref_show-sindex-graph.png|align="middle"}} (default on)

 * {{attachment:coref_mark-false-edge.png}} = Mark false edges(default on)
 * {{attachment:coref_mark-false-node.png}} = Mark false nodes (default on)

 * {{attachment:coref_include-gold-edge.png}} = Include gold edges(default off)
 * {{attachment:coref_include-gold-node.png}} = Include gold nodes(default off)

 * {{attachment:coref_hint_errortypes.png}} = ICARUS distinguish between five error types (figure below)
  * {{attachment:coref_errortypes.png}}


<<Anchor(coreference-document-outline-grid)>>
=== Document Outline Entity Grid: ===

Barzilay and Lapata [1] introduce the entity grid, a tabular view of entities in a document. Specifically, rows of the grid correspond to sentences, and columns to entities. The cells of the table are used to indicate that an entity is mentioned in the corresponding sentence. Entity grids provide a compact view on the distribution of mentions in a document and allows the user to see how the description of an entity changes from mention to mention.
[[attachment:coref_document-set-entity.png|{{attachment:coref_document-set-entity.png||width=250}}]]

''' Document Outline Entity Toolbar ''' {{attachment:coref_document-set-entity-tb.png}}


[1] Regina Barzilay and Mirella Lapata. 2008. Modeling Local Coherence: An Entity-Based Approach. Computational Linguistics, 34(1):1–34.



[[#icarus-coref-index|Back To Index]]

----

<<Anchor(coreference-context-outline-tb)>>
'''Context Outline Toolbar:'''
{{attachment:coref_document-set-graph_text-tb.png}} ]

 * {{attachment:preferences.png}} = Open the preferences
 * {{attachment:coref_hl-type.png}} = Five different types to highlight spans.
  * Background: {{attachment:coref_hl_background.png}}
  * Foreground: {{attachment:coref_hl_foreground.png}}
  * Underlined: {{attachment:coref_hl_underlined.png}}
  * Italic: {{attachment:coref_hl_italic.png}}
  * Bold: {{attachment:coref_hl_bold.png}}

 * {{attachment:coref_hl-spans.png}} = Turn on/off the span highlight
 * {{attachment:coref_force-lb.png}} = Every sentence is in a new line. (default on)
 * {{attachment:coref_show-sindex.png}} = Show the sentence informations ''SentenceNo-BeginIndex-EndIndex'' (red border) Example: SentenceNo=0, BeginIndex=24 and EndIndex=25 {{attachment:coref_show-index_example.png||align="middle"}}. (default on)
 * {{attachment:coref_show-dh.png}} = Display the current document header (red border) {{attachment:coref_document-header_example.png||align="middle"}} (default on)
 * {{attachment:coref_show-offset.png}} = Show the sentence index (red border){{attachment:coref_show-offset_example.png}} (default off)
 * {{attachment:coref_show-cluster.png}} = Show the sentence index (red border){{attachment:coref_show-cluster_example.png}} (default off)

 * {{attachment:filter_apply.png}} = Filter selected span. (Only words within the selected span are highlighted. The filter may be removed clicking either {{attachment:filter_reset.png}} or {{attachment:refresh.png}} (Note this refresh the whole view). (Also accessible via rightlick mouse context menu)
 * {{attachment:filter_reset.png}} = Remove the selected span filter. (Also accessible via rightlick mouse context menu)

 * {{attachment:coref_hits.png}} =
 * {{attachment:coref_scope}} = Corrent scope how many surrounding sentences should be displayed (1...5). Example assume the sentence with the mention is at index 3. by default dentence two and four are shown too. At most sentence 1,2, '''3''', 4 ... 8 will be displayed (scope set to five).

 * {{attachment:refresh.png}} = Refresh View
 * {{attachment:coref_filter-singleton.png}} = Filter out all singletons (default on)
 * {{attachment:coref_filter-nonhl.png}} = Filter out all singletons
 * {{attachment:coref_hint_errortypes.png}} = ICARUS distinguish between five error types (figure below)
  * {{attachment:coref_errortypes.png}}

[[#icarus-coref-index|Back To Index]]

ICARUS-Coreference-Perspective

Back To ICARUS Main Page

Index:

  1. How to add a new document-set

  2. Coreference Menu

  3. Document Outline

Back To Index

How to add a new document-set:

  1. Click coref_add.png to add a new document-set.

  2. The coref_document-set.png document-set editor shows up attachment:coref_document-set-editor.png

    • Name: specify the document-set that will show up in the Coref-Manager list.
    • Location: document-set location on the file system (local/network).
    • Reader: Set the reader for the new document-set. E.g.: CONLL12
    • Properties: (currently not used)

    • coref_document-set_example.png

      • coref_document-set-loaded.png = Document-set loaded (location correct)

      • coref_document-set-error.png = No location set

      • coref_document-set.png = Document-set not loaded yet

  3. New allocations can be added clicking on coref_add-allocation.png which will open the allocation editor attachment:coref_editor-allocation.png

    • Name: specify the allocation name
    • Location: allocation location on the file system (local/network).
    • Reader: Reader for the new allocation
    • Properties: (currently not used)

    • coref_allocation_example.png The icons show the allocation status error.png = No location set, loaded.png = Allocation loaded (location correct).

  4. To view the document-set with the specified allocation click coref_inspect.png

  5. Resulting document-outline for the document-set including coreference highlight (same color = same coreferent-set) attachment:coref_document-outline_example.png

Back To Index

Coreference Menu:

Coref-Manager

coref_manager.png

Coref-Manager Toolbar: coref_manager-tb.png

  • coref_add.png = Add new coref_document-set.png document-set

  • coref_delete.png = Delete selected coref_document-set.png document-set

  • coref_edit.png = Edit selected coref_document-set.png document-set

  • coref_inspect.png = Inspect selected coref_document-set.png document-set. Note coref_document-set-loaded.png indicates that the document-set was loaded successful.

  • coref_add-allocation.png = Add new allocation to selected document-set

  • coref_delete-allocation.png = Delete selected allocation

  • coref_edit-allocation.png = Edit selected allocation

  • coref_show-property.png = Open the Property Info dialog

  • coref_collapse-all.png = Collapse all document-sets in the list. Note: Document-set may be opened/closed clicking on open.png / close.png

Coref-Explorer

coref_explorer.png coref_explorer-loading.png

Back To Index

Document Outline:

The document outline supports three different presentation styles for document-sets:

  1. Document Outline Text

  2. Document Outline Graph

  3. Document Outline Grid

Document Outline Text:

attachment:coref_document-outline-text.png

Document Outline Text Toolbar: coref_document-outline-text-tb.png

  • coref_presenter-text.png = Selected presenter style (in this example text)

  • coref_selected_doc.png = Selected document

  • coref_show-property-outline.png = Show property outline

  • coref_show-context-outline-greyed.png = Text view is identical to the context outline. Therefore the context outline is shown greyed.

  • coref_show-property.png = Open the Property Info dialog

  • refresh.png = Refresh View

  • clear_view.png = Clear View

  • preferences.png = Open the preferences

  • coref_hl-type.png = Five different types to highlight spans.

    • Background: coref_hl_background.png

    • Foreground: coref_hl_foreground.png

    • Underlined: coref_hl_underlined.png

    • Italic: coref_hl_italic.png

    • Bold: coref_hl_bold.png

  • coref_hl-spans.png = Turn on/off the span highlight

  • coref_force-lb.png = Every sentence is in a new line. (default on)

  • coref_show-sindex.png = Show the sentence index (red border)coref_show-index_example.png (default on)

  • coref_show-dh.png = Display the current document header (red border) coref_document-header_example.png (default on)

  • coref_show-offset.png = Show the sentence index (red border)coref_show-offset_example.png (default off)

  • coref_show-cluster.png = Show the sentence index (red border)coref_show-cluster_example.png (default off)

  • filter_apply.png = Filter selected span. (Only words within the selected span are highlighted. The filter may be removed clicking either filter_reset.png or refresh.png (Note this refresh the whole view). (Also accessible via rightlick mouse context menu)

  • filter_reset.png = Remove the selected span filter. (Also accessible via rightlick mouse context menu)

  • coref_hits.png =

  • coref_mode.png = Four different modes:

    • default =
    • Gold =
    • False positives =
    • False negatives =

  • refresh.png = Refresh View

  • coref_filter-singleton.png = Filter out all singletons (default on)

  • coref_filter-nonhl.png = Filter out all singletons

  • coref_hint_errortypes.png = ICARUS distinguish between five error types (figure below)

    • coref_errortypes.png

Document Outline Graph:

Pairwise links output by an automatic coreference system can be treated as arcs in a directed graph. Linking the first mention of each cluster to an artificial root node creates a tree structure that encodes the entire clustering in a document.

In the example solid nodes/arcs present the predicted annotation whereas dashed nodes/arcs present the gold annotation. Discrepancies between predicted and gold are marked with different colors that show the different types of errors.

attachment:coref_document-set-graph.png

Document Outline Graph Toolbar coref_document-set-graph-tb.png

  • coref_presenter-graph.png = Selected presenter style (in this example graph)

  • coref_selected_doc.png = Selected document

  • coref_show-property-outline.png = Show property outline

  • coref_show-context-outline.png = Show sentences (red border) below the tree attachment:coref_document-set-graph_text-on.png

  • coref_show-property.png = Open the Property Info dialog

  • refresh.png = Refresh View

  • clear_view.png = Clear View

  • preferences.png = Open the preferences

  • clear.png = Clear View

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

  • import.png = Import graph from XML file

  • print.png = Print current graph

  • delete.png = Delete selectd node(s)/edge(s)

  • copy.png = Copy selectd node(s)/edge(s)

  • refresh.png = Refresh View

  • undo.png = Undo last operation

  • redo.png = Redo last operation

  • zin.png = Increase zoom level

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

  • zout.png = Decrease zoom level

  • hl_inedge.png = Highlight the incoming edge of the selected node (multiselection possible) (default off)

  • hl_outedge.png = Highlight the outgoing edge/edges of the selected node (multiselection possible) (default off)

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

  • zcompress.png = Compress graph (right-left). Merge node/edge information into a node. (default off)

  • coref_show-sindex.png = Show the sentence index (red border) align="middle" (default on)

  • coref_mark-false-edge.png = Mark false edges(default on)

  • coref_mark-false-node.png = Mark false nodes (default on)

  • coref_include-gold-edge.png = Include gold edges(default off)

  • coref_include-gold-node.png = Include gold nodes(default off)

  • coref_hint_errortypes.png = ICARUS distinguish between five error types (figure below)

    • coref_errortypes.png

Document Outline Entity Grid:

Barzilay and Lapata [1] introduce the entity grid, a tabular view of entities in a document. Specifically, rows of the grid correspond to sentences, and columns to entities. The cells of the table are used to indicate that an entity is mentioned in the corresponding sentence. Entity grids provide a compact view on the distribution of mentions in a document and allows the user to see how the description of an entity changes from mention to mention. attachment:coref_document-set-entity.png

Document Outline Entity Toolbar coref_document-set-entity-tb.png

[1] Regina Barzilay and Mirella Lapata. 2008. Modeling Local Coherence: An Entity-Based Approach. Computational Linguistics, 34(1):1–34.

Back To Index

Context Outline Toolbar: coref_document-set-graph_text-tb.png ]

  • preferences.png = Open the preferences

  • coref_hl-type.png = Five different types to highlight spans.

    • Background: coref_hl_background.png

    • Foreground: coref_hl_foreground.png

    • Underlined: coref_hl_underlined.png

    • Italic: coref_hl_italic.png

    • Bold: coref_hl_bold.png

  • coref_hl-spans.png = Turn on/off the span highlight

  • coref_force-lb.png = Every sentence is in a new line. (default on)

  • coref_show-sindex.png = Show the sentence informations SentenceNo-BeginIndex-EndIndex (red border) Example: SentenceNo=0, BeginIndex=24 and EndIndex=25 coref_show-index_example.png. (default on)

  • coref_show-dh.png = Display the current document header (red border) coref_document-header_example.png (default on)

  • coref_show-offset.png = Show the sentence index (red border)coref_show-offset_example.png (default off)

  • coref_show-cluster.png = Show the sentence index (red border)coref_show-cluster_example.png (default off)

  • filter_apply.png = Filter selected span. (Only words within the selected span are highlighted. The filter may be removed clicking either filter_reset.png or refresh.png (Note this refresh the whole view). (Also accessible via rightlick mouse context menu)

  • filter_reset.png = Remove the selected span filter. (Also accessible via rightlick mouse context menu)

  • coref_hits.png =

  • coref_scope = Corrent scope how many surrounding sentences should be displayed (1...5). Example assume the sentence with the mention is at index 3. by default dentence two and four are shown too. At most sentence 1,2, 3, 4 ... 8 will be displayed (scope set to five).

  • refresh.png = Refresh View

  • coref_filter-singleton.png = Filter out all singletons (default on)

  • coref_filter-nonhl.png = Filter out all singletons

  • coref_hint_errortypes.png = ICARUS distinguish between five error types (figure below)

    • coref_errortypes.png

Back To Index

extern/ICARUS-Coreference-Perspective (last edited 2014-07-17 08:13:54 by MarkusGaertner)