Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
94 lines (56 sloc) 2.08 KB

Step by Step Installation Instructions

Tested on Mac OS 10.6.8

Automatic Install

  1. Download
git clone kartograph
  1. Use to install Kartograph + required libraries
cd kartograph
sudo python install

Test installation

Kartograph at least needs a shapefile to create a svg map from. You can download public domain shapefiles from If you only want to test the installation, grab and unzip the following shapefile of the United States.

unzip -d shp

Now create a very simple map configuration and store it to map.yaml

-  src: shp/united-states.shp
   mode: bbox
   data: [-120,25,-73,50]

Now you can generate the SVG map using

kartograph svg map.yaml -o states.svg

If you want to preview generated maps automatically, save the following script to ```/usr/local/bin/firefox` (make sure to point it to the location where you installed Firefox on your system).

open -a /Applications/ $1

Manual Install

You need to install required libraries

###shapefile (

One of the following should work

sudo pypm install pyshp
easy_install pyshp


This should work:

pip install polygon

Alternatively download mac binaries from

and copy the folder "Polygon" into



git clone

Output should look like this:

Cloning into
remote: Counting objects: 422, done.
remote: Compressing objects: 100% (265/265), done.
remote: Total 422 (delta 210), reused 353 (delta 141)
Receiving objects: 100% (422/422), 38.82 MiB | 458 KiB/s, 	Resolving deltas: 100% (210/210), done.