dev

Author: davidhassell

cf/data/data.py

@@ -9901,7 +9901,19 @@ def to_dask_array(self, apply_mask_hardness=False, _asanyarray=True):
                 If True then force the mask hardness of the returned
                 array to be that given by the `hardmask` attribute.
 
-            {{_asanyarray: `bool`, optional}}
+            _asanyarray: `bool`, optional
+               If True (the default) and the `__asanyarray__`
+               attribute is also `True`, then a `cf_asanyarray`
+               operation is added to the graph of the returned Dask
+               array. If False then this operation is not added.
+
+               In general, setting *_asanyarray* to False should only
+               be done if it is known that a) the returned Dask array
+               is never going to be computed; or b) it is not
+               necessary to add a `cf_asanyarray` operation in lieu of
+               its functionality being implemented by a new Dask graph
+               layer that is going to be created at a later stage. See
+               `cf.data.dask_utils.cf_asanyarray` for further details.
 
                 .. versionadded:: NEXTVERSION
 
@@ -11968,11 +11980,11 @@ def todict(
 
         .. versionadded:: 3.15.0
 
-        .. seealso:: `to_dask_array`, `tolist`
+        .. seealso:: `to_dask_array`
 
         :Parameters:
 
-            `optimize_graph`: `bool`
+            optimize_graph: `bool`
                 If True, the default, then prior to being converted to
                 a dictionary, the graph is optimised to remove unused
                 chunks. Note that optimising the graph can add a
@@ -11984,7 +11996,12 @@ def todict(
 
                 .. versionadded:: NEXTVERSION
 
-            {{_asanyarray: `bool`, optional}}
+            _asanyarray: `bool`, optional
+               If True (the default) and the `__asanyarray__`
+               attribute is also `True`, then a `cf_asanyarray`
+               operation is added to the dictionary representation of
+               the Dask graph. If False then this operation is not
+               added. See `to_dask_array` for details.
 
                 .. versionadded:: NEXTVERSION
 

cf/docstring/docstring.py

@@ -632,21 +632,6 @@
     "{{to_size: `int`, optional}}": """to_size: `int`, optional
                 Pad the axis after so that the new axis has the given
                 size.""",
-    # REVIEW: getitem: `_docstring_substitution_definitions`: 'asanyarray'
-    # asanyarray
-    "{{_asanyarray: `bool`, optional}": """_asanyarray: `bool`, optional
-               If True (the default) and the `__asanyarray__`
-               attribute is also `True`, then add a `cf_asanyarray`
-               operation to the graph of the returned Dask array. If
-               False then this operation is not added. Setting
-               *_asanyarray* to False should only be done if it is
-               known that a) the returned Dask array is never going to
-               be computed; or b) it is not necessary to add a
-               `cf_asanyarray` operation in lieu of its functionality
-               being implemented by a new Dask graph layer that is
-               going to be created at a later stage. See
-               `cf.data.dask_utils.cf_asanyarray` for further
-               details.""",
     # _get_array index
     "{{index: `tuple` or `None`, optional}}": """index: `tuple` or `None`, optional
                Provide the indices that define the subspace. If `None`

cf/mixin/propertiesdata.py

@@ -4692,39 +4692,13 @@ def log(self, base=None, inplace=False, i=False):
             delete_props=True,
         )
 
-    # REVIEW: getitem: `to_dask_array`: new keyword 'asanyarray'
-    def to_dask_array(self, apply_mask_hardness=False, _asanyarray=None):
+    def to_dask_array(self):
         """Convert the data to a `dask` array.
 
-        .. warning:: By default, the mask hardness of the returned
-                     dask array might not be the same as that
-                     specified by the `hardmask` attribute.
-
-                     This could cause problems if a subsequent
-                     operation on the returned dask array involves the
-                     un-masking of masked values (such as by indexed
-                     assignment).
-
-                     To guarantee that the mask hardness of the
-                     returned dask array is correct, set the
-                     *apply_mask_hardness* parameter to True.
-
         .. versionadded:: 3.14.0
 
         .. seealso:: `cf.Data.to_dask_array`
 
-        :Parameters:
-
-            apply_mask_hardness: `bool`, optional
-                If True then force the mask hardness of the returned
-                array to be that given by the `hardmask` attribute.
-
-                .. versionadded:: NEXTVERSION
-
-            {{_asanyarray: `bool`, optional}}
-
-                .. versionadded:: NEXTVERSION
-
         :Returns:
 
             `dask.array.Array`
@@ -4743,9 +4717,7 @@ def to_dask_array(self, apply_mask_hardness=False, _asanyarray=None):
         if data is None:
             raise ValueError("Can't get dask array when there is no data")
 
-        return data.to_dask_array(
-            apply_mask_hardness=apply_mask_hardness, _asanyarray=_asanyarray
-        )
+        return data.to_dask_array()
 
     @_deprecated_kwarg_check("i", version="3.0.0", removed_at="4.0.0")
     @_inplace_enabled(default=False)