Merge branch 'rel/3.9.0' into 'v3.9'

Rel/3.9.0

See merge request fsl/fslpy!334

CHANGELOG.rst

@@ -3,8 +3,8 @@ order.
 
 
 
-3.9.0 (Monday 11th April 2022)
-------------------------------
+3.9.0 (Tuesday 12th April 2022)
+-------------------------------
 
 
 Added

fsl/data/atlases.py

@@ -880,10 +880,17 @@ class LabelAtlas(Atlas):
                        of each present value. The proportions are returned as
                        values between 0 and 100.
 
+        .. note:: Calling this method will cause the atlas image data to be
+                  loaded into memory.
+
         .. note:: Use the :meth:`find` method to retrieve the ``AtlasLabel``
                   associated with each returned value.
         """
 
+        # Mask-based indexing requires the image
+        # data to be loaded into memory
+        self.data
+
         # Extract the values that are in
         # the mask, and their corresponding
         # mask weights