Package: geoviews
Geographic visualizations for HoloViews.DownloadsBuild StatusCoverageLatest dev releaseLatest releaseDocsSupportWhat is it?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 atgeoviews.org, and a good
overview is in ourblog post announcement.GeoViews is built on theHoloViewslibrary for
building flexible visualizations of multidimensional data.  GeoViews
adds a family of geographic plot types based on theCartopylibrary, plotted using
either theMatplotliborBokehpackages.Each of the new GeoElement plot types is a new HoloViews Element that
has an associated geographic projection based oncartopy.crs. The
GeoElements currently includeFeature,WMTS,Tiles,Points,Contours,Image,QuadMesh,TriMesh,RGB,HSV,Labels,Graph,HexTiles,VectorFieldandTextobjects, 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 likegv.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.InstallationIf you want the latest GeoViews, you will need an up-to-date environment. Updating is never risk-free, but it is a good idea in general and the commandsconda list --revisionsandconda install --revision Ncan usually recover from updates gone awry.conda update --allYou can then install GeoViews and all of its dependencies with the following:conda install -c pyviz geoviewsAlternatively you can install the geoviews-core package, which
only installs the minimal dependencies required to run geoviews:conda install -c pyviz geoviews-coreIn certain circumstances proj6 issues may prevent installation or
cause issues (particularly with cartopy<=0.17). If you encounter these
issues ensure you also pin proj4::conda install proj4<6Once installed you can copy the examples into the current directory
using thegeoviewscommand and run them using the Jupyter
notebook:geoviews examples
cd geoviews-examples
jupyter notebook(Heregeoviews examplesis a shorthand forgeoviews copy-examples --path geoviews-examples && geoviews fetch-data --path geoviews-examples.)In the classic Jupyter notebook environment and JupyterLab, first make sure to load thegv.extension(). GeoViews objects will then render themselves if they are the last item in a notebook cell. For versions ofjupyterlab>=3.0the necessary extension is automatically bundled in thepyviz_commspackage, which must be >=2.0. However note that for version ofjupyterlab<3.0you must also manually install the JupyterLab extension with:jupyterlabextensioninstall@pyviz/jupyterlab_pyvizOnce you have installed JupyterLab and the extension launch it with:jupyter-labIf you want to try out the latest features between releases, you can
get the latest dev release by specifying-c pyviz/label/devin place
of-c pyviz.Additional dependenciesIf 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-nameGeoViews itself is also installable usingpip, but to do that you
will first need to have installed thedependencies of cartopy,
or else have set up your system to be able to build them.