DOC: Use explicit args in SpatialImage.orthoview

TEST: Test vlim functionality

Author: effigies

nibabel/spatialimages.py

@@ -589,9 +589,18 @@ def __getitem__(self, idx):
             "slicing image array data with `img.dataobj[slice]` or "
             "`img.get_data()[slice]`")
 
-    def orthoview(self, **kwargs):
+    def orthoview(self, axes=None, vlim=None):
         """Plot the image using OrthoSlicer3D
 
+        Parameters
+        ------------------
+        axes : tuple of mpl.Axes or None, optional
+            3 or 4 axes instances for the 3 slices plus volumes,
+            or None (default).
+        vlim : array-like or None, optional
+            Value limits to display image and time series. Can be None
+            (default) to derive limits from data.
+
         Returns
         -------
         viewer : instance of OrthoSlicer3D
@@ -603,8 +612,8 @@ def orthoview(self, **kwargs):
         consider using viewer.show() (equivalently plt.show()) to show
         the figure.
         """
-        return OrthoSlicer3D(self.dataobj, self.affine,
-                             title=self.get_filename(), **kwargs)
+        return OrthoSlicer3D(self.dataobj, self.affine, axes=axes,
+                             title=self.get_filename(), vlim=vlim)
 
     def as_reoriented(self, ornt):
         """Apply an orientation change and return a new image

nibabel/tests/test_viewers.py

@@ -68,6 +68,14 @@ def test_viewer():
     v.close()
     v._draw()  # should be safe
 
+    # Manually set value limits
+    vlim = np.array([-20, 20])
+    v = OrthoSlicer3D(data, vlim=vlim)
+    assert_array_equal(v._clim, vlim)
+    for im in v._ims:
+        assert_array_equal(im.get_clim(), vlim)
+    assert_array_equal(v._axes[3].get_ylim(), vlim)
+
     # non-multi-volume
     v = OrthoSlicer3D(data[:, :, :, 0])
     v._on_scroll(nt('event', 'button inaxes key')('up', v._axes[0], 'shift'))