Convert a shapefile into SVG paths easily used with JavaScript libraries like Raphael.
5 |There was a mistake loading your page.
9 |The site administrator has been notified about the problem.
10 |Please wait a few minutes and try again.
11 |We couldn't find the page you requested.
10 |There might be a mistake in the URL, or the link could be out of date.
11 |You could try:
12 |2 | 3 | dP d8888b. 4 | 88 `88 5 | .d8888b. 88d888b. 88d888b. .aaadP' .d8888b. dP .dP .d8888b. 6 | Y8ooooo. 88' `88 88' `88 88' Y8ooooo. 88 d8' 88' `88 7 | 88 88 88 88. .88 88. 88 88 .88' 88. .88 8 | `88888P' dP dP 88Y888P' Y88888P `88888P' 8888P' `8888P88 9 | 88 .88 10 | dP d8888P 11 | 12 |13 | 14 | django-shp2svg 15 | ============== 16 | 17 | For more information check out our post on The Times' Data Desk blog: [Introducing shp2svg](http://datadesk.latimes.com/posts/2012/12/introducing-shp2svg/) 18 | 19 | Convert a shapefile into an SVG you can use with JavaScript drawing libraries. 20 | 21 | Features 22 | -------- 23 | 24 | * Convert GIS shapefiles to SVG paths at any size 25 | * Get the SVG as JSON or an SVG file editable in Adobe Illustrator 26 | * Use any PostGIS supported projection 27 | * Calculate the centroids for each shape, useable in a proportional symbol map 28 | 29 | Setup 30 | ----- 31 | 32 | Make sure to have your computer [configured for GeoDjango](https://docs.djangoproject.com/en/dev/ref/contrib/gis/tutorial/). We also suggest using PostgreSQL with a [spatial database template](https://docs.djangoproject.com/en/dev/ref/contrib/gis/install/postgis/#spatialdb-template). 33 | 34 | If you go that route, you can set up a database using: 35 | 36 | $ createdb -T template_postgis shp2svg 37 | 38 | Then, create a virtualenv to store the codebase: 39 | 40 | $ virtualenv --no-site-packages shp2svg 41 | 42 | Clone down the repo: 43 | 44 | $ cd shp2svg 45 | $ git clone git@github.com:datadesk/django-shp2svg.git project 46 | 47 | And install the requirements: 48 | 49 | $ . bin/activate 50 | $ cd project 51 | $ pip install -r requirements.txt 52 | 53 | Sync up the database (we're using South, though you're welcome to drop it locally) and create the cache table: 54 | 55 | $ python manage.py syncdb 56 | $ python manage.py migrate shp2svg 57 | $ python manage.py createcachetable my_cache_table 58 | 59 | Finally, update your settings.py file with your database name and local settings. Start the local server: 60 | 61 | $ fab rs 62 | 63 | You're good to go! Check out [http://localhost:8000](http://localhost:8000). -------------------------------------------------------------------------------- /fabfile.py: -------------------------------------------------------------------------------- 1 | from __future__ import with_statement 2 | from fabric.api import * 3 | import os 4 | import random 5 | 6 | 7 | def rmpyc(): 8 | """ 9 | Erases pyc files from current directory. 10 | 11 | Example usage: 12 | 13 | $ fab rmpyc 14 | 15 | """ 16 | print("Removing .pyc files") 17 | with hide('everything'): 18 | local("find . -name '*.pyc' -print0|xargs -0 rm", capture=False) 19 | 20 | 21 | def rs(port=8000): 22 | """ 23 | Fire up the Django test server, after cleaning out any .pyc files. 24 | 25 | Example usage: 26 | 27 | $ fab rs 28 | $ fab rs:port=9000 29 | 30 | """ 31 | with settings(warn_only=True): 32 | rmpyc() 33 | local("python manage.py runserver 0.0.0.0:%s" % port, capture=False) 34 | 35 | 36 | def sh(): 37 | """ 38 | Fire up the Django shell, after cleaning out any .pyc files. 39 | 40 | Example usage: 41 | 42 | $ fab sh 43 | 44 | """ 45 | rmpyc() 46 | local("python manage.py shell", capture=False) 47 | 48 | 49 | def makesecret( 50 | length=50, 51 | allowed_chars='abcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*(-_=+)' 52 | ): 53 | """ 54 | Generates secret key for use in Django settings. 55 | """ 56 | key = ''.join(random.choice(allowed_chars) for i in range(length)) 57 | print 'SECRET_KEY = "%s"' % key 58 | 59 | 60 | def load(): 61 | """ 62 | Prints the current load values. 63 | 64 | Example usage: 65 | 66 | $ fab stage load 67 | $ fab prod load 68 | 69 | """ 70 | def _set_color(load): 71 | """ 72 | Sets the terminal color for an load average value depending on how 73 | high it is. 74 | 75 | Accepts a string formatted floating point. 76 | 77 | Returns a formatted string you can print. 78 | """ 79 | value = float(load) 80 | template = "\033[1m\x1b[%sm%s\x1b[0m\033[0m" 81 | if value < 1: 82 | # Return green 83 | return template % (32, value) 84 | elif value < 3: 85 | # Return yellow 86 | return template % (33, value) 87 | else: 88 | # Return red 89 | return template % (31, value) 90 | 91 | with hide('everything'): 92 | # Fetch the data 93 | uptime = run("uptime") 94 | # Whittle it down to only the load averages 95 | load = uptime.split(":")[-1] 96 | # Split up the load averages and apply a color code to each depending 97 | # on how high it is. 98 | one, five, fifteen = [_set_color(i.strip()) for i in load.split(',')] 99 | # Get the name of the host that is currently being tested 100 | host = env['host'] 101 | # Combine the two things and print out the results 102 | output = u'%s: %s' % (host, ", ".join([one, five, fifteen])) 103 | print(output) 104 | 105 | -------------------------------------------------------------------------------- /shp2svg/models.py: -------------------------------------------------------------------------------- 1 | import os 2 | import math 3 | import subprocess 4 | from django.conf import settings 5 | from django.contrib.gis.db import models 6 | 7 | 8 | def get_dbf_path(instance, filename): 9 | return os.path.join('shapes', instance.slug, instance.slug + '.dbf') 10 | 11 | def get_prj_path(instance, filename): 12 | return os.path.join('shapes', instance.slug, instance.slug + '.prj') 13 | 14 | def get_shp_path(instance, filename): 15 | return os.path.join('shapes', instance.slug, instance.slug + '.shp') 16 | 17 | def get_shx_path(instance, filename): 18 | return os.path.join('shapes', instance.slug, instance.slug + '.shx') 19 | 20 | 21 | class ShapefileContainer(models.Model): 22 | """ 23 | A model for grouping multiple shapes. Allows 24 | you to group U.S. States, for example, then export them as 25 | a Dict of SVG paths with the same projection. 26 | """ 27 | name = models.CharField(max_length=500) 28 | source = models.CharField(max_length=500, blank=True) 29 | slug = models.CharField(max_length=500, unique=True) 30 | dbf = models.FileField(upload_to=get_dbf_path, max_length=500) 31 | prj = models.FileField(upload_to=get_prj_path, max_length=500) 32 | shp = models.FileField(upload_to=get_shp_path, max_length=500) 33 | shx = models.FileField(upload_to=get_shx_path, max_length=500) 34 | objects = models.GeoManager() 35 | 36 | def __unicode__(self): 37 | return self.name 38 | 39 | def get_shapefile_folder(self): 40 | """ 41 | returns the path to the folder containing the shapefile 42 | """ 43 | return os.path.join(settings.ROOT_PATH, 'media', 'shapes', self.slug) 44 | 45 | def get_projected_shapes(self, srid): 46 | """ 47 | Returns a projected geoqueryset of all of the Shape objects 48 | in the collection 49 | """ 50 | return self.shape_set.all().transform(srid) 51 | 52 | def get_absolute_url(self): 53 | return '/%s/' % self.slug 54 | 55 | def delete(self, *args, **kwargs): 56 | """ 57 | A custom delete method that also kills the associated files 58 | """ 59 | # kill off the files individually 60 | self.dbf.delete() 61 | self.prj.delete() 62 | self.shp.delete() 63 | self.shx.delete() 64 | # get rid of the directory 65 | path = self.get_shapefile_folder() 66 | subprocess.call(['rm', '-rf', path]) 67 | # and kill off the object 68 | super(ShapefileContainer, self).delete(*args, **kwargs) 69 | 70 | 71 | class Shape(models.Model): 72 | """ 73 | An individual MultiPolygon 74 | """ 75 | poly = models.MultiPolygonField() 76 | # Will store the attributes here as JSON 77 | attributes = models.TextField(blank=True, null=True) 78 | shapefile = models.ForeignKey("ShapefileContainer", null=True, blank=True) 79 | objects = models.GeoManager() 80 | 81 | def get_extracted_coords(self): 82 | """ 83 | Extracts the nested multigeometry coordinates into a nicer list 84 | """ 85 | coords = self.poly.coords 86 | geom_list = [] 87 | for i in coords: 88 | for coord in i: 89 | geom_list.append(list(coord)) 90 | return geom_list -------------------------------------------------------------------------------- /shp2svg/migrations/0001_initial.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | import datetime 3 | from south.db import db 4 | from south.v2 import SchemaMigration 5 | from django.db import models 6 | 7 | 8 | class Migration(SchemaMigration): 9 | 10 | def forwards(self, orm): 11 | # Adding model 'ShapefileContainer' 12 | db.create_table('shp2svg_shapefilecontainer', ( 13 | ('id', self.gf('django.db.models.fields.AutoField')(primary_key=True)), 14 | ('name', self.gf('django.db.models.fields.CharField')(max_length=500)), 15 | ('source', self.gf('django.db.models.fields.CharField')(max_length=500, blank=True)), 16 | ('slug', self.gf('django.db.models.fields.CharField')(unique=True, max_length=500)), 17 | ('dbf', self.gf('django.db.models.fields.files.FileField')(max_length=500)), 18 | ('prj', self.gf('django.db.models.fields.files.FileField')(max_length=500)), 19 | ('shp', self.gf('django.db.models.fields.files.FileField')(max_length=500)), 20 | ('shx', self.gf('django.db.models.fields.files.FileField')(max_length=500)), 21 | )) 22 | db.send_create_signal('shp2svg', ['ShapefileContainer']) 23 | 24 | # Adding model 'Shape' 25 | db.create_table('shp2svg_shape', ( 26 | ('id', self.gf('django.db.models.fields.AutoField')(primary_key=True)), 27 | ('poly', self.gf('django.contrib.gis.db.models.fields.MultiPolygonField')()), 28 | ('attributes', self.gf('django.db.models.fields.TextField')(null=True, blank=True)), 29 | ('shapefile', self.gf('django.db.models.fields.related.ForeignKey')(to=orm['shp2svg.ShapefileContainer'], null=True, blank=True)), 30 | )) 31 | db.send_create_signal('shp2svg', ['Shape']) 32 | 33 | 34 | def backwards(self, orm): 35 | # Deleting model 'ShapefileContainer' 36 | db.delete_table('shp2svg_shapefilecontainer') 37 | 38 | # Deleting model 'Shape' 39 | db.delete_table('shp2svg_shape') 40 | 41 | 42 | models = { 43 | 'shp2svg.shape': { 44 | 'Meta': {'object_name': 'Shape'}, 45 | 'attributes': ('django.db.models.fields.TextField', [], {'null': 'True', 'blank': 'True'}), 46 | 'id': ('django.db.models.fields.AutoField', [], {'primary_key': 'True'}), 47 | 'poly': ('django.contrib.gis.db.models.fields.MultiPolygonField', [], {}), 48 | 'shapefile': ('django.db.models.fields.related.ForeignKey', [], {'to': "orm['shp2svg.ShapefileContainer']", 'null': 'True', 'blank': 'True'}) 49 | }, 50 | 'shp2svg.shapefilecontainer': { 51 | 'Meta': {'object_name': 'ShapefileContainer'}, 52 | 'dbf': ('django.db.models.fields.files.FileField', [], {'max_length': '500'}), 53 | 'id': ('django.db.models.fields.AutoField', [], {'primary_key': 'True'}), 54 | 'name': ('django.db.models.fields.CharField', [], {'max_length': '500'}), 55 | 'prj': ('django.db.models.fields.files.FileField', [], {'max_length': '500'}), 56 | 'shp': ('django.db.models.fields.files.FileField', [], {'max_length': '500'}), 57 | 'shx': ('django.db.models.fields.files.FileField', [], {'max_length': '500'}), 58 | 'slug': ('django.db.models.fields.CharField', [], {'unique': 'True', 'max_length': '500'}), 59 | 'source': ('django.db.models.fields.CharField', [], {'max_length': '500', 'blank': 'True'}) 60 | } 61 | } 62 | 63 | complete_apps = ['shp2svg'] -------------------------------------------------------------------------------- /project/settings.py: -------------------------------------------------------------------------------- 1 | import os 2 | ROOT_PATH = os.path.split(os.path.dirname(__file__))[0] 3 | 4 | DEBUG = True 5 | TEMPLATE_DEBUG = DEBUG 6 | 7 | # Fill in your admins here 8 | ADMINS = ( 9 | # ('Sample Admin', 'admin@example.com'), 10 | ) 11 | 12 | MANAGERS = ADMINS 13 | 14 | DATABASES = { 15 | 'default': { 16 | 'ENGINE': 'django.contrib.gis.db.backends.postgis', 17 | 'NAME': 'shp2svg', 18 | 'USER': 'postgres', 19 | 'PASSWORD': 'postgres', 20 | 'HOST': 'localhost', 21 | 'PORT': '5432', 22 | } 23 | } 24 | 25 | CACHES = { 26 | 'default': { 27 | 'BACKEND': 'django.core.cache.backends.db.DatabaseCache', 28 | 'LOCATION': 'my_cache_table', 29 | # 'BACKEND': 'django.core.cache.backends.dummy.DummyCache', 30 | } 31 | } 32 | 33 | TIME_ZONE = 'America/Los_Angeles' 34 | LANGUAGE_CODE = 'en-us' 35 | 36 | SITE_ID = 1 37 | USE_I18N = True 38 | USE_L10N = True 39 | USE_TZ = True 40 | 41 | MEDIA_ROOT = os.path.join(ROOT_PATH, 'media') 42 | MEDIA_URL = '/media/' 43 | STATIC_ROOT = os.path.join(ROOT_PATH, 'static') 44 | ADMIN_MEDIA_PREFIX = '/static/admin/' 45 | STATICFILES_DIRS = ( 46 | os.path.join(ROOT_PATH, 'templates', 'static'), 47 | ) 48 | 49 | STATIC_URL = '/static/' 50 | STATICFILES_FINDERS = ( 51 | 'django.contrib.staticfiles.finders.FileSystemFinder', 52 | 'django.contrib.staticfiles.finders.AppDirectoriesFinder', 53 | ) 54 | 55 | # Make this unique, and don't share it with anybody. 56 | SECRET_KEY = '' 57 | 58 | # List of callables that know how to import templates from various sources. 59 | TEMPLATE_LOADERS = ( 60 | 'django.template.loaders.filesystem.Loader', 61 | 'django.template.loaders.app_directories.Loader', 62 | ) 63 | 64 | MIDDLEWARE_CLASSES = ( 65 | 'django.middleware.gzip.GZipMiddleware', 66 | 'django.middleware.cache.UpdateCacheMiddleware', 67 | 'django.middleware.common.CommonMiddleware', 68 | 'django.contrib.sessions.middleware.SessionMiddleware', 69 | 'django.middleware.csrf.CsrfViewMiddleware', 70 | 'django.contrib.auth.middleware.AuthenticationMiddleware', 71 | 'django.contrib.messages.middleware.MessageMiddleware', 72 | 'django.middleware.clickjacking.XFrameOptionsMiddleware', 73 | 'django.middleware.cache.FetchFromCacheMiddleware', 74 | ) 75 | 76 | CACHE_MIDDLEWARE_ANONYMOUS_ONLY = True 77 | 78 | ROOT_URLCONF = 'project.urls' 79 | WSGI_APPLICATION = 'project.wsgi.application' 80 | TEMPLATE_DIRS = ( 81 | os.path.join(ROOT_PATH, 'templates'), 82 | ) 83 | 84 | INSTALLED_APPS = ( 85 | 'django.contrib.auth', 86 | 'django.contrib.contenttypes', 87 | 'django.contrib.sessions', 88 | 'django.contrib.sites', 89 | 'django.contrib.messages', 90 | 'django.contrib.staticfiles', 91 | 'django.contrib.sitemaps', 92 | 'django.contrib.gis', 93 | 'django.contrib.admin', 94 | 'shp2svg', 95 | 'south', 96 | ) 97 | 98 | LOGGING = { 99 | 'version': 1, 100 | 'disable_existing_loggers': False, 101 | 'filters': { 102 | 'require_debug_false': { 103 | '()': 'django.utils.log.RequireDebugFalse' 104 | } 105 | }, 106 | 'handlers': { 107 | 'mail_admins': { 108 | 'level': 'ERROR', 109 | 'filters': ['require_debug_false'], 110 | 'class': 'django.utils.log.AdminEmailHandler' 111 | } 112 | }, 113 | 'loggers': { 114 | 'django.request': { 115 | 'handlers': ['mail_admins'], 116 | 'level': 'ERROR', 117 | 'propagate': True, 118 | }, 119 | } 120 | } 121 | -------------------------------------------------------------------------------- /templates/setup_form.html: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /templates/shapefilecontainer_detail.html: -------------------------------------------------------------------------------- 1 | {% extends "base.html" %} 2 | 3 | {% block extra-css %} 4 | 7 | {% endblock %} 8 | 9 | {% block extra-js %} 10 | 11 | 12 | {% endblock %} 13 | 14 | {% block content %} 15 |