Change the layout applied to a link chart

As you build a link chart from a knowledge graph, you can change how entities are arranged to better visualize the relationships between them.

By default, entities are arranged using the Radial Tree layout. However, several other layouts are available: Force Directed, Community, Simple, Smart Tree, Radial Tree, Geographic, Timeline, Multi-Timeline, and Hierarchical. The layout used to arrange the contents of a link chart is indicated on the link chart context toolbar and is referred to as the current layout. Various operations that act on this link chart will use the current layout to process results. For example, when you add entities and their relationships, they are added in a manner that is appropriate for the current layout.

Basic layouts

This group only includes the Simple layout at this time. This layout arranges entities in a regularly spaced lattice pattern in which the size of the grid depends of the number of entities.

Organic layouts

In this group, entities are arranged on the link chart using force-directed layouts. This type of layout algorithm considers the link chart as if it were a mechanical system. The entities repel each other like two magnets aligned with the same poles facing each other, while they are attracted to each other by the relationships that join entities together. The algorithm iteratively reviews and places entities and evaluates the forces until equilibrium is reached. Settings allow you to customize how entities are placed. These layouts allow you to visualize entities in clusters that emphasize how they are connected.

The supported organic layouts are Force Directed, Community, and Geographic.

Force Directed

The Force Directed layout considers the link chart as if it were a mechanical system. The entities repel each other like two magnets aligned with the same poles facing each other, while they are attracted to each other by the relationships that join entities together. The algorithm iteratively reviews and places entities and evaluates the forces until equilibrium is reached. This layout allows you to visualize entities in clusters that emphasize how they are connected.

The Force Directed layout is the default layout used to arrange entities and relationships when a link chart is created.

Community

The Community layout finds communities, which are groups of entities that are closely related to each other. The Force Directed layout is then used to arrange the communities. The attraction forces along relationships between entities of different communities are relaxed so that different communities are more spread out than with the standard Simple layout.

Geographic

The Geographic layout arranges spatial entities geographically using their geometry. Spatial entities in which the entity has a null geometry and nonspatial entities are displayed on the link chart, but their placement and arrangement are determined using the Force Directed layout.

Your organization's basemap is used by default as a backdrop to provide spatial context.

Tree layouts

A tree layout arranges entities and their relationships as in nature in which the tree starts from the trunk and all branches move out from that point. In the link chart, the root entity is the starting point, positioned at the top for a top-to-bottom layout. The entities related to the root entity are then lined up in a row below the root entity, from left to right in the example below. Radial layouts are a particular form of tree layout in which the root of the tree is placed in the center of a circle, and the entities to which it is related are positioned in a circle around the root.

The algorithm identifies the entity associated with the smallest network topology index and uses it as the root entity.

The supported tree layouts are Smart Tree and Radial Tree.

Smart Tree

The Smart Tree layout arranges entities and their relationships as in nature in which the tree starts from the trunk and all branches move out from that point. In the link chart, the root entity is the starting point, positioned at the left. The entities related to the root entity are lined up in a row to the right of the root entity, from top to bottom in this example. Any entities related to those items that aren't in the link chart are added as another row closer to the bottom, and so on.

The algorithm identifies the entity associated with the smallest network topology index and uses it as the root entity.

Radial Tree

The Radial Tree layout places the root entity for the tree in the center of a circle. All leaf entities for the tree are positioned around the outer edge of the circle. Entities at each level of hierarchy in the tree are arranged in concentric circles between the root entity and the outer circle.

Hierarchical layouts

This group only includes the Hierarchical layout at this time. The Hierarchical layout is arranged similarly to the Radial Tree layout. However, an attempt is made to orient the majority of the relationships from the bottom to the top in which the origins for the relationship are positioned at the bottom and destination entities are positioned at the top.

The algorithm attempts to limit the number of places where the lines representing relationships cross each other. In contrast with the Radial Tree layout, relationships are not allowed between entities at the same level in the link chart with the Hierarchical layout.

Chronological layouts

Chronological layouts arrange entities and relationships using time. Entities with time properties, called event entities, and relationships with time properties, called event relationships, are arranged on one or more time lines in the order that they occurred. The entity type or relationship type must have a time property, and the layer must be time enabled for an entity or relationship to be considered an event. By default, the time direction starts with the oldest date on the left and the newest date on the right. These layouts include a time banner that shows the time intervals most appropriate for the data, the start and end of each event, and the UTC offset. Settingsallow you to customize the direction of the time axis, time zone, and the placement of entities and relationships.

