Kumu
  • Getting started
    • Welcome
    • Kumu 101
    • First steps
    • Quick tips
    • Webinars
  • Overview
    • Kumu's architecture
    • Accounts and workspaces
    • Kumu.io and Kumu Enterprise
    • Billing
    • User interfaces
      • Dashboard
      • Settings
      • Map editor
      • View editors
      • Quick Actions
    • Collaborating and sharing
    • Actions and permissions
    • Security
    • Advanced Editor hub
      • @settings reference
      • @controls reference
      • Color reference
      • Property reference
      • Selector reference
  • DISCIPLINES
    • SNA / Network Mapping
    • Systems mapping
    • Systems Practice workbook
  • Guides
    • Activity feed
    • Add-ons
      • Disqus
    • Bridge
    • Cluster
    • Controls
      • Cluster control
      • Color-legend control
      • Filter control
      • Focus control
      • Image control
      • Label control
      • Showcase control
      • SNA-dashboard control
      • Tagged-timeline control
      • Text Control
      • Title Control
      • View toggle control
    • Decorations
      • Direct decorations
      • Data-driven decorations
      • Flags
      • Icons
      • Images
      • Label templates
      • Popovers
    • Default view settings
    • Export
    • Fields
      • Computed fields
    • Filter
    • Focus
    • Forking
    • Grids & Guides
    • Import
      • Structure your data for Kumu
      • Excel / CSV
      • Google Sheets
      • JSON / Blueprints
    • Imported views
    • Layouts
      • Fixed
      • Force-directed
      • Remove overlap
      • Scatter
      • Snap-to
    • Legends
    • Licensing
    • Lightbox
    • Loops
    • Metrics
    • Two-factor authentication
    • Pro workspaces
      • Archiving projects
      • Discussions
    • Partial views
    • Presentations
    • Profiles
      • Markdown
    • Project admin
    • Selectors
    • Shapes
    • Share and embed maps
    • Shortcuts
    • Showcase
    • Slugs
    • Table
    • Templates
      • Geo template
    • URLs
    • Views
    • Widgets
  • About Kumu
    • What is Kumu?
    • How does it work?
    • Where can I get help?
  • Enterprise
    • About enterprise
    • Getting started with VMWare
    • Upgrading
    • Configuration
    • Creating user accounts
    • SSH Access
    • Single sign-on
    • Backing up enterprise data
    • Restoring enterprise data
    • Command line utilities
    • Changelog
  • Frequently Asked Questions
    • Does Kumu have a public API?
    • Does Kumu make use of AI?
    • How do I add annotations?
    • How do I add anchors to my map description?
    • How do I add arrows to my connections?
    • How do I add documents to profiles?
    • How do I add more than one element with the same label?
    • How do I add text dropdowns to my map overview?
    • How do I adjust arrow size?
    • How do I avoid duplicating data?
    • How do I change connection curvature?
    • How do I change font color?
    • How do I change font size?
    • How do I change the default for currency fields?
    • How do I change the length or strength of connections?
    • How do I change the order of control options?
    • How do I change the position of my element labels?
    • How do I cite Kumu?
    • How do I collapse duplicate connections?
    • How do I copy a map to another project?
    • How do I control label size while scaling element size?
    • How do I control text wrapping?
    • How do I convert a project from private to public?
    • How do I convert a project from public to private?
    • How do I create dynamic on/off toggles for my map?
    • How do I customize link text in popovers?
    • How do I customize the order of my legend?
    • How do I delete a project, map, or view?
    • How do I delete data from my project?
    • How do I downgrade my subscription?
    • How do I edit virtual elements?
    • How do I get rid of duplicates?
    • How do I hide elements without connections?
    • How do I hide images from the map but keep them in the profile?
    • How do I hide labels on my map?
    • How do I hide the settings button?
    • How do I keep elements from moving?
    • How do I list an element's connections in its profile?
    • How do I make elements transparent?
    • How do I make sense of my receipt?
    • How do I open a sub-system when clicking on an element?
    • How do I remove the Opposite entry from my legend?
    • How do I remove unneeded controls?
    • How do I remove unwanted legend entries?
    • How do I rename my map/view?
    • How do I restructure my adjacency matrix?
    • How do I save my changes in Kumu?
    • How do I select options by default in my control?
    • How do I set a minimum or maximum zoom level for my map?
    • How do I show the Settings button?
    • How do I size elements based on number of connections?
    • How do I transfer a project?
    • How do I update my credit card information?
    • How much data can my Kumu project handle?
    • How do my readers switch between maps and views?
    • My data won't import. What can I do?
    • My Kumu embed is not working. What can I do?
    • My map disappeared. How do I bring it back?
    • My PDF won't export. What can I do?
    • What pricing plans does Kumu have?
    • Where can I find my invoices?
    • Where can I find example Kumu projects?
Powered by GitBook
On this page
  • Creating a loop
  • Identifying loops in systems
  • Loop detection
  • Decorating loops

Was this helpful?

