ruff compliance for D409 and D410.

.ruff.toml

@@ -47,8 +47,6 @@ lint.ignore = [
     "D405",  # Section name should be properly capitalized
     "D406",  # Section name should end with a newline
     "D407",  # Missing dashed underline after section
-    "D409",  # Section underline should match the length of its name
-    "D410",  # Missing blank line after section
     "D411",  # Missing blank line before section
     "D412",  # No blank lines allowed between a section header and its content 
 

lib/iris/analysis/_regrid.py

@@ -988,6 +988,7 @@ def _create_cube(data, src, src_dims, tgt_coords, num_tgt_dims, regrid_callback)
     regrid_callback : callable
         The routine that will be used to calculate the interpolated
         values of any reference surfaces.
+
     Returns
     -------
     cube

lib/iris/analysis/cartography.py

@@ -65,7 +65,7 @@ def wrap_lons(lons, base, period):
         [-175.   30.  160.   75.]
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """
@@ -258,7 +258,7 @@ def get_xy_grids(cube):
         x, y = get_xy_grids(cube)
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """
@@ -289,7 +289,7 @@ def get_xy_contiguous_bounded_grids(cube):
         xs, ys = get_xy_contiguous_bounded_grids(cube)
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -499,7 +499,7 @@ def cosine_latitude_weights(cube):
         weights = np.sqrt(cosine_latitude_weights(cube))
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """

lib/iris/analysis/maths.py

@@ -107,7 +107,7 @@ def abs(cube, in_place=False):
         An instance of :class:`iris.cube.Cube`.
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -154,7 +154,7 @@ def intersection_of_cubes(cube, other_cube):
           cube1, cube2 = (intersections[0], intersections[1])
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -238,7 +238,7 @@ def add(cube, other, dim=None, in_place=False):
     iris.cube.Cube
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -293,7 +293,7 @@ def subtract(cube, other, dim=None, in_place=False):
     iris.cube.Cube
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -398,7 +398,7 @@ def multiply(cube, other, dim=None, in_place=False):
     iris.cube.Cube
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """
@@ -484,7 +484,7 @@ def divide(cube, other, dim=None, in_place=False):
     iris.cube.Cube
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """
@@ -550,7 +550,7 @@ def exponentiate(cube, exponent, in_place=False):
         An instance of :class:`iris.cube.Cube`.
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """
@@ -601,7 +601,7 @@ def exp(cube, in_place=False):
         An instance of :class:`iris.cube.Cube`.
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -631,7 +631,7 @@ def log(cube, in_place=False):
         An instance of :class:`iris.cube.Cube`.
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -665,7 +665,7 @@ def log2(cube, in_place=False):
         An instance of :class:`iris.cube.Cube`.
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 
@@ -695,7 +695,7 @@ def log10(cube, in_place=False):
         An instance of :class:`iris.cube.Cube`.
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 

lib/iris/analysis/trajectory.py

@@ -207,7 +207,7 @@ def interpolate(cube, sample_points, method=None):
         interpolated_cube = interpolate(cube, sample_points)
 
     Notes
-    ------
+    -----
     This function does not maintain laziness when called; it realises data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """

lib/iris/common/resolve.py

@@ -205,7 +205,7 @@ class Resolve:
         >>> resolver = Resolve(cube1, cube2)
         >>> results = [resolver.cube(data) for data in payload]
 
-    """  # noqa: D214
+    """  # noqa: D214, D410
 
     def __init__(self, lhs=None, rhs=None):
         """Resolve the provided ``lhs`` :class:`~iris.cube.Cube` operand and
@@ -2475,6 +2475,7 @@ def mapped(self):
                     time                        1860-06-01 00:00:00, bound=(1859-12-01 00:00:00, 1860-12-01 00:00:00)
                 Cell methods:
                     0                           time: mean (interval: 6 hour)
+
                 Attributes:
                     Conventions                 'CF-1.5'
                     Model scenario              'E1'
@@ -2542,6 +2543,7 @@ def shape(self):
                     time                        1860-06-01 00:00:00, bound=(1859-12-01 00:00:00, 1860-12-01 00:00:00)
                 Cell methods:
                     0                           time: mean (interval: 6 hour)
+
                 Attributes:
                     Conventions                 'CF-1.5'
                     Model scenario              'E1'

lib/iris/cube.py

@@ -4521,7 +4521,7 @@ def rolling_window(self, coord, aggregator, window, **kwargs):
             Notice that the forecast_period dimension now represents the 4
             possible windows of size 3 from the original cube.
 
-        """  # noqa: D214
+        """  # noqa: D214, D410
         # Update weights kwargs (if necessary) to handle different types of
         # weights
         weights_info = None

lib/iris/iterate.py

@@ -58,7 +58,7 @@ def izip(*cubes, **kwargs):
         ...    pass
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
     """

lib/iris/palette.py

@@ -117,7 +117,7 @@ def cmap_norm(cube):
         :class:`iris.palette.SymmetricNormalize`
 
     Notes
-    ------
+    -----
     This function maintains laziness when called; it does not realise data.
     See more at :doc:`/userguide/real_and_lazy_data`.
 

lib/iris/pandas.py

@@ -217,7 +217,7 @@ def as_cubes(
         :class:`~iris.coords.AncillaryVariable` objects.
 
     Returns
-    --------
+    -------
     :class:`~iris.cube.CubeList`
         One :class:`~iris.cube.Cube` for each column not referenced in
         `aux_coord_cols`/`cell_measure_cols`/`ancillary_variable_cols`.
@@ -584,7 +584,7 @@ def as_series(cube, copy=True):
     make sure it is not masked and use copy=False.
 
     Notes
-    ------
+    -----
     Since this function converts to/from a Pandas object, laziness will not be preserved.
 
     """
@@ -797,7 +797,7 @@ def as_data_frame(
     Name: surface_temperature, Length: 419904, dtype: float32
 
     Notes
-    ------
+    -----
     Since this function converts to/from a Pandas object, laziness will not be preserved.
 
     """