Managing raster data with PostGIS and Python

Managing raster data with PostGIS and Python

February 3, 2016

PostGIS is the spatial extension of the open source database management system PostgreSQL. It helps you to manage your data (vector and raster) within a coherent geodatabase through a variety of spatial functions. Having a spatial database, the times of data clutter and messiness are over, especially when you are dealing with big data. Initially PostGIS was created to for the handling of vector data only. However, during the recent years more and more raster handling functionalities were introduced. For a complete overview of spatial raster operators, have a look at:


Download and install PostgreSQL and PostGIS

Download PostgreSQL from here:

The installer for PostgreSQL includes the PostgreSQL server, pgAdmin III; a GUI for managing and developing your databases, and StackBuilder; a package manager that can be used to download and install additional PostgreSQL applications and drivers. From the StackBuilder GUI, select Spatial Extensions and install the respective PostGIS 2.2 Bundle for PostgreSQL.


Create a new spatial database

In pgAdmin, create a new database (right click: New Database):


and the spatial extension postgis (right click on Extensions: New Extension):


This will create a first table within your DB: spatial_ref_sys that contains the coordinate systems, map projections and the spatial indeces.


Set up Python

Python provides awesome functionality for the automated raster processing within PostGIS. Automatization is necessary especially when you deal with a lot of data and iterative processes. Python scripting is also needed as the pgAdmin GUI does not support the access of all functions.

Download Python 2.7 from here:

Psycopg2 is a Python library that accesses the objects of the PostgreSQL server and allows the execution of PostGIS commands from Python.

Download psycopg2 from here:


PostGIS scripting with Python

Import the Python libraries:

import psycopg2  
import subprocess 
import sys, os

Set up input path and a loop that goes through all TIFs in the directory:

input_path = "C:\\Data\\Raster\\"

for raster in os.listdir(input_path):    
    if raster.endswith(".tif"):
       name = raster.split(".tif")[0]
       raster = os.path.join(input_path, raster)

Connect to the PostgreSQL server:

       os.environ['PATH'] = r';C:\Program Files\PostgreSQL\9.4\bin'
       os.environ['PGHOST'] = 'localhost'
       os.environ['PGPORT'] = '5432'
       os.environ['PGUSER'] = 'postgres'
       os.environ['PGPASSWORD'] = 'postgres'
       os.environ['PGDATABASE'] = 'raster_database'
       rastername = str(name)
       rasterlayer = rastername.lower()
       conn = psycopg2.connect(database="raster_database", user="postgres", host="localhost", password="postgres") 
       cursor = conn.cursor()

Import each raster through raster2pgsql function (coordinate system epsg code is set to 32633 UTM):

       cmds = 'raster2pgsql -s 32633 -t 2000x2000 "' + raster + '" |psql', shell=True)

Now run any PostGIS command you like. In this example we run rescale the raster to 250m spatial resolution and reproject it from UTM 33N to WGS84 (epsg code 4326). At the end, the raster may be exported locally to *.hex data format. The export is optional, we could also convert the raster to CSV or numpy array.

       sql = "UPDATE " + rasterlayer + " SET rast = ST_Rescale(rast, 250, 'Near'); \
              UPDATE " + rasterlayer + " SET rast = ST_Transform(ST_SetSRID(rast,32633),4326);"

       rql = "COPY (SELECT encode(ST_AsTIFF(rast), 'hex') AS tif FROM " + rasterlayer + ") TO 'C:/Users/Data/" + rasterlayer + ".hex';"


you may also like:

R package for time-series animation of rasters

R package for time-series animation of rasters

One of remote sensing's greatest strengths is its capability to deliver consistent and highly resolved time series. These have a wonderful potential for visualizations and analysis.Creating a fluid and pretty animation from a collection of tifs can be complicated, as...

WASCAL MSc Program course on spatial data analysis

WASCAL MSc Program course on spatial data analysis

As part of the project WASCAL-DE-Coop, the Department of Remote Sensing at the University of Würzburg conducted the second course on Spatial Data Analysis, embedded in the WASCAL Master Research Program "Climate Change and Informatics" at the University Université...

most recent news:

Successful Hybrid WASCAL Symposium

Successful Hybrid WASCAL Symposium

We are very happy that the WASCAL symposium for Research and Capacity Building went very well. Our staff members who organized it managed to have a great hybrid symposium with valuable talks covering all aspects of WASCAL  while complying to the Covid-regulations. We...

New Publication on Automated building characterization

New Publication on Automated building characterization

A new publication by Hannes Taubenböck and colleagues is online about "Automated building characterization for seismic risk assessment using street-level imagery and deep learning". From the abstract: "Accurate seismic risk modeling requires knowledge of key...

Open Postdoc position on Megacities

Open Postdoc position on Megacities

Dear all, please find below an open Postdoc position with Hannes Taubenböck from our department. For the research project ‘Megacities – living environments of the future’, funded by the VolkswagenStiftung, the Chair of English Linguistics at the...