Extend and patch the knowledge graph
Introduction
In Studio it is possible to extend the project's knowledge graph by adding syncons, relationships between existing syncons and user data to existing syncons.
You can also patch the existing knowledge graph by adding, deleting and modifying existing lemmas and many more actions described in detail in the dedicated page.
Warning
Extension and patching are not available if the project was imported from an old project based on the legacy technology without updating the format of the knowledge graph.
You do this using the Knowledge Graph Editor Settings window.
The extension—and patch—operations are divided into four common phases:
- (Outside Studio) Prepare the files containing the specification of the changes to be made to the knowledge graph.
- Import the above files in your Studio project: source files are pre-processed to produce files with
.kge
extension inside the project'skge
folder which are suitable for the build operation. - Build the knowledge graph with the
.kge
files produced by the pre-processing referred to in the previous point. - Reload the knowledge graph to make the extended and/or patched KG available.
All the actions described below are applied for both extension and patch operations.
Source files preparation
Files with the .txt
extension allow you to easily add entities (people, organizations, brands, products, etc.) to the knowledge graph. Files with the .csv
extension allow for more operations.
A few things to remark:
- While for the knowledge graph extension you can use both
.txt
and.csv
files, for the knowledge graph patches, only.csv
files are allowed. -
If you have to extend and patch the knowledge graph, two files are necessary:
- One with the patch operations in the Patch tab.
- One with the extension operations in the Extension tab.
Read the article in the appendix to learn how to prepare these files according to your needs.
Import .txt files
To import a .txt
file, in the Knowledge Graph Editor Settings window:
- Select the Extension tab and select Add Import File .
- Select the
.txt
file to import. The Import into Knowledge Graph dialog will appear. - In KGE Filename enter the name to give to the corresponding pre-processed file (
.kge
extension). - In Separator select the character possibly used in your
.txt
files to separate multiple lemmas for the same syncon. -
Select the button representing a funnel to look for the parent syncon. The search dialog has the same properties of the Knowledge Graph Search tool window. Your selection will fill the Parent Syncon field.
Info
The parent syncon is the syncon to which the syncons of the entities created with the extension operation will be connected with the
supernomen/subnomen
link. Entities syncons will be "children" (subnomen) of the specified parent syncon. -
In Definition enter the gloss for all the syncons listed in the file (all the syncons will have the same gloss)1.
- Check Copy in project folder to create a copy of your file in the
kge\source
folder of the project. - Select Import. The file is added to the imported files list and corresponding files with
.kge
and.import
extensions are created under the project'skge
folder. Also, thekge\main.kge
file is updated.
Import .csv files
To import a .csv
file, in the Knowledge Graph Editor Settings window:
- Select the Extension tab for extension operations or the Patch tab for patch operations.
- Select Add Import File .
- Select the
.csv
file to import. The Import into Knowledge Graph dialog will appear. - In KGE Filename enter the name to give to the corresponding pre-processed file (
.kge
extension). -
In CSV Type select:
- EXT for
.csv
files used to extend the knowledge graph. - PATCH for
.csv
files used to patch the knowledge graph.
- EXT for
-
Check Copy in project folder to create a copy of your file in the
kge\source
folder of the project. - Select Import. The file is added to the imported files list and corresponding files with
.kge
and.import
extensions are created under the project'skge
folder. Also, thekge\main.kge
file is updated.
Note
Some example files and Excel templates are already downloadable and ready to be used.
Remove a file
To remove an imported file, in the Knowledge Graph Editor Settings window:
- Select the Extension tab or the Patch tab.
- Select the file from the list, then select Remove Import File .
Corresponding files with.kge
and.import
extensions inside the project'skge
folder are deleted and thekge\main.kge
file is updated.
Change the evaluation order
Pre-processed files—those with .kge
extension in the project's kge
folder—are evaluated one after the other during the build operation, using the same order in which they are listed in the Knowledge Graph Extension Settings window.
To change the order in which files are evaluated during the build operation, in the Knowledge Graph Editor Settings window:
- Select the Extension or Patch tab.
-
Select a file, then select:
- Up to move the file up one step.
Or:
- Down to move the file down one step.
Re-import a file
To re-import a source file after some changes, in the Knowledge Graph Editor Settings window:
- Select the Extension or Patch tab.
- Select the file, then Reimport File .
Build the extended knowledge graph
- Select Build to build the extended and/or patched knowledge graph.
- In the dialog, select Yes. Studio will be restarted to apply changes.
After reloading, the extended and/or patched knowledge graph is available and changes are accessible via the Knowledge Graph and the Knowledge Graph Search tool windows.
Remove the extensions
To build a new baseline knowledge graph out of a previously extended knowledge graph, in the Knowledge Graph Editor Settings window:
- Select Remove Extensions.
- In the dialog, select Yes. Studio will be restarted after the operation.
Possible patches are not undone.
Reset the knowledge graph
To restore the original baseline knowledge graph:
- In the Knowledge Graph Editor Settings window, select Reset.
- In the dialog, select Yes. Studio will be restarted after the operation.
-
Glosses may be invisible inside the Knowledge Graph and the Knowledge Graph Search tool windows depending on the type of knowledge graph. ↩