Metadata-Version: 2.1
Name: geofeather
Version: 0.2.0
Summary: Fast file-based format for geometries with Geopandas
Home-page: https://github.com/brendan-ward/geofeather
Author: Brendan C. Ward
Author-email: bcward@astutespruce.com
License: MIT
Description: # geofeather
        
        [![Build Status](https://travis-ci.org/brendan-ward/geofeather.svg?branch=master)](https://travis-ci.org/brendan-ward/geofeather)
        [![Coverage Status](https://coveralls.io/repos/github/brendan-ward/geofeather/badge.svg?branch=master)](https://coveralls.io/github/brendan-ward/geofeather?branch=master)
        
        A faster file-based format for geometries with `geopandas`.
        
        This project capitalizes on the very fast [`feather`](https://github.com/wesm/feather) file format to store geometry (points, lines, polygons) data for interoperability with `geopandas`.
        
        [Introductory post](https://medium.com/@brendan_ward/introducing-geofeather-a-python-library-for-faster-geospatial-i-o-with-geopandas-341120d45ee5).
        
        ## Why does this exist?
        
        This project exists because reading and writing standard spatial formats (e.g., shapefile) in `geopandas` is slow. I was working with millions of geometries in multiple processing steps, and needed a fast way to read and write intermediate files.
        
        In our benchmarks, we see about 5-6x faster file writes than writing from geopandas to shapefile via `.to_file()` on a `GeoDataFrame`.
        
        We see about 2x faster reads compared to geopandas `read_file()` function.
        
        ## How does it work?
        
        The `feather` format works brilliantly for standard `pandas` data frames. In order to leverage the `feather` format, we simply convert the geometry data from `shapely` objects into Well Known Binary ([WKB](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry)) format, and then store that column as raw bytes.
        
        We store the coordinate reference system using JSON format in a sidecar file `.crs`.
        
        ## Installation
        
        Available on PyPi at: https://pypi.org/project/geofeather/
        
        `pip install geofeather`
        
        ## Usage
        
        ### Write
        
        Given an existing `GeoDataFrame` `my_gdf`, pass this into `to_geofeather`:
        
        ```
        to_geofeather(my_gdf, 'test.feather')
        ```
        
        ### Read
        
        ```
        my_gdf = from_geofeather('test.feather')
        
        ```
        
        ## Indexes
        
        Right now, indexes are not supported in `feather` files. In order to get around this, simply reset your index before calling `to_geofeather`.
        
        ## Changes
        
        ### 0.2.0
        
        -   allow reading a subset of columns from a feather file
        -   store geometry in 'geometry' column instead of 'wkb' column (simplification to avoid renaming columns)
        
        ### 0.1.0
        
        -   Initial release
        
        ## Credits
        
        Everything that makes this fast is due to the hard work of contributors to `pyarrow`, `geopandas`, and `shapely`.
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
