Skip to main content

Kumu Network Mapping

1 Introduction to Kumu

2 Creating Kumu Project

Kumu Projects in the Wild

2.1 Creating Data File

2.1.1 Linking Data File to Kumu

2.2 Basic Editor

2.2.1 Map Overview Tab

2.2.2 Setting the Legend

2.2.3 Running basic metrics

2.3 Advanced Editor

Kumu Documentation: Advanced Editor Hub

2.3.1 Controls

Kumu Documentation: Controls

2.3.2 Clustering

Kumu Documentation: Clustering

2.3.3 Filtering

Kumu Documentation: Filtering

2.3.4 Settings

Kumu Documentation: @settings

Note: Some settings change dynamically as an individual interacts with the map. For example, as you cluster or connect by different elements, the elements that appear in setting cluster: will change.

2.3.5 Adding Images

Kumu Documentation: Image controls

Kumu Documentation: Image Decorations

2.3.6 Decoration

For broad accessibility of the network map, pick element colors from color-blind friendly color palettes. Multiple palettes can be found in the Data Analysis Guides.

Kumu Documentation: Color Legends

Kumu Documentation: Icons

Kumu Documentation: Popovers

2.3.7 Titles

Kumu Documentation: Titles

2.4 Forking a Project

2.5 Distributing Kumu Project

Kumu Documentation: Share and Embed Maps

3 Publication Network Maintenance

Elements: The publications (i.e. each row of the dataset because there is only one value for “Type”)

Type: There is one type of element in the dataset, which are publications

Tags/Element Type The columns that are used to categorize information about the elements, can contain multiple descriptors (i.e. method, theme)

3.1 Adding Column in linked data

  1. Add the column in the main spreadsheet
  2. Refresh network map page
  3. Open the hamburger menu in the top left corner and go to fields
  4. Under Relevance > Element Types > Publication, click edit at the bottom of the list and select the added column titles
  5. Re-run metrics

3.2 Adding Pub Type

  1. Open advanced editor

3.3 Adding Filter Category

3.4 Running Updated Metrics

Once the kumu_publication_network google sheets has been updated, you will need to re-run the metrics that scale the elements according to their frequency in the dataset.

  1. Refresh the Kumu Map
  2. Select all buttons under Connect by.... We want all element types to appear on the map.
  3. Click the erlenmeyer flask icon in the bottom right corner that is labeled Metrics
  4. Click Social Network Analysis
  5. Choose indegree as the metric and click Discover the Influencers
  6. Now deselect all buttons under Connect by... so that the only the publication elements appear on the map
  7. Choose indegree and again click Discover the Influencers
    1. This process resets the indegree value (i.e. how many connections between elements) to zero for the publications so that they have a standard element size. The recalculated metrics for the other element types (method, theme, etc.) will be retained and rescaled according to the dataset updates.

3.5 Advanced editor code guide

Code comments for Publication Network

# The controls section is going to define all of the interactive controls of the map, including the filters and cluster connection buttons.

@controls {
  top { #Sets location of next function, text, etc.
    title { #Sets the title of the map at the top. Important for accessibility!
      value: "Developmental Psychopathology Lab Publication Network"; #the title
      text-align: center; #title alignment
      font-size: 30; #title size
    }

    filter { #sets a filter at the top of the page for publication type (which is a column in dataset)
      target: element; #this is targeting the publications
      by: "Publication Type"; #options for filtering by "Publication Type" column in the dataset
      as: buttons; #Filter appears buttons instead of a dropdown
      multiple: true; #can select multiple filters at once, i.e. book and book chapter both appear
      default: show-all; #defaults to showing all of the publications types
      font-weight: bold;
      font-size: 15;
      padding: 15; #adjusts spacing around the filter bar
    }
  }

  bottom-right { #specify location for control is bottom right
    image { #adds the devpsy logo
      src: "https://developmental-psychopathology.lab.uiowa.edu/sites/developmental-psychopathology.lab.uiowa.edu/files/2022-07/Final%20Medium%20Line%20Logo%20Small.jpeg"; #this is the link to the logo on the lab website, update this link if that changes
      height: 140;
    }
  }

  top-left { #specify controls in the top left corner
    search {} #search bar will appear in top left

    text { #text header for filters
      value: "Filter by..."; #text to appear on map
      font-weight: bold;
      font-size: 20;
      padding: 0;
    }

    filter { #This will create a filter control
      target: element; #element is each publication (because there is only one "Type" in the dataset)
      by: "Theme"; #column to filter by from dataset
      as: dropdown; #sets filter to a dropdown format
      placeholder: "Theme"; #the text that appears on the filter
      multiple: true; #allows for selecting multiple filter categories (tags)
      default: show-all; #defaults to showing all themes in dataset
      font-size: 15;
      padding: 5; #helps create visual space between filters
    }

    filter {
      target: element;
      by: "Construct";
      as: dropdown;
      placeholder: "Construct";
      multiple: true;
      default: show-all;
      font-size: 15;
      padding: 5;
    }

    filter {
      target: element;
      by: "Sample/Population";
      as: dropdown;
      placeholder: "Sample/Population";
      multiple: true;
      default: show-all;
      font-size: 15;
      padding: 5;
    }

    filter {
      target: element;
      by: "Method";
      as: dropdown;
      placeholder: "Method";
      multiple: true;
      default: show-all;
      font-size: 15;
      padding: 5;
    }

    filter {
      target: element;
      by: "Open Science";
      as: dropdown;
      placeholder: "Open Science";
      multiple: true;
      default: show-all;
      font-size: 15;
      padding: 5;
    }

    filter {
      target: element;
      by: "Year";
      as: dropdown;
      placeholder: "Publication Year";
      multiple: true;
      default: show-all;
      font-size: 15;
      padding: 5;
    }

    filter {
      target: element;
      by: "Student Author";
      as: dropdown;
      placeholder: "Student Author";
      multiple: true;
      default: show-all;
      font-size: 15;
      padding: 5;
    }
  }

  bottom { #specifies that control is appearing at the bottom
    text { #text header for connection cluster buttons
      value: "Connect by..."; #text to appear on map
      font-weight: bold;
      font-size: 20;
      padding: 0;
    }

    cluster { #this function will generate the dynamic connections between publications based on the specified columns below
      by: "Theme", "Construct", "Open Science", "Sample/Population", "Method"; #specify the columns that will define the connections 
      as: buttons; #appear as buttons
      multiple: true; #allows you to connect by multiple columns (element types/tags), i.e. both theme and construct can appear
      default: "Theme"; #sets the default connection to appear, can set to * or show-all for all clusters to appear by default
      font-weight: bold;
      font-size: 15;
    }
  }
}

