Metadata-Version: 2.1
Name: dask-geopandas
Version: 0.4.0
Summary: Parallel GeoPandas with Dask
Author-email: Julia Signell <jsignell@gmail.com>
Maintainer: GeoPandas contributors
License: BSD 3-Clause
Project-URL: Home, https://geopandas.org
Project-URL: Documentation, https://dask-geopandas.readthedocs.io/
Project-URL: Repository, https://github.com/geopandas/dask-geopandas
Project-URL: Issue Tracker, https://github.com/geopandas/dask-geopandas/issues
Keywords: dask,geopandas,spatial,distributed,cluster
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: geopandas >=0.12
Requires-Dist: shapely >=2.0
Requires-Dist: dask >=2022.06.0
Requires-Dist: distributed >=2022.06.0
Requires-Dist: packaging
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'

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
