Remove mlab.poly_below

dstansby · dstansby · commit 2c861a3beff3 · 2018-09-29T11:05:07.000+01:00
diff --git a/doc/api/next_api_changes/2018-09-18-DS.rst b/doc/api/next_api_changes/2018-09-18-DS.rst
@@ -37,4 +37,5 @@ in Matplotlib 2.2 has been removed. See below for a list:
 - `mlab.contiguous_regions` (use `.cbook.contiguous_regions` instead)
 - `mlab.is_closed_polygon`
 - `mlab.poly_between`
+- `mlab.poly_below`
 - `mlab.donothing_callback`
diff --git a/lib/matplotlib/mlab.py b/lib/matplotlib/mlab.py
@@ -2686,34 +2686,3 @@ def inside_poly(points, verts):
 
     # Check to see which points are contained within the Path
     return [idx for idx, p in enumerate(points) if poly.contains_point(p)]
-
-
-@cbook.deprecated("2.2")
-def poly_below(xmin, xs, ys):
-    """
-    Given a sequence of *xs* and *ys*, return the vertices of a
-    polygon that has a horizontal base at *xmin* and an upper bound at
-    the *ys*.  *xmin* is a scalar.
-
-    Intended for use with :meth:`matplotlib.axes.Axes.fill`, e.g.,::
-
-      xv, yv = poly_below(0, x, y)
-      ax.fill(xv, yv)
-    """
-    if any(isinstance(var, np.ma.MaskedArray) for var in [xs, ys]):
-        numpy = np.ma
-    else:
-        numpy = np
-
-    xs = numpy.asarray(xs)
-    ys = numpy.asarray(ys)
-    Nx = len(xs)
-    Ny = len(ys)
-    if Nx != Ny:
-        raise ValueError("'xs' and 'ys' must have the same length")
-    x = xmin*numpy.ones(2*Nx)
-    y = numpy.ones(2*Nx)
-    x[:Nx] = xs
-    y[:Nx] = ys
-    y[Nx:] = ys[::-1]
-    return x, y
diff --git a/lib/matplotlib/pylab.py b/lib/matplotlib/pylab.py
@@ -235,7 +235,6 @@
     frange,
     identity, inside_poly, ispower2, isvector, l1norm,
     l2norm, log2, movavg, norm_flat,
-    poly_below,
     rec2csv, rec_append_fields, rec_drop_fields, rec_join, rms_flat,
     window_hanning, window_none)
 
