Skip to content

Commit

Permalink
DOC: Add install note re: advanced drivers on conda-forge (#474)
Browse files Browse the repository at this point in the history
  • Loading branch information
brendan-ward committed Sep 17, 2024
1 parent 262e925 commit 096e85f
Showing 1 changed file with 14 additions and 1 deletion.
15 changes: 14 additions & 1 deletion docs/source/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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
Expand Down

0 comments on commit 096e85f

Please sign in to comment.