Fetching contributors…
Cannot retrieve contributors at this time
145 lines (100 sloc) 6.15 KB

IATI Dashboard Requirements Status


The IATI Dashboard is a displays key numbers and graphs about the data on the IATI Registry.

See the Dashboard in action at

The Dashboard is in beta, all contents/urls/machine readable downloads are subject to change.

This repository is the code for the Dashboard frontend. Stats are generated from the Registry by stats code in a separate repository -

Technology Overview

The dashboard mostly in Python, with some helper Bash scripts.

Python scripts:

  • contains is a Flask application that makes use of Frozen Flask to generate some static HTML.
  • generates CSV files.
  • generates static images of graphs using matplotlib.

Bash helper scripts:

  • The main source of data for the Dashboard is stats generated by IATI-Stats (about the data on the IATI Registry). can be used to fetch a recently calculated copy of these stats. (or see calculating your own stats section below)
  • The Dashboard also uses various other data from online sources (including GitHub). These can be fetched using
  • runs all the above commands, see Usage below.



  • Unix based setup (e.g. Linux, Mac OS X) with bash etc.

  • wget and curl installed

  • Python 2.7

  • Python dev library python-dev

  • python-virtualenv (optional)

  • Development files for libfreetype, libpng, libxml and libxslt e.g. libfreetype6-dev libpng-dev libxml2-dev libxslt-dev.

    (alternatively, you may be able to install some of the python dependencies in requirements.txt using your package manager)

To install:

## Get the code
git clone
cd IATI-Dashboard

## Set up a virtual environment (recommended)
# Create a virtual environment
virtualenv pyenv
# Activate the virtual environment
# (you need to this every time you open a new terminal session)
source pyenv/bin/activate

## Install python dependencies
## Use pip as described below, or your distro's package manager to install
## the dependcies in requirements.txt
# If you are running a less recent linux distro, you will need to install distribute
easy_install -U distribute
pip install -r requirements.txt

# Create a configuration file
# Currently this is only used for GitHub credentials to make requests to the GitHub api
# You should be able to run the dashboard in live development mode (see Development below)
# without this file. (Although the GitHub tab will throw an error).
cp # And provide the necessary values


The following steps are performed routinely on our deployed Dashboard. (On our servers, the Dashboard is actually deployed using this salt file.

# Fetch the necessary calculated stats
# Fetch some extra data from github and github gists

mkdir out
python will output a MissingURLGeneratorWarning. This is expected, as some of the URLs defined are for the live development server only (see below).

The full list of steps for our deployment can be found in (The name of this is now a misnomer as the output is no longer a git repository - previously a commit was pushed to GitHub pages.)


For development, you can use the live Flask development server, instead of Frozen Flask.

python --live

Using the live development server is highly recommended, because it displays full bracktraces for 500 errors, whereas frozen flask does not.

Calculating your own stats for the dashboard

The Dashboard requires a stats-calculated directory, which can be downloaded using the shell script as described above, or calculated yourself using . stats-calculated corresponds to the gitout directory generated by IATI-Stat's

Often you only want to regenerate the current stats, use to download the pre-calculated historical stats and just replace the stats-calculated/current directory with the out directory produced by running the loop, aggregate and invert commands individually.


Copyright (C) 2013-2015 Ben Webb <>
Copyright (C) 2013-2014 David Carpenter <>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <>.