From 096e85f32a2759ebe5286192ed814e6a9bd6aa31 Mon Sep 17 00:00:00 2001 From: Brendan Ward Date: Tue, 17 Sep 2024 09:31:04 -0700 Subject: [PATCH] DOC: Add install note re: advanced drivers on conda-forge (#474) --- docs/source/install.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/source/install.md b/docs/source/install.md index 04b1853e..5419a36d 100644 --- a/docs/source/install.md +++ b/docs/source/install.md @@ -22,7 +22,15 @@ conda install -c conda-forge pyogrio This requires compatible versions of `GDAL` and `numpy` from `conda-forge` for raw I/O support and `geopandas` and their dependencies for GeoDataFrame -I/O support. +I/O support. By default, the `GDAL` package on conda-forge already supports a +wide range of vector formats. If needed, you can install additional drivers by +installing the associated +[conda-forge package](https://gdal.org/en/latest/download.html#conda). The +following packages are currently available to install extra vector drivers: + +- `libgdal-arrow-parquet` ((Geo)Parquet and (Geo)Arrow IPC) +- `libgdal-pg` (PostgreSQL / PostGIS) +- `libgdal-xls` (XLS - MS Excel format) ### PyPI @@ -40,6 +48,11 @@ most likely due to the installation process falling back to installing from the source distribution because the available wheels are not compatible with your platform. +The binary wheels available on PyPI include the core GDAL drivers (GeoJSON, +ESRI Shapefile, GPKG, FGB, OpenFileGDB, etc) but do not include more advanced +drivers such as LIBKML and Spatialite. If you need such drivers, we recommend +that you use conda-forge to install pyogrio as explained above. + ### Troubleshooting installation errors If you install GeoPandas or Fiona using `pip`, you may encounter issues related