MNT : remove mlab.premca

tacaswell · tacaswell · commit f7113d49335b · 2015-01-10T20:14:38.000-05:00
Deprecated in dc13d25 (2009-11-03)
diff --git a/doc/api/api_changes/code_removal.rst b/doc/api/api_changes/code_removal.rst
@@ -75,3 +75,8 @@ Contained only a no-longer used port of functionality from PIL
 Remove ``mlab.FIFOBuffer``
 --------------------------
 Not used internally and not part of core mission of mpl.
+
+
+Remove ``mlab.prepca``
+----------------------
+Deprecated in 2009.
diff --git a/lib/matplotlib/mlab.py b/lib/matplotlib/mlab.py
@@ -160,19 +160,6 @@
     gtk.main()
 
 
-Deprecated functions
----------------------
-
-The following are deprecated; please import directly from numpy (with
-care--function signatures may differ):
-
-
-:func:`load`
-    Load ASCII file - use numpy.loadtxt
-
-:func:`save`
-    Save ASCII file - use numpy.savetxt
-
 """
 
 from __future__ import (absolute_import, division, print_function,
@@ -1623,45 +1610,6 @@ def longest_ones(x):
     return longest_contiguous_ones(x)
 
 
-def prepca(P, frac=0):
-    """
-
-    .. warning::
-
-        This function is deprecated -- please see class PCA instead
-
-    Compute the principal components of *P*.  *P* is a (*numVars*,
-    *numObs*) array.  *frac* is the minimum fraction of variance that a
-    component must contain to be included.
-
-    Return value is a tuple of the form (*Pcomponents*, *Trans*,
-    *fracVar*) where:
-
-      - *Pcomponents* : a (numVars, numObs) array
-
-      - *Trans* : the weights matrix, i.e., *Pcomponents* = *Trans* *
-         *P*
-
-      - *fracVar* : the fraction of the variance accounted for by each
-         component returned
-
-    A similar function of the same name was in the MATLAB
-    R13 Neural Network Toolbox but is not found in later versions;
-    its successor seems to be called "processpcs".
-    """
-    warnings.warn('This function is deprecated -- see class PCA instead')
-    U, s, v = np.linalg.svd(P)
-    varEach = s**2/P.shape[1]
-    totVar = varEach.sum()
-    fracVar = varEach/totVar
-    ind = slice((fracVar >= frac).sum())
-    # select the components that are greater
-    Trans = U[:, ind].transpose()
-    # The transformed data
-    Pcomponents = np.dot(Trans, P)
-    return Pcomponents, Trans, fracVar[ind]
-
-
 class PCA(object):
     def __init__(self, a, standardize=True):
         """
diff --git a/lib/matplotlib/pylab.py b/lib/matplotlib/pylab.py
@@ -253,7 +253,7 @@
 
 from matplotlib.mlab import window_hanning, window_none,  detrend, demean, \
      detrend_mean, detrend_none, detrend_linear, entropy, normpdf, \
-     find, longest_contiguous_ones, longest_ones, prepca, \
+     find, longest_contiguous_ones, longest_ones, \
      prctile, prctile_rank, \
      center_matrix, rk4, bivariate_normal, get_xyz_where, \
      get_sparse_matrix, dist, \
