How To ..

This document contains a description of common routines used in VisDic.

Contents:

• 1. Dictionary Management
  • 1.1 How to open dictionaries
  • 1.2 How to save a dictionary
  • 1.3 How to load a dictionary
  • 1.4 How to export a dictionary to an XML file
• 2. Browsing the dictionary
  • 2.1 How to search an entry
  • 2.2 How to show a translation of an entry
  • 2.3 How to show an entry in other dictionary using non-standard relations
  • 2.4 How to search all topmost entries in a tree
  • 2.5 How to show a list of all words in a specific XML tag
  • 2.6 How to show a list of all entries in a dictionary
  • 2.7 How to show a list of selected entries in a dictionary
• 3. Editing the WordNet dictionary
  • 3.1 How to remove a literal from a synset
  • 3.2 How to add a literal to a synset
  • 3.3 How to change a literal in a synset
  • 3.4 How to delete a synset relation
  • 3.5 How to add a synset relation
  • 3.6 How to add a new synset
  • 3.7 How to link a synset via ILI of another WordNet synset
  • 3.8 How to link a synset using non-standard relation
  • 3.9 How to delete a synset
  • 3.10 How to copy the whole tree from one WordNet to another

1. Dictionary Management

1.1 How to open dictionaries

1. Activate the item "Files->Dictionaries..." from the main menu.
2. Move dictionaries you want to work with to the right list by clicking on left and right arrows.
Every dictionary you want to move must be selected first by clicking on it.
3. Arrange selected dictionaries by clicking on up and down arrows.
4. The topmost selected dictionary will be opened as the leftmost in the main window.
5. Click on "OK" button.

1.2 How to save a dictionary

Every dictionary in VisDic has 9 back-up slots for storing the data. These slots correspond to the folders bookmark1 ... bookmark9 in the dictionary folder.

1. Activate the item "Files->Save Bookmark" from the main menu.
2. Choose a name of the dictionary you want to save.
3. Choose a bookmark number for storing the data.
4. Click on "OK" button.
5. Wait for a respond whether the operation was successful or not.

1.3 How to load a dictionary

1. Activate the item "Files->Load Bookmark" from the main menu.
2. Choose a name of the dictionary you want to load.
3. Choose a bookmark number for restoring the data.
4. Click on "OK" button.
5. Wait for a respond whether the operation was successful or not.

1.4 How to export a dictionary to an XML file

1. Activate the item "Files->Export to XML..." from the main menu.
2. Choose a name of the dictionary you want to export.
3. Choose a file name of the target XML file. You can type it manually or invoke another dialog for browsing your file system clicking on "..." button.
4. Click on "OK" button.

2. Browsing the dictionary

2.1 How to search an entry

1. Enter the word you want to search in the edit box at the top of a dictionary frame.
2. Corresponding entries will be shown in a list placed below the edit box.
3. When you click on an entry in the list, it will be displayed in a notebook page placed below the list.
4. The notebook contains several types of view of the active entry. You can select a desired type of view by clicking on the corresponding page label placed at the top of the notebook.

2.2 How to show a translation of an entry

If two dictionaries are linked (e.g. WordNets through the ILI number), it is possible to show the entry in other dictionary. You can achieve it by the following way:

1. If you are in a tree view, click on the synset you want to show by the left mouse button.
2. Invoke a context sensitive menu by the right mouse button.
3. While holding the mouse button down, move to a "Show in XXX" item, where XXX is a name of the target dictionary.
4. Release the right mouse button.

Note: If the target entry does not exist, a new entry in the target dictionary will be prepared for editing. These two entries will be linked.

2.3 How to show an entry in other dictionary using non-standard relations

Entries in two different dictionaries can be also linked via other relations. You can show these relations by this way:

1. When you are in a tree view of the source dictionary, click on a synset you want to show by the left mouse button.
2. Invoke a context sensitive menu by the right mouse button.
3. While holding the mouse button down, move to the "Show YYY in XXX" item, where YYY is a name of the relation you wish to view, XXX is a name of the target dictionary.
4. Release the right mouse button.

Note: List of non-standard relations is specified in the dictionary .cfg file as EQ_TAGS.

Example:

  <EQ_TAGS>
    <EQ_TAG>SYNSET.EQ_HYPERONYM</EQ_TAG>
    <EQ_TAG>SYNSET.EQ_HYPONYM</EQ_TAG>
  </EQ_TAGS>

2.4 How to search all topmost entries in a tree

1. Activate the tree page (e.g. "HH Tree" in a WordNet dictionary).
2. Move the cursor to the area of the tree.
3. Invoke a context sensitive menu by the right mouse button.
4. While holding the mouse button down, move to the "Find topmost entries" item.
5. Release the right mouse button.

2.5 How to show a list of all words in a specific XML tag

You can show all words present in a specific XML tag using a special view represented by a notebook page. You can achieve it by adding new LIST tag with the type WORD into the VIEW definition stored in the dictionary .cfg file.

Example: If you wish to list all words present in SYNSET.SYNONYM.LITERAL tag, add these lines to the dictionary .cfg file (Words is a name of a notebook page):

  <LIST>
    <TYPE>	WORD			</TYPE>
    <NAME>	Words       		</NAME>
    <TAG>	SYNSET.SYNONYM.LITERAL	</TAG>
  </LIST>

2.6 How to show a list of all entries in a dictionary

