Registry / data / dask-geopandas

dask-geopandas

library0.5.0pypypi✓ verified 90d ago

Parallel GeoPandas with Dask. Extends GeoPandas to work with Dask for parallel and distributed execution of geospatial operations on large datasets. Current version: 0.5.0. Release cadence: irregular, roughly 1-2 releases per year.

data database

pip install dask-geopandas

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · DASK-GEOPANDAS

dask-geopandas

datapythonv0.5.0

Install

13.4s avg

Import

2858ms

Disk

476MB

Pass rate

5/ 10

Env Coverage5 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.5.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

build_error

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 13.4s · import 2.858s · 473MB

476MB installed

● package 476MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GeoDataFrame

✓ from dask_geopandas import GeoDataFrame

✗ from dask_geopandas import GeoDataFrame as dask_gdf

Use exact symbol name; alias if needed but the import path is correct.

from_delayed

✓ from dask_geopandas import from_delayed

✗ from dask_geopandas.io import from_delayed

from_delayed is at the top level, not under a submodule.

read_file

✓ from dask_geopandas import read_file

✗ import dask_geopandas; dask_geopandas.read_file()

Direct import works, but the function is also available at top level.

Load a GeoJSON file into a Dask GeoDataFrame lazily.

import geopandas as gpd from dask_geopandas import read_file # Read a GeoJSON file in parallel (lazy) ddf = read_file('path/to/file.geojson') print(ddf.head())

Debug

Known issues

deprecatedThe `geom_almost_equals` method has been removed in v0.5.0. Use `geom_equals_exact` instead.

fix

Replace calls to `ddf.geom_almost_equals` with `ddf.geom_equals_exact`.

affects: >=0.5.0

breakingShapely >=2 is now required; support for PyGEOS has been removed since v0.4.0.

fix

Ensure you have Shapely >=2 installed (`pip install shapely>=2`). Uninstall PyGEOS if present.

affects: >=0.4.0

gotcha`spatial_shuffle` may produce incorrect results if the meta object from `read_file` is not set correctly. Ensure you use the latest version (>=0.4.2) to avoid this bug.

fix

Upgrade to dask-geopandas >=0.4.2.

affects: <0.4.2

gotchaWhen using Dask's new query planning (dask >=2024.3.0), you must have dask-expr installed to avoid errors. It is installed automatically with `dask[dataframe]`.

fix

Install dask[dataframe] or dask-expr: `pip install dask[dataframe]`.

affects: >=0.4.0

breakingDask-GeoPandas now requires Python >=3.10 as of v0.5.0.

fix

Upgrade Python to 3.10 or later.

affects: >=0.5.0

Errors

Common errors & fixes

ImportError: cannot import name 'read_file' from 'dask_geopandas'

Older version of dask-geopandas may not have read_file; or the import path was from a different location.

fix

Upgrade to the latest version: `pip install --upgrade dask-geopandas`. If still failing, use `from dask_geopandas.io import read_file`.

TypeError: 'GeoDataFrame' object does not support item assignment

Trying to assign values to a Dask GeoDataFrame as if it were a pandas GeoDataFrame.

fix

Use `.assign()` or `map_partitions()` to modify columns lazily.

distributed.utils_test - ValueError: Input data has no spatial partitions set. Call `ddf = ddf.spatial_shuffle()` first.

Spatial join or other spatial operation requires spatial partitions to be set.

fix

Call `ddf = ddf.spatial_shuffle()` before performing spatial operations like `sjoin()`.

ModuleNotFoundError: No module named 'dask_expr'

Dask's new query planning (>=2024.3.0) requires dask-expr, which may not be installed.

fix

Install dask[dataframe] which includes dask-expr: `pip install dask[dataframe]`.

Upgrade

Version history

0.5.0latest on PyPI · released Jun 2, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/geopandas/dask-geopandas ↗

packagehttps://pypi.org/project/dask-geopandas/ ↗

homepagehttps://geopandas.org ↗

docshttps://dask-geopandas.readthedocs.io/ ↗