https://github.com/geopandas/dask-geopandas

Parallel GeoPandas with Dask
https://github.com/geopandas/dask-geopandas

Last synced: about 2 months ago
JSON representation

Parallel GeoPandas with Dask

• Host: GitHub
• URL: https://github.com/geopandas/dask-geopandas
• Owner: geopandas
• License: bsd-3-clause
• Created: 2020-02-13T21:17:19.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2024-06-25T10:16:45.000Z (3 months ago)
• Last Synced: 2024-07-29T12:13:09.125Z (about 2 months ago)
• Language: Python
• Homepage: https://dask-geopandas.readthedocs.io/
• Size: 498 KB
• Stars: 471
• Watchers: 23
• Forks: 45
• Open Issues: 67
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
dask-geopandas |conda| |pypi| |docs| |gitter|

=============================================

Parallel GeoPandas with Dask

Dask-GeoPandas is a project merging the geospatial capabilities of GeoPandas

and scalability of Dask. GeoPandas is an open source project designed to make working with geospatial data in Python easier. GeoPandas extends the datatypes used by pandas to allow spatial operations on geometric types.

Dask provides advanced parallelism and distributed out-of-core computation with a dask.dataframe module designed to scale

pandas. Since GeoPandas is an extension to the pandas DataFrame, the same way Dask scales pandas can also be applied to GeoPandas.

This project is a bridge between Dask and GeoPandas and offers geospatial capabilities of GeoPandas backed by Dask.

Documentation

-------------

See the documentation on https://dask-geopandas.readthedocs.io/en/latest/

Installation

------------

This package depends on Shapely, GeoPandas and Dask.

One way to install all required dependencies is to use the ``conda`` package manager to

create a new environment:

::

    conda create -n geo_env

    conda activate geo_env

    conda config --env --add channels conda-forge

    conda config --env --set channel_priority strict

    conda install dask-geopandas

Example

-------

Given a GeoPandas dataframe

.. code-block:: python

   import geopandas

   df = geopandas.read_file('...')

We can repartition it into a Dask-GeoPandas dataframe:

.. code-block:: python

   import dask_geopandas

   ddf = dask_geopandas.from_geopandas(df, npartitions=4)

The familiar spatial attributes and methods of GeoPandas are also available

and will be computed in parallel:

.. code-block:: python

   ddf.geometry.area.compute()

   ddf.within(polygon)

.. |pypi| image:: https://img.shields.io/pypi/v/dask-geopandas.svg

   :target: https://pypi.python.org/pypi/dask-geopandas/

.. |conda| image:: https://img.shields.io/conda/vn/conda-forge/dask-geopandas.svg

   :target: https://anaconda.org/conda-forge/dask-geopandas

   :alt: Conda Version

.. |docs| image:: https://readthedocs.org/projects/dask-geopandas/badge/?version=latest

   :target: https://dask-geopandas.readthedocs.io/en/latest/?badge=latest

   :alt: Documentation Status

.. |gitter| image:: https://badges.gitter.im/geopandas/geopandas.svg

   :target: https://gitter.im/geopandas/geopandas

   :alt: Gitter