components.CoReg.GeoArray_CoReg:
- removed not neccessary if condition

components.CoReg_local.COREG_LOCAL:
- __init__(): edited docstring

components.Geom_Quality_Grid.Geom_Quality_Grid:
- __init__(): edited docstring

coreg_cmd:
- added new parameter '-max_points' to argparser for local coregistration

- updated __version__

Bugfix for RANSAC outlier detection; fastened RANSAC parameter optimization; added maximum points parameter

components.CoReg_local.COREG_LOCAL:
- __init__():
    - added new keyword 'max_points' for setting maximum number points to which co-registration algorithm is applied
    - revised docstring
- view_CoRegPoints(): removed dirty hack from last commit

components.Geom_Quality_Grid.Geom_Quality_Grid:
- __init__():
    - added new keyword 'max_points' for setting maximum number points to which co-registration algorithm is applied
    - revised docstring
- _get_imXY__mapXY_points(): added docstring
- added function _exclude_bad_XYpos()
- get_CoRegPoints_table():
     - removed keyword 'exclude_outliers' (makes no sense anymore)
     - moved exclusion of bad data points to new function _exclude_bad_XYpos()
     - added random point selection in case maximum number of points has been provided

components.Geom_Quality_Grid.Tie_Point_Refiner:
- results of RANSAC filtering are now correctly merged to rest of the point cloud
- revised _RANSAC_outlier_detection(): fastened parameter optimization

- updated __version__

components.CoReg.GeoArray_CoReg:
- add_mask_bad_data() has been moved to GeoArray class within external library 'py_tools_ds'

components,CoReg.COREG:
- refactored attribute 'confidence_shifts' to 'shift_reliability'
- _get_opt_winpos_winsize(): bugfix for indexing GeoArray with float values
- refactored _calc_shift_confidence() to _calc_shift_reliability()

components,CoReg.CoReg_local:
- adjusted some code in consequence to new mask_baddata attribute within GeoArray
- adopted view_CoRegPoints() to new outlier detection algorithm

components,Geom_Quality_Grid.Geom_Quality_Grid:
- renamed column 'CONFIDENCE' within CoRegPoints_table to 'RELIABILITY'
- revised outlier detection algorithm:
    - _flag_outliers() has been moved to new class 'Tie_Point_Refiner'
    - _ransac_outlier_detection() has been moved to new class 'Tie_Point_Refiner'
    - to_GCPList() adopted to new outlier detection algorithm
- added class class 'Tie_Point_Refiner'

- updated __version__

internal array attributes of COREG and COREG_LOCAL are now GeoArray instances; added algorithm for calculating shift confidence

components.CoReg.imParamObj:
- refactored class to 'GeoArray_CoReg' - a subclass of GeoArray from external package 'py_tools_ds'
-> fixes duplicate attributes within old class imParamObj
- revised attribute settings
- revised add_mask_bad_data()

components.CoReg.COREG:
- COREG.ref and COREG.shift are now instances of GeoArray
- refactored attribures 'matchWin' and 'otherWin' to new attributes 'matchBox' and 'otherBox' (instances of boxObj)
- attribures 'matchWin' and 'otherWin' are now instances of GeoArray class -> allows easy visualization and attribute access
- added new attribute 'confidence_shifts' -> represents some kind of quality assessment for the calculated shifts
- show_matchWin():
     - added docstring
     - function body simplification due to new GeoArray attributes
     - added alternative to interactive mode
- added show_cross_power_spectrum(): function for quickly visulaizing an interactive 3D surface plot of cross power spectrum
- _get_opt_winpos_winsize():
    - added docstring
    - added automatic adjustion of matching window size in case matching window extent exceeds dimensions of input image overlap area
         -> fixes wrong shift values at the input images (appeared in case of slighly structured image border / if border was no straight line)
- _get_image_windows_to_match(): adapted function body to new GeoArray attributes
- _shrink_winsize_to_binarySize():
    - adapted function body to new GeoArray attributes
    - bugfix for not updating COREG.success in case matchign window became too small
