unified docstring terminology for structured_domain volumes

nifty5/domains/structured_domain.py

@@ -30,7 +30,7 @@ class StructuredDomain(Domain):
 
     @property
     def scalar_dvol(self):
-        """float or None : uniform cell volume, if applicable
+        """float or None : uniform pixel volume, if applicable
 
         Returns the volume factors of this domain as a floating
         point scalar, if the volume factors are all identical, otherwise
@@ -40,7 +40,7 @@ class StructuredDomain(Domain):
 
     @property
     def dvol(self):
-        """float or numpy.ndarray(dtype=float): Volume factors
+        """float or numpy.ndarray(dtype=float): pixel volume(s)
 
         Returns the volume factors of this domain, either as a floating
         point scalar (if the volume factors are all identical) or as a

nifty5/field.py

@@ -284,12 +284,12 @@ class Field(object):
         return res
 
     def weight(self, power=1, spaces=None):
-        """Weights the pixels of `self` with their invidual pixel-volume.
+        """Weights the pixels of `self` with their invidual pixel volumes.
 
         Parameters
         ----------
         power : number
-            The pixels get weighted with the volume-factor**power.
+            The pixel values get multiplied with their volume-factor**power.
 
         spaces : None, int or tuple of int
             Determines on which sub-domain the operation takes place.