removed pylab load and save

jdh2358 · jdh2358 · commit 8539b65ae483 · 2009-08-06T11:53:23.000Z
svn path=/branches/v0_99_maint/; revision=7396
diff --git a/CHANGELOG b/CHANGELOG
@@ -1,6 +1,11 @@
+
 2009-08-03 Fixed boilerplate.py so it doesn't break the ReST docs. - JKS
 
-======================================================================
+
+2009-08-03 pylab no longer provides a load and save function.  These
+           are available in matplotlib.mlab, or you can use
+           numpy.loadtxt and numpy.savetxt for text files, or np.save
+           and np.load for binary numpy arrays. - JDH
 
 2009-07-31 Tagging 0.99.0.rc1 at 7314 - MGD
 
diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -18,8 +18,13 @@ list may help describe what changes may be necessary in your code.
 .. _configobj: http://www.voidspace.org.uk/python/configobj.html
 .. _`enthought.traits`: http://code.enthought.com/projects/traits
 
-Changes beyond 0.98.x
-=====================
+Changes in 0.99
+======================
+
+* pylab no longer provides a load and save function.  These are
+  available in matplotlib.mlab, or you can use numpy.loadtxt and
+  numpy.savetxt for text files, or np.save and np.load for binary
+  numpy arrays.
 
 * User-generated colormaps can now be added to the set recognized
   by :func:`matplotlib.cm.get_cmap`.  Colormaps can be made the
diff --git a/lib/matplotlib/pylab.py b/lib/matplotlib/pylab.py
@@ -236,6 +236,9 @@
      base_repr, binary_repr, log2, ispower2, \
      rec_append_fields, rec_drop_fields, rec_join, csv2rec, rec2csv, isvector
 
+import matplotlib.mlab as mlab
+import matplotlib.cbook as cbook
+
 from numpy import *
 from numpy.fft import *
 from numpy.random import *
@@ -248,3 +251,25 @@
 import numpy as np
 import numpy.ma as ma
 
+def load(*args, **kwargs): 
+    raise  NotImplementedError(load.__doc__)   		
+load.__doc__ = """\
+    pylab no longer provides a load function, though the old pylab
+    function is still available as matplotlib.mlab.load (you can refer
+    to it in pylab as "mlab.load").  However, for plain text files, we
+    recommend numpy.loadtxt, which was inspired by the old pylab.load
+    but now has more features.  For loading numpy arrays, we recommend
+    numpy.load, and its analog numpy.save, which are available in
+    pylab as np.load and np.save.
+    """
+
+
+def save(*args, **kwargs): 
+    raise  NotImplementedError(save.__doc__)   		
+save.__doc__ = """\
+    pylab no longer provides a save function, though the old pylab
+    function is still available as matplotlib.mlab.save (you can still
+    refer to it in pylab as "mlab.save").  However, for plain text
+    files, we recommend numpy.savetxt.  For saving numpy arrays,
+    we recommend numpy.save, and its analog numpy.load, which are
+    available in pylab as np.save and np.load."""
