Skip to content

Welcome to the Development Data Partnership!

A partnership between international organizations and companies, created to facilitate the use of third-party data in research and international development.

Get Started

Probably you are looking where to start, so if:

You're done! Go ahead explore the documentation or install and contribute!

Resources

Awesome Data Partnership

A curated list of the Development Data Partnership public data goods and derivative works.

Documentation

Data documentation repositories curated for each Development Partner, based on their signed license agreements.

Links to each Data Partner's Documentation:

Important: The documentation may NOT be shared with persons outside of your organization.

Data Partner Repository WBG IDB IMF
Carto Examples
ClimaCell Examples
Cuebiq Examples
ESA Examples
ESRI Examples
Facebook Examples
Google Examples
Grab Examples
GSMA Examples
Indigo Examples
InLoco Examples
LinkedIn Examples
Mapbox Examples
Mapillary Examples
Mobike Examples
Orbital Insight Examples
Premise Examples
SafeGraph Examples
Twitter Examples
Uber Examples
Unacast Examples
Veraset Examples
Waze Examples
WhereIsMyTransport Examples
X-Mode Examples

Installation

The Partnership maintains a Python package that offers partner-specific and general helper functions.

Before installing the package, you will have to:

  1. Install Python 3.6+
  2. Set up GitHub with ssh. Alternatively, see username/password.

Unfortunately, the package not public, so you will have to be authenticated via GitHub.

Now you are ready to pip install! It is strongly recommended that you create a virtual environment.

pip install git+ssh://git@github.com/datapartnership/datapartnership.git@v0.2

Verifying

Now you should have datapartnership installed on your environment.

>> import datapartnership
>> datapartnership.__version__
0.2.0

See examples on the documentation.

Can I use https instead?

We recommend ssh. Alternatively, you can change your global settings to use https instead.

That way, you will be able to login with your username and password. If you are using two-factor authentication on GitHUb, you will have to create a personal token.

Now change your global settings,

git config --global url."https://github.com/".insteadOf "git@github.com:"
git config --global credential.helper cache

Finally, while installing, use git+https://github.com/ instead of git+ssh://git@github.com/. For example,

pip install git+https://github.com/datapartnership/datapartnership.git

Contributing

Our documentation follows the literate programming paradigm.

Literate programming is a programming paradigm introduced by Donald Knuth in which a computer program is given an explanation of its logic in a natural language, such as English, interspersed with snippets of macros and traditional source code, from which compilable source code can be generated. Wikipedia

It requires nbdev. Check CONTRIBUTING.