The following types of events are represented in chronological layouts:

• Durative entity events—Entities with a start and end date property
• Punctual entity events—Entities with only one date property
• Durative relationship events—Relationships with a start and end date property
• Punctual relationship events—Relationships with only one date property

Note:

Chronological layouts require that filtering content using time be configured on the link chart sublayer properties. The time fields used must have the timestamp offset type. Time can be set on a link chart created in ArcGIS Pro and imported into to Knowledge Studio, or you can set time in the link chart layer definition using ArcGIS Pro or the ArcGIS REST API.

All entities not related to an event will be arranged using the Force Directed layout outside of the chronological part of the layout.

The supported chronological layouts are Timeline and Multi-Timeline.

Timeline

The Timeline layout arranges all events in a single time line. By default, the direction of time is left to right, and events that overlap in time are arranged vertically.

The Timeline layout has various elements to communicate the relationship between events over time. The time axis (number 1 in the image above) indicates the time direction, the UTC offset, dates and times, and the start and end of events. The timeline (number 2 in the image above) contains the events. Nonevent entities (number 3 in the image above) related to events are displayed outside of the timeline. Relationships between nonevent entities and nonevent entities not related to event entities (number 4 in the image above) are displayed farthest from the time axis.

You can change the properties that arrange entities and relationships in this layout in the layout settings.

Multi-Timeline

The Multi-Timeline layout creates individual timelines for each entity related to an event. Event entities are placed between the timelines. Relationships are drawn between a timeline and the connected event entity. Relationships connecting events that have both a start time and an end time, also called durative events, have a right angle. The portion along the timeline represents the duration of the event. The layout arranges entities and relationships depending on the type of event as follows:

• Durative entity events—The relationships have the right angle to the entity event, and are drawn on the timeline for the duration of the event.
• Punctual entity events—Relationships are drawn in a straight line from the timeline to the event entity.
• Durative relationship events—The relationship is drawn on both of the timelines of the nonevent entities for the duration of the event.
• Punctual relationship events—Relationships are drawn in a straight line from the timeline to the nonevent entities.

The Multi-Timeline layout has various elements to communicate the relationship between events over time.

The time axis (number 1 in the image above) indicates the time direction, the UTC offset, dates and times, and the start and end of events. Events are represented on multiple timelines (number 2 in the image above). A timeline can have a timeline root (number 3 in the image above) represented at the beginning of the timeline. The timeline root is a nonevent entity that is related to events drawn on the timeline. There is at most one timeline that has no root: this timeline contains events that are not related to any entity in the link chart. Relationships between nonevent entities and nonevent entities not related to event entities (number 4 in the image above) are displayed to the outside of the timeline roots. The time scale (number 5 in the image above).

You can change the properties that arrange entities and relationships in this layout in the layout settings.

Apply a different layout to a link chart

A link chart's current layout is selected on the link chart context toolbar in the Layouts drop-down menu. For example, if the link chart is currently using the default Radial Tree layout, you can select the Force Directed layout from the Layouts drop-down menu.

To apply a different layout to a link chart, complete the following steps:

1. Click Layouts on the link chart context toolbar.
2. Choose a layout from the drop-down menu.

All entities and relationships in the link chart are rearranged according to the new layout.

Change layout settings

Organic layouts and chronological layouts have additional settings that you can configure to refine the way the algorithm generates the layout.

Change organic layout settings

If you use organic layouts, a few settings allow you to adjust how entities and relationships are positioned on a link chart.

Knowledge Studio uses an iterative process to determine where to place entities and relationships on the link chart. The number of iterations used by organic layouts for the necessary calculations is optimized to get a good result in a reasonable amount of time. However, if you are willing to wait longer with large link charts, additional iterations can be made that can improve the overall results. Use the Computation Budget setting to indicate the maximum amount of time that can be spent performing the calculations. The value specified is not an absolute number of seconds but a relative amount of time.

