Controlling graph relations

You can use the Relations pop-up to control the number of links indicated. The number of links between a node and other nodes is displayed as a glyph on the node. These links come from the relations defined in the data model, see Creating relations.

You can control the number of links indicated on a node using the features in the Relations pop-up. For example, the node for a large multinational company, such as Google, could have tens of thousands of links. The links might include connections to other companies, investors, articles that mention them, or the location of the headquarters. You could limit the relations to show the most meaningful results.

Google as a node in the graph

The number represents the number of links. This might be different to the number of nodes that appear when you add relations because some nodes might be connected by more than one link.

The Relations pop-out has the following sections:

  • Relations: Limits the nodes produced by adding relations to the relations that you specify. The list of relations are based on the simple relations and records-as-relations defined in the data model.

  • Aggregated: Limits the nodes produced by adding relations to the aggregated relations that you specify.

To control the links indicated by the glyph, do the following:

  1. From the right-most sidebar, click Relations.

  2. Click either Relations or Aggregated to expand.

  3. Select the relations you want to apply.

Records-as-relations

Records-as-relations defined in the data model, appear in the Relations section. Those that have a manually defined label use that label name, the relation and it’s inverse are listed separately. Those that use a field value as a label are combined and listed under [*] . To view and select the individual relations that you want to apply, click [*].

For more information about records-as-relations, see Records-as-relations.

Aggregated relations

Aggregated relations are links that count the intermediate entities that are in between two entities in the data model. You can limit the nodes produced by adding relations to the aggregated relations that you specify.

They’re processed through the Elasticsearch back-end system and are well-performing. They also work well with intermediate nodes that have multi-value attributes. For example, articles can mention many companies. By activating the aggregated relation Company → Article → Company (companies mentioned in articles that mention companies) and selecting some nodes, you get a useful graph that displays companies mentioned alongside other companies within articles.

To gain a further understanding of how an aggregated link is formed, right-click it, select Filter to dashboard, and then select a target dashboard. The selected dashboard will open with the filter that was used to create the aggregated link applied.

Aggregated relations aren’t counted in the glyph on a node. If you deselect all simple relations, the count on all nodes will be zero regardless of the selections you make under Relations - aggregated.

It’s often helpful to deselect all simple relations before you enable or disable aggregated relations.

Aggregated relation

Configuring aggregated relations

You can modify the following options of the aggregated relation:

Type

Terms (default) shows all terms. Significant terms removes values that are less meaningful. It excludes values that are too common in the dataset to be of interest and highlights those tied to the initial node that may be of interest to your investigation.

Size

The number of returned links by the count of the intermediate entities. Defaults to the top 10.

Metric

Count (default) returns the total number of documents that contain the term. You can select sum, min, max, or average and then select the field to aggregate on.

Invert arrow

To invert the direction of the edge, turn on the Invert arrow toggle. This visually changes the direction of the edge without changing how the aggregated relation is computed.

Creating aggregated relations

  1. From the graph browser rightmost sidebar, Click the relations button.

  2. Click the Relations- aggregated panel.

  3. Click Create an aggregated relation.

  4. In the Create aggregated relation window, select the path.

  5. Select the term, size, metric, and arrow direction.

  6. Click Save relation.

To edit an aggregated relation:

  • Click the Action button (…​) of the relation and select Edit.

For more information, refer to the Elasticsearch documentation about the Significant Terms aggregation.

To make the list of aggregated relations cleaner, ensure that you configure the data model to mark when fields are a unique value and when they are a single value. For more information, see Fields tab.