All versions of this manual
X

 Linkurious Enterprise user manual

This is the user manual of Linkurious Enterprise.

The first two chapters titled Getting Started and Building Your First Graph Visualization will teach you the basics of using Linkurious Enterprise.

The following chapters are divided in themes. They go through the features of Linkurious Enterprise and explain how to apply them to successfully visualize graphs. It works both as a manual and a primer on graph visualization.

Just like our software, this guide assumes no prior knowledge of graph visualization techniques. If you read it thoroughly, you will be able to find valuable connections and structural patterns in your data, to improve your graph database, and to communicate your findings efficiently.

 First visualization

In this chapter, we will learn the basics of how to explore and visualize a graph database with Linkurious Enterprise.

About the dataset

This section of the manual and the following chapters are based on a dataset coming from Crunchbase. Crunchbase is a popular website that tracks the start-up ecosystem, especially companies and investors.

We have used Crunchbase to create a graph database of approximately 75 000 nodes and 250 000 edges. From this we have then created a subset of to focus on San Francisco Bay Area companies only. It contains 14 866 nodes and 47 093 edges. A graph contains 4 types of nodes:

Companies and investors are linked to cities by the HAS_CITY edge. Companies are linked to each other by the ACQUIRED edge. Investors and companies are linked to each other by the INVESTED_IN edge. Companies are linked to markets by the HAS_MARKET edge.

In order to follow this manual, we suggest you to download and install the dataset. Extract the archive and put its content in the folder [YOUR_NEO4J_FOLDER]/data/graph.db.

 First visualization: At first glance

Here is a look at the interface of Linkurious Enterprise.

Dashboard

The dashboard lists the visualizations created by the user. The following image is of a typical dashboard in Linkurious Enterprise.

dashboard

Workspace

The workspace allows you to explore the graph database and represent it visualization as a node-link diagram.

workspace

 First visualization: Create a new visualization

From the Quick-search bar

We can start to explore the data and get a quick overview of a node and its relations through the Quick Search bar. The Quick Search bar is accessible directly from the Dashboard. Here we will look for the Company Instagram.

Several matching results come up. We can select the one we are interested in and a visualization is created:

From New Visualization

An alternative is to create a new visualization by clicking on New visualization in the Dashboard.

We can now search for nodes and edges.

For example, if we want to look for the company Instagram, we simply type the name of any property associated with this node. Here, we type Instagram, which is the name of the company. Several results which contain the word Instagram in one of their properties are returned. We can click on the one that we're interested in.

Here we selected the company Instagram. The node appears in the graph area.

 First visualization: Inspect data

In order to view the different properties of a node, we click on it. Information immediately appears on the left side of the screen.

Here we can see that there is a node with the id #26389. It is called Instagram and has a Company category. Below we can see the various properties associated with the node.

For example the node has a country property with the value USA.

We can scroll down to see more properties or use the search bar to find a property.

Notice the number next to the node, it is the number of undisplayed edges.

Inspect edges in the same manner.

Display the connections of a node

Time to find out about the particular edges of a node. The easiest way to get that information is to double-click on the node we are interested in. Here we are interested in Instagram.

Now we can see some nodes that are connected to Instagram.

Notice the white halo around each node? All the nodes surrounded by the white halo are connected to the currently selected node (or nodes). In this case, all the nodes are connected to Instagram.

The lines between the nodes represent the edges. All the edges have a direction from one node to another (represented by an arrow).

If we click on a given edge, the properties of that edge will be displayed in the left panel.

 Search

In this chapter, we will learn how to search nodes and edges with Linkurious Enterprise.

We will first look at how to search nodes and edges then we will be looking at different advanced search options Linkurious Enterprise provides.

 Search: Search nodes

We may have millions of nodes in our graph. What if we want to look at a specific node?

The first possibility is to use the Quick Search bar from the Dashboard.

The second possibility is to use the search bar in the Workspace once we have created a new visualization.

We can look for a node by typing the name of any of its properties. Here, for example, we look for the property Instagram. We see the list of suggestions that match our search.

The search can be applied to all the nodes in the database or to all the nodes in the visualization simply by switching from ALL to LOCAL

All the entries in the database containing the word Instagram will appear. These results are sorted by relevance.

For each result we can see:

When we click on the result of our choice, it will be added to the workspace. Now we can visualize it.

How it works : by default, Linkurious Enterprise indexes all the properties of your graph. If any property of a node matches your search, it will be returned.

For example, you could find the Instagram node by typing instagram, or USA or 2010-03.

