lots of interactive fixes and an INTERACTIVE howto

jdh2358 · jdh2358 · commit cd0e1f3e5fd6 · 2003-05-12T19:47:22.000Z
svn path=/trunk/matplotlib/; revision=13
diff --git a/INTERACTIVE b/INTERACTIVE
@@ -0,0 +1,74 @@
+To use matplotlib interactively from the prompt, you need a special
+interpreter that doesn't enter the gtk mainloop.  One is provided in
+examples/interactive.py.  The coew functionality of this interpreter
+was provided by Brian McErlean and John Finlay.  See the header for
+more info.
+
+This will only work if you have pygtk compiled with threading.  See
+instrubtions below.
+
+WIN32 Users
+
+  I haven't tested the interactive shell on win32.  It is apparently
+  possible, but not easy, to get threading to work on win32.  See
+  http://www.async.com.br/faq/pygtk/index.py?req=show&file=faq21.003.htp
+
+LINUX/UNIX Users:
+
+  To compile pygtk with threading, I recommend you make a backup of your
+  existing pygtk install tree and completely remove it
+
+  eg 
+    > cd /your/path/to/python/site-packages
+    > cp -a gtk-2.0 /some/backup/dir
+    > rm -rf gtk-2.0
+
+  This is because I have found that recompiling pygtk with threads on top
+  of an existing installation w/o threads does not enable threads.  Your
+  milage may vary.
+
+  Then from a clean pygtk src tree
+
+   > ./configure --enable-thread  # and any other flags
+   > make install
+
+TESTING threading
+
+  To test whether this install worked, try running this script
+
+    import pygtk
+    pygtk.require('2.0')
+    import gtk
+
+    import threading, time
+
+    def func():
+      n = 0
+      while 1:
+        print n
+        n += 1
+        time.sleep(0.1)
+
+    gtk.threads_init()
+    threading.Thread(target=func).start()
+    gtk.mainloop()
+
+
+
+  If it spits numbers back at you, you're golden.
+
+TESTING with matplotlib
+
+  You should be able to make a simple plot with
+
+  > cd examples
+  > ./interactive.py
+  Welcome to matplotlib.
+
+      help(matlab)   -- shows a list of all matlab compatible commands provided
+      help(plotting) -- shows a list of plot specific commands
+
+  >> plot([1,2,3])
+
+
+
diff --git a/README b/README
@@ -17,6 +17,10 @@ INSTALL
 
   If you have the requirements, just do 'python setup.py install'.  
 
+  If you want to use matplotlib interactively from the prompt, see
+  INTERACTIVE
+
+
 EXAMPLES
 
   See the examples in the examples dir.
diff --git a/TODO b/TODO
@@ -7,11 +7,15 @@
      command line, but the GUI needs to be updated to allow resolution
      to be set along with filename
 
--- fix text size calculations using pango layouts: DONE
+-- fix text size calculations using pango layouts: 
+
+     DONE
  
 -- add a font selection dialog for the axis text
 
--- enable vertical rendering for ylabels: DONE
+-- enable vertical rendering for ylabels: 
+     
+     DONE
 
 -- enable anti aliasing for fonts: DONE with pango
 
@@ -21,7 +25,9 @@
 -- add a color selection dialog for the background, lines, and text
 
 -- allow interactive control of the plot from the python shell after
-   it has been launched using the cookbook thread recipe.  DONE
+   it has been launched using the cookbook thread recipe.  
+
+      DONE
 
 -- write a user guide
 
@@ -36,7 +42,7 @@
    working cross platform.  According to the docs this is better
    handled using size hints -- but I don't know how to use them, yet.
 
--- vlines and hlines disappear on in some instance due to improper
+-- vlines and hlines disappear in some instance due to improper
    clipping
 
 -- One the errorbar demo the hlines do not always appear symmetric
@@ -45,8 +51,13 @@
 
 -- Clip patches outside view port
 
+   DONE
+
 -- Allow background color to be set for subplots  
 
+   DONE: subplot now takes a kwarg axisbg with color format string
+   just as axes does
+
 -- Expose bug on win32 for axis text
 
 -- Fix floating point bug on panx/pany where 0 is computed as 5e-17
@@ -60,5 +71,32 @@
 
    plot(t1, p1, 'o', t2, p2, ogtt.times, ogtt.cpeptide, 's')
 
+   DONE: 2003-05-12 fixed _grab_next_args in figure.py 
+
 -- xlabel is lower than it needs to be
 
+    UPDATE: made a change -- make sure this works
+
+-- interactive setting of x/ylabels doesn't redraw all labels unless
+   you click a forced redraw
+
+   DONE 2003-05-12  Removed some of the state handling of text labels
+   so they always redraw
+
+-- When you change a property using the OO interface in interactive,
+   the figure doesn't know to redraw.  
+
+   Some possibilities:
+
+   1) redraw on all interactive commands.  kind of heavy handled
+
+   2) override setattr on artist to signal a redraw event. kind of
+      heavy handled
+
+   3) allow derived classes to signal redraw events when nexessary.
+      kind of code intrusive.
+
+
+-- on exit from interactive.py call gtk. mainquit
+
+-- pan zoom on axes_demo flushes insets
diff --git a/examples/axes_demo.py b/examples/axes_demo.py
@@ -18,7 +18,6 @@
     axis([0, 1, 1.1*min(s), 2*max(s) ])
     xlabel('time (s)')
     ylabel('current (nA)')
-
     title('Gaussian white noise convolved with an exponential function')
 
 # Make a histogram probability density inset
@@ -38,5 +37,4 @@
     set(a, 'xticks', [])
     set(a, 'yticks', [])
 
-
 show()
diff --git a/examples/interactive.py b/examples/interactive.py
@@ -178,18 +178,22 @@ def signal_handler (*args):
     interpreter.feed ("from matplotlib import matlab")
     interpreter.feed ("from matplotlib.matlab import *")
     interpreter.feed ("sys.path.append('.')")
+
+    # turn off rendering until end of script
+    matplotlib.matlab.interactive = 0
     if len (sys.argv) > 1:
         for line in file(sys.argv[1], 'r'):
-            print '>>', line.rstrip(),
+            if line.lstrip().find('show()')==0: continue
+            print '>>', line.rstrip()
             interpreter.feed(line)
-        gcf().draw()
+        #gcf().draw()
+    interpreter.feed ("ShowOn().set(1)")
     print """Welcome to matplotlib.
 
     help(matlab)   -- shows a list of all matlab compatible commands provided
     help(plotting) -- shows a list of plot specific commands
     """ 
 
-    matplotlib.matlab.interactive = 1
 
     try:
         while 1:
