Remove mlab.recs_join

dstansby · dstansby · commit 6de5073ee0b9 · 2018-09-29T11:05:08.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
@@ -41,6 +41,7 @@ in Matplotlib 2.2 has been removed. See below for a list:
 - `mlab.inside_poly`
 - `mlab.rec2csv` (use numpy.recarray.tofile instead)
 - `mlab.rec2text` (use numpy.recarray.tofile instead)
+- `mlab.recs_join`
 - `mlab.csvformat_factory`
 - `mlab.get_formatd`
 - `mlab.FormatDatetime` (use datetime.strftime instead)
diff --git a/lib/matplotlib/mlab.py b/lib/matplotlib/mlab.py
@@ -1821,65 +1821,6 @@ def mapped_r2field(name):
     return newrec
 
 
-@cbook.deprecated("2.2")
-def recs_join(key, name, recs, jointype='outer', missing=0., postfixes=None):
-    """
-    Join a sequence of record arrays on single column key.
-
-    This function only joins a single column of the multiple record arrays
-
-    *key*
-      is the column name that acts as a key
-
-    *name*
-      is the name of the column that we want to join
-
-    *recs*
-      is a list of record arrays to join
-
-    *jointype*
-      is a string 'inner' or 'outer'
-
-    *missing*
-      is what any missing field is replaced by
-
-    *postfixes*
-      if not None, a len recs sequence of postfixes
-
-    returns a record array with columns [rowkey, name0, name1, ... namen-1].
-    or if postfixes [PF0, PF1, ..., PFN-1] are supplied,
-    [rowkey, namePF0, namePF1, ... namePFN-1].
-
-    Example::
-
-      r = recs_join("date", "close", recs=[r0, r1], missing=0.)
-
-    """
-    results = []
-    aligned_iters = cbook.align_iterators(operator.attrgetter(key),
-                                          *[iter(r) for r in recs])
-
-    def extract(r):
-        if r is None:
-            return missing
-        else:
-            return r[name]
-
-    if jointype == "outer":
-        for rowkey, row in aligned_iters:
-            results.append([rowkey] + list(map(extract, row)))
-    elif jointype == "inner":
-        for rowkey, row in aligned_iters:
-            if None not in row:  # throw out any Nones
-                results.append([rowkey] + list(map(extract, row)))
-
-    if postfixes is None:
-        postfixes = ['%d' % i for i in range(len(recs))]
-    names = ",".join([key] + ["%s%s" % (name, postfix)
-                              for postfix in postfixes])
-    return np.rec.fromrecords(results, names=names)
-
-
 @cbook.deprecated("2.2")
 def csv2rec(fname, comments='#', skiprows=0, checkrows=0, delimiter=',',
             converterd=None, names=None, missing='', missingd=None,
