Metadata-Version: 2.0
Name: svgis
Version: 0.1.2
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)
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
Requires-Dist: pyproj (>=1.9.3,<1.10)
Requires-Dist: fiona (>=1.5.0,<2.0)
Requires-Dist: svgwrite (>=1.1.6,<1.2)
Requires-Dist: fionautil (>=0.3.1,<1.0)
Requires-Dist: utm (>=0.4.0,<1)

svgis
-----

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

.. code:: bash

    $ svgis draw in.shp -o out.svg
    $ svgis draw in.shp in.geojson -o out.svg

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 -y libgdal1-dev``.

Command line options
--------------------

--bounds
^^^^^^^^

Only draw the portion of the input file between latitudes 40 and 41 and
longitudes -74 and -73 (roughly the New York City area). Note that
coordinates are given as 'minx miny maxx maxy'.

.. code:: bash

     $ svgis draw --bounds -74 40 -73 41 in.geojson out.svg

--scale
^^^^^^^

While SVG is a vector format, clients may have trouble handling very
large numbers. Use the scale option to scale down the output. Dimensions
in the map will be divided by this number (so larger numbers yield
smaller coordinates in the output SVG).

.. code:: bash

     $ svgis draw --scale 1000 in.shp -o out.svg

Projections
~~~~~~~~~~~

There are two ways to provide projections. Using both at the same time
is unsupported. If the input file doesn't have an internal projection,
SVGIS will assume `WGS84 <http://epsg.io/4326>`__.

--epsg
^^^^^^

Use this option to provide the EPSG code of a desired projection. The
example will draw an svg with `EPSG:2908 <http://epsg.io/2908>`__, the
New York Long Island state plane projection.

.. code:: bash

     $ svgis draw --epsg 2908 in.shp -o out.svg

--proj4
^^^^^^^

Use this option to provide a Proj4 string that defines a projection.

.. code:: bash

     $ svgis draw --epsg 2908 in.shp -o out.svg

--utm
~~~~~

Attempt to use a local UTM projection to draw the input geodata.

.. code:: bash

     $ svgis draw --utm in.shp -o out.svg

Style
~~~~~

--style
^^^^^^^

The style parameter takes either a CSS file or a CSS string.

.. code:: bash

     $ svgis draw --style style.css in.shp -o out.svg
     $ svgis draw --style "line { stroke: green; }" in.shp -o out.svg

--padding
^^^^^^^^^

Adds a padding around the output image.

.. code:: bash

     $ svgis draw --padding 100 in.shp -o out.svg



