python-matplotlib 1.4.2-3.1 / usr / lib / python2.7 / dist-packages / matplotlib / backends / web_backend / nbagg_uat.ipynb

{
 "metadata": {
  "name": "",
  "signature": "sha256:1d491e506b54b126f6971897d3249a9e6f96f9d50bf4e4ba8d179c6b7b1aefa8"
 },
 "nbformat": 3,
 "nbformat_minor": 0,
 "worksheets": [
  {
   "cells": [
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "## UAT for NbAgg backend.\n",
      "\n",
      "The first line simply reloads matplotlib, uses the nbagg backend and then reloads the backend, just to ensure we have the latest modification to the backend code. Note: The underlying JavaScript will not be updated by this process, so a refresh of the browser after clearing the output and saving is necessary to clear everything fully."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "import matplotlib\n",
      "reload(matplotlib)\n",
      "\n",
      "matplotlib.use('nbagg')\n",
      "\n",
      "import matplotlib.backends.backend_nbagg\n",
      "reload(matplotlib.backends.backend_nbagg)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 1 - Simple figure creation using pyplot\n",
      "\n",
      "Should produce a figure window which is interactive with the pan and zoom buttons. (Do not press the close button, but any others may be used)."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "import matplotlib.backends.backend_webagg_core\n",
      "reload(matplotlib.backends.backend_webagg_core)\n",
      "\n",
      "import matplotlib.pyplot as plt\n",
      "plt.interactive(False)\n",
      "\n",
      "fig1 = plt.figure()\n",
      "plt.plot(range(10))\n",
      "\n",
      "plt.show()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 2 - Creation of another figure, without the need to do plt.figure.\n",
      "\n",
      "As above, a new figure should be created."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.plot([3, 2, 1])\n",
      "plt.show()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 3 - Connection info\n",
      "\n",
      "The printout should show that there are two figures which have active CommSockets, and no figures pending show."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print(matplotlib.backends.backend_nbagg.connection_info())"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 4 - Closing figures\n",
      "\n",
      "Closing a specific figure instance should turn the figure into a plain image - the UI should have been removed. In this case, scroll back to the first figure and assert this is the case."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.close(fig1)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 5 - No show without plt.show in non-interactive mode\n",
      "\n",
      "Simply doing a plt.plot should not show a new figure, nor indeed update an existing one (easily verified in UAT 6).\n",
      "The output should simply be a list of Line2D instances."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.plot(range(10))"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 6 - Connection information\n",
      "\n",
      "We just created a new figure, but didn't show it. Connection info should no longer have \"Figure 1\" (as we closed it in UAT 4) and should have figure 2 and 3, with Figure 3 without any connections. There should be 1 figure pending."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "print matplotlib.backends.backend_nbagg.connection_info()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 7 - Show of previously created figure\n",
      "\n",
      "We should be able to show a figure we've previously created. The following should produce two figure windows."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.show()\n",
      "plt.figure()\n",
      "plt.plot(range(5))\n",
      "plt.show()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 8 - Interactive mode\n",
      "\n",
      "In interactive mode, creating a line should result in a figure being shown."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.interactive(True)\n",
      "plt.figure()\n",
      "plt.plot([3, 2, 1])"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Subsequent lines should be added to the existing figure, rather than creating a new one."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.plot(range(3))"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "Disable interactive mode again."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.interactive(False)"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 9 - Multiple shows\n",
      "\n",
      "Unlike most of the other matplotlib backends, we may want to see a figure multiple times (with or without synchronisation between the views, though the former is not yet implemented). Assert that plt.gcf().canvas.manager.reshow() results in another figure window which is synchronised upon pan & zoom."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "plt.gcf().canvas.manager.reshow()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 10 - Saving notebook\n",
      "\n",
      "Saving the notebook (with CTRL+S or File->Save) should result in the saved notebook having static versions of the figues embedded within. The image should be the last update from user interaction and interactive plotting. (check by converting with ``ipython nbconvert <notebook>``)"
     ]
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 11 - Creation of a new figure on second show\n",
      "\n",
      "Create a figure, show it, then create a new axes and show it. The result should be a new figure.\n",
      "\n",
      "**BUG: Sometimes this doesn't work - not sure why (@pelson).**"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "fig = plt.figure()\n",
      "plt.axes()\n",
      "plt.show()\n",
      "\n",
      "plt.plot([1, 2, 3])\n",
      "plt.show()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 12 - OO interface\n",
      "\n",
      "Should produce a new figure and plot it."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "from matplotlib.backends.backend_nbagg import new_figure_manager,show\n",
      "\n",
      "manager = new_figure_manager(1000)\n",
      "fig = manager.canvas.figure\n",
      "ax = fig.add_subplot(1,1,1)\n",
      "ax.plot([1,2,3])\n",
      "fig.show()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "## UAT 13 - Animation\n",
      "\n",
      "The following should generate an animated line:"
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "import matplotlib.animation as animation\n",
      "import numpy as np\n",
      "\n",
      "fig, ax = plt.subplots()\n",
      "\n",
      "x = np.arange(0, 2*np.pi, 0.01)        # x-array\n",
      "line, = ax.plot(x, np.sin(x))\n",
      "\n",
      "def animate(i):\n",
      "    line.set_ydata(np.sin(x+i/10.0))  # update the data\n",
      "    return line,\n",
      "\n",
      "#Init only required for blitting to give a clean slate.\n",
      "def init():\n",
      "    line.set_ydata(np.ma.array(x, mask=True))\n",
      "    return line,\n",
      "\n",
      "ani = animation.FuncAnimation(fig, animate, np.arange(1, 200), init_func=init,\n",
      "                              interval=32., blit=True)\n",
      "plt.show()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    },
    {
     "cell_type": "markdown",
     "metadata": {},
     "source": [
      "### UAT 14 - Keyboard shortcuts in IPython after close of figure\n",
      "\n",
      "After closing the previous figure (with the close button above the figure) the IPython keyboard shortcuts should still function.\n",
      "\n",
      "### UAT 15 - Figure face colours\n",
      "\n",
      "The nbagg honours all colours appart from that of the figure.patch. The two plots below should produce a figure with a transparent background and a red background respectively (check the transparency by closing the figure, and dragging the resulting image over other content). There should be no yellow figure."
     ]
    },
    {
     "cell_type": "code",
     "collapsed": false,
     "input": [
      "import matplotlib\n",
      "matplotlib.rcParams.update({'figure.facecolor': 'red',\n",
      "                            'savefig.facecolor': 'yellow'})\n",
      "plt.figure()\n",
      "plt.plot([3, 2, 1])\n",
      "\n",
      "with matplotlib.rc_context({'nbagg.transparent': False}):\n",
      "    plt.figure()\n",
      "\n",
      "plt.plot([3, 2, 1])\n",
      "plt.show()"
     ],
     "language": "python",
     "metadata": {},
     "outputs": []
    }
   ],
   "metadata": {}
  }
 ]
}