Denoising for Sentinel-1 (and possibly other) single-band SAR images.

This package implements the denoising method described in the paper: "TODO"

This package provides both:
– A C++ library, directly callable without any Python dependency
– A Python module, which calls the C++ library as a backend

A ready-to-use Python script for denoising Sentinel-1 images is also provided.

This package is designed, built, tested under Linux (Debian/testing). Sorry for Windows or MacOS users, I have neither the time nor the motivation to support your favorite operating system. However, if you port this package to your OS, pleased contact me and we may include your changes in the next version.

PYTHON USERS
============

This package can be installed classically with "./setup.py build" and "./setup.py install".
You may want to use "./setup.py install --user" to install locally if you don't have permissions to install system-wise. Installing in a Python virtual environment is supported, although first installing gdal within that virtual environment may be tricky (*see below).
Dependencies are numpy, scikit-image (skimage) and gdal>=2.1.

C++ USERS
=========

"make lib" will build the C++ library and "make install" will install it. See "make" without arguments for options and default locations.

LICENCE
=======

This package is released under either of the two licenses below, your choice:
- LGPL v2.1 or later, https://www.gnu.org
  The GNU Lesser General Public Licence, version 2.1 or,
  at your option, any later version.
- CeCILL-C, http://www.cecill.info
  The CeCILL-C license is more adapted to the French laws,
  but can be converted to the GNU LGPL.
You can use, modify and/or redistribute the software under the terms of any
of these licences, which should have been provided to you together with this
sofware. If that is not the case, you can find a copy of the licences on
the indicated web sites.
Other dependencies (boost, Eigen, CImg) come with their own licences, which are all compatible with CeCILL-C_V1 and LGPL. 

Nicolas Brodu, 2017-10-09


* Additional notes for Python users
===================================
First install GDAL and libgdal-dev globally. Then, you could either use the "--system-site-packages" option of virtualenv, or have to resort to something like "pip install gdal --global-option=build_ext --global-option='-I/path/to/gdal/include/'" from within the virtualenv. Lookup "Installing GDAL in a Python virtual environment" on the Internet in case of trouble.