The search bar in the Workspace provides an Advanced Search option not available through the Quick Search Bar of the Visualizations Dashboard. We can thus reduce the results to the category we are interested in. Those options are described in the Advanced search section.

 Search: Search edges

We may have millions of edges in our graph. What if we want to look at a specific edge?

The fastest way is to use the search bar in the Linkurious Enterprise interface after we have have created a new visualization.

By default the finder will be set to find all nodes in the database. To search an edge, we click on the Edges button after typing the search value. To search only the edges present in the visualization, we click on the LOCAL button.

The search for edges works exactly like the search for nodes.

We simply type what we are looking for. We see the list of suggestions that match our search.

In the search result, we can see that there is an edge that has the value 1925000 for the property raised_amount_usd.

We choose the result we are interested in by clicking on it. It is immediately added to the workspace where we can visualize it.

 Search: Advanced search

You're looking for a specific node or edge, and the search bar has returned too many results? The text you are searching for is too common! You may want to narrow you search by specifying categories/types or multiple properties.

Searching for a company that contains the string Facebook in any of its properties returns a large number of results. Let's try to narrow it down.

When we click on the Advanced icon, a new menu appears:

In the footer of the advanced search screen, we see the number of nodes whose properties contain Facebook (353), and we're able to review them by clicking through the result pages.

In the header, in addition to having the search text, we have the followings options:

In our graph, Facebook is categorized as a Company. We are going to click and type Company on the category filter button to restrict our search to the nodes that have the category Company.

We can now see the different results.

In our graph, a Company can have properties like category, country, first_funding_at or founded_at and more. Not all the nodes categorised as a Company will have all the properties, though.

In order to narrow down our results, we are going to search multiple properties at once. To find Facebook, we are going to look for a company that uses "facebook.com" as its homepage url.

Now when we type facebook, the results are filtered to show only the nodes that have the category Company and the value facebook.com for the property homepage_url.

We can see that the results are now filtered. We can now select the result we are interested in by clicking on the select box on the left side of the result, then on the ADD ALL button.

The same approach can be applied to searching for edges.

Linkurious Enterprise will look for exact matches for the values you enter in the search options menu.

 Search: Advanced syntax

Linkurious Enterprise uses Elasticsearch. You can thus use the Elasticsearch syntax detailed in the Elastic query_string documentation.

Simply type the following commands in the Linkurious Enterprise search bar (only available with the remote search option ALL).

Field name

Where the "status" field contains "active": status:active

Where the "title" field contains "quick" or "brown" (if you omit the OR operator, the default operator will be used): title:(quick OR brown), title:(quick brown)

Where the "author" field contains the exact phrase "john smith": author:"John Smith"

Where any of the fields "book.title", "book.content" or "book.date" contains "quick" or "brown" (note how we need to escape the * with a backslash): book.\*:(quick brown)

Where the field "title" has no value (or is missing): _missing_:title

Where the field "title" has any non-null value: _exists_:title

Ranges

Ranges can be specified for date, numeric or string fields. Inclusive ranges are specified with square brackets [min TO max] and exclusive ranges with curly brackets {min TO max}.

Where the "date" fields has a value in 2012: date:[2012-01-01 TO 2012-12-31]

Where the "count" field in a number between 1 and 5: count:[1 TO 5]

Where the "count" field in greater than 10: count:[10 TO *]

Where the "date" field has a value before 2012: date:{* TO 2012-01-01}

Where the "count" field has a value from 1 up to, but not including, 5: count:[1..5}

Ranges with one side unbounded can use the following syntax:

Boolean operators

By default, all terms are optional, as long as one term matches. A search for foo bar baz will find any document that contains one or more of foo or bar or baz. We have already discussed the default_operator above, which allows you to force all terms to be required, but there are also boolean operators which can be used in the query string itself to provide more control.

The preferred operators are + (this term must be present) and - (this term must not be present). All other terms are optional. For example, the query quick brown +fox -news states that:

Boosting

Use the boost operator ^ to make one term more relevant than another. For instance, if we want to find all documents about foxes, but we are especially interested in quick foxes: quick^2 fox

The default boost value is 1, but can be any positive floating point number. Boosts between 0 and 1 reduce relevance.

Boosts can also be applied to phrases or to groups: "john smith"^2 (foo bar)^4

Grouping

Multiple terms or clauses can be grouped together with parentheses, to form sub-queries: (quick OR brown) AND fox

Groups can be used to target a particular field, or to boost the result of a sub-query: status:(active OR pending) title:(full text search)^2

 Manipulating the graph

