Metadata-Version: 1.1
Name: svgis
Version: 0.3.7
Summary: Draw geodata in SVG
Home-page: https://github.com/fitnr/svgis
Author: Neil Freeman
Author-email: contact@fakeisthenewreal.org
License: GNU General Public License v3 (GPLv3)
Description: SVGIS
        -----
        
        |Build Status| |Coverage Status|
        
        Create SVG drawings from vector geodata files (SHP, geoJSON, etc).
        
        SVGIS is good for: creating small multiples, combining lots of datasets
        in a sensible projections, and drawing maps with basic styles 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 --project utm south_dakota.shp north_dakota.geojson -o dakota.svg
            svgis draw --style my.css england.shp scotland.shp wales.shp -o great_britain.svg
        
        Documentation: http://pythonhosted.org/svgis
        
        Install
        -------
        
        Requires `fiona <http://pypi.python.org/pypi/fiona>`__, which in turn
        requires GDAL.
        
        Before installing, run the following on OS X: ``brew install gdal``. On
        Linux: ``sudo apt-get -qq install libgdal1-dev``.
        
        Then:
        
        ::
        
            pip install svgis
        
        An additional feature is available if you want to download more
        prerequisites:
        
        ::
        
            # Clip output shapes to the bounding box (smaller files)
            brew install geos # os x
            sudo yum/apt-get geos # linux
            pip install svgis[clip]
        
        Command line tool
        -----------------
        
        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 <http://pythonhosted.org/svgis/>`__ 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 --crs EPSG:5070 --scale 1000 --bounds -124 20.5 -64 49 cb_2014_us_nation_20m.shp -o us.svg
        
        The next two examples use the `Natural
        Earth <http://naturalearthdata.com>`__ admin-0 data set.
        
        Draw upper income countries in green, low-income countries in blue:
        
        .. code:: css
        
            /* 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 <http://epsg.io/102013>`__, simplifying the output polygons,
        and draw Germany in purple.
        
        .. code:: bash
        
            svgis draw \ 
                --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 \ 
                ne_110m_admin_0_countries.shp ne_110m_lakes.shp \ 
                -o out.svg
        
        .. |Build Status| image:: http://img.shields.io/travis/fitnr/svgis/master.svg?style=flat
           :target: https://travis-ci.org/fitnr/svgis
        .. |Coverage Status| image:: https://img.shields.io/coveralls/fitnr/svgis/master.svg?style=flat
           :target: https://coveralls.io/r/fitnr/svgis?branch=master
        
Keywords: svg gis geojson shapefile
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Operating System :: OS Independent
