{"id":23062,"library":"dask-geopandas","title":"Dask-GeoPandas","description":"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.","status":"active","version":"0.5.0","language":"python","source_language":"en","source_url":"https://github.com/geopandas/dask-geopandas","tags":["geospatial","dask","geopandas","parallel","big-data"],"install":[{"cmd":"pip install dask-geopandas","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Use exact symbol name; alias if needed but the import path is correct.","wrong":"from dask_geopandas import GeoDataFrame as dask_gdf","symbol":"GeoDataFrame","correct":"from dask_geopandas import GeoDataFrame"},{"note":"from_delayed is at the top level, not under a submodule.","wrong":"from dask_geopandas.io import from_delayed","symbol":"from_delayed","correct":"from dask_geopandas import from_delayed"},{"note":"Direct import works, but the function is also available at top level.","wrong":"import dask_geopandas; dask_geopandas.read_file()","symbol":"read_file","correct":"from dask_geopandas import read_file"}],"quickstart":{"code":"import geopandas as gpd\nfrom dask_geopandas import read_file\n\n# Read a GeoJSON file in parallel (lazy)\nddf = read_file('path/to/file.geojson')\nprint(ddf.head())","lang":"python","description":"Load a GeoJSON file into a Dask GeoDataFrame lazily."},"warnings":[{"fix":"Replace calls to `ddf.geom_almost_equals` with `ddf.geom_equals_exact`.","message":"The `geom_almost_equals` method has been removed in v0.5.0. Use `geom_equals_exact` instead.","severity":"deprecated","affected_versions":">=0.5.0"},{"fix":"Ensure you have Shapely >=2 installed (`pip install shapely>=2`). Uninstall PyGEOS if present.","message":"Shapely >=2 is now required; support for PyGEOS has been removed since v0.4.0.","severity":"breaking","affected_versions":">=0.4.0"},{"fix":"Upgrade to dask-geopandas >=0.4.2.","message":"`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.","severity":"gotcha","affected_versions":"<0.4.2"},{"fix":"Install dask[dataframe] or dask-expr: `pip install dask[dataframe]`.","message":"When 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]`.","severity":"gotcha","affected_versions":">=0.4.0"},{"fix":"Upgrade Python to 3.10 or later.","message":"Dask-GeoPandas now requires Python >=3.10 as of v0.5.0.","severity":"breaking","affected_versions":">=0.5.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Upgrade to the latest version: `pip install --upgrade dask-geopandas`. If still failing, use `from dask_geopandas.io import read_file`.","cause":"Older version of dask-geopandas may not have read_file; or the import path was from a different location.","error":"ImportError: cannot import name 'read_file' from 'dask_geopandas'"},{"fix":"Use `.assign()` or `map_partitions()` to modify columns lazily.","cause":"Trying to assign values to a Dask GeoDataFrame as if it were a pandas GeoDataFrame.","error":"TypeError: 'GeoDataFrame' object does not support item assignment"},{"fix":"Call `ddf = ddf.spatial_shuffle()` before performing spatial operations like `sjoin()`.","cause":"Spatial join or other spatial operation requires spatial partitions to be set.","error":"distributed.utils_test - ValueError: Input data has no spatial partitions set. Call `ddf = ddf.spatial_shuffle()` first."},{"fix":"Install dask[dataframe] which includes dask-expr: `pip install dask[dataframe]`.","cause":"Dask's new query planning (>=2024.3.0) requires dask-expr, which may not be installed.","error":"ModuleNotFoundError: No module named 'dask_expr'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}