This release is a pre-release and may not be stable for production use.
Geographic visualizations for HoloViews.
| Downloads |   |
| Build Status |  |
| Coverage |  |
| Latest dev release |   |
| Latest release |      |
| Docs |   |
| Support |  |
What 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 at geoviews.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
If 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 commands conda list --revisions and conda install --revision N can usually recover from updates gone awry.
conda update --all
You can then install GeoViews and all of its dependencies with the following:
conda install -c pyviz geoviews
Alternatively you can install the geoviews-core package, which only installs the minimal dependencies required to run geoviews:
conda install -c pyviz geoviews-core
In 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<6
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.)
In the classic Jupyter notebook environment and JupyterLab, first make sure to load the gv.extension(). GeoViews objects will then render themselves if they are the last item in a notebook cell. For versions of jupyterlab>=3.0 the necessary extension is automatically bundled in the pyviz_comms package, which must be >=2.0. However note that for version of jupyterlab<3.0 you must also manually install the JupyterLab extension with:
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
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.
7 maintainers
Metadata
7 maintainers
Release files for geoviews 1.16.0b0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| geoviews-1.16.0b0.tar.gz | 505.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| geoviews-1.16.0b0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / geoviews-1.16.0b0.tar.gz
| Download URL | geoviews-1.16.0b0.tar.gz |
|---|---|
| Size | 505.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
47e6c1e9f687f2be1e508de984d4582390cb6477ad67793a22be6b31dbb99f30
|
|
BLAKE2b-256 checksum How to use checksums |
a5060de1059b17fd4c45713e45ae0295286401e096e3a62c8eeacbfbc0421184
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / geoviews-1.16.0b0-py3-none-any.whl
| Download URL | geoviews-1.16.0b0-py3-none-any.whl |
|---|---|
| Size | 570.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
00cbcfde754d979f5e40c34c15dc7f31d95599052897cfb0c712a441f4fc735a
|
|
BLAKE2b-256 checksum How to use checksums |
db34ab13f855e1b6e0335838f24980db2a24fb39a49956cee277f81f14cf84ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency log
