---
id: gdal
version: "3.13.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# GDAL — GDAL: Geospatial Data Abstraction Library

License: permissive · Maintenance: active · Downloads: 384.2K/mo

## What it is and what it does

GDAL is a mature geospatial data abstraction library that exposes C++ classes and methods for reading, writing, and manipulating raster (gridded) and vector (feature-based) geospatial data through Python. The package wraps GDAL/OGR functionality via SWIG-generated bindings, providing access to five major modules: gdal (raster operations), ogr (vector operations), osr (spatial reference systems), gdal_array (numpy integration), and gdalconst (constants).

Installation requires system-level GDAL libraries and headers, making it more complex than pure-Python packages. The bindings are tightly coupled to the underlying C++ library version, so your libgdal installation must match or exceed the required version. A key advanced feature is integration with numpy arrays through methods like ReadAsArray(), enabling numerical processing of raster data. The package is actively maintained, widely used in GIS workflows, and has no known security vulnerabilities.

Use it for:

- Read and write raster data (GeoTIFF, HDF5, NetCDF) and convert to numpy arrays for scientific analysis.
- Process vector data (shapefiles, GeoJSON, PostGIS) to query, filter, and transform geographic features.
- Perform coordinate system transformations and spatial reference conversions between different projections.
- Build GIS utilities and command-line tools that manipulate multiple geospatial formats programmatically.
- Integrate geospatial data pipelines into larger scientific or machine-learning workflows requiring raster/vector I/O.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

GDAL provides Python bindings to read, write, and manipulate geospatial raster and vector data through a C++ abstraction layer.

Yes, with conditions. GDAL is the de facto standard for geospatial data I/O in Python and is actively maintained with no known vulnerabilities. Install it if you need to work with raster or vector geospatial data. However, expect higher installation friction than typical Python packages: you must have system GDAL libraries and headers pre-installed, and building from source requires SWIG and compilation tools. Use conda on Windows and macOS to avoid compilation.

## Install

pip install gdal
uv add gdal
poetry add gdal

## Installing GDAL

Before you install: Installation requires system-level GDAL libraries and development headers; building from source has high friction due to SWIG compilation and multiple dependencies (libgdal 3.13.2 or greater, SWIG 4 or greater, numpy, setuptools, wheel). Pre-built conda packages are available and recommended for Windows and macOS. Maintenance is active with recent releases.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the license notice.

Quickstart:

pip install gdal

from osgeo import gdal
from osgeo import ogr
from osgeo import osr

dataset = gdal.Open('data.tif')
band = dataset.GetRasterBand(1)
data = band.ReadAsArray()

libgdal system library (3.13.2 or greater) and development headers must be installed; numpy is required for array operations and must be installed before building bindings; building from source requires SWIG 4 or greater and compilation tools.

Verify before relying:

- Whether pre-built wheels cover all major platforms and Python versions or if source compilation is typically required.
- Performance characteristics for large raster datasets beyond the memory-intensive warning for ReadAsArray.
- Compatibility matrix between GDAL Python version, libgdal version, and numpy versions in practice.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: high
- Maintenance: active
- Downloads: 384.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

geospatial data processing, raster and vector data, GIS data manipulation, gdal python bindings, geospatial file formats, raster array conversion, spatial data I/O, geospatial-io, raster-vector, gis

[View on SkillFed](https://skillfed.io/packages/gdal) · [View on PyPI](https://pypi.org/project/gdal/)