Skip to content

enricofer/django-warp

Repository files navigation

DJANGO WARP

Latest Version Downloads License Wheel Status Supported Python Versions

A reusable Django app for raster datasets collaborative georeferencing. The typical use case is the environmental and administrative organizations paper archive digitalization.

Features

  • Many datasets with different settings, coordinate systems and basemaps.
  • make use of GDAL/OGR library.
  • Requires no Gis/desktop skills:
    • simple control input
    • visual feedback
  • responsive interface

REQUIREMENTS

Required python libraries:

  • django
  • django-apps
  • django-cors-headers
  • django-http-proxy
  • python-slugify
  • django-imagekit
  • django-raster
  • pygdal

Required libraries: GDAL/OGR 2.0 http://www.gdal.org/

INSTALL

Last stable version:

pip install django-warp

Development version:

pip install django-warp

USAGE

  • Add django.contrib.gis, httpproxy, django_warp to your INSTALLED_APPS
  • Define MEDIA_URL, MEDIA_ROOT, STATIC_URL, STATIC_ROOT
  • Add url(r'^warp/', include('django_warp.urls')), to urlpatterns in site urls.py
  • Append + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) to urlpatterns. A minimal urls.py should be like this:
from django.conf.urls import include,url
from django.conf.urls.static import static
from django.conf import settings

urlpatterns = [
    ...
    url(r'^warp/', include('django_warp.urls')),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
  • ./manage.py makemigrations django_warp and ./manage.py migrate to create db context
  • Run server and browse to [yourserver address]\warp\ and login with a valid site credentials
  • First create a dataset with epsg code, extents and baselayer
  • Then upload images and define correlation and clipping to do georeferencing

CHANGELOG

0.1 first release

0.2 improved dataset manager

0.3 setting epsg projection different from 3857 4326 issues fix

0.4 new feature - download zipped collection of dataset georefs tiff along with .vrt file new feature - auto pan/zoom on target/source view change can't clip raster issue fixed

0.5 new feature - imagewms server for georeferenced datasets new feature - display dataset coverage with internal imagewms server new feature - overlay of all georeferenced datasets coverage from internal imagewms server in warp view new feature - raster metadata edit in warp view new feature - can move rasters between datasets new feature - datasets cloning accidental clipping polygon moving while panning in warp windows issue fixed border transparency in datasets coverage issue fixed

0.6 update to Django 2.1

SCREENSHOTS

available datasets

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/datasets.png

dataset setting, default to EPSG:3857 projection (web mercator) and OSM baselayer

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/dataset_form_3857.png

dataset custom settins: EPSG:3003 projection (web mercator) with ArcGis Mapserver baselayer

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/dataset_form_3003.png

loading a new image

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/image_load.png

correlated available images in datasets

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/dataset_images.png

correlating source image on the left on target map on the right

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/correlate_01.png

couple of correlation point on source image and target map

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/correlate_02.png

clipping source image

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/correlate_04.png

succesful correlation

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/correlate_05.png

datasets coverage overlays in target map

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/dataset_coverages.png

dataset overview with georeferenced images mosaic

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/overview.png

printing a correlated image

https://raw.githubusercontent.com/enricofer/django-warp/master/docs/print.png