Network Diagrams

When you're working on an investigation, sometimes it's helpful to sketch out a network of all the participants so that you can understand who is linked to what.

Network diagrams let you sketch out networks of people, companies and other entities into a visual diagram of actors and connections. It uses the same types of nodes and connections as Aleph and runs both within the Aleph interface and on your desktop computer.

Creating Diagrams in Aleph

Network diagrams can be created in the Aleph interface by following the steps below.

Enabling your account

  1. Log in to Aleph using your usual account information

  2. Network diagrams are currently a test feature on Aleph, so you will need to first enable test features on your Aleph account:

    • From the Home Screen, click on the Settings tab in the bottom left corner of the screen.

    • Then click the box titled "Test new features before they are finished"

    • Click "Update" to save your user settings

    • You should now see the “Network diagrams” tab in the list on the left side of your screen.

Enable your Aleph account to show test features

Creating your first diagram

Now that you've enabled diagrams for your account, you'll be able to create new diagrams within any Personal Dataset you have access to on Aleph.

Click the "Network diagrams" button on any Personal Dataset page, and then the "New diagram" button to get started.

You will now be able to map people, companies, and the relationships between them, which will be saved within your Aleph account, and only be visible to you and whoever you choose to share the diagram with.

Adding entities to your diagram

To add people, companies, or other entities to your diagram, click the "Add entities" icon in the toolbar on the left side of the screen, or double click anywhere in the graphing area.

Once you have created multiple entities in your diagram, you can connect them by clicking the "Add edges" icon.

Any entities and relationships you create within a diagram will automatically be added to the Personal Dataset in which your diagram was created. This allows you to cross-reference the lists of people, companies, and other entities you have created in your diagrams with data from across the rest of Aleph.

Sharing diagrams

Once you have created a diagram, you can allow others to view or edit it by allowing them access to the Personal Dataset in which it is contained.

You can also export your diagram to be saved as a file on your computer by clicking the "Export" button in the top right corner of the diagram editor. Once the diagram has been exported as a file, it can be edited using the Desktop application or shared with others as with any other file on your computer.

Download the Desktop App

Creating network diagrams within Aleph allows you to map networks of people and influence directly alongside the rich ecosystem of data and processing tools that Aleph provides. Sometimes, though, you might want to work on a diagram offline, within the private confines of your own device.

For this reason, we have created a desktop application, called VIS Desktop, which is available for download on Github for Microsoft Windows, Apple MacOS X and common Linux distributions.

Creating and editing diagrams within the desktop app works the same as in Aleph, but allows you to work on your investigation files offline, with all data contained on your own device. Using the desktop app, investigation files can be created, edited, and shared as you would any other file on your computer, and will not be shared with others unless you explicitly decide to.

If you are interested, you are also welcome to explore and contribute to the source code of the application.

Frequently Asked Questions

Below some of the common questions we've received about VIS Desktop. If you have another question or want to suggest an improvement, please get in touch.

How does this relate to OCCRP VIS?

Visual Investigative Scenarios (VIS) is an application developed by OCCRP, RISE Project and QuickData that is the inspiration for VIS Desktop. While it's been a beloved tool to some reporters, it has also become slow and cumbersome. We're unable to add new features and ensure its continued safety.

That's why we are planning to phase out the old version of VIS once VIS Desktop has become stable and battle-tested. Our goal is to export all existing VIS diagrams so that they can be opened in VIS Desktop, so that people can continue to work with their data. It's unlikely this transition will happen before 202.

How much data can I add to a VIS Desktop diagram?

The goal of VIS Desktop is to support investigative mind mapping, not big data analysis. While you may be able to add several hundred companies and people to a chart, the ideal size of a chart is somewhere around to 50-150 entities.

Can I make entities into groups?

Yes. Simply select two or more entities, then click the "Group selection" button, as depicted below.

Can I embed a diagram in an article?

Yes. In main the toolbar, you have an option to export an SVG graphic to a file. This SVG can be opened and "beautified" in a program like Adobe Illustrator or Inkscape (open source), and eventually published to the web as an image.

Please be conscious, however, that VIS diagrams are mainly intended to be investigative sketches. Their complexity can easily exceed the complexity we should force our readers to deal with. Be nice to the mortals.

Can I import a spreadsheet of names and companies?

That'd be cool, right! We'll try to get it added soon.