In this chapter, we'll learn how to manipulate a graph, and more precisely the different options Linkurious Enterprise provides to explore and work on a visualization.

We will see how to select nodes and edges we are interested in and how to expand. Then we will learn how to hide them, how to apply a layout to the graph, how to pin nodes, how to undo/redo all actions and some useful shortcuts.

 Manipulating the graph: Select nodes and edges

The easiest way to select a node or an edge is to simply click on it. It is also possible to select multiple nodes at once.

To do so, click on More in the top menu.

Or right-click on the background.

By selecting the sub-menu Select, you have the following options:

The following options are also available in addition to the sub-menu Select:

Shortcuts are also available for this actions. See the list of Workspace shortcuts.

 Manipulating the graph: Expand nodes

Expanding nodes means displaying the nodes that are connected to one node or to a group of nodes.

We can expand nodes in different ways:

Both Expand buttons (actions panel and right-click) display the same options and a list of available neighbor categories.

If the expanded nodes have too many neighbors, it may however lead to unreadable visualization.

Linkurious Enterprise prevents us from adding too many neighbors at once by asking to filter the retrieved neighborhood. A safeguard popup will appear, providing options to select a specific edge type and neighbor category, to pick the most or least connected neighbors, and to change the maximal number of retrieved neighbors. We may bypass this limit manually.

Supernodes

When the number of neighbors of a node is bigger than the supernodeThreshold configured by the administrator (on the following example, 1000), the node will show on the badge an approximate value of connections followed by the plus signal.

Despite the behavior of a supernode being similar to the one of a regular node, it is not possible to expand multiple nodes at the same time when at least one of the selected nodes is a supernode.

As with regular nodes, we can expand supernodes in different ways. The only difference is that we will have a list of edge types instead of categories.

To avoid ending up with an unreadable visualization every time a supernode is expanded, a safeguard popup will appear, providing options to select multiple edge types, neighbor categories and maximum number of retrieved neighbors.

It is tempting to always add more nodes and edges to your visualization. Beware though, if you are not careful you may end up with too many nodes on your screen... and a worthless visualization.

In order to avoid that, remember to always think twice before adding more information to your visualization. The filters and the hide functionality are here to help!

 Manipulating the graph: Queries and templates

In this chapter, we will learn how to use queries and query templates:

Most graph databases support a query language that can be used to express pattern queries in the graph. For example, Neo4j supports Cypher and JanusGraph supports Gremlin.

The Cypher query language is similar to SQL, it can be learned from Neo4j's online documentation.

Running standard queries

Standard queries can be executed from the Query Management panel, that can be opened using the Magic wand icon in the top left corner of the workspace.

The following query returns all the cities that are connected to at least 3 companies and at most 100.

MATCH (city:City)<-[hasCity:HAS_CITY]-(company:Company)
WITH city, count(company) as score, collect(company) as companies, collect(hasCity) as hasCities
WHERE score > 3 AND score < 100
RETURN city, companies, hasCities

Running a standard query

Note that the Cypher query has to contain a RETURN statement. Only nodes and edges returned are displayed. Returned values that are not a node or an edge (such as the score in the previous example) are not displayed.

Running query templates

The following template returns, in the limit of "max", the "COMPANY" neighbours of the parameter node.

MATCH (n)-[edge]-(company:Company)
WHERE id(n) = {{"Node":node}}
RETURN edge, company
LIMIT {{"max":number:10}}

Running a query template

A query template accepts several types of variables:

Single-node query templates can be run on multiple nodes at once, the same way it is possible to expand multiple nodes at once.

Managing queries and templates

The Query Management panel is opened through the "Magic Wand" icon in the workspace. It contains 3 tabs:

open query modal

A user can view the details, execute and load in the editor:

A user can edit and delete:

shared query

Sharing queries and templates

Queries and Templates can be shared:

sharing a query

Queries and Templates can require a lot of computing resources from the database. Make sure to test your queries and templates properly and verify that you have enough computing power before sharing them. If overloaded, your database server may run slow or even crash, making the database unavailable, and Linkurious Enterprise unusable.

Creating a standard query

The Query Editor provides a place to create and validate queries before saving them.

The Preview allows to visualize the results of a query:

query preview

Creating a query template

A Template is a mix of code (Cypher or Gremlin) and placeholders for variables. The way to declare the variables is inspired by the "Mustache" templating language, using the double curly braces to mark the start and end of a variable declaration.

Example:

MATCH (n)-[e]-(m) WHERE id(n) = {{"My node":node}} RETURN e, m

Testing templates in the editor

When a Template variable is detected, a form is generated and displayed to the right of the query editor, allowing the template to be tested.

