User Guides
Transforming Graph Data
Using Link

The Link transform connects nodes with equivalent property values through edges of a new or existing relationship. Properties can be linked even if the property names differ, which is especially useful for combining data from different sources. Link can also be used to explicitly draw a connection among nodes within a data set.

Examples use the open-source dataset for the HBO series Game of Thrones. For a hands-on exercise, see our How to GraphXR (opens in a new tab) tutorials.

For example, the Game of Thrones Characters.csv file includes the characterName property, while the Lines.csv file includes the speaker property. Although named differently, the two properties have matching values, that is, the name of the character in the show. We can use those properties to create a relationship between lines of dialog and the character that spoke it.

If a property is missing, or the values do not match, a link will not be created. This can result in nodes remaining unconnected. To correct this, you can select and inspect the unconnected nodes and if appropriate, edit the property values.

To Link nodes by property value:

  1. To operate on the entire data set, deselect all the data.

  2. In the Transform panel, open the Link tab.

  3. In this example, we'll link characters to the lines they spoke. Select or enter the following details:
    Source Category: select Characters
    Create Relationship: enter SPOKE
    Target Category: select Lines
    Source Property: select characterName
    Target Property: select speaker

  4. Click Run. Error and completion messages will appear below the Run button.
    The new SPOKE relationship appears in the legend, and Character nodes now have new directional SPOKE edges connected to the respective Lines nodes.

For easier visualization, the data for each category are arranged using Geometric layouts.