#The settings are going to specify the default view settings of the map. Refer to Kumu's guide on the @settings reference to see available specification options.

@settings {
  element-size: 400; #this is a larger than default element size to help with accessible visibility
  element-font-size: 400; #larger than defauly font size (under map bubbles) to help with accessible visibility
  background-color: white; #map background is white
  font-cutoff: 1;
  layout-preset: hairball; #part of the force-directed layout (bouncy instead of a static layout)
  layout-particle-charge: 4000; #repels elements from each other to create more visual space on the map
  connection-length: 400; #forces longer connection lines to create visual space/avoid tight overlapped clusters
  element-scale: scale("indegree", 0.5, 3); #this map is scaled by the indegree metric, which is specified here; can change the range of element sizes if you want the scale more/less visually drastic
  template: 0;
  connection-curvature: 0.25; #sets slight curve to gray connection lines
  selection-color: red; #sets the colored ring that will appear on a selected element (default is red!)
  cluster: "Theme"; #his will dynamically shift as you interact with the cluster buttons on the button, don't need to edit this line ever
}

#Sets the text box popup that appears when you hover over a publication. Intended to help with accessibility/visibility
["element type"="Publication"] { #specify that popover is intended for the publications (i.e. all rows)
  popover: "#### {{label}}"; #the text that pops up is the in-text citation (which is specified in the "label" column of the dataset); the #### sets it to fourth-level header size
}

#Specify the appearance of element types that are used to connect/filter publications 
element["element type"="Method"] { #use element function to tweak specifics about the elements (here we specify how the method elements will appear)
  icon: wrench; #select icon from standard css icon list
  icon-color: white; #this is why the icon appears white
  color: transparent; #removes the default circle around element so that we can add transparent shadow behind the icon below
  border-width: 0;
  shadow-color: #CC6677; #specifies to add a shadow in this color (choose color-blind friendly colors!)
  shadow-opacity: 0.4; #set opacity of shadow
  shadow-size: 1; #sets how big the shadow border around the icon, 1 is ideal
}

element["element type"="Construct"] {
  icon: star;
  icon-color: white;
  color: transparent;
  border-width: 0;
  shadow-color: #C4451C;
  shadow-opacity: 0.4;
  shadow-size: 1;
}

element["element type"="Open Science"] {
  icon: share-alt;
  icon-color: white;
  color: transparent;
  border-width: 0;
  shadow-color: grey;
  shadow-opacity: 0.6;
  shadow-size: 1;
}

element["element type"="Sample/Population"] {
  icon: user;
  icon-color: white;
  color: transparent;
  border-width: 0;
  shadow-color: red;
  shadow-opacity: 0.4;
  shadow-size: 1;
}

element["element type"="Theme"] {
  icon: comment;
  icon-color: white;
  color: transparent;
  shadow-color: green;
  shadow-opacity: 0.4;
  shadow-size: 1;
}

#Specify that network connections lines are "undirected" so they have no arrows. Also area to specify width and color of connection lines (currently set to default)
connection {
  arrow-visibility: hidden; 
  color: grey;
  size: 6;
}

#Specify color of each type of publication (relevant for map appearance and the legend)
/* Journal Publication */
element["publication type"="journal publication"] {
  color: #0072B2;
}

/* R Package */
element["publication type"="r package"] {
  color: #009E73;
}

/* Book Chapter */
element["publication type"="book chapter"] {
  color: #E69F00;
}

/* Book */
element["publication type"="book"] {
  color: #56B4E9;
}

/* Documentation */
element["publication type"="documentation"] {
  color: #D55E00;
}

#specify shadow ring around the publications that have a student author 
/* Student Author */
element["student author"="YES"] { #refers to the "student author" column in the dataset
  shadow-color: #8a2be2;
  shadow-opacity: 0.3;
  shadow-size: 1.5;
}



Developmental Psychopathology Lab