template testing

Query templates syntax

A variable is made of 3 terms separated by a colon (:), the first 2 being mandatory:

A Query Template can be made of:

When a Query Template consists of at least one node variable, it is available through both the context menu and the Query Management panel.

When a Query Template consists of non-graph variables only, it is available through the Query Management panel only.

Single-node templates

When a query template that consist of one node variable and any number of non-graph variables:

running qudery templates from the node context menu

Two-nodes templates

using the shortest path bultin query

Multi-nodes templates

E.g. the following Template returns only the nodes that are shared neighbours to each and every node of the input nodeset:

MATCH (n) WHERE id(n) in {{"My nodes":nodeset}}
MATCH (n)-[e]-(m)
WITH m, collect(e) as edges, count(distinct n) as sharedNeighborCount
WHERE sharedNeighborCount = length({{"My nodes":nodeset}})
RETURN m, edges

using a nodeset variable

Query templates variable types

node variable

Used to inject a single node ID in a graph query.

Examples:

nodeset variable

Used to inject a list of node IDs in a graph query.

Examples:

enum variable

Used to inject a string, numerical or boolean value in a graph query, from a list of choices.

Examples:

boolean variable

Used to inject a true/false value in a graph query.

Examples:

date variable

Used to inject a date-time in a graph query.

Example:

datetime variable

Used to inject a date-time in a graph query.

Example:

number variable

Used to inject a numerical value in a graph query.

Example:

string variable

Used to inject a string of text in a graph query.

Example:

Access-rights considerations

There are 4 levels of permission associated with the queries and templates:

For Cypher: Any query or template containing the CALL statement is considered as a read/write query.

Queries and templates that write in the database can be shared with any user group, including those that were not granted "Write" permissions on any node category. Be considerate as to who you share queries with, and who has the right to share queries (see "Access Right" section in administration manual)

 Manipulating the graph: Lasso

It is possible to select the nodes within a particular area of your visualization. For that, Linkurious Enterprise provides a lasso.

To do so, click on More in the top menu or right-click on the background. Select Lasso.

Move the lasso around the nodes you are interested in selecting to select them.

You can also use the lasso by pressing the ctrl key (cmd on MacOS) while dragging with the mouse to draw the outline of the desired selection.

Release the mouse when you are finished and your selection is activated.

 Manipulating the graph: Hide

Your visualization is getting too complex and you may want to remove from a visualization (i.e. hide) a few nodes or edges from a visualization to make it easier to understand. Notice that hidden nodes an edges are not deleted from the database.

In the picture below, three nodes are selected. Simply click on the Remove icon to remove them from the visualization.

The three nodes are now removed from the visualization.

The Toggle Lasso option can be used to select the nodes we want to hide. We need to make sure the central node is not selected, otherwise all the edges connected to this node will also be hidden.

 Manipulating the graph: Layouts

Visualization controls

On the Workspace, various controls are available on the right-bottom of the screen:

A click on the layout button will apply the current layout, which is a fast force-directed layout by default. Three categories of layouts are available: force-directed, hierarchical and radial. They come with pre-defined flavors:

Force-directed layout

Such layouts position nodes according to their connections: connected nodes are usually closed to each others, while disconnected nodes are usually pushed further.

By setting "incremantal expand" to active, force-directed layouts will be applied only on new nodes added to the visualization.

Best Mode (default): Takes the longest time to compute new node positions but provides better results than the Fast Mode.

Fast Mode: Quickly finds new node positions but some overlapping nodes may exist.

Hierarchical layout

Such layouts organize nodes in different layers automatically by aligning nodes of each layer either vertically or horizontally. The root nodes are automatically found.

Top-to-bottom Mode: Will position root nodes at the top of the screen.

Bottom-to-top Mode: Will position root nodes at the bottom of the screen.

Left-to-right Mode: Will position root nodes at the left side of the screen.

Right-to-left Mode: Will position root nodes at the right side of the screen.

Radial layout

Radial layouts position nodes around the currently selected node (used as center of the layout) based on their graph-theoretical distance (shortest path in the graph). This is useful for revealing layers in data and for drawing the rest of the graph in its relation to the pre-defined focus node.

Best mode: Will use an energy model to produce more readable layouts. It is also capable of handling special cases like disconnected components.

Fast mode: Will use a geometrical model, which is faster but can produce more overlapping edges.

 Manipulating the graph: Pinning nodes

It is possible to pin the nodes on your graph visualization. Pinning a node allows to fix it at a specific place on the graph.