- _get_peakpos(): added docstring
- added _calc_shift_confidence(): function for calculating a single confidence percentage for assessing calculated shifts
- _get_deshifted_otherWin(): - adapted function body to new GeoArray attributes
- calculate_spatial_shifts(): added automatic calculation of shift confidence

components.CoReg_local.COREG_LOCAL:
- __init__():
    - added 2nd tieP_filter_level to docstring
    - COREG_LOCAL.imref and COREG_LOCAL.im2shift are now instances of GeoArray
    - added assertion regarding tieP_filter_level

components.Geom_Quality_Grid.Geom_Quality_Grid:
- _get_spatial_shifts(): now additionally returns COREG.confidence_shifts
- get_CoRegPoints_table():
     - 'added new column 'CONFIDENCE' to Geom_Quality_Grid.CoRegPoints_table
- _flag_outliers(): catched empty GeoDataFrame exception
- test_if_singleprocessing_equals_multiprocessing_result(): now disables RANSAC outlier detection during calculation

- updated __version__

added interactive visualization for comparing reference and target image coregistration before and after de-shifting

components.CoReg.COREG:
- __init__(): added assertion that rejects GeoArray objects where isinstance(geoArr, GeoArray) returns False due to Jupyter Notebook autoreload magic
- _set_outpathes(): added assertion
- added functin show_matchWin() for visualizing reference and target image coregistration before and after de-shifting

components.CoReg_local.COREG_LOCAL:
- __init__(): added assertion that rejects GeoArray objects where isinstance(geoArr, GeoArray) returns False due to Jupyter Notebook autoreload magic

components.Geom_Quality_Grid.Geom_Quality_Grid:
- separated RANSAC outlier detection from _flag_outliers()
- added _ransac_outlier_detection(): still a prototype

- updated __version__

components.CoReg.imParams:
- __init__():  added attribute mask_baddata
- added add_mask_bad_data()

components.CoReg.COREG:
- __init__(): implemented new keywords 'mask_baddata_ref' and 'mask_baddata_tgt'
- _get_opt_winpos_winsize(): now checks bad data mask if window position is within bad data area

components.CoReg_local.COREG_LOCAL:
- __init__(): implemented new keywords 'mask_baddata_ref' and 'mask_baddata_tgt'

components.Geom_Quality_Grid.Geom_Quality_Grid:
- get_CoRegPoints_table(): added vectorized filtering of points within bad data area
- _flag_outliers(): added docstring, some minor revisions

coreg_cmd:
- renamed parameters path_im0 and path_im1 to path_ref and path_tgt
- added parameters '-mask_ref' and '-mask_tgt' to global an local argument parser

- updated __version__

components.CoReg_local_COREG_LOCAL:
- view_CoRegPoints(): added optional plotting of RANSAC flagged points

components.Geom_Quality_Grid.Geom_Quality_Grid:
- get_CoRegPoints_table():
    - updated algorithm for detection points outside the overlap polygon -> now much faster
    - implemented level 2 outlier filtering
- added function _flag_outliers()
- to_GCPList():    implemented level 2 outlier filtering

components.CoReg.imParams:
- added attribute 'xygrid_specs'

components.CoReg.COREG:
- added attributes 'ssim_orig', 'ssim_deshifted', '_ssim_improved' and property 'ssim_improved'
- _get_opt_winpos_winsize(): outlier assertion is now a tracked exception
- _get_image_windows_to_match(): bugfix for passing rspAlg from wrong attribute
- added function _get_deshifted_otherWin()
- added function _validate_ssim_improvement()
- calculate_spatial_shifts() added call for _validate_ssim_improvement()
- added function _get_inverted_coreg_info()

components.CoReg_local.COREG_LOCAL:
- implemented keyword 'tieP_filter_level'
- view_CoRegPoints(): implemented keyword 'hide_filtered'

