Edit Documents

Sintelix document model has two layers of data:

• text references, and
• entities.

Text references are marked up spans of text, easily visible on document view. They're not copied to the Network by default.

Entities are groups of text references within a document. They correspond to all the mentions of the same object (distinct Person, Organisation, etc) and group all the information about that object.

Entities and their features are copied to the network by default.

Document editing is performed mostly by adding, removing, and, changing the type of text references.

However, because it is entity, and not text references that form a network, the end goal of document editing is to produce correct entity information.

Not all text references need to be grouped into an entity. The Document Processing Configuration output table contains a column Document Entity Resolution which decides for each type, whether that type forms and entity.

Document editing enforces that table by ensuring that all text references that need to form an entity do so.

To add a new text reference to a document:

• make sure no entity is currently selected
• select the desired text reference type from the ontology view on the right
• hold the control button on your keyboard
• using your mouse, click and hold on the first word you want to markup
• holding the left mouse button, move to the last word to markup
• release the left mouse button.

  

  Text reference will be created. If the current Document Processing Configuration declares the selected type as Document Entity Resolution, a new entity for that text reference will be created as well.

To delete a text reference, right-click on it, then select Delete ".

• If this text reference does not belong to an entity, it is deleted immediately.
• If this text reference belongs to an entity, but is the only text reference of that entity, it is deleted immediately, and the corresponding entity is also deleted.
• If this text reference belongs to an entity, but the entity has more text references, a pop-up gives an option to delete all of the entity's text references in bulk.

To change the type of a text reference:

• Select the desired text reference type from the ontology view on the right.
• Right-click on the text reference to change.
• From the menu, select Change Type.

Similar to deletion, if the text reference belongs to an entity that has other text references, a pop-up appears. The pop-up gives an option to change the type of all the text references of the entity.

All text references that mention the same object should be grouped into one entity. If they're not then:

• Select a text reference belonging to an entity you want to merge to. Its features and label remain in the merged entity.

• Right-click on a text reference belonging to the entity you want to merge.
• Select Merge into selected entity.

Make sure the features and label of the merged entity are correct. See Editing features below,

To split an entity into two entities:

• Select a text reference belonging to en entity you want to split.
• On the left-hand side select Move text references to another entity.
• From the pop-up select Create New Entity.
• On the left-hand side, for each text reference that needs to be moved, select Move.

Make sure the features and label of both entities are correct (see Editing features below).

To edit features of a text reference:

1. Select a text reference. The features and entity label are available on the left hand side.

2. Edit as required, then select Save.

   

To create a text reference and immediately add it to an existing entity:

1. Select a text reference belonging to an entity you want to merge to.
2. Hold the control button on your keyboard.
3. Use left mouse button to markup new text reference, as described in the Creating a new text reference section.

To markup all instances of identical text:

1. Create an example text reference.
2. Right-click on that text reference.
3. Select Edit all Occurrences.
4. In the window that opens, select all instances of the same text you want to markup.

Connections are a layer of information that links entities together, and eventually produces network links.

When a text reference is involved in some connection, a number appears showing how many connections use this text reference.

To delete a connection:

Click on any text reference and select Delete from the Connections panel.

To create a new connection:

1. Identify the text references that should be connected.
2. Select one member of the connection.
3. Right-click on another member of the connection.
4. Select Add Connection.

5. In the dialog box for Create Connection, make sure the connection type is correct, and the two text references occupy correct slots. If there is a third slot (such as keyword), and there is a correct text reference for it, select the empty slot and then select the text reference to fill it.

6. Select Create.

The Ontology link schema has a list of valid link types. To create a new link on the Ontology, then modify it.

To add a new a Document tag category:

1. Select the + button next to Document Tags.

2. Enter the name of the new category in the Tag Category field, then select Add :

3. To add a new tag from an existing category enter the tag name in the Add Tag... field, then select Add.

To delete an existing tag:

Select Delete next to the tag you want to delete.

If a Document Tag category has no tags, the category is automatically removed by the system.