Docs

Quick Start with the Adjacency List

The Adjacency List format and the Adjacency Matrix format are two formats that arrange the data in different ways on a spreadsheet but will give you the same result. The choice of whether to use one format over another is up to you and which you find more intuitive.

Many users have reported finding the Adjacency List a bit more intuitive, so we suggest starting with that.

In this quickstart, we'll walk through an example using the Adjacency List template. This example describes how classes organized into different departments in a school are related.

Step 1 To start, download the Adjacency List example. Then, go to the Dashboard, click on create New Map and select List Format.

The Adjacency List format lists each entity in each row, and columns of the entity across in columns. Let's take a look at this first row in the spreadsheet:

idtypename ...
SCH School School name ...

This first row describes an entity whose id is SCH and whose type is School. These two properties are required. Having a name column is also highly recommended. Read up in more detail on the Adjacency List Format.

Step 2 Then, upload your data as prompted. You will see the following parsed result:

This tells you that Rhumbl has understood from the spreadsheet that there are 7 entities total, and amongst those 7 entities, there are 11 relationships. What are those relationships?

There is 1 corequisite relationship, parsed from this cell in our spreadsheet:

idtypename rel::dir::corequisites ...
Y1 Class name of topic Y1 X2...

This says that the class Y1 has a corequisite of X2; therefore, we have 1 corequisite relationship.

We have 4 prerequisite relationships. From this row, 2 prerequisite relationships are created — notice that the entries must be semi-colon separated.

idtypename rel::dir::prerequisites ...
Y2 Class name of topic Y2 X2;Y1...

We also have 6 is_under relationships. They come from the fact that each entity belongs to one group. The only entity that doesn't have a parent group is the root entity, which in our case is the School entity. This row says that Department X is under the School.

idtypename rel::parent::is_under ...
X Department Department X SCH...

Step 3 Choose a color scheme. Rhumbl provides you with a few different color schemes. We'll talk about how you can change specific colors later, but for now, we'll just pick the Dark scheme.

You've now made your first map!

Where to go from here? You can continue on if you want to learn about the Adjacency Matrix format, or jump into the documentation of the Adjacency List format.