components.DeShifter.DESHIFTER:
- bugfix for not handling attribute 'band2process' correctly
- added attributes init_args and init_kwargs
- revised _get_out_extent(): bugfix for not handling clip extent correctly; bugfix for wrong call of find_nearest()
- correct_shifts(): bugfix for wrong condition in connection with target_xyGrid keyword

components.Geom_Quality_Grid.Geom_Quality_Grid:
- implemented keyword 'tieP_filter_level'
- get_CoRegPoints_table():
     - exclusion of points outside of overlap polygon is now much faster
     - added new columns to CoRegPoints_table: 'SSIM_BEFORE', 'SSIM_AFTER', 'SSIM_IMPROVED', 'LAST_ERR'

- updated __version__

components.CoReg.COREG:
- implemented new keyword 'target_xyGrid'
- added out format assertion

components.CoReg_local.COREG_LOCAL:
- implemented new keywords 'out_gsd', 'align_grids', 'match_gsd', 'target_xyGrid', 'resamp_alg_deshift', 'resamp_alg_calc'
- modified output format assertion

components.DeShifter.DESHIFTER:
- edited docstring

components.Geom_Quality_Grid.Geom_Quality_Grid:
- implemented new keyword 'resamp_alg_calc'
- CoRegPoints_table: edited print output
- to_GCPList(): edited print output

added output creation options to COREG, COREG_LOCAL and DESHIFTER (keyword 'out_crea_options'); edited some docstrings

components.CoReg.COREG:
- implemented new keyword 'out_crea_options' for specifying GDAL output creation options
- __init__(): edited docstring

components.CoReg_local.COREG_LOCAL:
- implemented new keyword 'out_crea_options' for specifying GDAL output creation options
- __init__(): edited docstring

components.DeShifter.DESHIFTER:
- implemented new keyword 'out_crea_options' for specifying GDAL output creation options

coreg_cmd:
- added parameter '-fmt_out' to global coregistration subparser as well as to COREG call

- updated __version__

components.CoReg.COREG:
- coreg_info: bugfix for recalculating spatial shifts although they are already there

components.CoReg_local.COREG_LOCAL:
- CoRegPoints_table(): added docstring
- show_image_footprints(): added docstring

components.DeShifter.DESHIFTER:
- bugfix for not properly setting nodata value
- correct_shifts(): bugfix for not passing nodata value when saving GeoArray

components.Geom_Quality_Grid.Geom_Quality_Grid:
- CoRegPoints_table: added docstring
- GCPList: added docstring
- _get_imXY__mapXY_points(): added print output
- get_CoRegPoints_table(): updated progress bar calls
- to_PointShapefile(): reordered keywords; added docstring

- updated __version__

components.CoReg:
- imParams:
    - removed attribute 'corner_coords' (not needed anymore)
    - imParams.poly is now directly derived from GeoArray
- COREG:
    - added keywords 'footprint_poly_ref' and 'footprint_poly_tgt'
    - refactored 'data_corners_im0' and 'data_corners_im1' to 'data_corners_ref' and 'data_corners_tgt'
    - _get_clip_window_properties(): bugfix for getting stuck within while loop

components.CoReg_local:
- COREG_LOCAL:
    - added keywords 'footprint_poly_ref' and 'footprint_poly_tgt'
    - refactored 'data_corners_im0' and 'data_corners_im1' to 'data_corners_ref' and 'data_corners_tgt'
    - added keyword 'ignore_errors' (not yet implemented completely)

components.Geom_Quality_Grid.Geom_Quality_Grid:
- get_CoRegPoints_table(): added empty GDF assertion; updated COREG kwargs

components.geometry:
- get_true_corner_mapXY(): added DeprecationWarning

coreg_cmd:
- updated calls for COREG and COREG_LOCAL
- added TODOs

components.CoReg:
- imParams:
    - quiet mode and progress keyword are now passed to GeoArray

components.CoReg_local:
- COREG_LOCAL:
    - quiet mode and progress keyword are now passed to GeoArray

