DOC: Note about pixel placement in imshow

matplotlib · tacaswell · Apr 11, 2015 · Apr 7, 2015 · Apr 7, 2015 · Apr 7, 2015
commit 604a02e999654cdadcdb196cbd5ad8877f105b2b
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -4682,6 +4682,12 @@ def imshow(self, X, cmap=None, norm=None, aspect=None,
         See also
         --------
         matshow : Plot a matrix or an array as an image.
+
+        Notes
+        -----
+        Unless *extent* is used, pixel centers will be located at integer
+        coordinates. In other words: the origin will coincide with the center
+        of pixel (0, 0).
 
         Examples
         --------