Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

DOC: Add install note re: advanced drivers on conda-forge #474

Merged
merged 3 commits into from
Sep 17, 2024
Merged

DOC: Add install note re: advanced drivers on conda-forge #474

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
3301fc7
Add install note re: advanced drivers on conda-forge
brendan-ward Sep 16, 2024
674b550
Cleanup conda-forge packages that are default vs optional
brendan-ward Sep 16, 2024
dcfab2e
PR suggestions
brendan-ward Sep 17, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 14 additions & 1 deletion docs/source/install.md
View file
Open in desktop
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