Skip to content

GeoManager

Open-source geospatial data management for Wagtail CMS

Overview

GeoManager is a comprehensive Wagtail-based Django package for managing, serving, and visualizing geospatial data. It provides a full admin interface for raster, vector, WMS, and tile layers — purpose-built for environmental monitoring platforms like FloodWatch.
Version 0.7.2 (Beta)
License GPL-3.0
Python >= 3.11
Framework Django 4.2 + Wagtail 6.3
Maintainer Hillary Koros (hkoros@icpac.net)

How It Works

graph LR
    subgraph Data Input
        A[Raster Files<br/><i>GeoTIFF, COG, NetCDF</i>]
        B[Vector Data<br/><i>Shapefile, GeoJSON</i>]
        C[WMS Services<br/><i>External OGC layers</i>]
    end

    subgraph GeoManager
        D[Admin Interface<br/><i>Wagtail CMS</i>]
        E[Layer Registry<br/><i>Models + Metadata</i>]
        F[Style Engine<br/><i>Color ramps, classifications</i>]
        G[Watchers<br/><i>Auto-sync pipelines</i>]
    end

    subgraph Output
        H[REST API<br/><i>DRF endpoints</i>]
        I[Tile Server<br/><i>Dynamic tiles</i>]
        J[Map Viewer<br/><i>Frontend consumption</i>]
    end

    A --> D
    B --> D
    C --> D
    D --> E
    E --> F
    G --> E
    E --> H
    F --> I
    H --> J
    I --> J

Core Features

Raster Layer Management

Upload and manage GeoTIFF, COG, and NetCDF raster datasets. Automatic Cloud-Optimized GeoTIFF (COG) conversion. Configure time-series raster layers with temporal metadata for animated overlays.

Vector Layer Management

Import shapefiles and GeoJSON into PostGIS. Manage vector tile layers with configurable styling. Support for both file-based and database-backed vector layers.

WMS Integration

Connect to external WMS services with automated dataset synchronization. Configure request layers, sync schedules, and fallback behavior for third-party OGC services.

Layer Styling

Visual style editor with color ramps, value classifications, and opacity controls. Define custom color scales for raster data with named breakpoints. Preview styles directly in the admin interface.

Automated Watchers

Configure directory watchers that automatically detect and ingest new data files. Set up periodic sync tasks for external data sources. Supports FTP, SFTP, and local filesystem monitoring.

Multi-Language Support

Full internationalization with translations in 6 languages:

Language Code
English en
French fr
Arabic ar
Amharic am
Swahili sw
Spanish es

Installation

From GitHub

pip install git+https://github.com/icpac-igad/flood_watch_system.git#subdirectory=eafw_cms/geomanager

From Release

pip install git+https://github.com/icpac-igad/flood_watch_system.git@geomanager-v0.7.2#subdirectory=eafw_cms/geomanager

Add to Django Settings

INSTALLED_APPS = [
    # ...
    "geomanager",
    "wagtail",
    "rest_framework",
    # ...
]

Run Migrations

python manage.py migrate
python manage.py initialize_geomanager

Technology Stack

graph TB
    subgraph Application Framework
        DJANGO[Django 4.2]
        WAGTAIL[Wagtail 6.3]
        DRF[Django REST Framework]
    end

    subgraph Geospatial Processing
        GDAL[GDAL]
        RASTERIO[Rasterio]
        SHAPELY[Shapely]
        GEOPANDAS[GeoPandas]
    end

    subgraph Data Formats
        XARRAY[xarray + NetCDF4]
        COG[Cloud-Optimized GeoTIFF]
        POSTGIS[PostGIS]
    end

    subgraph Rendering
        LARGE[large-image<br/><i>Tile generation</i>]
        CAIRO[CairoSVG]
        MPL[Matplotlib]
    end

    WAGTAIL --> DJANGO
    DRF --> DJANGO
    RASTERIO --> GDAL
    GEOPANDAS --> SHAPELY
    XARRAY --> COG
    LARGE --> RASTERIO

Management Commands

Command Description
initialize_geomanager Create default categories, settings, and initial configuration
ingest_geomanager_raster Ingest raster data files into the layer registry
process_geomanager_layer_directory Batch process a directory of layer files
trigger_watchers Manually trigger all configured data watchers

Learn More