implemented new module 'CoReg_local' for detection and correction of local shifts; revised some functions due to changes in external library 'py_tools_ds'

components.CoReg:
- imParamObj: updated derivation of nodata value and footprint polygo
- COREG: - added attribute 'deshift_results'

components.CoReg_local:
- added as new module for detection and correction of local shifts

components.DeShifter:
- moved DESHIFTER property '_dict_rspAlg_rsp_Int' to module top-level
- _get_out_extent(): updated algorithm

components. Geom_Quality_Grid.Geom_Quality_Grid:
- __init__():
    - changed most of the input args and kwargs
    - revised the whole function -> COREG_obj is not instanced within class COREG_LOCAL
    - added property 'CoRegPoints_table'
    - added property 'GCPList'
    - dump_CoRegPoints_table(): revision
    - quality_grid_to_PointShapefile(): refactored to 'to_PointShapefile'
    - _quality_grid_to_PointShapefile(): refactored to '_to_PointShapefile'
    - quality_grid_to_Raster_using_KrigingOLD(): revised getter for path_out
    - _Kriging_sp(): revised getter for path_out
    - view_results(): moved to class COREG_LOCAL
    - view_results_folium(): moved to class COREG_LOCAL
    - correct_shifts(): moved to class COREG_LOCAL

components.geometry:
- get_true_corner_mapXY(): adjusted some lines due to update of 'py_tools_ds'
- find_noDataVal(): moved to external library 'py_tools_ds'

__init__:
- updated __version__

resampling algorithms are now adjustable in COREG; bugfix for not respecting taking nodata value when de-shifting

 COREG:
 - added keywords 'resamp_alg_deshift' and 'resamp_alg_calc'
 - updated docstring
 - added warning when resampling algorithm 'average' is chosen
 - _calc_shifted_cross_power_spectrum(): bugfix for not using pyfftw even if available
 - refactored calc_subpixel_shifts() to _calc_subpixel_shifts()
 - added _dict_rspAlg_rsp_Int

 DESHIFTER:
 - refactored dict_rspAlg_rsp_Int to property _dict_rspAlg_rsp_Int
 - added 'nodata' keyword

 MAIN:
 - fixed some typos

COREG / DESHIFTER: output format is now adjustable via keyword argument; Bugfix for wrong output filename

 COREG:
 - added keyword 'fmt_out' that allows to set the output format for deshifted data
 - improved docstring
 - Bugfix for missing output filename in case COREG had been instanced with default argument for path_out

 DESHIFTER:
 - added keyword 'fmt_out' that allows to set the output format for deshifted data
 - Bugfix for missing GeoArray in deshift_results in case align_grids=False

 MAIN:
 - updated default argument of '-o' option

COREG:
- some modifications in order to ensure Python 2.7 compatibility
- pyfftw is now only imported if available

Geom_Quality_Grid:
- some modifications in order to ensure Python 2.7 compatibility

MAIN:
- CoReg_Sat root directory is automatically added to PATH
- py_tools_ds root directory is automatically added to PATH (expected to be in CoReg_Sat root directory)

implemented shifts vector length and angle directly into CoReg; calculation of geometric quality grid now 100% faster

COREG:
- __init__(): added new attributes 'vec_length_map' and 'vec_angle_deg'
- _get_image_windows_to_match(): bugfix for running warp_ndarray in multiprocessing if multiprocessing is disabled
- calculate_spatial_shifts(): moved calculation of X/Y shifts in map units here; implemented calculation of shifts vector length and angle

DESHIFTER:
- __init__(): added attribute 'GeoArray_shifted'
- deshift_results(): added keys 'updated geotransform' and 'GeoArray_shifted' to returned dict

Geom_Quality_Grid:
- _get_spatial_shifts(): now returns values for all columns of quality grid
- revised get_quality_grid(): now much simpler and 100% faster
- view_results() added functionality for saving the output figure to disk

added functions for visualizing results of geometric quality grid and polygons calculated by COREG class

COREG:
- added show_image_footprints(): a function to show a web map containing the calculated polygons within Jupyter Notebook

DESHIFTER:
- correct_shifts(): bugfix for showing warping progress bars in quiet mode

Geom_Quality_Grid:
- added view_results(): a function for showing a map of the calculated quality grid with the target image as background
- added view_results_folium(): a function for showing a web map of the calculated quality grid with the target image as background (for Jupyter Notebook)

COREG:
- calculate_spatial_shifts(): bugfix for printing None instead of calculated shifts within RuntimeError in case of too large shifts

DESHIFTER:
- updated documentation of keyword warp_alg
- implemented multiprocessing (keyword CPUs)
- implemented first prototype of local shift-correction based on a list of GCPs

Geom_Quality_Grid:
- replaced keyword 'multiproc' by 'CPUs'
- added method to_GCPList()
- added method correct_shifts()

README:
- added README for the whole package

Daniel Scheffler authored Oct 13, 2016 and Mathias Peters committed Oct 13, 2016

CoReg:
- revised assertion message in case of different projections

DeShifter:
- De-shifting now also works if updated map info is None
- get_out_grid(): converted to protected method
- grids_alignable(): converted to protected method
- get_out_extent(): converted to protected method; bugfix for returning wrong order of output extent coordinated in case clipextent is None

- imParamObj: simplified parameter settings and adjusted calls of GEO.find_noDataVal

Geom_Quality_Grid:
- get_quality_grid(): bugfix for processing the wrong input array shape during coregistration
- added quiet mode for some print outputs

GEO:
- added new version of find_noDataVal() that now also supports GeoArrays as input
- get_true_corner_mapXY(): added automatic reordering of corner coordinates in order to avoid shapely self intersection warnings

bugfix for not properly detecting actual image corner coordinates (fix applied in external library 'py_tools_ds')

CoReg:
- imParamObj: added verbose and quiet mode to GEO.get_true_corner_mapXY

GEO:
- improved error handling during calculation of actual image corner coordinates

COREG:
- some functions are now imported directly from py_tools_ds instead of from geometry
- moved imParamObj and COREG to new module 'CoReg'

DESHIFTER:
- some functions are now imported directly from py_tools_ds instead of from geometry
- moved DESHIFTER to new module 'DeShifter'

Geom_Quality_Grid:
- some functions are now imported directly from py_tools_ds instead of from geometry
- moved Geom_Quality_Grid to new module Geom_Quality_Grid

MAIN:
- fixed a unicode string error within arg parser
- some code style changes
- bugfix for not properly parsing '-calc_cor'
- __version__ is now imported from package.__init__

package.__init__:
- added __version__

UTL:
- removed deprecated imports

IO:
- revised some imports

GEO:
- removed all imports of functions that are not directly needed within geometry

new modules:
- CoReg
- DeShifter
- Geom_Quality_Grid