Blizzard
125 lines
5.1 KiB
Plaintext
125 lines
5.1 KiB
Plaintext
Metadata-Version: 2.4
|
|
Name: pyogrio
|
|
Version: 0.11.1
|
|
Summary: Vectorized spatial vector file format I/O using GDAL/OGR
|
|
Author: pyogrio contributors
|
|
Author-email: "Brendan C. Ward" <bcward@astutespruce.com>
|
|
Maintainer: pyogrio contributors
|
|
License: MIT License
|
|
|
|
Copyright (c) 2020-2024 Brendan C. Ward and pyogrio contributors
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
|
|
Project-URL: Home, https://pyogrio.readthedocs.io/
|
|
Project-URL: Repository, https://github.com/geopandas/pyogrio
|
|
Classifier: Development Status :: 5 - Production/Stable
|
|
Classifier: Intended Audience :: Science/Research
|
|
Classifier: License :: OSI Approved :: MIT License
|
|
Classifier: Operating System :: OS Independent
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Topic :: Scientific/Engineering :: GIS
|
|
Requires-Python: >=3.9
|
|
Description-Content-Type: text/markdown
|
|
License-File: LICENSE
|
|
Requires-Dist: certifi
|
|
Requires-Dist: numpy
|
|
Requires-Dist: packaging
|
|
Provides-Extra: dev
|
|
Requires-Dist: cython; extra == "dev"
|
|
Provides-Extra: test
|
|
Requires-Dist: pytest; extra == "test"
|
|
Requires-Dist: pytest-cov; extra == "test"
|
|
Provides-Extra: benchmark
|
|
Requires-Dist: pytest-benchmark; extra == "benchmark"
|
|
Provides-Extra: geopandas
|
|
Requires-Dist: geopandas; extra == "geopandas"
|
|
Dynamic: license-file
|
|
|
|
# pyogrio - bulk-oriented spatial vector file I/O using GDAL/OGR
|
|
|
|
Pyogrio provides fast, bulk-oriented read and write access to
|
|
[GDAL/OGR](https://gdal.org/en/latest/drivers/vector/index.html) vector data
|
|
sources, such as ESRI Shapefile, GeoPackage, GeoJSON, and several others.
|
|
Vector data sources typically have geometries, such as points, lines, or
|
|
polygons, and associated records with potentially many columns worth of data.
|
|
|
|
The typical use is to read or write these data sources to/from
|
|
[GeoPandas](https://github.com/geopandas/geopandas) `GeoDataFrames`. Because
|
|
the geometry column is optional, reading or writing only non-spatial data is
|
|
also possible. Hence, GeoPackage attribute tables, DBF files, or CSV files are
|
|
also supported.
|
|
|
|
Pyogrio is fast because it uses pre-compiled bindings for GDAL/OGR to read and
|
|
write the data records in bulk. This approach avoids multiple steps of
|
|
converting to and from Python data types within Python, so performance becomes
|
|
primarily limited by the underlying I/O speed of data source drivers in
|
|
GDAL/OGR.
|
|
|
|
We have seen \>5-10x speedups reading files and \>5-20x speedups writing files
|
|
compared to using row-per-row approaches (e.g. Fiona).
|
|
|
|
Read the documentation for more information:
|
|
[https://pyogrio.readthedocs.io](https://pyogrio.readthedocs.io/en/latest/).
|
|
|
|
## Requirements
|
|
|
|
Supports Python 3.9 - 3.13 and GDAL 3.4.x - 3.9.x.
|
|
|
|
Reading to GeoDataFrames requires `geopandas>=0.12` with `shapely>=2`.
|
|
|
|
Additionally, installing `pyarrow` in combination with GDAL 3.6+ enables
|
|
a further speed-up when specifying `use_arrow=True`.
|
|
|
|
## Installation
|
|
|
|
Pyogrio is currently available on
|
|
[conda-forge](https://anaconda.org/conda-forge/pyogrio)
|
|
and [PyPI](https://pypi.org/project/pyogrio/)
|
|
for Linux, MacOS, and Windows.
|
|
|
|
Please read the
|
|
[installation documentation](https://pyogrio.readthedocs.io/en/latest/install.html)
|
|
for more information.
|
|
|
|
## Supported vector formats
|
|
|
|
Pyogrio supports most common vector data source formats (provided they are also
|
|
supported by GDAL/OGR), including ESRI Shapefile, GeoPackage, GeoJSON, and
|
|
FlatGeobuf.
|
|
|
|
Please see the [list of supported formats](https://pyogrio.readthedocs.io/en/latest/supported_formats.html)
|
|
for more information.
|
|
|
|
## Getting started
|
|
|
|
Please read the [introduction](https://pyogrio.readthedocs.io/en/latest/supported_formats.html)
|
|
for more information and examples to get started using Pyogrio.
|
|
|
|
You can also check out the [API documentation](https://pyogrio.readthedocs.io/en/latest/api.html)
|
|
for full details on using the API.
|
|
|
|
## Credits
|
|
|
|
This project is made possible by the tremendous efforts of the GDAL, Fiona, and
|
|
Geopandas communities.
|
|
|
|
- Core I/O methods and supporting functions adapted from [Fiona](https://github.com/Toblerity/Fiona)
|
|
- Inspired by [Fiona PR](https://github.com/Toblerity/Fiona/pull/540/files)
|