geoviews


Namegeoviews JSON
Version 1.11.1 PyPI version JSON
download
home_pagehttps://geoviews.org
SummaryGeoViews is a Python library that makes it easy to explore and visualize geographical, meteorological, and oceanographic datasets, such as those used in weather, climate, and remote sensing research.
upload_time2024-02-13 17:04:08
maintainer
docs_urlNone
author
requires_python>=3.9
licenseBSD 3-Clause
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <img src="/doc/_static/logo_stacked.png" width="200"/><br>

-----------------

**Geographic visualizations for HoloViews.**

|    |    |
| --- | --- |
| Downloads | ![https://pypistats.org/packages/geoviews](https://img.shields.io/pypi/dm/geoviews?label=pypi) ![https://anaconda.org/pyviz/geoviews](https://pyviz.org/_static/cache/geoviews_conda_downloads_badge.svg)
| Build Status | [![Linux/MacOS/Windows Build Status](https://github.com/holoviz/geoviews/workflows/tests/badge.svg?query=branch:main)](https://github.com/holoviz/geoviews/actions/workflows/test.yaml?query=branch%3Amain) |
| Coverage | [![codecov](https://codecov.io/gh/holoviz/geoviews/branch/main/graph/badge.svg)](https://codecov.io/gh/holoviz/geoviews) |
| Latest dev release | [![Github tag](https://img.shields.io/github/tag/holoviz/geoviews.svg?label=tag&colorB=11ccbb)](https://github.com/holoviz/geoviews/tags) [![dev-site](https://img.shields.io/website-up-down-green-red/https/holoviz-dev.github.io/geoviews.svg?label=dev%20website)](https://holoviz-dev.github.io/geoviews/) |
| Latest release | [![Github release](https://img.shields.io/github/release/holoviz/geoviews.svg?label=tag&colorB=11ccbb)](https://github.com/holoviz/geoviews/releases) [![PyPI version](https://img.shields.io/pypi/v/geoviews.svg?colorB=cc77dd)](https://pypi.python.org/pypi/geoviews) [![geoviews version](https://img.shields.io/conda/v/pyviz/geoviews.svg?colorB=4488ff&style=flat)](https://anaconda.org/pyviz/geoviews) [![conda-forge version](https://img.shields.io/conda/v/conda-forge/geoviews.svg?label=conda%7Cconda-forge&colorB=4488ff)](https://anaconda.org/conda-forge/geoviews) [![defaults version](https://img.shields.io/conda/v/anaconda/geoviews.svg?label=conda%7Cdefaults&style=flat&colorB=4488ff)](https://anaconda.org/anaconda/geoviews) |
| Docs | [![gh-pages](https://img.shields.io/github/last-commit/holoviz/geoviews/gh-pages.svg)](https://github.com/holoviz/geoviews/tree/gh-pages) [![site](https://img.shields.io/website-up-down-green-red/http/geoviews.org.svg)](http://geoviews.org) |
| Support | [![Discourse](https://img.shields.io/discourse/status?server=https%3A%2F%2Fdiscourse.holoviz.org)](https://discourse.holoviz.org/) |

## 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](https://geoviews.org), and a good
overview is in our [blog post announcement](https://www.continuum.io/blog/developer-blog/introducing-geoviews).

GeoViews is built on the [HoloViews](https://holoviews.org) library for
building flexible visualizations of multidimensional data.  GeoViews
adds a family of geographic plot types based on the
[Cartopy](http://scitools.org.uk/cartopy) library, plotted using
either the [Matplotlib](http://matplotlib.org) or
[Bokeh](https://bokeh.org) 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:

```bash
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](http://scitools.org.uk/cartopy/docs/latest/installing.html#requirements),
or else have set up your system to be able to build them.

            

Raw data

            {
    "_id": null,
    "home_page": "https://geoviews.org",
    "name": "geoviews",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "",
    "keywords": "",
    "author": "",
    "author_email": "",
    "download_url": "https://files.pythonhosted.org/packages/c3/63/9407aac96e9262e16bd0b72d141d3dc831169d13a93afdb62650b107cad4/geoviews-1.11.1.tar.gz",
    "platform": "Windows",
    "description": "<img src=\"/doc/_static/logo_stacked.png\" width=\"200\"/><br>\n\n-----------------\n\n**Geographic visualizations for HoloViews.**\n\n|    |    |\n| --- | --- |\n| Downloads | ![https://pypistats.org/packages/geoviews](https://img.shields.io/pypi/dm/geoviews?label=pypi) ![https://anaconda.org/pyviz/geoviews](https://pyviz.org/_static/cache/geoviews_conda_downloads_badge.svg)\n| Build Status | [![Linux/MacOS/Windows Build Status](https://github.com/holoviz/geoviews/workflows/tests/badge.svg?query=branch:main)](https://github.com/holoviz/geoviews/actions/workflows/test.yaml?query=branch%3Amain) |\n| Coverage | [![codecov](https://codecov.io/gh/holoviz/geoviews/branch/main/graph/badge.svg)](https://codecov.io/gh/holoviz/geoviews) |\n| Latest dev release | [![Github tag](https://img.shields.io/github/tag/holoviz/geoviews.svg?label=tag&colorB=11ccbb)](https://github.com/holoviz/geoviews/tags) [![dev-site](https://img.shields.io/website-up-down-green-red/https/holoviz-dev.github.io/geoviews.svg?label=dev%20website)](https://holoviz-dev.github.io/geoviews/) |\n| Latest release | [![Github release](https://img.shields.io/github/release/holoviz/geoviews.svg?label=tag&colorB=11ccbb)](https://github.com/holoviz/geoviews/releases) [![PyPI version](https://img.shields.io/pypi/v/geoviews.svg?colorB=cc77dd)](https://pypi.python.org/pypi/geoviews) [![geoviews version](https://img.shields.io/conda/v/pyviz/geoviews.svg?colorB=4488ff&style=flat)](https://anaconda.org/pyviz/geoviews) [![conda-forge version](https://img.shields.io/conda/v/conda-forge/geoviews.svg?label=conda%7Cconda-forge&colorB=4488ff)](https://anaconda.org/conda-forge/geoviews) [![defaults version](https://img.shields.io/conda/v/anaconda/geoviews.svg?label=conda%7Cdefaults&style=flat&colorB=4488ff)](https://anaconda.org/anaconda/geoviews) |\n| Docs | [![gh-pages](https://img.shields.io/github/last-commit/holoviz/geoviews/gh-pages.svg)](https://github.com/holoviz/geoviews/tree/gh-pages) [![site](https://img.shields.io/website-up-down-green-red/http/geoviews.org.svg)](http://geoviews.org) |\n| Support | [![Discourse](https://img.shields.io/discourse/status?server=https%3A%2F%2Fdiscourse.holoviz.org)](https://discourse.holoviz.org/) |\n\n## What is it?\n\nGeoViews is a Python library that makes it easy to explore and\nvisualize any data that includes geographic locations.  It has\nparticularly powerful support for multidimensional meteorological\nand oceanographic datasets, such as those used in weather, climate,\nand remote sensing research, but is useful for almost anything\nthat you would want to plot on a map!  You can see lots of example\nnotebooks at [geoviews.org](https://geoviews.org), and a good\noverview is in our [blog post announcement](https://www.continuum.io/blog/developer-blog/introducing-geoviews).\n\nGeoViews is built on the [HoloViews](https://holoviews.org) library for\nbuilding flexible visualizations of multidimensional data.  GeoViews\nadds a family of geographic plot types based on the\n[Cartopy](http://scitools.org.uk/cartopy) library, plotted using\neither the [Matplotlib](http://matplotlib.org) or\n[Bokeh](https://bokeh.org) packages.\n\nEach of the new GeoElement plot types is a new HoloViews Element that\nhas an associated geographic projection based on ``cartopy.crs``. The\nGeoElements currently include ``Feature``, ``WMTS``, ``Tiles``,\n``Points``, ``Contours``, ``Image``, ``QuadMesh``, ``TriMesh``,\n``RGB``, ``HSV``, ``Labels``, ``Graph``, ``HexTiles``, ``VectorField``\nand ``Text`` objects, each of which can easily be overlaid in the same\nplots. E.g. an object with temperature data can be overlaid with\ncoastline data using an expression like ``gv.Image(temperature) *\ngv.Feature(cartopy.feature.COASTLINE)``. Each GeoElement can also be\nfreely combined in layouts with any other HoloViews Element , making\nit simple to make even complex multi-figure layouts of overlaid\nobjects.\n\n## Installation\n\nIf 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.\n\n```\nconda update --all\n```\n\nYou can then install GeoViews and all of its dependencies with the following:\n\n```\nconda install -c pyviz geoviews\n```\n\nAlternatively you can install the geoviews-core package, which\nonly installs the minimal dependencies required to run geoviews:\n\n```\nconda install -c pyviz geoviews-core\n```\n\nIn certain circumstances proj6 issues may prevent installation or\ncause issues (particularly with cartopy<=0.17). If you encounter these\nissues ensure you also pin proj4::\n\n    conda install proj4<6\n\nOnce installed you can copy the examples into the current directory\nusing the ``geoviews`` command and run them using the Jupyter\nnotebook:\n\n```\ngeoviews examples\ncd geoviews-examples\njupyter notebook\n```\n\n(Here `geoviews examples` is a shorthand for `geoviews copy-examples\n--path geoviews-examples && geoviews fetch-data --path\ngeoviews-examples`.)\n\nIn 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:\n\n```bash\njupyter labextension install @pyviz/jupyterlab_pyviz\n```\n\nOnce you have installed JupyterLab and the extension launch it with:\n\n```\njupyter-lab\n```\n\nIf you want to try out the latest features between releases, you can\nget the latest dev release by specifying `-c pyviz/label/dev` in place\nof `-c pyviz`.\n\n### Additional dependencies\n\nIf you need to install libraries only available from conda-forge, such\nas Iris (to use data stored in Iris cubes) or xesmf, you should\ninstall from conda-forge:\n\n```\nconda create -n env-name -c pyviz -c conda-forge geoviews iris xesmf\nconda activate env-name\n```\n\n-----\n\nGeoViews itself is also installable using `pip`, but to do that you\nwill first need to have installed the [dependencies of cartopy](http://scitools.org.uk/cartopy/docs/latest/installing.html#requirements),\nor else have set up your system to be able to build them.\n",
    "bugtrack_url": null,
    "license": "BSD 3-Clause",
    "summary": "GeoViews is a Python library that makes it easy to explore and visualize geographical, meteorological, and oceanographic datasets, such as those used in weather, climate, and remote sensing research.",
    "version": "1.11.1",
    "project_urls": {
        "Homepage": "https://geoviews.org"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cbdfe56a1f048e6aeda6a163a367a1b308f7053154564d728b53a55df603be23",
                "md5": "1830c606fc0795f3cbf4d2e99f717bbc",
                "sha256": "0e982259e12a0adf5d31be6a853a17d5b2dff8fff5a445eab0bf5e505db3f588"
            },
            "downloads": -1,
            "filename": "geoviews-1.11.1-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1830c606fc0795f3cbf4d2e99f717bbc",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.9",
            "size": 512493,
            "upload_time": "2024-02-13T17:04:04",
            "upload_time_iso_8601": "2024-02-13T17:04:04.235584Z",
            "url": "https://files.pythonhosted.org/packages/cb/df/e56a1f048e6aeda6a163a367a1b308f7053154564d728b53a55df603be23/geoviews-1.11.1-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c3639407aac96e9262e16bd0b72d141d3dc831169d13a93afdb62650b107cad4",
                "md5": "b9d14c6d9d1f6703a31f2aed931374f3",
                "sha256": "6c65e2122c8b62ee7985bb956369d05953c7704081f90b686a0fdfaf20933d2b"
            },
            "downloads": -1,
            "filename": "geoviews-1.11.1.tar.gz",
            "has_sig": false,
            "md5_digest": "b9d14c6d9d1f6703a31f2aed931374f3",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 801570,
            "upload_time": "2024-02-13T17:04:08",
            "upload_time_iso_8601": "2024-02-13T17:04:08.128864Z",
            "url": "https://files.pythonhosted.org/packages/c3/63/9407aac96e9262e16bd0b72d141d3dc831169d13a93afdb62650b107cad4/geoviews-1.11.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-02-13 17:04:08",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "geoviews"
}
        
Elapsed time: 0.23483s