The Knowledge Graph tool window is the main interface to the project's Knowledge Graph.
It shows information about syncons that have been selected in other tool windows, but can also be be used to search, navigate and explore the Knowledge Graph to find the syncons and lemmas needed for categorization and extraction rules.
The window contains three strips, from top to bottom:
- The variable name, "upwards linked syncons" strip, with a blue band on the left
- The Syncons strip, with a red band on the left
- The variable name, "downwards linked syncons" strip, with a green band on the left
The entire colored band and the Expand and Collapse buttons on the left of each strip act as toggle switches to turn on and off the full-window display of the strip.
The Syncons strip shows all the syncons matching a search but can also show the syncon that has been selected in other sections of the tool window or in another tool window.
In the rest of this article the term current syncon will be used to refer to the syncon that's selected in the Syncons strip.
"Upwards linked syncons" strip
This strip shows syncons that are linked "upwards" with the current syncon along the link that's selected in the toolbar's Link drop-down list.
The strip name comes from the left part of the link name, so for example, if the link name is supernomen/subnomen, the strip is named Supernomen, and shows the parent of the current syncon in the
"Downwards linked syncons" strip
This strip shows syncons that are linked "downwards" with the current syncon along the link that's selected in the toolbar's Link drop-down list.
The strip name comes from the right part of the link name, so for example, if the link is
supernomen/subnomen, the strip is named Subnomen and shows the children of the current syncon in the
Stripes initially contain rows representing syncons.
Syncon rows can be expanded to show syncon lemmas, which are displayed in separate rows.
Rows representing syncons are identified by an icon that corresponds to the part-of-speech and they have these elements:
|Expand/collapse toggle switch||Button that shows or hides syncon's lemmas|
|Part-of-speech symbol||An icon corresponding to the syncon part-of-speech.|
|Lemmas column||A comma separated sequence of syncon's lemmas; if there are many lemmas, the list is truncated and the number of items that are not displayed is shown at the end of the list prefixed by the plus sign (
|F column||Syncon frequency|
|W column||Syncon weight|
|Domains column||Knowledge domains the syncon belongs to|
|ID column||Syncon identification number|
|Pin column||Pin toggle switch|
Rows that represent the lemmas of a syncon are marked by the icon with a capital L and they have these elements:
|Lemmas column||The lemma plus possible properties like extra information, marked with capital letter E, and register information, marked with capital letter R|
|F column||Lemma frequency|
|W column||Lemma weight|
|Pin column||Pin toggle switch|
The icons that identify part-of-speech are:
|Go Back and Go Forward||Go back and forth in the search history.|
|Search box and list||Specify the search criteria. The box has an auto-complete feature that automatically suggests lemmas while you type. The drop-down list shows the search history.|
|Find||Start a search.|
|Match Case||When activated, results must match the case of the search criteria.|
|Links list||Knowledge graph links. After a search, only the links the current syncon belongs to are shown.|
|Full Hierarchy View||Turn on and off the ancestry visualization in the "upwards linked syncons" strip.|
|Custom Data View||Turn on and off the display of additional information about the current syncon in the Custom Data panel that appears in the right part of the Syncons strip.|
|Toggle Advanced Pin Mode||When activated, additional columns are shown on the right of the strips to allow for pinning not only the syncons but also custom data.|
|Clear||Clear the results, the search box and the list of pinned items, but not the search history.|
Enter key can be used as an alternative to the Find button to start a search.
Context menu commands
|Pin / Unpin||Pin/unpin the current item|
|Pin all lemmas||Pin all the current item's lemmas|
|Copy selected syncon Id||(Only for syncons) Copy the selected syncons IDs in the clipboard as a comma separated list|
|Set as Syncon ID 1 in PathFinder||(Only for syncons) Copy the ID of the current syncon in the Syncon ID 1 field of the Path Finder panel of the Knowledge Graph Search tool window|
|Set as Syncon ID 2 in PathFinder||(Only for syncons) Copy the ID of the current syncon in the Syncon ID 2 field of the Path Finder panel of the Knowledge Graph Search tool window|
Multiple selection is possible.
Double-clicking an item—s syncon or a lemma—in the Syncons strip act as a toggle switch to pin or unpin the item itself.
Double-clicking a syncon in one of the two "linked syncons" strips makes the selected syncon become the new current syncon. It is displayed in the Syncons strip and the other two strips are updated to show syncons that are linked with the new current syncon.
Pinned Syncons and Lemmas pane
The Pinned Syncons and Lemmas pane allows managing pinned items and "commiting" their data to the cursor position in the rules files that's currently open in the editor.
This pane is similar to a clipboard, since pinning and committing resemble copy-and-paste operations.
The pane appears after the first item has been pinned and disappears if emptied.
Each pinned item has an identifying symbol on the right:
Syncon information include:
- Knowledge domains the syncon belongs to
- Part-of-speech icon
|Commit button||Paste pinned items' data at the cursor position in the current file inside the editor; what's actually pasted depends of the choice in Commit Format|
|Clipboard commands drop-down menu||Copy pinned items' data to the clipboard|
|Commit Format drop-down menu||Choose the format in which pinned items' data is committed or copied to the clipboard|
|Hide checkbox||Minimize the Knowledge Graph tool window after the commit action|
The commit action is only successful if the current file in the editor is a rules file. Otherwise you will have an error.
Possible choices for Commit Format are:
The clipboard commands drop-down menu has the following commands:
|Copy all lemmas of selected items||Copy the lemmas of the selected items to the clipboard|
|Copy all lemmas of all list items||Copy the lemmas of the all pinned items to the clipboard|
|Copy code snippet||Copy a code snippet based on the value of Commit Format to the clipboard (see above)|
Context menu commands
|Unpin||Unpin the current item|
|Unpin all||Unpin all the items|
|Browse||(only for syncons) Open the selected syncons in the Syncons strip, the first becoming the new current syncon|
|Copy selected syncon ID||(Only for syncons) Copy the selected syncons' IDs in the clipboard as a comma separated list|
|Set as Syncon ID 1 in PathFinder||(Only for syncons) Copy the ID of the current syncon in the Syncon ID 1 field of the Path Finder tab of the Knowledge Graph Search tool window|
|Set as Syncon ID 2 in PathFinder||(Only for syncons) Copy the ID of the current syncon in the Syncon ID 2 field of the Path Finder tab of the Knowledge Graph Search tool window|
Multiple selection is possible.
The info bar shows the number of pinned items, by type.
The info bar is divided in three parts, from left to right:
- Current module indicator/selector
- Number of syncons in the Syncons strip, in the upwards linked sysncons strip and in the downwards linked syncons strip
- Number of pinned items, by type.
The current module indicator/selector shows the language and the name of the current project module. The list allows switching to another module to change the context of syncons and lemmas selection.
Full hierarchy view
In full hirerachy view mode, the "upwards linked syncons" strip initially shows, instead of individual syncons, special items that comprise the hierarchical ancestry of the "parent" of the current syncon except for the root syncon of the hierarchy.
These items, when expanded, show all the syncons that make up that ancestry.
In the following picture, syncon emberizid is the parent of syncon finch in the supernomen/subnomen hierarchy.
In full hierarchy view mode, instead of the emeberizid sycon, the entire hierarchical path up to verterbrate is shown and, if the ancestry item is expanded, all the syncon along the path plus the root syncon of the hierarchy are showm from the most generic (animal) down to the more specific (emnberizid).
The syncons can then be expanded themselves to show their lemmas.
In this mode, the item representing the entire ancestry is described, in the Lemma column, by a sequence of lemmas corresponding to the sycons along the hierarchical path, from the more specific to the more generic and far ancestor. Lemmas in the sequence are separated by double right-pointing angle quotation marks (»).
To enter and exit this mode, use the Full Hierachy View button on the toolbar.