Let pyplot users find out if a figure number exists, or list fignums.

efiring · efiring · commit 95c7b70ba7a9 · 2009-03-08T06:37:06.000Z
svn path=/trunk/matplotlib/; revision=6966
diff --git a/CHANGELOG b/CHANGELOG
@@ -1,3 +1,5 @@
+2009-03-07 Add pyplot access to figure number list - EF
+
 2009-02-28 hashing of FontProperties accounts current rcParams - JJL
 
 2009-02-28 Prevent double-rendering of shared axis in twinx, twiny - EF
diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -19,7 +19,11 @@ list may help describe what changes may be necessary in your code.
 
 Changes for 0.98.x
 ==================
-* Removed numerix package.
+* Added new :func:`matplotlib.pyplot.fignum_exists` and
+  :func:`matplotlib.pyplot.get_fignums`; they merely expose
+  information that had been hidden in :mod:`matplotlib._pylab_helpers`.
+
+* Deprecated numerix package.
 
 * Added new :func:`matplotlib.image.imsave` and exposed it to the
   :mod:`matplotlib.pyplot` interface.
@@ -46,7 +50,7 @@ Changes for 0.98.x
         ================   ================
 
 
-* Removed the configobj and experiemtnal traits rc support
+* Removed the configobj and experimental traits rc support
 
 * Modified :func:`matplotlib.mlab.psd`, :func:`matplotlib.mlab.csd`,
   :func:`matplotlib.mlab.cohere`, and :func:`matplotlib.mlab.specgram`
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -273,6 +273,14 @@ def gcf():
     else:
         return figure()
 
+fignum_exists = _pylab_helpers.Gcf.has_fignum
+
+def get_fignums():
+    "Return a list of existing figure numbers."
+    fignums = _pylab_helpers.Gcf.figs.keys()
+    fignums.sort()
+    return fignums
+
 def get_current_fig_manager():
     figManager = _pylab_helpers.Gcf.get_active()
     if figManager is None:

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+2009-03-07 Add pyplot access to figure number list - EF`
	`2`	`+`
`1`	`3`	`2009-02-28 hashing of FontProperties accounts current rcParams - JJL`
`2`	`4`
`3`	`5`	`2009-02-28 Prevent double-rendering of shared axis in twinx, twiny - EF`