As discussed above for organic layouts, entities repel each other but are also attracted to each other by their relationships. By default, the repulsion radius used in organic layouts is calculated automatically based on the data in the graph. However, you can manually adjust the Repulsion Radius setting to get a different result. For example, with a community layout, if you increase the radius size, communities not tightly connected are positioned farther apart on the link chart. In other cases, if an organic layout evenly distributes a specific set of data in a circular pattern, for example, increasing the repulsion radius may not have a noticeable effect because the forces between the entities are well balanced. The ideal edge length is multiplied by this value when the repulsion distance is calculated.

With a geographic layout, entities with spatial locations are fixed in their geographic position on the map. Entities without spatial locations are arranged using the standard layout. You can influence how these entities are arranged by modifying the Ideal Edge Length setting, which specifies how attraction and repulsion forces are computed along a relationship. By increasing the ideal edge length, related entities without a spatial location are positioned farther away from those with a spatial location. Different lengths may be appropriate for maps of different scales.

Two methods can be used to calculate the ideal distance between a spatial entity and a related nonspatial entity. The Multiplicative setting is used by default in which the ideal distance that would typically be used on a link chart is multiplied by the given amount. The Absolute setting allows you to specify the ideal edge length in decimal degrees. Use a small absolute ideal value when the link chart has a large geographic scale, for example, when the data represents a city—larger numbers will place related nonspatial entities outside the map extent.

By default, the map zooms in or out as you adjust the Ideal Edge Length setting. All entities will always be shown on the link chart. Check the Keep current extent check box to change the placement of the nonspatial entities without changing the map's scale.

To change the organic layout settings, complete the following steps:

1. Ensure that the current layout for the link chart is an organic layout.
2. On the context toolbar, click Visualization.
3. Click Layout Settings in the drop-down menu.
4. Slide the control either direction to change the Computation Budget setting.

   By default, a maximum of 2 seconds are allowed to complete the appropriate calculations. The minimum value is 1 second, and the maximum value is 100 seconds. Increasing the budget may cause longer computation times.

5. Turn off the Auto toggle button to turn off automatic calculations for the Repulsion Radius setting and change how the radius is calculated by dragging the slide control either direction.

   The default repulsion radius value is 1, the minimum value is 1, and the maximum value is 99.

6. If the current layout for the link chart is geographic, click the Ideal Edge Length drop-down list, click the appropriate method for calculating the distance, and drag the slide control either direction.

   For the Multiplicative method, the default multiplier value is 1, the minimum value is 0, and the maximum value is 5. For the Absolute method, the default multiplier value is 1, the minimum value is 0, and the maximum value is 360.

7. If the current layout for the link chart is geographic, check the Keep current extent check box to keep the same map scale as you change the layout settings.
8. Click Apply.

The entities are repositioned on the link chart according to the updated settings.

Note:

To return the layout settings to their default values, click Reset, and click Apply. Clicking Reset does not change the current extent of the map when you use a geographic layout.

Change chronological layout settings

If you use chronological layouts, settings allow you to adjust the time banner, time direction, and how entities and relationships are positioned on a link chart. The Time axis direction setting specifies the direction to orient the layout and where to place the oldest events. The default is left, which places the oldest events on the left of the time line and the newest event on the right.

Chronological layouts have the Time banner setting, which adds a graphical element that provides context for the time intervals, time direction, start and end times of events, and time zone. If the time properties in the graph are in a specific time zone, use the UTC offset in Minutes setting to update the UTC property on the time banner to the correct offset. The value provided is in minutes and is multiplied by 60 to generate the offset. For example, if the data was collected in July in California (Pacific Daylight Time), set the UTC offset to -420 (-7 hours). Use the Show event ticks option to change the arrows indicating the start and end times of events on the time banner.

For entity events that have a start and end time property, you can use the Durative entity event options to visualize the duration on the link chart. Show duration shows a transparent line at the entity event indicating the duration of that event. For example, in a dataset tracking phone calls between people, the phoneCall entity type might have a property for the start date and time of the call and a second property for the end of the call. The Width option increases or decreases the size of the duration line. In a Multi-Timeline layout, use the Entity location slider to change where in relation to the event entity to draw the line. By default, the duration line is to the left of the event entity.

In a Multi-Timeline layout, Show interval bounds uses the relationship line to show the duration of events. The relationship is drawn along the timeline between the start and end time.

The Events settings control how overlapping entities and relationships are drawn in the link chart. Separate timeline overlaps specifies whether overlapping events on a given timeline are drawn on top of each other or visually separated. Separate time overlaps specifies whether events that overlap in time will be visually separated. In a Timeline layout, you can configure additional relationship settings. Move first bends places the first bend of the relationship above all events. Second bend ratio specifies where the second bend will be placed as a ratio of the position of the first bend.

