Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/enricofer/django-warp

a reusable django app for raster maps georeferencing
https://github.com/enricofer/django-warp

django django-application gdal georeferencing ogr reusable-components

Last synced: about 1 month ago
JSON representation

a reusable django app for raster maps georeferencing

Awesome Lists containing this project

README

        

==============
DJANGO WARP
==============

.. image:: https://img.shields.io/pypi/v/django-warp.svg?style=plastic
:target: https://pypi.python.org/pypi/django-warp/
:alt: Latest Version

.. image:: https://img.shields.io/pypi/dm/django-warp.svg?style=plastic
:target: https://pypi.python.org/pypi/django-warp/
:alt: Downloads

.. image:: https://img.shields.io/pypi/l/django-warp.svg?style=plastic
:target: https://pypi.python.org/pypi/django-warp/
:alt: License

.. image:: https://img.shields.io/pypi/wheel/django-warp.svg?style=plastic
:target: https://pypi.python.org/pypi/django-warp/
:alt: Wheel Status

.. image:: https://img.shields.io/pypi/pyversions/django-warp.svg?style=plastic
:target: https://pypi.python.org/pypi/django-warp/
:alt: 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

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

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

.. image:: 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

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

loading a new image

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

correlated available images in datasets

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

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

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

couple of correlation point on source image and target map

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

clipping source image

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

succesful correlation

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

datasets coverage overlays in target map

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

dataset overview with georeferenced images mosaic

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

printing a correlated image

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