From 0fbbed525f1471dec9589a0fc118a3277c0df6b4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Johannes=20Sch=C3=B6nberger?= <hannesschoenberger@gmail.com>
Date: Sun, 12 Aug 2012 10:37:48 +0200
Subject: [PATCH] improve doc string of local_binary_pattern function

---
 skimage/feature/texture.py | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/skimage/feature/texture.py b/skimage/feature/texture.py
index 7eff0d30..101f4a5a 100644
--- a/skimage/feature/texture.py
+++ b/skimage/feature/texture.py
@@ -228,12 +228,13 @@ def greycoprops(P, prop='contrast'):
 
 
 def local_binary_pattern(image, P, R, method='default'):
-    """Texture classification using gray scale and rotation invariant LBP
-    (Local Binary Patterns).
+    """Gray scale and rotation invariant LBP (Local Binary Patterns).
+
+    LBP is an invariant descriptor that can be used for texture classification.
 
     Parameters
     ----------
-    image : NxM array
+    image : (N, M) array
         graylevel image
     P : int
         number of circularly symmetric neighbour set points (quantization of the
@@ -254,15 +255,16 @@ def local_binary_pattern(image, P, R, method='default'):
 
     Returns
     -------
-    output : NxM array
+    output : (N, M) array
         LBP image
 
     References
     ----------
-    Timo Ojala, Matti Pietikainen, Topi Maenpaa. Multiresolution Gray-Scale and
-        Rotation Invariant Texture Classification with Local Binary Patterns.
-        http://www.rafbis.it/biplab15/images/stories/docenti/Danielriccio/\
-        Articoliriferimento/LBP.pdf, 2002.
+    .. [1] Multiresolution Gray-Scale and Rotation Invariant Texture
+           Classification with Local Binary Patterns.
+           Timo Ojala, Matti Pietikainen, Topi Maenpaa.
+           http://www.rafbis.it/biplab15/images/stories/docenti/Danielriccio/\
+           Articoliriferimento/LBP.pdf, 2002.
     """
 
     methods = {