Skip to main content

Draw geodata in SVG

Project description

SVGIS

Build Status Coverage Status

Create SVG drawings from vector geodata files (SHP, geoJSON, etc).

SVGIS is great for: creating small multiples, combining lots of datasets in a sensible projection, and drawing styled based on classes in the source data. It’s perfect for creating base maps for editing in a drawing program, and its CSS-based styling gives great flexibility for styling.

svgis draw input.shp -o out.svg
svgis draw south_dakota.shp north_dakota.geojson -o dakota.svg
svgis draw england.shp scotland.shp wales.shp --style gb.css -o great_britain.svg

Documentation: http://pythonhosted.org/svgis

Install

Requires fiona, which in turn requires GDAL.

To instal GDAL:

On OS X: brew install gdal (requires Homebrew)

On Linux: sudo apt-get install libgdal1-dev

On Windows: see OSGeo4W

Then:

pip install svgis

An option feature of svgis is clipping polygons to a bounding box. This will speed things up if you need to draw only part of a very complex feature.

To support clipping output shapes, you’ll need the GEOS library:

  • OS X: brew install geos

  • Linux: sudo apt-get install geos

  • Windows: GEOS is part of OSGeo4W, so you have it!

Then, install svgis with a slightly different command:

pip install svgis[clip]

Commands

The svgis command line tool includes several utilities. The most important is svgis draw, which draws SVG maps based on input geodata layers.

Additional commands: * svgis bounds: get the bounding box for a layer in a given projection * svgis graticule: create a graticule (grid) within a given bounds * svgis project: determine what projection svgis draw will (optionally) generate for given bounding box * svgis scale: change the scale of an existing SVG * svgis style: add css styles to an existing SVG

Read the docs for complete information on these commands and their options.

Examples

Draw the outline of the contiguous United States, projected in Albers:

curl -O http://www2.census.gov/geo/tiger/GENZ2014/shp/cb_2014_us_nation_20m.zip
unzip cb_2014_us_nation_20m.zip
svgis draw cb_2014_us_nation_20m.shp --crs EPSG:5070 --scale 1000 --bounds -124 20.5 -64 49 -o us.svg

The next two examples use the Natural Earth admin-0 data set.

Draw upper income countries in green, low-income countries in blue:

/* style.css */
.income_grp_5_Low_income {
    fill: blue;
}
.income_grp_3_Upper_middle_income {
    fill: green
}
.ne_110m_lakes {
    fill: #09d;
    stroke: none;
}
svgis draw --style style.css --class-fields income_grp ne_110m_admin_0_countries.shp ne_110m_lakes.shp -o out.svg

Draw national boundaries and lakes in Europe using an Albers projection, simplifying the output polygons, and draw Germany in purple.

svgis draw ne_110m_admin_0_countries.shp ne_110m_lakes.shp \
    --crs EPSG:102013 \
    --scale 1000 \
    --simplify 90 \
    --style '.ne_110m_admin_0_countries { fill: tan } .Germany { fill: purple }' \
    --style '.ne_110m_lakes { fill: #09d; stroke: none; }' \
    --class-fields name \
    --bounds -10 30 40 65 \
    -o out.svg

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

svgis-0.4.4.tar.gz (28.8 kB view details)

Uploaded Source

Built Distribution

svgis-0.4.4-py2.py3-none-any.whl (31.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file svgis-0.4.4.tar.gz.

File metadata

  • Download URL: svgis-0.4.4.tar.gz
  • Upload date:
  • Size: 28.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for svgis-0.4.4.tar.gz
Algorithm Hash digest
SHA256 7a8ac582c464302e34553ebea79288523590a1b9b9b38ce35e934b728b0e4356
MD5 6a8e950233048ff18276afaf3882c589
BLAKE2b-256 6633caf702e77c06c2629ff6979f6831a63c13ed11033486a2bdad730cfcecbd

See more details on using hashes here.

File details

Details for the file svgis-0.4.4-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for svgis-0.4.4-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 149450736652d9d5982579adae4fa4918b6b78f77f2e255566315f8870bbdf0e
MD5 8f2e89c4649efd1685914ff378d0b024
BLAKE2b-256 28592d670804baed74e38b0b66f2a8aea88c28e1ea9f797ac4a2f3256e20cbac

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page