To pin a node, we can either select Pin on the tooltip opened by right-clicking, or click on More in the actions menu.

A pin symbol appears on the node.

If we pin a node, this node will stay at the same place when we move the rest of the graph, for example using the force-directed layout option:

 Manipulating the graph: Undo/redo

You now have the possibility to revert your last action on a visualization.

You can revert only the last action you do in the visualization.

For example, after expanding a node, clicking the undo button (or using the shortcut ctrl-z or cmd-z on MacOS) will revert the expand by returning the graph to its previous state.

After reverting the expand, you can go back and re-run it by clicking on the redo button (or using the shortcut ctrl-y or cmd-y on MacOS).

We have now the same nodes in the same positions as before.

Some actions cannot currently be undone :

 Manipulating the graph: Shortcuts

Depending of your operating system, you will have to use the ctrl key (Windows, Linux) or the cmd one (MacOS) to trigger actions.

Camera

Selecting

Creating and Editing

Undo / redo

 Design

In this chapter, we'll learn how to adjust the captions, the colors and the sizes of nodes and edges. This will help you make your visualizations more meaningful.

All these features are available on the Design panel that can be open by clicking on the following icon on the right top of the screen:

The Design panel will open with the Styles and Nodes tabs pre-selected:

Styles set in a new visualization are automatically re-applied to newly created visualizations. Users can reset the styles at any time.

Default styles

Default styles may be defined by an Administrator of Linkurious Enterprise. Users can then change these styles after creating or opening a visualization.

By default, every node category has a pre-assigned color.

 Design: Captions

Linkurious Enterprise lets you choose which properties should be displayed on the workspace next to every node and edge.

On the example below, only the names of the nodes are displayed by Linkurious Enterprise. In order to customize this, we need to open the Design panel and select the Captions tab.

On the Captions tab, we can see the different properties of the nodes in our graph. The Name property is currently the only one shown. Let's add then the Country to the visualization; to do so, we click on Country. This property is now added to the displayed properties listed in the red area.

The text displayed next to the nodes is now different: instead of Baseline Ventures we can see Baseline Ventures - USA.

The same approach can be used for the edges, whose list is available on the Edges tab.

Linkurious Enterprise will use the properties in the order they appear in the list. By placing the cursor on one property already in the caption list, we have the possibility to change the order or to remove properties.

If a node doesn't have a property, Linkurious Enterprise won't show a caption for that property for that node.

 Design: Nodes color

If all your nodes or edges have the same color, it is difficult to distinguish them without looking at their individual properties. A great way to solve this is to color the nodes according to a certain category or property.

For example, our nodes with category Company may have a Country property that we would like to highlight; Linkurious Enterprise enables us to color the nodes according to a particular property, here Country.

This way, a French and a German start-up will have different colors despite having the same category; it will be easier to distinguish them visually.

In the picture below, we see that the start-up Twitter is connected to many investors. At first glance we have no idea where these investors are coming from.

Let's open the Design panel on the right corner of the screen and hit the Styles tab.

We can see all the node categories and, clicking on them, we can see their properties and property values.