You can show all entries in a dictionary using a special view represented by a notebook page. You can achieve it by adding new LIST tag with the type ENTR into the VIEW definition stored in the dictionary .cfg file.

Example: If you wish to list all entries in a dictionary, add these lines to the dictionary .cfg file (Entries is a name of a notebook page, VISDIC_SHORT is a definition used for displaying entries):

  <LIST>
    <TYPE>	ENTR			</TYPE>
    <NAME>	Entries  		</NAME>
    <DEF>	VISDIC_SHORT		</DEF>
  </LIST>

2.7 How to show a list of selected entries in a dictionary

You can show a subset of entries in a dictionary using a special view represented by a notebook page. You can achieve it by adding new LIST tag with the type ENTR into the VIEW definition stored in the dictionary .cfg file and with specified query which selects the subset of entries.

Example: You wish to list all base concepts in a WordNet dictionary. All base concepts have set SYNSET.BASE tag to the value "*". Add these lines to the dictionary .cfg file (VISDIC_SHORT is a definition used for displaying entries):

  <LIST>
    <TYPE>	ENTR			</TYPE>
    <NAME>	Base Concepts  		</NAME>
    <DEF>	VISDIC_SHORT		</DEF>
    <QUERY>	SYNSET.BASE="*"		</QUERY>
  </LIST>

3. Editing the WordNet dictionary

3.1 How to remove a literal from a synset

1. Look up the desired synset and activate the "Edit" page.
2. Click on "-" button right from the literal you want to remove.
3. Click on "Update" button at the bottom of a form.

3.2 How to add a literal to a synset

1. Look up the desired synset and activate the "Edit" page.
2. Click on "+" button right from any existing literal. A new literal will be placed under the one you click on.
3. Type the literal you want to add and its sense to the freshly created edit areas.
4. Click on "Update" button at the bottom of a form.

3.3 How to change a literal in a synset

1. Look up the desired synset and activate the "Edit" page.
2. Edit the literal you want to change or its sense.
3. Click on "Update" button at the bottom of a form.

Note: This procedure deletes only one synset. Related synsets will be preserved.

3.4 How to delete a synset relation

1. Look up the desired synset and activate the "Edit" page.
2. Click on "-" button right from the relation you want to remove.
3. Click on "Update" button at the bottom of a form.

3.5 How to add a synset relation

1. Look up the desired synset and activate the "Edit" page.
2. Click on "+" button right from any existing relation. A new relation will be placed under the one you click on.
3. Now read carefully: Because relations are pointers to the other synsets, they are edited by a special way.
4. Type a literal belonging to the related synset and press "Enter" as if you want to search entries.
5. Corresponding synsets will be placed into a list which can be invoked by clicking on "down" button right from the edit box.
6. Once you have the list invoked, select a synset you want to make relation with.
7. Click on "Update" button at the bottom of a form.

3.6 How to add a new synset

1. Activate the "Edit" page.
2. If you want to have a synset linked via ILI, follow instructions 2.2. Note you will also automatically get a synset gloss. Continue with the step 4.
3. If you want just to create a new entry without linking via ILI (e.g. in case it does not exist in the other WordNet), click on "New" button at the bottom of a form.
4. Add new literals, relations and part of speech (these procedures were described above).
5. Click on "Update" button at the bottom of a form.

3.7 How to link a synset via ILI of another WordNet synset

1. Look up the desired synset in a pattern WordNet (e.g. English).
2. Move to your WordNet.
3. Search the synset you want your synset to be linked with.
4. If you are in a tree view, click on the synset you want to link by the left mouse button.
5. Invoke a context sensitive menu by the right mouse button.
6. While holding the button down move to the "Take key from XXX" item, where XXX is a name of the pattern WordNet.
7. Release the right mouse button.

3.8 How to link a synset using non-standard relation

1. Look up the desired synset in a pattern WordNet (e.g. English).
2. Move to your WordNet.
3. Search the synset you want your synset to be linked with.
4. If you are in a tree view, click on the synset you want to link by the left mouse button.
5. Invoke a context sensitive menu by the right mouse button.
6. While holding the button down move to the "Take YYY from XXX" item, where YYY is a name of a relation and XXX is a name of the pattern WordNet.
7. Release the right mouse button.

Note: List of non-standard relations is specified in the dictionary .cfg file as EQ_TAGS.

Example:

  <EQ_TAGS>
    <EQ_TAG>SYSNET.EQ_HYPERONYM</EQ_TAG>
    <EQ_TAG>SYNSET.EQ_HYPONYM</EQ_TAG>
  </EQ_TAGS>

3.9 How to delete a synset

1. Look up the desired synset and activate the "Edit" page.
2. Click on "Delete" button at the bottom of a form.

3.10 How to copy the whole tree from one WordNet to another

This function is useful when you are building your WordNet using Expand model.

1. In a pattern WordNet (e.g. English) activate a tree page.
2. Click on a synset which makes a top of the tree you want to copy.
3. Invoke a context sensitive menu by the right mouse button.
4. While holding the button down, move to the "Copy tree to XXX" item, where XXX is a name of your WordNet.
5. Release the right mouse button.
6. Another dialog will be invoked (similar to the picture below).
7. In this dialog you will see a list of all synsets which already exists in your WordNet.
8. There is another note in the last column of the list which indicates, whether the existing synset is or is not under the topmost one.
9. Do not apply changes if any synset has "no" in the column and hang these synsets under the topmost one rather.
10. You can apply changes clicking on "Apply" button.