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