Skip to content
lightmare edited this page Jul 17, 2018 · 12 revisions

Mapnik's PluginArchitecture supports the use of different input formats.

This plugin supports the GDAL library in order to read a lot of spatial geo raster data from multiple formats.


Make sure that running python scons/ shows the following line

Checking for gdal-config --libs... yes
Checking for gdal-config --cflags... yes

To check if the gdal plugin built and was installed correctly you can do:

    >>> from mapnik import DatasourceCache as c
    >>> 'gdal' in c.plugin_names()


parameter value description default
file string file of the raster to be read
base string base path where to search for file parameter
band integer request for a specific raster band index, -1 means all bands. Note that a band read from a single band raster gets interpreted as Grayscale if band=-1 is specified while they retain their original value when explicitly referenced with the "band" parameter. This affects effectiveness of RasterColorizer -1
nodata double allow setting nodata value on the fly (will override value if nodata is set in data)
shared boolean Whether to open the dataset in shared mode. Not recommend to enable true unless you can guarantee that one on thread accesses a given file at the same time (unlikely given the way that most tiling software works with mapnik). It is only beneficial therefore if you are rendering multiprocess and single threaded and are working in low memory situation. Internally it directs Mapnik to call GDALOpenShared instead of GDALOpen which means that GDAL will consult its global cache of datasets. GDAL will try to return a copy of the dataset if access from multiple threads (but this defeats the purpose of sharing) false


To style a layer from GDAL use the RasterSymbolizer


This plugin in Mapnik >= 0.7.0 supports reading overviews created with gdaladdo. Parallel creation of GDAL datasources from TIFF files in a multi-threaded program requires libgdal >= 2.0.2.


    map.append_style('Raster Style',style)
    lyr = Layer('GDAL Layer from TIFF file')
    lyr.datasource = Gdal(base='/path/to/your/data',file='raster.tif')
    lyr.styles.append('Raster Style')


    <!-- NOTE: must be in the same SRS as your map-->
    <Layer name="GDAL Layer from TIFF file">
    		<Parameter name="type">gdal</Parameter>
    		<Parameter name="file">/path/to/your/data/raster.tiff</Parameter>


Plugin datasource initialization example code can be found on PluginArchitecture.

A GDAL datasource may be created as follows:

        parameters p;
        layer lyr("GDAL Layer from TIFF file");

Further References

Clone this wiki locally
You can’t perform that action at this time.