# Wavelet Block Thresholding¶


This numerical tour presents block thresholding methods, that makes use of the structure of wavelet coefficients of natural images to perform denoising. Theoretical properties of block thresholding were investigated in CaiSilv Cai99 HallKerkPic99

In [44]:
from __future__ import division

import numpy as np
import scipy as scp
import pylab as pyl
import matplotlib.pyplot as plt

from nt_toolbox.general import *
from nt_toolbox.signal import *

import warnings
warnings.filterwarnings('ignore')

%matplotlib inline

The autoreload extension is already loaded. To reload it, use:


## Generating a Noisy Image¶

Here we use an additive Gaussian noise.

Size of the image of $N=n \times n$ pixels.

In [45]:
n = 256


First we load an image $f_0 \in \RR^N$.

In [46]:
f0 = rescale(load_image("nt_toolbox/data/boat.bmp", n))


Display it.

In [47]:
plt.figure(figsize = (5,5))
imageplot(f0)


Noise level.

In [48]:
sigma = .08


Generate a noisy image $f=f_0+\epsilon$ where $\epsilon \sim \Nn(0,\si^2\text{Id}_N)$.

In [49]:
from numpy import random

f = f0 + sigma*random.standard_normal((n,n))


Display it.

In [50]:
plt.figure(figsize = (5,5))
imageplot(clamp(f))


## Orthogonal Wavelet Thresholding¶

We first consider the traditional wavelet thresholding method.

Parameters for the orthogonal wavelet transform.

In [51]:
Jmin = 4


Shortcuts for the foward and backward wavelet transforms.

In [52]:
from nt_toolbox.perform_wavelet_transf import *

wav  = lambda f  : perform_wavelet_transf(f, Jmin, +1)
iwav = lambda fw : perform_wavelet_transf(fw, Jmin, -1)


Display the original set of noisy coefficients.

In [53]:
plt.figure(figsize=(10,10))
plot_wavelet(wav(f), Jmin)
plt.show()


Denoting $\Ww$ and $\Ww^*$ the forward and backward wavelet transform, wavelet thresholding $\tilde f$ is defined as

$$\tilde f = \Ww^* \circ \theta_T \circ \Ww(f)$$

where $T>0$ is the threshold, that should be adapted to the noise level.

The thresholding operator is applied component-wise

$$\th_T(x)_i = \psi_T(x_i) x_i$$

where $\psi_T$ is an atenuation fonction. In this tour, we use the James Stein (JS) attenuation:

$$\psi_T(s) = \max\pa{ 0, 1-\frac{T^2}{s^2} }$$
In [54]:
psi = lambda s,T : np.maximum(1-T**2/np.maximum(abs(s)**2, 1e-9*np.ones(np.shape(s))), np.zeros(np.shape(s)))


Display the thresholding function $\th_T$.

In [55]:
s = np.linspace(-3, 3, 1024)

plt.plot(s, s*psi(s,1))
plt.plot(s, s, 'r--')

plt.show()


Thresholding operator.

In [56]:
theta = lambda x,T : psi(x, T)*x
ThreshWav = lambda f,T : iwav(theta(wav(f), T))


Test the thresholding.

In [57]:
T = 1.5*sigma

plt.figure(figsize=(5,5))
imageplot(clamp(ThreshWav(f, T)))


Exercise 1

Display the evolution of the denoising SNR when $T$ varies. Store in $f_{Thresh}$ the optimal denoising result.

In [58]:
run -i nt_solutions/denoisingwav_4_block/exo1

In [59]:
## Insert your code here.


Display the optimal thresolding.

In [60]:
plt.figure(figsize = (5,5))
imageplot(clamp(fThresh), "SNR = %.1f dB" %snr(f0, fThresh))


## Block Thresholding Operator¶

A block thresholding operator of coefficients $x=(x_i)_{i=1}^P \in \RR^P$ is defined using a partition $B$ into a set of blocks $b$

$$\{1,\ldots,P\} = \bigcup_{b \in B} b.$$

$$\forall i \in b, \quad \theta_T(x)_i = \psi_T\left( \norm{x_b}_2 \right) x_i$$

where $x_b = (x_j)_{j \in B} \in \RR^{\abs{b}}$. One thus thresholds the $\ell^2$ norm (the energy) of each block rather than each coefficient independently.

For image-based thresholding, we use a partition in square blocks of equal size $w \times w$.

The block size $w$.

In [61]:
w = 4
n = 256


Compute indexing of the blocks.

In [62]:
[X,Y,dX,dY] = np.meshgrid(np.arange(1,n-w+2,w),np.arange(1,n-w+2,w),np.arange(0,w),np.arange(0,w))
I = (X + dX-1) + (Y + dY-1)*n
for k in range(n//w):
for l in range(n//w):
I[k][l] = np.transpose(I[k][l])


Block extraction operator. It returns the set $\{x_b\}_{b \in B}$ of block-partitioned coefficients.

In [63]:
block = lambda x : np.ravel(x)[I]


Block reconstruction operator.

In [64]:
def assign(M,I,H):
M_temp = M
np.ravel(M_temp)[I] = H
return np.reshape(M_temp,(n,n))

iblock = lambda H : assign(np.zeros([n,n]), I, H)


Check that block extraction / reconstruction gives perfect reconstruction.

In [65]:
from numpy import linalg

print("Should be 0:", linalg.norm(f - iblock(block(f))))

Should be 0: 0.0


Compute the average energy of each block, and duplicate.

In [66]:
def energy(H):
H_tmp = np.copy(H)
for i in range(n//w):
for j in range(n//w):
H_tmp[i][j] = np.sqrt(np.mean(H_tmp[i][j]**2))#*np.ones([1,1])
return H_tmp


Block thresholding operator.

In [67]:
Thresh = lambda H,T : psi(energy(H), T)*H
ThreshBlock = lambda x,T : iblock(Thresh(block(x), T))


Exercise 2

Test the effect of block thresholding on the image $f_0$ itself, for increasing value of $T$. Of course directly thresholding the image has no interest, this is just to vizualize the effect.

In [68]:
run -i nt_solutions/denoisingwav_4_block/exo2