# Lonboard
[![PyPI][pypi_badge]][pypi_link]
[![Conda Version][conda_version_badge]][conda_version]
[![Binder][binder_badge]][binder_jupyterlab_url]
[![open_in_colab][colab_badge]][colab_notebook_link]
[pypi_badge]: https://badge.fury.io/py/lonboard.svg
[pypi_link]: https://pypi.org/project/lonboard/
[binder_badge]: https://mybinder.org/badge_logo.svg
[binder_jupyterlab_url]: https://mybinder.org/v2/gh/developmentseed/lonboard/HEAD?urlpath=lab/tree/examples/
[colab_badge]: https://colab.research.google.com/assets/colab-badge.svg
[colab_notebook_link]: https://colab.research.google.com/github/developmentseed/lonboard/blob/main
[conda_version_badge]: https://img.shields.io/conda/vn/conda-forge/lonboard.svg
[conda_version]: https://anaconda.org/conda-forge/lonboard
A Python library for fast, interactive geospatial vector data visualization in Jupyter.
Building on cutting-edge technologies like [GeoArrow](https://github.com/geoarrow/geoarrow) and [GeoParquet](https://github.com/opengeospatial/geoparquet) in conjunction with [GPU-based map rendering](https://deck.gl/), Lonboard aims to enable visualizing large geospatial datasets interactively through a simple interface.
![](assets/hero-animated.gif)
<p align="center">3 million points rendered from a GeoPandas <code>GeoDataFrame</code> in JupyterLab. <a href="https://developmentseed.org/lonboard/latest/examples/internet-speeds/" target="_blank"> Example notebook</a>.</p>
## Install
To install Lonboard using pip:
```
pip install lonboard
```
Lonboard is on [conda-forge](https://anaconda.org/conda-forge/lonboard) and can be installed using [conda](https://docs.conda.io), [mamba](https://mamba.readthedocs.io/), or [pixi](https://pixi.sh/). To install Lonboard using conda:
```
conda install -c conda-forge lonboard
```
To install from source, refer to the [developer documentation](https://github.com/developmentseed/lonboard/blob/main/DEVELOP.md).
## Get Started
For the simplest rendering, pass geospatial data into the top-level [`viz` function](https://developmentseed.org/lonboard/latest/api/viz/#lonboard.viz.viz).
```py
import geopandas as gpd
from lonboard import viz
gdf = gpd.GeoDataFrame(...)
viz(gdf)
```
Under the hood, this delegates to a [`ScatterplotLayer`](https://developmentseed.org/lonboard/latest/api/layers/scatterplot-layer/), [`PathLayer`](https://developmentseed.org/lonboard/latest/api/layers/path-layer/), or [`PolygonLayer`](https://developmentseed.org/lonboard/latest/api/layers/polygon-layer/). Refer to the [documentation](https://developmentseed.org/lonboard/) and [examples](https://developmentseed.org/lonboard/latest/examples/internet-speeds/) for more control over rendering.
## Documentation
Refer to the documentation at [developmentseed.org/lonboard](https://developmentseed.org/lonboard/).
## Why the name?
This is a new binding to the [deck.gl](https://deck.gl) geospatial data visualization library. A "deck" is the part of a skateboard you ride on. What's a fast, geospatial skateboard? A <em>lon</em>board.
![](assets/dalle-lonboard.jpg)
Raw data
{
"_id": null,
"home_page": "https://github.com/developmentseed/lonboard",
"name": "lonboard",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": "GIS, cartography, visualization, geopandas, pandas, shapely",
"author": "Kyle Barron",
"author_email": "kyle@developmentseed.org",
"download_url": "https://files.pythonhosted.org/packages/e9/39/ddcacc408b811922c1f4990abb4c4dfced69785f787c9a7de419447e3f2f/lonboard-0.9.3.tar.gz",
"platform": null,
"description": "# Lonboard\n\n[![PyPI][pypi_badge]][pypi_link]\n[![Conda Version][conda_version_badge]][conda_version]\n[![Binder][binder_badge]][binder_jupyterlab_url]\n[![open_in_colab][colab_badge]][colab_notebook_link]\n\n[pypi_badge]: https://badge.fury.io/py/lonboard.svg\n[pypi_link]: https://pypi.org/project/lonboard/\n[binder_badge]: https://mybinder.org/badge_logo.svg\n[binder_jupyterlab_url]: https://mybinder.org/v2/gh/developmentseed/lonboard/HEAD?urlpath=lab/tree/examples/\n[colab_badge]: https://colab.research.google.com/assets/colab-badge.svg\n[colab_notebook_link]: https://colab.research.google.com/github/developmentseed/lonboard/blob/main\n[conda_version_badge]: https://img.shields.io/conda/vn/conda-forge/lonboard.svg\n[conda_version]: https://anaconda.org/conda-forge/lonboard\n\nA Python library for fast, interactive geospatial vector data visualization in Jupyter.\n\nBuilding on cutting-edge technologies like [GeoArrow](https://github.com/geoarrow/geoarrow) and [GeoParquet](https://github.com/opengeospatial/geoparquet) in conjunction with [GPU-based map rendering](https://deck.gl/), Lonboard aims to enable visualizing large geospatial datasets interactively through a simple interface.\n\n![](assets/hero-animated.gif)\n\n<p align=\"center\">3 million points rendered from a GeoPandas <code>GeoDataFrame</code> in JupyterLab. <a href=\"https://developmentseed.org/lonboard/latest/examples/internet-speeds/\" target=\"_blank\"> Example notebook</a>.</p>\n\n## Install\n\nTo install Lonboard using pip:\n\n```\npip install lonboard\n```\n\nLonboard is on [conda-forge](https://anaconda.org/conda-forge/lonboard) and can be installed using [conda](https://docs.conda.io), [mamba](https://mamba.readthedocs.io/), or [pixi](https://pixi.sh/). To install Lonboard using conda:\n\n```\nconda install -c conda-forge lonboard\n```\n\nTo install from source, refer to the [developer documentation](https://github.com/developmentseed/lonboard/blob/main/DEVELOP.md).\n\n## Get Started\n\nFor the simplest rendering, pass geospatial data into the top-level [`viz` function](https://developmentseed.org/lonboard/latest/api/viz/#lonboard.viz.viz).\n\n```py\nimport geopandas as gpd\nfrom lonboard import viz\n\ngdf = gpd.GeoDataFrame(...)\nviz(gdf)\n```\n\nUnder the hood, this delegates to a [`ScatterplotLayer`](https://developmentseed.org/lonboard/latest/api/layers/scatterplot-layer/), [`PathLayer`](https://developmentseed.org/lonboard/latest/api/layers/path-layer/), or [`PolygonLayer`](https://developmentseed.org/lonboard/latest/api/layers/polygon-layer/). Refer to the [documentation](https://developmentseed.org/lonboard/) and [examples](https://developmentseed.org/lonboard/latest/examples/internet-speeds/) for more control over rendering.\n\n## Documentation\n\nRefer to the documentation at [developmentseed.org/lonboard](https://developmentseed.org/lonboard/).\n\n## Why the name?\n\nThis is a new binding to the [deck.gl](https://deck.gl) geospatial data visualization library. A \"deck\" is the part of a skateboard you ride on. What's a fast, geospatial skateboard? A <em>lon</em>board.\n\n![](assets/dalle-lonboard.jpg)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Fast, interactive geospatial data visualization in Jupyter.",
"version": "0.9.3",
"project_urls": {
"Documentation": "https://developmentseed.org/lonboard/latest/",
"Homepage": "https://github.com/developmentseed/lonboard",
"Repository": "https://github.com/developmentseed/lonboard"
},
"split_keywords": [
"gis",
" cartography",
" visualization",
" geopandas",
" pandas",
" shapely"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eb0616b19a7d85c0099711f7d7a5e99ab1f9923dd05627dd7d685cf19269d09d",
"md5": "a06a1fd5071bd952573236f96e2d9a7c",
"sha256": "5c879d764dc70dc288f7e4d94d6d57eb5c4c1acdcaad14b15b220af4d36a8882"
},
"downloads": -1,
"filename": "lonboard-0.9.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a06a1fd5071bd952573236f96e2d9a7c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 675401,
"upload_time": "2024-05-27T12:46:58",
"upload_time_iso_8601": "2024-05-27T12:46:58.676605Z",
"url": "https://files.pythonhosted.org/packages/eb/06/16b19a7d85c0099711f7d7a5e99ab1f9923dd05627dd7d685cf19269d09d/lonboard-0.9.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e939ddcacc408b811922c1f4990abb4c4dfced69785f787c9a7de419447e3f2f",
"md5": "80bc6efcb9c5f313315c0dca03d49cf9",
"sha256": "ca64ed194901c67296869a4cf26ee6400fa648183601fbb8f95d09f2c34249f5"
},
"downloads": -1,
"filename": "lonboard-0.9.3.tar.gz",
"has_sig": false,
"md5_digest": "80bc6efcb9c5f313315c0dca03d49cf9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 661013,
"upload_time": "2024-05-27T12:47:00",
"upload_time_iso_8601": "2024-05-27T12:47:00.924103Z",
"url": "https://files.pythonhosted.org/packages/e9/39/ddcacc408b811922c1f4990abb4c4dfced69785f787c9a7de419447e3f2f/lonboard-0.9.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-27 12:47:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "developmentseed",
"github_project": "lonboard",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "lonboard"
}