The Line seperation settings control how visually overlapping relationships will be offset. The Strength setting offsets each overlapping relationship from the previous one by the given amount. Turn on the Space evenly toggle button to have the relationships offset equidistant from each other. The Shape ratio setting changes where the angles are located on the relationship line. The default is zero, which places a bend in the relationship near each entity. The larger the number, the closer to the middle of the relationship line the bends are placed.

By default, the link chart zooms in or out as you adjust the layout settings. All entities are always visible on the link chart. Check the Keep current extent check box to change the placement of the nonspatial entities without changing the map's scale.

To automatically apply your settings, turn on the Auto Apply toggle button.

To change the chronological layout settings, complete the following steps:

1. Ensure that the current layout for the link chart is a chronological layout.
2. On the context toolbar, click Visualization.
3. Click Layout Settings in the drop-down menu.
4. Click one of the direction buttons to change the direction that the layout is oriented in the link chart:
   • Left—The layout is arranged with time increasing from left to right.
   • Right—The layout is arranged with time increasing from right to left.
   • Up—The layout is arranged with time increasing from bottom to top.
   • Down—The layout is arranged with time increasing from top to bottom.
5. Specify the number of minutes for the time zone offset in UTC offset in minutes by doing one of the following:
   • Provide a number in the text box.
   • Use the up or down arrows.

   The default value is 0, the minimum value is -720 (-12:00 hours), and the maximum value is 840 (+14:00 hours). The value is multiplied by 60 to generate the UTC offset on the time banner.

6. Click the Show event ticks drop-down menu and change how events are shown on the time banner:
   • Start and end—A dark grey arrow is positioned at the start of the event and a light grey arrow is positioned at the end of the event. This is the default.
   • Start—A dark grey arrow is positioned at the start of the event.
   • None—No indicators are provided for the start or end of events.
7. Click Show duration to add a grey transparent line indicating the duration of the entity event.
8. Change the Width value of the duration line by doing one of the following:
   • Provide a number in the text box.
   • Use the up or down arrows.

   The default value is 5, the minimum value is 1, and the maximum value is 10.

9. If the current layout for the link chart is Multi-Timeline, move the Entity location slider to change where the duration line is placed in relation to the entity.

   By default, the duration line is drawn to the left of the entity.

10. If the current layout for the link chart is Multi-Timeline, click Show interval bounds to use the relationship lines to represent the start and end of an event.
11. Click Separate timeline overlaps to turn off the visual separation of events that overlap on a given timeline.

    By default, all events are drawn with no overlap.

12. Click Separate time overlaps to turn off the visual separation of events that overlap in time.

    By default, all events are drawn with no overlap.

    If the current layout for the link chart is Timeline, you can click Move first bends to have the relationship bend at the entity. By default, the first bend of the relationship is beyond the separated entities on the timeline.

13. If the current layout for the link chart is Timeline, increase or decrease Second bend ratio to change where the second relationship bend is positioned as a ratio of the position of the first bend by doing one of the following:
    • Provide a number in the text box.
    • Use the up or down arrows.

    The default value is 0.3, the minimum value is 0.0, and the maximum value is 1.0.

14. Increase the Strength value of the relationship line offset to change the distance that overlapping relationship lines are drawn from each other by doing one of the following:
    • Provide a number in the text box.
    • Use the up or down arrows.

    The default value is0, the minimum value is 0.0, and the maximum value is 10.0.

15. Click Space evenly to make the space between two consecutive offset relationships even.
16. Increase the Shape ratio value to change where the bends in the offset relationships occur by doing one of the following:
    • Provide a number in the text box.
    • Use the up or down arrows.

    The default value is 0, the minimum value is 0.0, and the maximum value is 1.0.

17. Check the Keep current extent check box to keep the same scale as you change the layout settings.
18. Optionally, click Auto Apply to automatically update the link chart layout as you change the settings.
19. Click Apply.
20. Optionally, click Reset to reset the settings to one of the following:
    • Reset—Reset all settings to the system default values.
    • Discard—Discards the latest changes and reset to the last settings saved in the link chart.

The entities are repositioned in the link chart according to the current settings.