From 5bae2046df8090bd2ad324c2a1625bc89267e9dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Johannes=20Sch=C3=B6nberger?= <jschoenberger@demuc.de>
Date: Mon, 27 May 2013 21:15:36 +0200
Subject: [PATCH] Add example to circle_perimeter drawing function

---
 skimage/draw/_draw.pyx | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/skimage/draw/_draw.pyx b/skimage/draw/_draw.pyx
index 94abe627..e1ae4a59 100644
--- a/skimage/draw/_draw.pyx
+++ b/skimage/draw/_draw.pyx
@@ -181,7 +181,6 @@ def circle_perimeter(Py_ssize_t cy, Py_ssize_t cx, Py_ssize_t radius,
         bresenham : Bresenham method
         andres : Andres method
 
-
     Returns
     -------
     rr, cc : (N,) ndarray of int
@@ -199,8 +198,27 @@ def circle_perimeter(Py_ssize_t cy, Py_ssize_t cx, Py_ssize_t radius,
     References
     ----------
     .. [1] J.E. Bresenham, "Algorithm for computer control of a digital
-        plotter", 4 (1965) 25-30.
-    .. [2] E. Andres, "Discrete circles, rings and spheres", 18 (1994) 695-706.
+           plotter", 4 (1965) 25-30.
+    .. [2] E. Andres, "Discrete circles, rings and spheres",
+           18 (1994) 695-706.
+
+    Examples
+    --------
+    >>> from skimage.draw import circle_perimeter
+    >>> img = np.zeros((10, 10), dtype=np.uint8)
+    >>> rr, cc = circle_perimeter(4, 4, 3)
+    >>> img[rr, cc] = 1
+    >>> img
+    array([[0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+           [0, 0, 0, 1, 1, 1, 0, 0, 0, 0],
+           [0, 0, 1, 0, 0, 0, 1, 0, 0, 0],
+           [0, 1, 0, 0, 0, 0, 0, 1, 0, 0],
+           [0, 1, 0, 0, 0, 0, 0, 1, 0, 0],
+           [0, 1, 0, 0, 0, 0, 0, 1, 0, 0],
+           [0, 0, 1, 0, 0, 0, 1, 0, 0, 0],
+           [0, 0, 0, 1, 1, 1, 0, 0, 0, 0],
+           [0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+           [0, 0, 0, 0, 0, 0, 0, 0, 0, 0]], dtype=uint8)
 
     """