Convert matplotlib contour plots to geojson
Project description
# geojsoncontour
[![Build Status](https://travis-ci.org/bartromgens/geojsoncontour.svg?branch=master)](https://travis-ci.org/bartromgens/geojsoncontour) [![PyPI version](https://badge.fury.io/py/geojsoncontour.svg)](https://badge.fury.io/py/geojsoncontour) [![Coverage Status](https://coveralls.io/repos/github/bartromgens/geojsoncontour/badge.svg?branch=master)](https://coveralls.io/github/bartromgens/geojsoncontour?branch=master)
A Python 3 module to convert matplotlib contour plots to geojson.
Designed to show geographical [contour plots](http://matplotlib.org/examples/pylab_examples/contour_demo.html),
created with [matplotlib/pyplot](https://github.com/matplotlib/matplotlib), as vector layer on interactive slippy maps like [OpenLayers](https://github.com/openlayers/ol3) and [Leaflet](https://github.com/Leaflet/Leaflet).
Demo project that uses geojsoncontour: [climatemaps.romgens.com](http://climatemaps.romgens.com)
Currently only supports contour lines.
## Installation
The recommended way to install is via pip,
```
$ pip install geojsoncontour
```
## Usage
### Contour plot to geojson
```python
import numpy
import matplotlib.pyplot as plt
import geojsoncontour
# Create contour data lon_range, lat_range, Z
<your code here>
# Create a contour plot plot from grid (lat, lon) data
figure = plt.figure()
ax = figure.add_subplot(111)
contour = ax.contour(lon_range, lat_range, Z, levels=levels, cmap=plt.cm.jet)
# Convert matplotlib contour to geojson
geojsoncontour.contour_to_geojson(
contour=contour,
geojson_filepath='out.geojson',
contour_levels=levels,
ndigits=3,
unit='m'
)
```
See [example1.py](geojsoncontour/examples/example1.py) for a basic but complete example.
### Show the geojson on a map
An easy way to show the generated geojson on a map is the online geojson renderer [geojson.io](http://geojson.io).
### Style properties
Stroke color and width are set as geojson properties following https://github.com/mapbox/simplestyle-spec.
### Create geojson tiles
Try [geojson-vt](https://github.com/mapbox/geojson-vt) or [tippecanoe](https://github.com/mapbox/tippecanoe) if performance is an issue and you need to tile your geojson contours.
## Tests
Run all tests,
```
python -m unittest discover
```
[![Build Status](https://travis-ci.org/bartromgens/geojsoncontour.svg?branch=master)](https://travis-ci.org/bartromgens/geojsoncontour) [![PyPI version](https://badge.fury.io/py/geojsoncontour.svg)](https://badge.fury.io/py/geojsoncontour) [![Coverage Status](https://coveralls.io/repos/github/bartromgens/geojsoncontour/badge.svg?branch=master)](https://coveralls.io/github/bartromgens/geojsoncontour?branch=master)
A Python 3 module to convert matplotlib contour plots to geojson.
Designed to show geographical [contour plots](http://matplotlib.org/examples/pylab_examples/contour_demo.html),
created with [matplotlib/pyplot](https://github.com/matplotlib/matplotlib), as vector layer on interactive slippy maps like [OpenLayers](https://github.com/openlayers/ol3) and [Leaflet](https://github.com/Leaflet/Leaflet).
Demo project that uses geojsoncontour: [climatemaps.romgens.com](http://climatemaps.romgens.com)
Currently only supports contour lines.
## Installation
The recommended way to install is via pip,
```
$ pip install geojsoncontour
```
## Usage
### Contour plot to geojson
```python
import numpy
import matplotlib.pyplot as plt
import geojsoncontour
# Create contour data lon_range, lat_range, Z
<your code here>
# Create a contour plot plot from grid (lat, lon) data
figure = plt.figure()
ax = figure.add_subplot(111)
contour = ax.contour(lon_range, lat_range, Z, levels=levels, cmap=plt.cm.jet)
# Convert matplotlib contour to geojson
geojsoncontour.contour_to_geojson(
contour=contour,
geojson_filepath='out.geojson',
contour_levels=levels,
ndigits=3,
unit='m'
)
```
See [example1.py](geojsoncontour/examples/example1.py) for a basic but complete example.
### Show the geojson on a map
An easy way to show the generated geojson on a map is the online geojson renderer [geojson.io](http://geojson.io).
### Style properties
Stroke color and width are set as geojson properties following https://github.com/mapbox/simplestyle-spec.
### Create geojson tiles
Try [geojson-vt](https://github.com/mapbox/geojson-vt) or [tippecanoe](https://github.com/mapbox/tippecanoe) if performance is an issue and you need to tile your geojson contours.
## Tests
Run all tests,
```
python -m unittest discover
```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Close
Hashes for geojsoncontour-0.1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6c5f9b9ca0cb3cb12a3e7fcdef98ca83555c356ef6270bd3a8a41551661d9b1c |
|
MD5 | 2795783cd072c6754c8e9bcb717c8af3 |
|
BLAKE2b-256 | 37ce27f6bce1d8f6afb32fc1741aba7e3bfa869d54ce2d8bd3ee1cf7171992bf |