Metadata-Version: 2.4
Name: lonboard
Version: 0.14.0
Summary: Fast, interactive geospatial data visualization in Jupyter.
Project-URL: homepage, https://developmentseed.org/lonboard/latest/
Project-URL: documentation, https://developmentseed.org/lonboard/latest/
Project-URL: repository, https://github.com/developmentseed/lonboard
Project-URL: issues, https://github.com/developmentseed/lonboard/issues
Project-URL: changelog, https://github.com/developmentseed/lonboard/blob/main/CHANGELOG.md
Author-email: Kyle Barron <kyle@developmentseed.org>
License-Expression: MIT
License-File: LICENSE
Keywords: GIS,cartography,geopandas,pandas,shapely,visualization
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Jupyter
Classifier: Framework :: Jupyter :: JupyterLab
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.11
Requires-Dist: anywidget~=0.9.0
Requires-Dist: arro3-compute>=0.4.1
Requires-Dist: arro3-core>=0.4.1
Requires-Dist: arro3-io>=0.4.1
Requires-Dist: geoarrow-rust-core>=0.5.2
Requires-Dist: ipywidgets>=7.6.0
Requires-Dist: numpy>=1.14
Requires-Dist: pyproj>=3.3
Requires-Dist: traitlets>=5.7.1
Requires-Dist: typing-extensions>=4.12.0
Provides-Extra: cli
Requires-Dist: click>=8.1.7; extra == 'cli'
Requires-Dist: pyogrio>=0.8; extra == 'cli'
Requires-Dist: shapely>=2; extra == 'cli'
Provides-Extra: cog
Requires-Dist: async-geotiff>=0.1.0; (python_version >= '3.11') and extra == 'cog'
Requires-Dist: morecantile>=7.0; (python_version >= '3.11') and extra == 'cog'
Provides-Extra: geopandas
Requires-Dist: geopandas>=0.13; extra == 'geopandas'
Requires-Dist: pandas>=2; extra == 'geopandas'
Requires-Dist: pyarrow>=16; extra == 'geopandas'
Requires-Dist: shapely>=2; extra == 'geopandas'
Provides-Extra: movingpandas
Requires-Dist: movingpandas>=0.17; extra == 'movingpandas'
Description-Content-Type: text/markdown

# Lonboard

[![PyPI][pypi_badge]][pypi_link]
[![Conda Version][conda_version_badge]][conda_version]
[![PyPI - Downloads][pypi-img]][pypi-link]
[![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
[pypi-img]: https://static.pepy.tech/badge/lonboard
[pypi-link]: https://pypi.org/project/lonboard/

A Python library for fast, interactive geospatial 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)