Clicking on the desire property we can see all the values from the nodes in the visualization; from here, in two steps, we can change the color based on a value:

  1. Click on the color icon

  1. Select one color from the list or insert one other color on the input using the color name (e.g. blue), its hexadecimal color code (e.g. #0000FF) or its rgb, rgba (e.g. rgb(0, 0, 255), rgba(0, 0, 255, 1))

We repeat the process until we have a new color for each value:

All the nodes that do not have the property or none of the values for which we applied a rule will remain with the color of their category.

 Design: Edges color

Coloring edges works exactly the same as coloring nodes.

We only need to click on the Edges tab of the Design panel and choose a given color based on the type of an edge or the value of an edge property:

 Design: Nodes size

By default all the nodes have the same size.

It is possible to apply different sizes to nodes depeding of their categories and/or property values. This way it is possible to differentiate nodes with a specific category and/or property.

This works similarly to the coloring functionality of Linkurious Enterprise. Coloring and sizing can be combined to make powerful visualizations.

For example Andreessen Horowitz is a leading VC firm with 187 edges to different companies it has funded. Which company has received the biggest funding? Hard to know by simply looking at this graph:

We are going to size the different companies according to their funding_total property in order to visualize which ones are the most successful.

We click on the upper right corner to open up the Design panel. We open the Company category and the funding_total property.

Linkurious Enterprise can size the nodes according to any property.

We want to set the size on the node with the biggest funding_total. To do so we need to see all the values and apply a size on the last one.

  1. Click on the size icon

  1. Select one size from the list

Now we can see that the majority of nodes continue showing the standard size and the nodes with the biggest value has a different size.

The larger node represents "Pinterest". We can quickly identify it as the most successful investment of investor "Andreessen Horowitz".

 Design: Edges size

Setting sizes on edges works exactly the same as setting sizes on nodes.

We only need to click on the Edges tab of the Design panel and choose a given size based on the type of an edge or the value of an edge property:

 Design: Icons

Linkurious Enterprise allows you to change the appearance of nodes by adding icons, letters or numbers.

We open the Design panel and choose the Styles and Nodes tab:

We can now see all the node categories and apply an Linkurious Enterprise icon, letter, number or custom icon to each one of them in three steps:

  1. Click on the + icon for a given category

  1. Select the desired library (Linkurious Enterprise icons library, letters, numbers or custom icons)

See how to add custom icons on our administrator manual. After adding the desired images they will be visible on the custom icons section and can be applied like a regular icon.

  1. Select an Linkurious Enterprise icon, letter, number or custom icon to apply

It is also possible to apply icons based on node property values.

In the example above, we have chosen 4 different icons to differentiate the nodes according to their category:

 Filters

In this chapter, we will learn how to filter the nodes and edges within a visualization according to their category/type or property values.

This technique will help you to focus on the relevant information in your graph and avoid information overload.

 Filters: Property types

Before we move to filters is essential to understand the meaning of property types.

For each property, its detected type (textual or numerical) is shown as an icon next to the property name:

The type is automatically detected and can be set manually by clicking on the type icon; this opens the type selector:

After a property-type has been set manually, its icon color will change to blue. The same will happen if a filter is applied on a property value from an automatically generated type.

 Filters: Filtering nodes

To start applying filters we must open the Filter panel clicking on the following icon on the right top of the screen:

The filter panel will open with the Nodes tab pre-selected:

Filter by category

Each category contains the amount on nodes shown in the visualization with the category, the selection option and the possibility to filter.

To filter by category we only need to click on the toggle located on the same line as the category; the filter will be applied to all nodes in the visualization with the filtered category.

Non filtered category:

Filtered category:

Filter by property value

To filter by property value we first need to open the category the property belongs to. We open the property and we look for the values we want to filter:

Textual property

For textual property, each value is listed. Each one has the amount on nodes shown in the visualization with that property value, the selection option and the possibility to filter.

Numerical / Date property

For numerical property, the values are aggregated on a chart divided in 21 intervals with the height of the bars representing the amount of nodes with the value inside the interval.

Numerical / Date filtering

Here we can filter out all the values smaller than the lower bound and bigger than the upper bound:

To activate the interval filtering, we need to activate the lower and/or upper bound by clicking on the + button of the bound we want to enable.

The picker for each bound will then appear on the chart:

The filter can be updated by dragging the pickers or changing the value directly in the input field:

To remove a bound, click on the trash icon next to the bound you want to remove.

For date filtering, every input expects one date of the format YYYY-MM-DD

Numerical / Date values statistics

Here we can see the amount of node with valid values and select them:

Missing and invalid values statistics

Here we can see the amount of node with missing or invalid values, select and filter them:

 Filters: Filtering edges

Filtering edges works exactly the same as filtering nodes.

We only need to click on the Edges tab of the Filter panel:

 Edit data

In this chapter, we will learn to edit, add and remove nodes or edges to our graph.

 Edit data: Edit properties and categories

Nodes are made of one (or multiple) categories, and a set of properties. Edges are made of one type, and a set of properties.

Properties are simple key-value pairs (e.g. name: "James", age: 31).

Node categories are used to tag a node (e.g. Company). Some graph databases (e.g. Neo4j) support multiple node categories.

Edge types are used to define the nature of an edge (e.g. FRIEND_OF).

It is a limitation of most graph databases that the type of an edge cannot be edited once the edge has been created.

Editing a node / edge

If we select a node or an edge, we can edit it by right-clicking on it or clicking on the More option in the Selection panel.

Next, we click on Edit, which will open the node or edge edit modal.

Node edit modal

Edge edit modal

Adding, Editing or Removing a property

To add a new property, we need to fill in the name of the property and provide a value new_property, and new_property_value, for example--and click on the Add button.

To edit the new property or an existing one, we only need to change its value, and when everything is edited, click on the Save button.

To remove a property, we only need to click on the Delete button and when everything is edited click on the Save button.

The edge edit modal works exactly the same way

Adding and removing a category

Only available on nodes

To add a category to a node we need to type the desired category. After typing the first character, categories already present in the database that match it will be shown. The first option on the list is to select a new one.

To select one category (even new), we need to click on the list. If the input changes its color to green, your choice has been accepted. Next, we click on the Add button and, if we want to save the changes, on the Save button.

To remove a category, we need to click on the right side of the cross.

These changes will only be saved after clicking on the Save button.

 Edit data: Create nodes and edges

The easiest way to create a node or an edge is to right-click on the background or click on the More option in the top menu.

For edge creation, we can select one or two nodes and right-click on one of them to automatically use the selected nodes as source and target.

Create a node

First we need to select or create a new category for the node using the marked input.

When we begin typing compa the category Company appears on the list along with the option to create a new category named compa.

Let's select Company and click on the Add button. The company is then added, and since a category is already present in the database, the properties list will be filled with those properties already on Company nodes.

We can now fill the desired properties or create new ones at the end of the list and click the Save button to add the new node to the visualization.

The new node is now saved and added with the inserted data. The node is also automatically selected.

Create an edge

The easiest way to create an edge between two nodes is to select them and then right-click on one of them or on the More option in the selection panel.

After clicking on Create Edge the edge creation modal will open with three important fields:

Since we already selected two nodes, the target and the source are automatically filled. Using the opposite arrows on top, it is possible to switch between source and target. If we open the edge creation modal without any node selected, we can use the source or target inputs to search for nodes present in the visualization.

Next, we need to select a type for the edge (unlike with node creation, in edge creation type is required). Clicking on the type input will show all types present in the database. Let's select HAS_CITY

As with nodes, we can add as many properties as we want to an edge. When we are done, we click on the Save button.

Finally, we can see in our graph our new edge:

It is also possible to create a new edge without selecting any node by right-clicking on the background or by clicking the More button in the top menu.

 Edit data: Delete nodes and edges

Delete nodes

If we want to delete one or more nodes from our database, we need to select the nodes we want to delete and right-click on one of them or on the More option in the selection panel.

After clicking Delete x node(s) from the DB a confirmation modal will appear.

After clicking on Confirm, the node will be deleted from the database.

Delete edges

If we want to delete one or more edges from our database, we need to select the edges we want to delete and right-click on one of them or on the Delete option in the selection panel.

After clicking Delete x edge(s) from the DB a confirmation modal will appear.

After clicking on Confirm, the edge will be deleted from the database.

 Geography

In this chapter, we will learn how to display graph data on a geographic map.

 Geography: Geographic data

Nodes must contain geographic coordinates as properties. Latitude and longitude data must be expressed in decimal degrees (e.g. "38.8897,-77.0089") as available in many geographic information systems (GIS).

The Administrator should configure which property is the latitude property, and which property is the longitude property of the nodes of the data-source. Without configuration, Linkurious Enterprise will try to use properties called "latitude" or "lat", and "longitude", "long" or "lng".

When geographic coordinates exist in a node of the visualization, we can switch to the geo mode.

 Geography: Display a geographic map

The Geo mode switch is available in the lower righthand corner of the Workspace. We can enable and disable the geo mode at will to switch between the standard "network" view and the geographic view.

Click on it to display the geographical map. Nodes are positioned on the map according to their geographic coordinates. Other nodes present in the visualization can be hidden by the "geo coordinates" filter.

LKE includes some different layers that can be selected by clicking on the layer button in the lower righthand corner of the screen.

We can zoom in and out, drag nodes on the map to improve readability, select nodes and edges, etc. If we want to move the nodes to their original position we can always reset their coordinates by right-clicking on the background:

Finally, we can publish an interactive widget from Workspace menu > Publish with the geographical layers.

 Manage visualizations

In this chapter, we'll learn how to save and share the visualization created with Linkurious Enterprise.

 Manage visualizations: Auto-save

When we are working on a visualization, we can save it in the Menu by clicking on `Save.

Then we only need to choose a name and click on the Save button.

Afterwards, the modifications will be automatically saved.

We can access a saved visualization via the Linkurious Enterprise dashboard.

 Manage visualizations: Organize

Visualizations are by default added to the Dashboard. From the dashboard we can delete, rename or open a visualization.

We can also organize the visualizations in folders.

Open, rename or delete a visualization

The following actions are possible either when we right-click on a visualization or on the right menu of the dashboard:

Arrange visualizations in folders

To create a folder, we either right-click on the dashboard background or in the right menu Create folder.

We enter the name of our folder.

We hit Save. Our folder is created.

We open the folder by clicking on it. If we want to move a visualization into the folder we used the actions move to when right-clicking on our visualization:

We select the folder we want to move to our visualization:

The visualization has been moved to the folder.

 Manage visualizations: Duplicate

It is possible to duplicate a visualization. This feature might be useful when we want to try new things in our visualization and keep a record of the last version, this way the duplicate is used as a draft.

From the Dashboard

It is possible to duplicate a saved visualization from the Dashboard as follows:

We then click on Duplicate and a copy of our visualization is displayed and directly accessible on the Dashboard:

From the Workspace

It is also possible to duplicate a saved visualization from the Workspace via the "Save as" function in the Menu:

The duplicate is then accessible from the Dashboard menu.

Note that after duplicating from the Workspace, the document we are then working on is the duplicate.

It is possible to duplicate a visualization shared with you by another user.

If a user has shared a visualization with you but you are not allowed to modify it, duplicate this visualization. You will be able to modify the copy.

 Manage visualizations: Share

It is possible to share a visualization with another Linkurious Enterprise user. People we share a visualization with will be able to access it through the interface. If we right-click on a visualization, we can share it as follows:

We click on the Share menu and type the username or email of the person we want to share the visualization with.

We can give read-only rights or allow modifications.

 Manage visualizations: Publish

Linkurious Enterprise offers the possibility to publish interactive visualizations online. Published visualizations can be accessed with an URL or embedded in a Web page à la Google Maps. They contain a snapshot of graph data at the time the visualization is published. The visualization author can update or un-publish his visualizations anytime. Anyone can explore these visualizations interactively, enabling easier collaboration around graph data.

We can publish a visualization from the Workspace via the left menu:

Before publishing a visualization, we can choose various options to customize the interface:

The options are:

In the screenshot above, we have disabled the share option. We can see that the Share button on the right of the screen disappeared. Finally, we can publish it:

The visualization is now available online! We can share the link or integrate it into a web page by adding the script of the web widget into the source code of a web page.

If the server that hosts Linkurious Enterprise is accessible via intranet only, published visualizations will be available within the organization and won’t be available outside.

 Manage visualizations: Export

We have created a visualization and we want to share or modify its content. We open the Workspace menu, then click on the Export button.

The visualization data can be exported in the following formats:

After clicking on a format, we can configure the export (PNG and SVG) and click on Download. The file is automatically downloaded by the browser.

The PNG export available here will create an image of the complete graph even if we are currently zooming to a specific area. Here is an example:

This feature is different from the Screenshot button available on match and guest visualizations: it creates an image of the displayed area on the screen only.

 Manage visualizations: Delete

Deleting a visualization is only possible through the Dashboard

Either:

The visualization is deleted after confirmation.

 Alerts

In this chapter, we will learn how to work collaboratively on alerts. Administrators can configure alerts through the Administration panel. Users will then get a list of matches for each alert.

In fraud investigation or IT monitoring, alert matches happen when anomalous patterns appear in data. A team of analysts will investigate the matches to confirm the cases or dismiss the false positives. Graph visualization helps them to explore data in detail and to collect visual evidence of suspicious activity. They can report the results to escalate the matches by sharing the corresponding visualization.

Challenges rely on the quantity of alert matches processed by analysts: they have limited time and can select which matches to focus on. A score can be defined for an alert such as potential money lost, risk score, or date of the match.

 Alerts: List alerts

If at least one alert is configured by the administrator, users can access the list of alerts from the Alert menu item.

 Alerts: List matches

After double-clicking on an alert we get the list of newly detected matches. Matches are ordered by creation date. If the administrator has set up specific columns to this alert, we can sort matches by those columns.

Each row represents a match.

A match is either new, confirmed, or dismissed. On the left we can access the list of matches by status. For instance the following image shows the list of dismissed matches. We can see who has changed the status of those matches.

To take a decision, you must investigate on a match. Simply click on a row to open the match visualization.

 Alerts: Investigate a match

We visualize a match within a specific interface. On top of the visualization, you can :

Just below, you can download an image of the match, toggle the geo mode, and undo or redo your last action.

By clicking on a node or edge, you will open its property panel to see its type and properties.

Some features of the workspace are present to help you investigate, including expanding nodes or hiding items.

 Guest Mode

What is the Guest mode

The Guest mode is a way to share graphs with people who do not have an account on Linkurious Enterprise.

Key characteristics:

The Guest mode is available once an Administrator has enabled it.

Standard user interface:

Guest mode user interface:

Share a visualization

There are 2 options to share a visualization with the Guest mode:

  1. From the dashboard, right-click on a visualization and click Share
  2. From the workspace of that visualization, go to Menu > Share

Security warning