From 50a18383df275d3f131b275baccd8e8f63c58fac Mon Sep 17 00:00:00 2001
From: Ankit Agrawal <aaaagrawal@iitb.ac.in>
Date: Wed, 31 Jul 2013 12:40:49 +0530
Subject: [PATCH] Adding doc for the different modes of
 _slanted_integral_inage_modes

---
 skimage/feature/censure.py | 42 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/skimage/feature/censure.py b/skimage/feature/censure.py
index 9997ad50..cea2b4c3 100644
--- a/skimage/feature/censure.py
+++ b/skimage/feature/censure.py
@@ -54,12 +54,34 @@ def _get_filtered_image(image, no_of_scales, mode):
 
 def _slanted_integral_image_modes(img, mode=1):
     if mode == 1:
+        """
+        The following figures describe area that is summed up to calculate
+        the value at point @ in slanted integral image.
+         _________________
+        |********/        |  
+        |*******/         |
+        |******/          |
+        |-----@           |
+        |                 |
+        |                 |
+        |_________________|
+        """
         image = np.copy(img, order='C')
         mode1 = np.zeros((image.shape[0] + 1, image.shape[1]), order='C')
         _slanted_integral_image(image, mode1)
         return mode1[1:, :]
 
     elif mode == 2:
+        """
+         _________________
+        |                 |
+        |                 |
+        |                 |
+        |           @_____|
+        |          /******|
+        |         /*******|
+        |________/________| 
+        """
         image = np.copy(img, order='C')
         image = np.fliplr(image)
         image = np.flipud(image)
@@ -72,6 +94,16 @@ def _slanted_integral_image_modes(img, mode=1):
         return mode2
 
     elif mode == 3:
+        """
+         _________________
+        |                 |
+        |\\               |
+        |*\\              |
+        |**\\             |
+        |***@             |
+        |***|             |
+        |___|_____________| 
+        """
         image = np.copy(img, order='C')
         image = np.flipud(image)
         image = image.T
@@ -83,6 +115,16 @@ def _slanted_integral_image_modes(img, mode=1):
         return mode3
 
     else:
+        """
+         ________________
+        |           |****|
+        |           |****|
+        |           @****|
+        |            \\**|
+        |             \\*|
+        |              \\|
+        |________________|
+        """
         image = np.copy(img, order='C')
         image = np.fliplr(image)
         image = image.T