Edit on GitHub
  1. Guides

Loops

PreviousLightboxNextMetrics

Last updated 1 month ago

Was this helpful?

In Kumu, the three basic items you can create are elements, connections, and loops.

Visually speaking, elements are circles, connections are lines between the elements, and loops are groups of two or more connections.

Loops show up on the map as a text label, and the default position of that label is in the middle of all the connections that are part of the group.

You can use these visual tools in all kinds of different ways, but here are some common uses that we see:

Elements
Connections
Loops

Factors in a system (causes and effects)

Cause-and-effect relationships

Causal loops

Stocks

Flows

Sub-systems

Decisions, chances, and ends in a decision tree

Paths along the decision tree

Multi-part decisions

Steps in a process

Paths from one step to the next

Sub-processes

People

Interpersonal relationships

Sub-networks or communities

People & organizations

Connect people to the organizations they're affiliated with

Sub-networks or communities

Authors & books/articles they've co-authored

Connect authors to their books/articles

Sub-networks or communities

Stakeholders & areas of interest

Connect stakeholders to the areas they're interested in

Sub-networks or communities

Funders, non-profits, and population groups

Connect funders to non-proftis, and connect non-profits to the populations they serve

Sub-networks or communities

Companies and sectors/industries

Connect companies to their sectors/industries

Sub-networks or communities

Creating a loop

To create a loop, you can click the green button at the bottom of your map and select "Add loop". Then, click on the connections you want to include in the loop, then add a descriptive loop label below and press enter on your keyboard.

Click & drag the loop label to move it, or hold down Option on your keyboard (Alt on Windows) and click & drag to move the entire loop, including all its elements and connections, while maintaining their structure.

Identifying loops in systems

Colloquially, you can use the word “loop” to describe any kind of line that curves around in a circle or an oval. When you’re mapping systems in Kumu, you’ll find many groups of connections that meet that definition, but they aren’t necessarily the loops that a system mapper is looking for.

In a system map, a great litmus test for discovering loops is to ask the question, “If I follow the arrows in this group of connections, can I get trapped?” If the answer is yes, you’ve found a loop!

If not, the structure is not a loop, but might still be complex enough to deserve some further study.

Here’s an example of a structure that looks like a loop, but is not, because no matter which arrow you follow, you always end up at the same factor, escaping the trap:

On the other hand, if you reverse just one of the arrows in the structure, you inevitably get trapped going around and around in a circle:

This is the kind of loop you’re looking for in a system map.

It’s rarely so simple—in many cases, your loops will contain more than three connections, and they likely won’t be laid out in such a nice, circular shape. You'll also have the rest of the elements and connections in the map contending for your attention. This is where loop detection comes in handy!

Loop detection

Automatic loop detection

We finally added the much-awaited feature that allows you to detect loops automatically!

To detect loops, follow these steps:

  1. Create your map with some elements and connections, as you would normally.

  2. Click on the green plus icon at the bottom of your map, and choose "Add loop".

  3. Click "detect loops automatically".

  4. A menu will pop up on the left side of your map with the detected loops.

Some things to know:

  • Loops are ranked from shortest (least amount of elements) to longest (most elements).

  • You can hover over any loop name to showcase it on the map and see which elements/connections are a part of it.

  • Click on any loop number to give it a name and save it. Unnamed loops are not saved in your dataset!

  • Adding a name to a loop will add that label to your map in the center of the loop.

NOTE: Some maps are simply too large for Kumu to automatically detect loops, as the number of loops on a highly inter-connected system map can quickly run into the thousands. If you notice that loop detection is not giving you any results, you can try one of two things:

Decorating loops

Once you've identified your loops, you might want to customize how they look! One common thing to change is your loops' font size. This can be done in the Advanced Editor, like so:

loop {
  font-size: 40; // Replace with any number
}
// replace My Specific Loop with the label of your loop
loop[Label = "My Specific Loop"] {
  font-size: 40;
}

Less common, but still useful, is to categorize loops with types like Vicious, Virtuous, Stagnating, and Stabilizing, then color-code by those loop types. If you add those types to the Loop Type field (under the Label in the profile), you can use this code to color code automatically:

loop {
  font-color: categorize("Loop Type", olympic)
}

If you want to edit a loop, click on the loop's label to open its in the left side panel. In the bottom right corner of the profile, click the pencil icon to select and de-select connections that are a part of the loop.

not a loop
this is a system loop

Loops can only be . You can't export loops to Excel.

Automatic loop detection is not (yet) available for maps imported with Google Sheets. If you'd like to use loop detection, please .

Try simplifying your map by unnecessary elements and/or connections.

out one part of your map and run loop detection again. Make sure to save your loops before you filter another part of the map!

This code will change the font size for all loops. If you just want to change the size for a specific loop, you can use a . Here's an example that selects by label to decorate one loop:

You can replace olympic with the name of any of our .

profile
exported with JSON
deleting
Filter
selector
color palettes
import your map with Excel
Elements, connections, and loops