Update docs, function name

Author: effigies

nibabel/funcs.py

@@ -206,7 +206,7 @@ def as_closest_canonical(img, enforce_diag=False):
        unmodified.
     '''
     # Get the image class to transform the data for us
-    img = img.transpose(io_orientation(img.affine))
+    img = img.as_reoriented(io_orientation(img.affine))
 
     # however, the affine may not be diagonal
     if enforce_diag and not _aff_is_diag(img.affine):

nibabel/nifti1.py

@@ -1969,10 +1969,10 @@ def set_sform(self, affine, code=None, **kwargs):
             else:
                 self._affine[:] = self._header.get_best_affine()
 
-    def transpose(self, ornt):
+    def as_reoriented(self, ornt):
         """Apply an orientation change and return a new image
 
-        If image already has orientation, return the original image, unchanged
+        If ornt is identity transform, return the original image, unchanged
 
         Parameters
         ----------
@@ -1985,7 +1985,7 @@ def transpose(self, ornt):
            the transpose that needs to be done to the implied array, as in
            ``arr.transpose(ornt[:,0])``
         """
-        img = super(Nifti1Pair, self).transpose(ornt)
+        img = super(Nifti1Pair, self).as_reoriented(ornt)
 
         if img is self:
             return img

nibabel/spatialimages.py

@@ -486,10 +486,10 @@ def orthoview(self):
                              title=self.get_filename())
 
 
-    def transpose(self, ornt):
+    def as_reoriented(self, ornt):
         """Apply an orientation change and return a new image
 
-        If image already has orientation, return the original image, unchanged
+        If ornt is identity transform, return the original image, unchanged
 
         Parameters
         ----------