{"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,"search_vec":"'-2':33 '0.5.0':27 '1':32 'big':42 'big-data':41 'cadenc':29 'current':25 'dask':2,7,13,38 'dask-geopanda':1 'data':43 'dataset':24 'distribut':17 'execut':18 'extend':8 'geopanda':3,5,9,39 'geospati':20,37 'irregular':30 'larg':23 'oper':21 'parallel':4,15,40 'per':35 'releas':28,34 'rough':31 'version':26 'work':11 'year':36","created_at":"2026-05-01T06:02:13.583267+00:00","updated_at":"2026-05-01T06:02:13.583267+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.5.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://geopandas.org","github":"https://github.com/geopandas/dask-geopandas","docs":"https://dask-geopandas.readthedocs.io/","changelog":null,"pypi":"https://pypi.org/project/dask-geopandas/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-28","last_verified":"2026-06-28","next_check":"2026-07-29","install_tag":null}}