The Link transform connects nodes with matching property values via new edges belonging to a new or existing relationship. You can use Link to bring two different data sets together, and also to explicitly draw a connection among nodes within a data set. You can link properties even if the property names differ.

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

For example, when imported into GraphXR, the Game of Thrones Characters.csv file includes the characterName property, and 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. So 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. You can select and inspect the unconnected nodes and, if desired, 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.
    The Character nodes now have new directional edges showing the lines of dialog each one spoke.

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