π Welcome to CausalMap!!
πΊ If you like learning through video, there are some short Causal Map videos to get you started: here. Or keep reading this Guide!
Try this: code the short example project:#
- We've created a practice project for you called
example-short-[your-username]. This gives you your own copy of our tutorial project to experiment with freely. You should see it in the Project Dropdown Menu at top left of the app. - Select source
1in the source selector. This will display the text from this source. This source is already partially coded for you. - Practice highlighting causal claims in the Source Text Viewer to create links in the Create Links tab.
- View, edit or delete existing links in the Source Text Viewer in the Create Links tab by clicking on the highlighted sections of text or on the corresponding links in the Map.
- Watch the causal relationships grow in the Map panel
Try this: view some examples of what you can do.#
These examples are views of a real-life, anonymised QuIP project in the field of international development.
- Main factors map.
- Main factors table.
- Consequences of increased knowledge map.
- Comparing groups (pivot heatmap) table.
You can find them in the Project Dropdown Menu.
Get help / read the documentation#
The documentation you are reading now is embedded in the app via the Help System and is also available as a standalone Guide.
Each section corresponds to a different part of the interface.
Within the app, you can:
- click the blue help buttons to find out more about the different parts of the app
- use the top bar buttons described in Navbar (Help, Guide, Bookmark, and Support chat).
But what even is causal mapping?#
This Guide is all about how to use the app. For example it tells you how to use the different filters. If you want to find out more about the ideas behind those filters, we have a new "Ideas Garden" with a more discursive look at the theory and everything that surrounds causal mapping. It's a work in progress but we are adding material every day, please bear with us.
Someone shared their work with you?#
If they have to a particular map (or table), click the link and you will be automatically taken to view the corresponding map (or table), providing they have given you the correct permissions.
Alternatively if they have just asked you to log in at the app to explore a file name, say "project-x", log in and click on the dropdown list on the left-hand side and click on project-x to load it. If you can't find that file name, it means they haven't correctly shared it with the email address you logged in with.
The previous version of Causal Map, version 3, was already, as far as we know, the only software dedicated to causally coding causal claims within texts. Version 4 improves over Causal Map 3 in the following ways:
The app uses a two-pane layout with a draggable border between them (default split 30:70).
There are many dropdown menus throughout the app.
Qualitative causal mapping involves taking passages of text, e.g. from interviews or documents, and identifying sections which make causal claims. We highlight each of these sections and specify a causal factor at each end of each link (for example Lost job or Went hungry). This means creating a new factor or reusing an existing one. Usually we create these factors inductively as we code, and revise and review and consolidate them as part of the process, as with any other kind of qualitative content analysis.
Do qualitative causal analyses on the selected links by filtering or manipulating them.
Ideas Garden: Factors Panel
Ideas Garden: Links Panel
Use this panel to build pivot tables and charts from your project data with a simple dragβandβdrop interface. Three subtabs: Pivot table, Summary (one-dimensional heatmaps for categorical vars with <10 categories, mean/median for continuous), and All-by-all checks (pairwise significance tests).
The Logs tab shows a concise history of what has happened in your projects β for example, when links or sources were edited or deleted, when projects were created, or when AI processing ran.
The yellow button in the navbar is the fastest way to save useful views of your current project: maps or tables. From that one entry point you can quickly save views, update existing bookmarks, and copy links, images, legends, or a combined HTML block (link + image + legend) for reporting.
Requires an AI subscription
Requires an AI subscription
MapCat is the small chat helper at the bottom-right.
Hints are small popovers that appear occasionally to help you discover features.
First of all, there's nothing to worry about, it's fun!