---
id: datashader
version: "0.19.1"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# datashader — Data visualization toolchain based on aggregating into a grid

License: permissive · Maintenance: active · Downloads: 411.2K/mo

## What it is and what it does

Datashader is a data rasterization library that transforms large datasets into images through a three-stage pipeline: projection (mapping records to grid bins), aggregation (computing reductions per bin), and transformation (processing aggregates into final images). It's designed to handle datasets too large for traditional plotting libraries by compressing them into smaller aggregate arrays before visualization.

The package works standalone or as a preprocessing layer for plotting libraries, allowing them to work with much larger datasets than they normally could handle. It depends on core scientific Python libraries (numpy, pandas, scipy, numba) for numerical computation and uses xarray for multidimensional data handling. The library supports Python 3.10, 3.11, 3.12, 3.13, and 3.14 and is actively maintained.

Use it for:

- Visualize large numbers of data points from CSV or database sources without memory overflow or rendering lag.
- Create density plots and aggregated views from high-resolution geospatial or time-series data.
- Preprocess massive datasets for use with interactive plotting libraries as a preprocessing stage.
- Aggregate and render scientific simulation outputs or sensor data streams into interpretable images.
- Build custom visualization pipelines by composing projection, aggregation, and transformation stages.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Datashader converts large datasets into accurate visual representations by rasterizing data through projection, aggregation, and transformation stages, enabling scalable visualization of millions of records.

Yes. Datashader is production-stable (Development Status 5), actively maintained, has no known vulnerabilities, and solves a real problem—visualizing datasets that would overwhelm traditional plotting tools. The low-friction install and well-established scientific dependencies make it a safe choice for data visualization pipelines at scale.

## Install

pip install datashader
uv add datashader
poetry add datashader

## Installing datashader

Before you install: Low friction installation with a pure-Python wheel. Twelve runtime dependencies including numba, numpy, pandas, and scipy are well-maintained scientific libraries. Active maintenance with a release 87 days ago and ongoing repository activity.

License in practice: BSD-3-Clause is permissive; you can use, modify, and distribute datashader with minimal restrictions, provided you include the license notice.

Quickstart:

pip install datashader

import datashader as ds
import pandas as pd

df = pd.read_csv('data.csv')
canvas = ds.Canvas()
agg = canvas.points(df, 'x', 'y')
image = ds.transfer_functions.shade(agg)

Verify before relying:

- Specific performance characteristics and dataset size thresholds where datashader provides meaningful advantages.
- Compatibility and integration patterns with particular plotting libraries when used as a preprocessing stage.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 411.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

large dataset visualization, data rasterization pipeline, big data image rendering, aggregation-based plotting, scalable data visualization, grid-based data binning, high-performance data imaging, data-visualization, rasterization, big-data

[View on SkillFed](https://skillfed.io/packages/datashader) · [View on PyPI](https://pypi.org/project/datashader/)