Simple, concise geographical visualization in Python
Branch: master
Clone or download
Latest commit a73ebd2 Feb 11, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
conda.recipe Fix run_constrained version templating. (#200) Jul 6, 2018
doc Minor gallery fix Feb 11, 2019
examples Add geometry resampling operation (#282) Jan 19, 2019
geoviews
.appveyor.yml Temporarily ignore appveyor tests Jan 28, 2019
.gitattributes Switch versioning system to use autover (#143) Mar 12, 2018
.gitignore Packaging, installation, and testing (#138) May 4, 2018
.gitmodules WIP: website (#106) Jan 13, 2018
.travis.yml Update to latest nbsite (#298) Feb 11, 2019
CONTRIBUTING.md Initial rename to geoviews and tidy. Apr 20, 2016
LICENSE Added LICENSE file Jul 6, 2018
MANIFEST.in Include LICENSE and README in Manifest.in May 23, 2018
README.md Updated docs Jan 28, 2019
dodo.py Added release tag support. Also allow longer to upload cache. (#160) May 4, 2018
setup.py Pin GDAL (#285) Jan 25, 2019
tox.ini Removed references to non-existent notebooks. (#188) Jun 7, 2018

README.md

Travis Windows build status

GeoViews

GeoViews is a Python library that makes it easy to explore and visualize any data that includes geographic locations. It has particularly powerful support for multidimensional meteorological and oceanographic datasets, such as those used in weather, climate, and remote sensing research, but is useful for almost anything that you would want to plot on a map! You can see lots of example notebooks at geo.holoviews.org, and a good overview is in our blog post announcement.

GeoViews is built on the HoloViews library for building flexible visualizations of multidimensional data. GeoViews adds a family of geographic plot types based on the Cartopy library, plotted using either the Matplotlib or Bokeh packages.

Each of the new GeoElement plot types is a new HoloViews Element that has an associated geographic projection based on cartopy.crs. The GeoElements currently include Feature, WMTS, Tiles, Points, Contours, Image, QuadMesh, TriMesh, RGB, HSV, Labels, Graph, HexTiles, VectorField and Text objects, each of which can easily be overlaid in the same plots. E.g. an object with temperature data can be overlaid with coastline data using an expression like gv.Image(temperature) * gv.Feature(cartopy.feature.COASTLINE). Each GeoElement can also be freely combined in layouts with any other HoloViews Element , making it simple to make even complex multi-figure layouts of overlaid objects.

Installation

You can install GeoViews and its dependencies using conda:

conda install -c pyviz geoviews

Alternatively you can also install the geoviews-core package, which only installs the minimal dependencies required to run geoviews:

conda install -c pyviz geoviews-core

Once installed you can copy the examples into the current directory using the geoviews command and run them using the Jupyter notebook:

geoviews examples 
cd geoviews-examples
jupyter notebook

(Here geoviews examples is a shorthand for geoviews copy-examples --path geoviews-examples && geoviews fetch-data --path geoviews-examples.)

To work with JupyterLab you will also need the PyViz JupyterLab extension:

conda install -c conda-forge jupyterlab
jupyter labextension install @pyviz/jupyterlab_pyviz

Once you have installed JupyterLab and the extension launch it with:

jupyter-lab

If you want to try out the latest features between releases, you can get the latest dev release by specifying -c pyviz/label/dev in place of -c pyviz.

Additional dependencies

If you need to install libraries only available from conda-forge, such as Iris (to use data stored in Iris cubes) or xesmf, you should install from conda-forge:

conda create -n env-name -c pyviz -c conda-forge geoviews iris xesmf
conda activate env-name

Note -- Do not mix conda-forge and defaults. I.e., do not install packages from conda-forge into a GeoViews environment created with defaults. If you are using the base environment of mini/anaconda, or an environment created without specifying conda-forge before defaults, and you then install from conda-forge, you will very likely have incompatibilities in underlying, low-level dependencies. These binary (ABI) incompatibilities can lead to segfaults because of differences in how non-Python packages are built between conda-forge and defaults.


GeoViews itself is also installable using pip, but to do that you will first need to have installed the dependencies of cartopy, or else have set up your system to be able to build them.