search

developmentseed / lonboard

A Python library for fast, interactive geospatial vector data visualization in Jupyter.
https://developmentseed.org/lonboard/latest/
MIT License
510 stars 27 forks source link
anywidget apache-arrow apache-parquet data-visualization deck-gl geoarrow geopandas geoparquet geospatial geospatial-analysis jupyter jupyter-widget longboard map-visualization maps parquet python visualization webgl

readme

Lonboard

PyPI Conda Version Binder open_in_colab

A Python library for fast, interactive geospatial vector data visualization in Jupyter.

Building on cutting-edge technologies like GeoArrow and GeoParquet in conjunction with GPU-based map rendering, Lonboard aims to enable visualizing large geospatial datasets interactively through a simple interface.

3 million points rendered from a GeoPandas GeoDataFrame in JupyterLab. Example notebook.

Install

To install Lonboard using pip:

pip install lonboard

Lonboard is on conda-forge and can be installed using conda, mamba, or pixi. To install Lonboard using conda:

conda install -c conda-forge lonboard

To install from source, refer to the developer documentation.

Get Started

For the simplest rendering, pass geospatial data into the top-level viz function.

import geopandas as gpd
from lonboard import viz

gdf = gpd.GeoDataFrame(...)
viz(gdf)

Under the hood, this delegates to a ScatterplotLayer, PathLayer, or PolygonLayer. Refer to the documentation and examples for more control over rendering.

Documentation

Refer to the documentation at developmentseed.org/lonboard.

Why the name?

This is a new binding to the deck.gl geospatial data visualization library. A "deck" is the part of a skateboard you ride on. What's a fast, geospatial skateboard? A lonboard.