[](https://mybinder.org/v2/gh/davidbrochart/xarray_leaflet/main?urlpath=lab%2Ftree%2Fexamples%2Fintroduction.ipynb)
[](https://github.com/davidbrochart/xarray_leaflet/actions)
# xarray-leaflet: an xarray extension for tiled map plotting
[xarray](http://xarray.pydata.org) and [Leaflet](https://leafletjs.com) share this ability to work with fragments of data, xarray through Dask's chunks, and Leaflet through map tiles. In the end this is really the same concept, so it was a natural thing to make them work together.
Fortunately xarray is written in Python, and we happen to have a great Python binding for Leaflet, [ipyleaflet](https://ipyleaflet.readthedocs.io).
xarray-leaflet uses ipyleaflet as a plotting backend for data arrays. It generates map tiles on the fly, possibly using Dask's lazy evaluation system and Zarr's chunked data storage, and serves them through the Jupyter server, allowing for big data visualization.
See the example notebooks:
- [examples/introduction.ipynb](https://github.com/davidbrochart/xarray_leaflet/blob/master/examples/introduction.ipynb) to get started.
- [examples/dynamic.ipynb](https://github.com/davidbrochart/xarray_leaflet/blob/master/examples/dynamic.ipynb) for more advanced visualizations, and in particular dynamic maps.
- [examples/custom_projection.ipynb](https://github.com/davidbrochart/xarray_leaflet/blob/master/examples/custom_projection.ipynb) for an example of non-Mercator projection.
## How does it compare to other visualization libraries?
xarray-leaflet doesn't try to reinvent the wheel. It stands on the shoulders of giants: xarray, Jupyter widgets, Leaflet. By combining this software stack, it opens up new possibilities while being a relatively small library.
## Installation
Using conda:
```bash
conda install -c conda-forge xarray_leaflet
```
Using pip:
```bash
pip install xarray_leaflet
```
## Using xarray-leaflet with Voila
To work with xarray-leaflet, Voila has to be launched with the following command:
```bash
jupyter server --ServerApp.open_browser=True --ServerApp.default_url="voila/render/path_to_notebook.ipynb"
```
Raw data
{
"_id": null,
"home_page": null,
"name": "xarray_leaflet",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.5",
"maintainer_email": null,
"keywords": "jupyter,leaflet,server,xarray",
"author": null,
"author_email": "David Brochart <david.brochart@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f9/cc/ad2db6d106038aa2984a551df6fe65dfa5ea4506939843ac08db6ad2a3dd/xarray_leaflet-0.2.3.tar.gz",
"platform": null,
"description": "[](https://mybinder.org/v2/gh/davidbrochart/xarray_leaflet/main?urlpath=lab%2Ftree%2Fexamples%2Fintroduction.ipynb)\n[](https://github.com/davidbrochart/xarray_leaflet/actions)\n\n# xarray-leaflet: an xarray extension for tiled map plotting\n\n[xarray](http://xarray.pydata.org) and [Leaflet](https://leafletjs.com) share this ability to work with fragments of data, xarray through Dask's chunks, and Leaflet through map tiles. In the end this is really the same concept, so it was a natural thing to make them work together.\n\nFortunately xarray is written in Python, and we happen to have a great Python binding for Leaflet, [ipyleaflet](https://ipyleaflet.readthedocs.io).\n\nxarray-leaflet uses ipyleaflet as a plotting backend for data arrays. It generates map tiles on the fly, possibly using Dask's lazy evaluation system and Zarr's chunked data storage, and serves them through the Jupyter server, allowing for big data visualization.\n\nSee the example notebooks:\n- [examples/introduction.ipynb](https://github.com/davidbrochart/xarray_leaflet/blob/master/examples/introduction.ipynb) to get started.\n- [examples/dynamic.ipynb](https://github.com/davidbrochart/xarray_leaflet/blob/master/examples/dynamic.ipynb) for more advanced visualizations, and in particular dynamic maps.\n- [examples/custom_projection.ipynb](https://github.com/davidbrochart/xarray_leaflet/blob/master/examples/custom_projection.ipynb) for an example of non-Mercator projection.\n\n## How does it compare to other visualization libraries?\n\nxarray-leaflet doesn't try to reinvent the wheel. It stands on the shoulders of giants: xarray, Jupyter widgets, Leaflet. By combining this software stack, it opens up new possibilities while being a relatively small library.\n\n## Installation\n\nUsing conda:\n\n```bash\nconda install -c conda-forge xarray_leaflet\n```\n\nUsing pip:\n\n```bash\npip install xarray_leaflet\n```\n\n## Using xarray-leaflet with Voila\n\nTo work with xarray-leaflet, Voila has to be launched with the following command:\n\n```bash\njupyter server --ServerApp.open_browser=True --ServerApp.default_url=\"voila/render/path_to_notebook.ipynb\"\n```\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "An xarray extension for map plotting",
"version": "0.2.3",
"split_keywords": [
"jupyter",
"leaflet",
"server",
"xarray"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a02c685a6c187bba3434552ad6df10cd0f5960b09fef3d83e53b48a976d96b3f",
"md5": "2d2681a4badfb1eb5f0212e378fb8137",
"sha256": "27c099d16ff1dc48efd48b430568c5e46ac43c04f53364811fdad99598f03013"
},
"downloads": -1,
"filename": "xarray_leaflet-0.2.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d2681a4badfb1eb5f0212e378fb8137",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.5",
"size": 9598,
"upload_time": "2023-01-17T17:21:27",
"upload_time_iso_8601": "2023-01-17T17:21:27.449606Z",
"url": "https://files.pythonhosted.org/packages/a0/2c/685a6c187bba3434552ad6df10cd0f5960b09fef3d83e53b48a976d96b3f/xarray_leaflet-0.2.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f9ccad2db6d106038aa2984a551df6fe65dfa5ea4506939843ac08db6ad2a3dd",
"md5": "facb4176643708a3709df962e0b3f90c",
"sha256": "728efd1a06ed92581412bffbb9fd9bc79c99513c57b6f45cbbcdb7b7295a2fc0"
},
"downloads": -1,
"filename": "xarray_leaflet-0.2.3.tar.gz",
"has_sig": false,
"md5_digest": "facb4176643708a3709df962e0b3f90c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.5",
"size": 352833,
"upload_time": "2023-01-17T17:21:29",
"upload_time_iso_8601": "2023-01-17T17:21:29.179947Z",
"url": "https://files.pythonhosted.org/packages/f9/cc/ad2db6d106038aa2984a551df6fe65dfa5ea4506939843ac08db6ad2a3dd/xarray_leaflet-0.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-17 17:21:29",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "xarray_leaflet"
}
JSON