Skip to content
Produce watertight polygonal vector maps by tracing raster images
Python
Branch: master
Clone or download
Pull request Compare This branch is even with mzucker:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
images
.gitignore
LICENSE
README.md
maptrace.py

README.md

maptrace

Produce watertight polygonal vector maps by tracing raster images.

  • THIS IS NOT A GIS TOOL (the output is not georeferenced)

  • DO NOT USE THIS TOOL TO CIRCUMVENT COPYRIGHT RESTRICTIONS ON EXISTING MAPS (you will be judged in the next life)

  • DO NOT USE THIS TOOL ON MULTI-MEGAPIXEL IMAGES (because loops are really slow in Python)

On the other hand, it might come in handy to generate crisp display images for presentations/articles from raster images you created yourself.

Requirements

  • Python 2 or 3
  • Numpy 1.10 or higher
  • Scipy 0.17 or higher
  • Pillow

Image copyrights

The files in the images directory are licensed as follows:

Maps created by maptrace.py from these input images (including the respective outputs in the examples directory) shall be considered derivative works for copyright purposes.

Examples

The images in the examples directory were created by running the following commands:

python maptrace.py -c images/pa-2012-pres.png -f open:cross,1 -n2
python maptrace.py images/pa-counties.png -m 1000 -e1.42 -n4 -b4
python maptrace.py -c images/birds-head.png -C8 -m40 -n8 -q5 -s8 -b16 -f dilate:box,2

(The last command might take a few minutes.)

Software license

The maptrace.py program itself is provided under the MIT license.

You can’t perform that action at this time.