semvec/pypi-packages huggingface dataset:
rastertodataframe 0.2.1
A simple python module that converts a raster to a Pandas DataFrame.
License: MIT license
Keywords: rastertodataframe

===================
Raster To DataFrame
===================


.. image:: https://img.shields.io/pypi/v/rastertodataframe.svg
        :target: https://pypi.python.org/pypi/rastertodataframe
        :alt: PyPI Status

.. image:: https://travis-ci.org/mblack20/rastertodataframe.svg?branch=master
        :target: https://travis-ci.org/mblack20/rastertodataframe
        :alt: Build Status

.. image:: https://readthedocs.org/projects/rastertodataframe/badge/?version=latest
        :target: https://rastertodataframe.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://coveralls.io/repos/github/mblack20/rastertodataframe/badge.svg?branch=master
        :target: https://coveralls.io/github/mblack20/rastertodataframe?branch=master
        :alt: Coverage Status



A simple python module that converts a raster to a Pandas DataFrame.

.. code-block:: python

   from rastertodataframe import raster_to_dataframe

   raster_path = '/some/gdal/compatible/file.tif'
   vector_path = '/some/ogr/compatible/file.geojson'

   # Extract all image pixels (no vector).
   df = raster_to_dataframe(raster_path)

   # Extract only pixels the vector touches and include the vector metadata.
   df = raster_to_dataframe(raster_path, vector_path=vector_path)


* Free software: MIT license
* Documentation: https://rastertodataframe.readthedocs.io.


Features
--------

* Convert any GDAL compatible raster to a Pandas DataFrame.
* Optionally, if any OGR compatible vector file is given, only pixels touched by the vector are extracted from the raster. The output DataFrame includes these pixels as well as any attributes from the vector file.


Installation
------------

.. code-block:: python

        pip install rastertodataframe

* A working GDAL/OGR installation is required. This is best accomplished with `conda <https://conda.io/miniconda.html>`_.

.. code-block:: shell

        conda install -c conda-forge numpy gdal geopandas pandas pyproj


Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.1 (2019-02-13)
------------------

* Add support for single band rasters.

0.2.0 (2018-07-12)
------------------

* Implement tiling to reduce memory use for large rasters.

0.1.3 (2018-07-09)
------------------

* Remove dependencies to fix non-building installs.

0.1.2 (2018-07-09)
------------------

* Fix creation of temporary files on windows.

0.1.1 (2018-07-08)
------------------

* All logic implement with unit tests. Prepare for PyPI release.

0.1.0 (2018-07-07)
------------------

* Project started.