In this Session…

Before you begin…

  • Inspecting properties.

  • Using Extract to model new categories and relationships from properties.

  • Exporting data and saving data Views.

To follow along, you can download:

Slide

1

How To GraphXR 3. Properties and Extract

2

Before You Begin…

Ideally, you’ll have worked through Module 2. Import, Navigate, and Select Data. If you’re starting here, and you want to follow along, you’ll need to:

  • Log in to GraphXR, create a Project, and open its graph space. 

  • Download the file https://kineviz.com/s/GXR_QSG.zip, which contains the Game of Thrones data we’ll use in our tutorials.

  • Unzip it and drag and drop the Characters.csv file onto the graph space.

3

Columns in the Characters.csv spreadsheet (name, etc.) are treated as properties of the node. With a single node selected, press ctrl+i or click the Info icon to show the Info window. You can double click to edit a value, and add properties using the Add Property button.

4

Adding properties directly to nodes can be convenient but quickly becomes hard to manage. A more scalable way to record a unique property is with a dedicated remark node. Click the Annotate button to create a remark node linked to your current selection.

5

A remark needs to have one or more properties. Once you’ve added these, click Add Annotation to create the remark.

6

You’ll notice the new Remark node is a different color from the other nodes. All the nodes created when we imported Characters.csv are automatically assigned to a Characters category. Remark is a separate category. See this by choosing Category on the Legend.

7

Let’s switch to Property view. In the Legend, click Property. A dropdown with the first  property name appears, and below it a list of each unique value for that property in the graph. The list is scrollable for cases like this where many unique values are detected.

8

The houseName property has just a few unique values, one for each of the great houses (families) in Game of Thrones. Let’s use houseName to create nodes for the Houses. Open the Transform panel => Extract tab.

9

The Transform panel includes some of GraphXR’s most powerful capabilities, letting you interactively model your data. Transforms affect the whole graph if nothing is selected. If you make a  selection, a transform operates on only those elements.

10

We’ll use Extract to create a new House category from the houseName property. We’ll also create a new belongs_to relationship in the process, linking the new House nodes to their Character node sources.

11

Let’s set houseName as a key so that a single node is created for each unique value of houseName, rather than a separate one for every source node. Now click Run.

12

A node has been created for each House. Character nodes are now connected to their houses via edges of the belongs_to relationship. This is a good time to save our work!

13

Open the Project panel => Data tab. Here you can download the current state of your graph as a GraphXR (GXRF) file, export it as a group of CSVs, or write back to your database, if you have connected to one.

14

You can also save to the cloud. We call this creating a View. Enter a descriptive name and click Save View.

15

Now that we’ve saved our progress, let’s go on to Module 4: Link and Filter and bring in more data.

Next Steps…