components.Geom_Quality_Grid.Geom_Quality_Grid:
 - quiet mode and progress keyword are now passed to GeoArray

components.CoReg.COREG:
- added _validate_ssim_improvement() - not yet working
- _get_image_windows_to_match(): bugfix for using wrong bands

components.CoReg_local.COREG_LOCAL:
- view_CoRegPoints(): now used the correct band of the background image

components.DeShifter.DESHIFTER:
- revised __init__()
- correct_shifts(): revised condition for diciding if warping is needed

components.Geom_Quality_Grid.Geom_Quality_Grid:
- _get_spatial_shifts(): bugfix for returning match win size XY vice versa

components.DeShifter.DESHIFTER:
- _get_out_grid(): bugfix for negative ref_ygsd

coreg_cmd:
- edited some print outputs

components.CoReg.COREG:
- edited docstring

- renamed dsc__CoReg_Sat_FourierShiftTheorem.py to coreg_cmd.py
- updated __version__
- updated README and associated figures

components.CoReg.imParams:
- r_b4match' and 's_b4match' are now internally handled as band indices rather than band numbers

components.CoReg._local.COREG_LOCAL:
- removed attributes r_b4match and s_b4match (confusing duplicates of COREG_LOCAL.imref.r_b4match

components.Geom_Quality_Grid.Geom_Quality_Grid:
- r_b4match' and 's_b4match' are now internally handled as band indices rather than band numbers

components.geometry:
- get_true_corner_mapXY(): added docstring, refactored keyword 'bandNr' to 'band' -> now handled as index

components.CoReg:
- imParams: mask is now calculated from only one band -> avoids reading the whole datacube

components.CoReg_local:
- COREG_LOCAL:
    - __init__(): some docstring modifications
    - added attribute '_success'
    - property quality_grid: now shows calculated coreg points figure in verbose mode
    - view_CoRegPoints(): added outlier filtering for points in figure
    - correct_shifts(): bugfix for trying to corrects shifts without GCPs

components.Geom_Quality_Grid.Geom_Quality_Grid:
- GCPList: bugfix for running to_GCPList() twice
- get_CoRegPoints_table(): disabled verbose mode during grid calculation
- to_GCPList(): now returns an empty list if no valid matches are available

MAIN:
- major revision; added subparsers; added argparser for COREG_LOCAL
- added run_global_coreg()
- added run_local_coreg()

- updated __version__

components.CoReg:
- imParams: bugfix for outdated assertion
- COREG:
    - implemented keyword 'progress' for switching progress bars on or off
    - converted attribute 'coreg_info' to property

components.CoReg_local.COREG_LOCAL:
- implemented keyword 'progress' for switching progress bars on or off
- added property 'coreg_info'

components.DeShifter.DESHIFTER:
- implemented keyword 'progress' for switching progress bars on or off
- removed deprecated keywords 'warp_alg' and 'tempDir'
- correct_shifts(): outcommented algorithm for GDAL command line warping

components.Geom_Quality_Grid.Geom_Quality_Grid:
- implemented keyword 'progress' for switching progress bars on or off
- get_CoRegPoints_table():
    - duplicated IO is now avoided
    - added progressbars for single and multiprocessing modes

- updated __version__

components.CoReg:
- imParams: bugfix for outdated assertion
- COREG:
    - implemented keyword 'progress' for switching progress bars on or off
    - converted attribute 'coreg_info' to property

components.CoReg_local.COREG_LOCAL:
- implemented keyword 'progress' for switching progress bars on or off
- added property 'coreg_info'

components.DeShifter.DESHIFTER:
- implemented keyword 'progress' for switching progress bars on or off
- removed deprecated keywords 'warp_alg' and 'tempDir'
- correct_shifts(): outcommented algorithm for GDAL command line warping

components.Geom_Quality_Grid.Geom_Quality_Grid:
- implemented keyword 'progress' for switching progress bars on or off
- get_CoRegPoints_table():
    - duplicated IO is now avoided
    - added progressbars for single and multiprocessing modes

- updated __version__

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