Skip to content

Make maps of world voting patterns, such as UN General Assembly votes.

License

Notifications You must be signed in to change notification settings

small-hack/kaartmaker

Repository files navigation

Kaartmaker

Make world and regional labeled maps based on voting. Most commonly used for representing UN General Assembly votes.

kaartmaker -C ./kaartmaker/datasets/UN_general_assembly/russia_ceasefire/world_ukraine_votes.csv -t "UNGA vote on ceasefire in Ukraine" -s "gadebate.un.org"

Map of world Ukraine votes

kaartmaker -C ./kaartmaker/datasets/UN_general_assembly/israel_ceasefire/world_palestine_votes.csv -t "UNGA on Ceasefire in Gaza" -s "gadebate.un.org" -r world

Map of world Gaza votes

kaartmaker -C ./kaartmaker/datasets/UN_general_assembly/israel_ceasefire/world_palestine_votes.csv -t "UNGA on Ceasefire in Gaza" -s "gadebate.un.org" -r europe

Map of Europe Gaza votes

kaartmaker -C ./kaartmaker/datasets/UN_general_assembly/russia_ceasefire/world_ukraine_votes.csv -t "UNGA vote on ceasefire in Ukraine" -s "gadebate.un.org" -r europe

Map of Europe Ukraine votes

If you'd like to see more examples, please check them out here.

Features

  • Use your own csv datasets to generate maps for the world, or specific regions

  • Generate geojson files for specific regions with your vote data :)

  • Colors are colorblind friendly, selected from here can also be reversed for vote types

  • Use sovereignty (default) or subunits to get more granularity on countries e.g. Scotland, North Ireland, Wales, and Isle of Man distinguished from the United Kingdom

Installation

Prereqs

Install with pipx (recommended for end users)

We recommend using pipx to install kaartmaker into an isolated python environment.

pipx install kaartmaker

Install with pip

This will break your system packages on Debian.

pip install kaartmaker --break-system-packages

Install with poetry (recommended for development)

Clone the repo and cd into the root directory of the repo, then run:

# install kaartmaker
poetry install

# open a virtual env and then you can run kaartmaker
poetry shell

How To

kaartmaker --help

SVG showing the full help text when you run kaartmaker --help

Donwload your geojson data

Maps (sovereignty, units, subunits, and disputed areas) can be downloaded from: https://www.naturalearthdata.com/downloads/10m-cultural-vectors/10m-admin-0-details/

You can also download geojson files with the download_geojson.sh or download_geojson.py scripts in this repo.

Using a comma separated list (CSV) file

To use kaartmaker, you'll need to provide a CSV file with columns called NAME_EN and VOTE. Valid votes are YES|NO or AGAINST|ABSTENTION|IN FAVOR Example when documenting :

NAME_EN,VOTE
Brazil,IN FAVOR
Czechia,AGAINST
Germany,ABSTENTION

status

Mostly stable, but happy to take a look at Issues and Pull Requests :)

Please star the repo if you find it interesting!