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 your first project
  • Building your first loop
  • Adding additional background and context using profiles
  • Bringing your map to life with decorations
  • Refine your view

Was this helpful?

Edit on GitHub
  1. DISCIPLINES

Systems Practice workbook

PreviousSystems mappingNextActivity feed

Last updated 1 month ago

Was this helpful?

Are you working with the Systems Practice workbook, either through the or directly with The Omidyar Group? If so, you're in the right place. This guide provides a step-by-step approach on how to use Kumu alongside a systems practice.

New to using Kumu? Kumu is a collaborative, web-based platform for creating interactive system maps. If you're not already familiar with Kumu, click on the links below to explore existing projects build using Kumu:

Creating your first project

Choosing a template

Since you're building a system map, make sure to choose the "systems" template.

Inviting someone to collaborate

Building your first loop

Watch this video for an overview on how to build your first loop in Kumu:

The green button

Click on the green button at the bottom of the map, and you'll see several options:

  • Add element

  • Add connection

  • Add loop

  • Sketch

  • Import

Try clicking on the first option, Add element, to create a new element. Kumu will prompt you to give the element a label and press the enter key on your keyboard. Voila! You've added your first element.

Add a few more elements, then try selecting Add connection from that menu to connect your elements. Once you have a few connections, you can select Add loop to create a group of connections.

Tip: Speed up this process by using keyboard shortcuts! Press E to add an element, C to add a connection, and L to add a loop. Or, hold alt on your keyboard, the click the map to add an element. Hold alt and click-and-drag from an element to create a connection.

Sketch mode

If you're building your map by hand, you should definitely give sketch mode a try! Click the green button and select Sketch to activated sketch mode.

Once sketch mode is activated, you can add an element by clicking anywhere on the map, and you can add a connection by clicking and dragging from an existing element.

Quickly enter sketch mode by pressing K on your keyboard, and press the esc key to exit. While in sketch mode, you can move elements by holding the alt key on your keyboard, then clicking and dragging the element.

Indicating the causality of a connection

Whenever you add a connection, it's a good practice to indicate the causality of a connection (how one factor affects another). The Systems Practice guide recommends using the following options:

  • ++ (as one factor increases, the other also increases)

  • -- (as one factor decreases, the other also decreases)

  • +- (as one factor increases, the other decreases)

  • -+ (as one factor decreases, the other increases)

Creating a loop label

You'll continue adding elements and connections until you have one or more loops. It can be helpful to explicitly name the loops you are building by adding a loop label. To add a loop label, click the green button and then choose "add loop". You then need to click on each connection that is part of the loop, then add a loop label, and finally hit enter.

Now if you click on the loop label, you'll see a profile for the loop show up on the left hand side. Use this to include a narrative of the dynamics of the loop.

What should I use as a loop label? We recommend using a combination of "R" or "B" (for reinforcing and balancing) plus a short label for the dynamic at play (R: Trust in Government) and even a numerical label if that further helps differentiate your loops (R15: Trust in Government).

Made a mistake or need to edit the loop? To edit an existing loop, click on the loop label and then click the edit icon . You can then click connections to add/remove them from the loop.

Moving elements and loops and reshaping connections

You can click and drag any element to move its location. You can also change the curvature of a connection by clicking and dragging the middle of the connection. If you want to move just the loop label, simply click and drag the label. If you'd like to move the loop label along with all the elements and connections in that loop, hold alt or option on your keyboard, then click and drag the label.

Adding additional background and context using profiles

Leverage analysis

If you're using the +Acumen Systems Practice Course project, you'll automatically have a field listed in the profile called "leverage analysis". Click to edit the value of this field and you'll see there are 5 choices:

  • Frozen

  • Energy for change

  • Mixed bag

  • Bright spots

  • Ripple effects

Use this field to indicate which elements, connections, and loops fall into each of the above categories.

Defining elements/factors

It can be helpful to have more than just a few works explaining what each factor is on your map. Add a definition of the factor and try linking out to other websites and sources that contain more information about that factor.

You'll see a dashed rectangle towards the top of the profile for an element. Click where it says "add description" and then type in your definition and paste in any relevant links.

Custom fields

Looking to track more information about each element, connection or loop? You can easily add a new field by clicking the "+ New Field" button in the profile of any element, connection or loop. For example, you might add a "Stakeholder working on this area" field and use that to list the relevant people and organizations working on a given element, connection, or loop.

Bringing your map to life with decorations

  1. Next to Color by, use the dropdown to select "leverage analysis"

And you're done! All elements will now be be marked with colored arcs, and each colored arc represents one of the different options in your leverage analysis field.

Refine your view

Great work so far—you've created a project, started building your first map, and even added decorations to liven things up. But as you expand your map with more information, you will probably want to view different slices of the information at different times, so you can tell a story without overwhelming your map readers.

To do that, you'll use filter, focus, showcase—four different ways to refine what is visible or dominant in the map. Follow these links for the full guides for each tool:

If you don't already have a Kumu account, sign up for one by visiting https://kumu.io/join. Once you've created an account, visit your and .

If you'd like to collaborate on your map with other team members, open your map and then use the menu icon in the upper left corner to access the project settings. Click on the MEMBERS section, then add an email address to invite someone to collaborate. If that person already has a Kumu account, they'll immediately get access. If not, we'll send an invitation asking them to sign up for Kumu, then we'll automatically add their new account to the project.

To indicate the causality of a connection, first click on the connection so that the appears on the left side of your screen. You'll see a placeholder at the top that says "add connection type". Click that placeholder, then choose which of the above best represents the causality of the connection. You'll then see the corresponding "+" or "-" appear at the ends of the connection.

Kumu makes it easy to add additional information about each element, connection, and loop using the .

Here's an example of a profile for an element with additional context included:

Once you've added additional background and context using the profile, you can then bring that context to life by creating based on the values you've saved to the profile. Let's run through an example to color-code elements by the values in their leverage analysis field.

Click the settings icon on the right side of the map to open the

These arcs are called , and they are a decoration created specifically for fields that can hold more than one value. Flags are just one of many different element decorations in Kumu:

To learn how to create different element decorations, how to decorate connections, how to decorate specific groups of elements, and more, be sure to check out our .

You've worked through Kumu's guide for Systems Practice—nice job! For additional help, you can browse our other guides or email us at .

Hewlett Foundation’s The Madison Initiative
Hawaii Quality of Life
dashboard
create a new project
profile
profile
decorations
flags
full guide on decorations
Filter
Focus
Showcase
support@kumu.io
+Acumen course
Download the TOG Systems Practice workbook
Basic Editor
Element decoration options
System map in Kumu