add comment

skimage/rank/_core16.pxd

@@ -91,9 +91,17 @@ char shift_x, char shift_y,int bitdepth):
 
     # allocate memory with malloc
     cdef int max_se = srows*scols
+
+    # number of element in each attack border
     cdef int n_se_n, n_se_s, n_se_e, n_se_w
 
+    # the current local histogram distribution
     cdef int* histo = <int*>malloc(maxbin * sizeof(int))
+
+    # these lists contain the relative pixel row and column for each of the 4 attack borders
+    # east, west, north and south
+    # e.g. se_e_r lists the rows of the east structuring element border
+
     cdef int* se_e_r = <int*>malloc(max_se * sizeof(int))
     cdef int* se_e_c = <int*>malloc(max_se * sizeof(int))
     cdef int* se_w_r = <int*>malloc(max_se * sizeof(int))

skimage/rank/_core16b.pxd

@@ -92,9 +92,17 @@ char shift_x, char shift_y,int bitdepth, int s0, int s1):
 
     # allocate memory with malloc
     cdef int max_se = srows*scols
+
+    # number of element in each attack border
     cdef int n_se_n, n_se_s, n_se_e, n_se_w
 
+    # the current local histogram distribution
     cdef int* histo = <int*>malloc(maxbin * sizeof(int))
+
+    # these lists contain the relative pixel row and column for each of the 4 attack borders
+    # east, west, north and south
+    # e.g. se_e_r lists the rows of the east structuring element border
+
     cdef int* se_e_r = <int*>malloc(max_se * sizeof(int))
     cdef int* se_e_c = <int*>malloc(max_se * sizeof(int))
     cdef int* se_w_r = <int*>malloc(max_se * sizeof(int))

skimage/rank/_core16p.pxd

@@ -88,9 +88,17 @@ char shift_x, char shift_y,int bitdepth, float p0, float p1):
 
     # allocate memory with malloc
     cdef int max_se = srows*scols
+
+    # number of element in each attack border
     cdef int n_se_n, n_se_s, n_se_e, n_se_w
 
+    # the current local histogram distribution
     cdef int* histo = <int*>malloc(maxbin * sizeof(int))
+
+    # these lists contain the relative pixel row and column for each of the 4 attack borders
+    # east, west, north and south
+    # e.g. se_e_r lists the rows of the east structuring element border
+
     cdef int* se_e_r = <int*>malloc(max_se * sizeof(int))
     cdef int* se_e_c = <int*>malloc(max_se * sizeof(int))
     cdef int* se_w_r = <int*>malloc(max_se * sizeof(int))

skimage/rank/_core8.pxd

@@ -81,9 +81,17 @@ char shift_x, char shift_y):
 
     # allocate memory with malloc
     cdef int max_se = srows*scols
+
+    # number of element in each attack border
     cdef int n_se_n, n_se_s, n_se_e, n_se_w
 
+    # the current local histogram distribution
     cdef int* histo = <int*>malloc(256 * sizeof(int))
+
+    # these lists contain the relative pixel row and column for each of the 4 attack borders
+    # east, west, north and south
+    # e.g. se_e_r lists the rows of the east structuring element border
+
     cdef int* se_e_r = <int*>malloc(max_se * sizeof(int))
     cdef int* se_e_c = <int*>malloc(max_se * sizeof(int))
     cdef int* se_w_r = <int*>malloc(max_se * sizeof(int))

skimage/rank/_core8p.pxd

@@ -78,9 +78,17 @@ char shift_x, char shift_y, float p0, float p1):
 
     # allocate memory with malloc
     cdef int max_se = srows*scols
+
+    # number of element in each attack border
     cdef int n_se_n, n_se_s, n_se_e, n_se_w
 
+    # the current local histogram distribution
     cdef int* histo = <int*>malloc(256 * sizeof(int))
+
+    # these lists contain the relative pixel row and column for each of the 4 attack borders
+    # east, west, north and south
+    # e.g. se_e_r lists the rows of the east structuring element border
+
     cdef int* se_e_r = <int*>malloc(max_se * sizeof(int))
     cdef int* se_e_c = <int*>malloc(max_se * sizeof(int))
     cdef int* se_w_r = <int*>malloc(max_se * sizeof(int))