{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "\n", "*This notebook contains an excerpt from the [Python Data Science Handbook](http://shop.oreilly.com/product/0636920034919.do) by Jake VanderPlas; the content is available [on GitHub](https://github.com/jakevdp/PythonDataScienceHandbook).*\n", "\n", "*The text is released under the [CC-BY-NC-ND license](https://creativecommons.org/licenses/by-nc-nd/3.0/us/legalcode), and code is released under the [MIT license](https://opensource.org/licenses/MIT). If you find this content useful, please consider supporting the work by [buying the book](http://shop.oreilly.com/product/0636920034919.do)!*\n", "\n", "*No changes were made to the contents of this notebook from the original.*" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "< [Histograms, Binnings, and Density](04.05-Histograms-and-Binnings.ipynb) | [Contents](Index.ipynb) | [Customizing Colorbars](04.07-Customizing-Colorbars.ipynb) >" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Customizing Plot Legends" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Plot legends give meaning to a visualization, assigning meaning to the various plot elements.\n", "We previously saw how to create a simple legend; here we'll take a look at customizing the placement and aesthetics of the legend in Matplotlib.\n", "\n", "The simplest legend can be created with the ``plt.legend()`` command, which automatically creates a legend for any labeled plot elements:" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "collapsed": true }, "outputs": [], "source": [ "import matplotlib.pyplot as plt\n", "plt.style.use('classic')" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "collapsed": true }, "outputs": [], "source": [ "%matplotlib inline\n", "import numpy as np" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\nAAAAAElFTkSuQmCC\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "x = np.linspace(0, 10, 1000)\n", "fig, ax = plt.subplots()\n", "ax.plot(x, np.sin(x), '-b', label='Sine')\n", "ax.plot(x, np.cos(x), '--r', label='Cosine')\n", "ax.axis('equal')\n", "leg = ax.legend();" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "But there are many ways we might want to customize such a legend.\n", "For example, we can specify the location and turn off the frame:" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n5o8AKIAhqjoz5xgm9miwaJHt2rR2rfUpbtlifYxffAE0b/7n47t0sT77evUse7ZqBVStGhH19F6v\njXstW2bLedf5AAAHA0lEQVQJes0aG2/au9cSfokStpNeRoZ15Rw4YAm/cmW7O40aAY0bW+lilM/5\nonDKyLBWwdKltrLdyJF/PmbjRmvZHz1qT8gSJezNoE0b26zARxHfYh86dOip7z0eDzweT8DXpgCo\n2pPvvPPs5gLp6cDBg/bB5NgxoGhR+1BSsuSpLkui0EpPt9H3888HypXz+bWVlJSEpKSkU98PHz7c\n0cT+uKquyOMYttiJiHwU9iUFRKSziGwDcA2AWSIyJ5DzERFR4LgIGBFRBOMiYERExMROROQ2TOxE\nRC7DxE5E5DJM7ERELsPETkTkMkzsREQuw8ROROQyTOxERC7DxE5E5DJM7ERELsPETkTkMkzsREQu\nw8ROROQyTOxERC7DxE5E5DJM7ERELsPETkTkMkzsREQuw8ROROQyTOxERC7DxE5E5DJM7ERELsPE\nTkTkMkzsREQuE1BiF5EXRWSdiCSLyKciUjJYgRERkX8CbbF/AeAyVW0IYCOAwYGHREREgQgosavq\nl6rqzfn2OwCVAw+JiIgCEcw+9n8AmBPE8xERkR/i8jtAROYDqHDmjwAogCGqOjPnmCEAMlU1Ma9z\nDRs27NTXHo8HHo/H94iJiFwsKSkJSUlJAZ1DVDWwE4j0BPAAgOtUNT2P4zTQaxERFTYiAlUVX34n\n3xZ7PhdsB+AJAK3ySupERBQ+AbXYRWQjgPMA7Mv50Xeq+vA5jmWLnYjIR/602APuiinwhZjYiYh8\n5k9i58xTIiKXYWInInIZJnYiIpdhYicichkmdiIil2FiJyJyGSZ2IiKXYWInInIZJnYiIpdhYici\nchkmdiIil2FiJyJyGSZ2IiKXYWInInIZJnYiIpdhYicichkmdiIil2FiJyJyGSZ2IiKXYWInInIZ\nJnYiIpdhYicichkmdiIil2FiJyJymYASu4g8IyKrRGSliMwVkYrBCoyIiPwjqur/L4uUUNUjOV8/\nAuBSVX3oHMdqINciIiqMRASqKr78TkAt9pNJPcf5ALyBnI+IiAIXF+gJRGQEgHsAHADQJuCIiIgo\nIPl2xYjIfAAVzvwRAAUwRFVnnnHcQADFVHXYOc7DrhgiIh/50xWTb4tdVf9awHMlAvgcwLBzHTBs\n2On/8ng88Hg8BTw1EVHhkJSUhKSkpIDOEejgaS1V3ZTz9SMAWqpql3McyxY7EZGPQtJiz8coEakN\nGzTdCuDBAM9HREQBCqjF7tOF2GInIvJZ2MsdiYgo8jCxExG5DBM7EZHLMLE7INBSJjfhY3EaH4vT\n+FgEhondAXzSnsbH4jQ+FqfxsQgMEzsRkcswsRMRuUxY69jDciEiIpfxtY49bImdiIjCg10xREQu\nw8ROROQyIU/sItJORH4WkQ05a7YXSiJSWUQWikiKiPwkIo86HZPTRCRGRH4UkRlOx+IkEblARD4R\nkXU5z4+rnY7JKSLymIisEZHVIvK+iJzndEzhJCJvi8huEVl9xs9Ki8gXIrJeROaJyAX5nSekiV1E\nYgC8BqAtgMsAdBWRuqG8ZgTLAtBfVS8D0AxA70L8WJzUF8Bap4OIAGMBfK6q9QBcAWCdw/E4QkQu\nAvAIgMaq2gC2+uydzkYVdhNh+fJMgwB8qap1ACwEMDi/k4S6xX4VgI2qulVVMwF8CKBTiK8ZkVT1\nN1VNzvn6COzFW8nZqJwjIpUBtAfwltOxOElESsL2MZgIAKqapaqHHA7LSbEAzheROADFAex0OJ6w\nUtWlAH4/68edAEzK+XoSgM75nSfUib0SgG1nfL8dhTiZnSQi1QA0BPC9s5E46v8APAHbZrEwqw4g\nTUQm5nRLTRCRYk4H5QRV3QlgNIBUADsAHFDVL52NKiKUV9XdgDUQAZTP7xc4eBpmIlICwFQAfXNa\n7oWOiHQAsDvnE4zk3AqrOACNAbyuqo0BHIN99C50RKQUrHVaFcBFAEqIyF3ORhWR8m0MhTqx7wBw\n8RnfV875WaGU8/FyKoApqjrd6Xgc1ALA30TkFwAfAGgjIpMdjskp2wFsU9Ufcr6fCkv0hdENAH5R\n1f2qmg3gMwDNHY4pEuwWkQoAICIVAezJ7xdCndiXA6glIlVzRrfvBFCYKyDeAbBWVcc6HYiTVPVJ\nVb1YVWvAnhMLVfUep+NyQs5H7G05W0wCwPUovAPKqQCuEZG/iIjAHovCOJB89qfYGQB65nzdA0C+\njcJA9zzNk6pmi0gfAF/A3kTeVtXC+IeCiLQAcDeAn0RkJezj1JOqOtfZyCgCPArgfREpAuAXAPc6\nHI8jVHWZiEwFsBJAZs6/E5yNKrxEJBGAB0CCiKQCGApgFIBPROQfsL2lu+R7Hi4pQETkLhw8JSJy\nGSZ2IiKXYWInInIZJnYiIpdhYicichkmdiIil2FiJyJyGSZ2IiKX+X90/gsujUnAQAAAAABJRU5E\nrkJggg==\n", "text/plain": [ "" ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "ax.legend(loc='upper left', frameon=False)\n", "fig" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can use the ``ncol`` command to specify the number of columns in the legend:" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" } ], "source": [ "ax.legend(frameon=False, loc='lower center', ncol=2)\n", "fig" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can use a rounded box (``fancybox``) or add a shadow, change the transparency (alpha value) of the frame, or change the padding around the text:" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\nRKQeAD+AMQAeUdVFeRzLWTGhtHy59cNPmgT861/WzAynzZvt42z79o4M8mZlAZ9+ahOB0tOt+6N7\n99DOWssUv2K9AAAIXElEQVTKsn7zt96y2aY9elgRppo1Q3dNIhw6ZE/2N94Atm61Pr8HHwTKlgXg\nYnVHEZkJYAATewTYtcv6tRs2dP7cqsDatdZ3HqYZOqo2//3dd630dtOmVhipQwf7kBKsw4ftA8/E\nifbaqlPHNsC4887oG6umEFG1HZvatLEnXrlyzp7/jTesQXb//TaIc1IdASZ2ytuIEbZv6EUXWadx\nrVp5L+VPS7NPAitXAvPmWQ35YsXsaxcWfBw+bIOrX39tkxnKlrXenssus7IFNWvap+lTFRxTtQ2Z\nNm2yu5Saar1HCxbYtMXrrrOSNU68WZDHZGfbQoX//c92bjr/fFs82Lw5cPvtef+u328DNWvW2JaY\n7doV+vIhSewiMg3AWSf+CIACGKyqk3KPYWKPBjNn2q5NK1ZYn+KGDdbH+O23QIsWfz2+Sxfrs2/Q\nwLJn69ZAjRoRMZ/e77dxr/nzLUEvW2bjTTt3WsIvU8Z20svMtK6cvXst4VerZnfnkkuAJk1s6mKU\nr/micMrMtFbBnDlW2W748L8es3attewPHbInZJky9maQkGCbFRRSxLfYhwwZcux7n88Hn88X9LUp\nCKr25CtRwm4ekJEB7NtnH0wOHwZKlrQPJWXLHuuyJAqtjAwbfT/jDKBSpUK/tlJSUpCSknLs+6FD\nh7qa2B9R1YV5HMMWOxFRIYW9pICIJIrIJgDNAEwWkSnBnI+IiILHImBERBGMRcCIiIiJnYjIa5jY\niYg8homdiMhjmNiJiDyGiZ2IyGOY2ImIPIaJnYjIY5jYiYg8homdiMhjmNiJiDyGiZ2IyGOY2ImI\nPIaJnYjIY5jYiYg8homdiMhjmNiJiDyGiZ2IyGOY2ImIPIaJnYjIY5jYiYg8homdiMhjmNiJiDyG\niZ2IyGOY2ImIPCaoxC4iz4vIShFZLCKfi0hZpwIjIqLABNti/xbAharaGMBaAIOCD4mIiIIRVGJX\n1e9U1Z/77TwA1YIPiYiIguFkH/s/AExx8HxERBSAYvkdICLTAJx14o8AKIDBqjop95jBALJUNTmv\ncyUlJR372ufzwefzFT5iIiIPS0lJQUpKSlDnEFUN7gQiPQDcB+AqVc3I4zgN9lpEREWNiEBVpTC/\nk2+LPZ8LtgfwKIDWeSV1IiIKn6Ba7CKyFkAJALtzfzRPVR88zbFssRMRFVIgLfagu2IKfCEmdiKi\nQgsksXPlKRGRxzCxExF5DBM7EZHHMLETEXkMEzsRkccwsRMReQwTOxGRxzCxExF5DBM7EZHHMLET\nEXkMEzsRkccwsRMReQwTOxGRxzCxExF5DBM7EZHHMLETEXkMEzsRkccwsRMReQwTOxGRxzCxExF5\nDBM7EZHHMLETEXkMEzsRkccwsRMReUxQiV1EnhSRJSKSKiJTRaSKU4EREVFgRFUD/2WRMqp6MPfr\nhwBcoKoPnOZYDeZaRERFkYhAVaUwvxNUi/1oUs91BgB/MOcjIqLgFQv2BCIyDMCdAPYCSAg6IiIi\nCkq+XTEiMg3AWSf+CIACGKyqk0447jEApVQ16TTnYVcMEVEhBdIVk2+LXVWvLeC5kgF8DSDpdAck\nJR3/L5/PB5/PV8BTExEVDSkpKUhJSQnqHMEOntZR1XW5Xz8EoJWqdjnNsWyxExEVUkha7Pl4VkTq\nwgZNNwK4P8jzERFRkIJqsRfqQmyxExEVWtinOxIRUeRhYici8hgmdiIij2Fid0GwU5m8hI/FcXws\njuNjERwmdhfwSXscH4vj+Fgcx8ciOEzsREQew8ROROQxYZ3HHpYLERF5TGHnsYctsRMRUXiwK4aI\nyGOY2ImIPCbkiV1E2ovIKhFZk1uzvUgSkWoiMkNElovILyLSx+2Y3CYiMSKySEQmuh2Lm0TkTBH5\nVERW5j4/rnA7JreIyMMiskxElorIByJSwu2YwklE3haR7SKy9ISflReRb0VktYh8IyJn5neekCZ2\nEYkB8CqAdgAuBNBVROqH8poRLBtAf1W9EEBzAL2K8GNxVF8AK9wOIgKMAvC1qjYAcDGAlS7H4woR\nOQfAQwCaqGojWPXZ29yNKuzGwvLliQYC+E5V6wGYAWBQficJdYv9cgBrVXWjqmYB+AhApxBfMyKp\n6u+qujj364OwF29Vd6Nyj4hUA9ABwFtux+ImESkL28dgLACoaraq7nc5LDfFAjhDRIoBKA1gq8vx\nhJWqzgHwx0k/7gRgXO7X4wAk5neeUCf2qgA2nfD9ZhThZHaUiJwHoDGAn9yNxFX/B+BR2DaLRVlN\nALtEZGxut9SbIlLK7aDcoKpbAYwAkAZgC4C9qvqdu1FFhMqquh2wBiKAyvn9AgdPw0xEygD4DEDf\n3JZ7kSMi1wPYnvsJRnJvRVUxAE0AvKaqTQAchn30LnJEpBysdVoDwDkAyohIN3ejikj5NoZCndi3\nADj3hO+r5f6sSMr9ePkZgPGqOsHteFzUEsDfReRXAB8CSBCR91yOyS2bAWxS1Z9zv/8MluiLomsA\n/Kqqe1Q1B8AXAFq4HFMk2C4iZwGAiFQBsCO/Xwh1Yl8AoI6I1Mgd3b4NQFGeAfEOgBWqOsrtQNyk\nqo+r6rmqWgv2nJihqne6HZcbcj9ib8rdYhIArkbRHVBOA9BMRP4mIgJ7LIriQPLJn2InAuiR+/Vd\nAPJtFAa752meVDVHRHoD+Bb2JvK2qhbFPxREpCWA2wH8IiKpsI9Tj6vqVHcjowjQB8AHIlIcwK8A\n7nY5Hleo6nwR+QxAKoCs3H/fdDeq8BKRZAA+APEikgZgCIBnAXwqIv+A7S3dJd/zsKQAEZG3cPCU\niMhjmNiJiDyGiZ2IyGOY2ImIPIaJnYjIY5jYiYg8homdiMhjmNiJiDzm/wFXrVjs8UnD7wAAAABJ\nRU5ErkJggg==\n", "text/plain": [ "" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "ax.legend(fancybox=True, framealpha=1, shadow=True, borderpad=1)\n", "fig" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "For more information on available legend options, see the ``plt.legend`` docstring." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Choosing Elements for the Legend\n", "\n", "As we have already seen, the legend includes all labeled elements by default.\n", "If this is not what is desired, we can fine-tune which elements and labels appear in the legend by using the objects returned by plot commands.\n", "The ``plt.plot()`` command is able to create multiple lines at once, and returns a list of created line instances.\n", "Passing any of these to ``plt.legend()`` will tell it which to identify, along with the labels we'd like to specify:" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "y = np.sin(x[:, np.newaxis] + np.pi * np.arange(0, 2, 0.5))\n", "lines = plt.plot(x, y)\n", "\n", "# lines is a list of plt.Line2D instances\n", "plt.legend(lines[:2], ['first', 'second']);" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "I generally find in practice that it is clearer to use the first method, applying labels to the plot elements you'd like to show on the legend:" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "plt.plot(x, y[:, 0], label='first')\n", "plt.plot(x, y[:, 1], label='second')\n", "plt.plot(x, y[:, 2:])\n", "plt.legend(framealpha=1, frameon=True);" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice that by default, the legend ignores all elements without a ``label`` attribute set." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Legend for Size of Points\n", "\n", "Sometimes the legend defaults are not sufficient for the given visualization.\n", "For example, perhaps you're be using the size of points to mark certain features of the data, and want to create a legend reflecting this.\n", "Here is an example where we'll use the size of points to indicate populations of California cities.\n", "We'd like a legend that specifies the scale of the sizes of the points, and we'll accomplish this by plotting some labeled data with no entries:" ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "import pandas as pd\n", "cities = pd.read_csv('data/california_cities.csv')\n", "\n", "# Extract the data we're interested in\n", "lat, lon = cities['latd'], cities['longd']\n", "population, area = cities['population_total'], cities['area_total_km2']\n", "\n", "# Scatter the points, using size and color but no label\n", "plt.scatter(lon, lat, label=None,\n", " c=np.log10(population), cmap='viridis',\n", " s=area, linewidth=0, alpha=0.5)\n", "plt.axis(aspect='equal')\n", "plt.xlabel('longitude')\n", "plt.ylabel('latitude')\n", "plt.colorbar(label='log$_{10}$(population)')\n", "plt.clim(3, 7)\n", "\n", "# Here we create a legend:\n", "# we'll plot empty lists with the desired size and label\n", "for area in [100, 300, 500]:\n", " plt.scatter([], [], c='k', alpha=0.3, s=area,\n", " label=str(area) + ' km$^2$')\n", "plt.legend(scatterpoints=1, frameon=False, labelspacing=1, title='City Area')\n", "\n", "plt.title('California Cities: Area and Population');" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "The legend will always reference some object that is on the plot, so if we'd like to display a particular shape we need to plot it.\n", "In this case, the objects we want (gray circles) are not on the plot, so we fake them by plotting empty lists.\n", "Notice too that the legend only lists plot elements that have a label specified.\n", "\n", "By plotting empty lists, we create labeled plot objects which are picked up by the legend, and now our legend tells us some useful information.\n", "This strategy can be useful for creating more sophisticated visualizations.\n", "\n", "Finally, note that for geographic data like this, it would be clearer if we could show state boundaries or other map-specific elements.\n", "For this, an excellent choice of tool is Matplotlib's Basemap addon toolkit, which we'll explore in [Geographic Data with Basemap](04.13-Geographic-Data-With-Basemap.ipynb)." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Multiple Legends\n", "\n", "Sometimes when designing a plot you'd like to add multiple legends to the same axes.\n", "Unfortunately, Matplotlib does not make this easy: via the standard ``legend`` interface, it is only possible to create a single legend for the entire plot.\n", "If you try to create a second legend using ``plt.legend()`` or ``ax.legend()``, it will simply override the first one.\n", "We can work around this by creating a new legend artist from scratch, and then using the lower-level ``ax.add_artist()`` method to manually add the second artist to the plot:" ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "collapsed": false }, "outputs": [ { "data": { "image/png": "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\nIsL+/fsRGRlpVDm7du0yugw5JCQkoHfv3qhVq5ZBSR0A3n//faxatQpLliwxQYTml5HU7927h6Cg\nIIWjSSfRqRi8AAAYRUlEQVRJEl68eGHQb+q1116Dj48PoqOj8eGHH5o0N1hUYiciPH78WLH9a7Va\njBw5EteuXcOxY8dQpUoVg8siImg0Gih9lhIcHIwmTZogIiLCqHKaN2+Oo0ePYuLEifD29pYpOsMJ\nIbBq1SrUqFHDqHJu3bqFzp07G/39GOP58+fo2rUrXF1dsW7dOoOSOgDUqFEDfn5+ePToEXQ6ncxR\n6ufUqVNISEiQpazLly/jwoULspRlrLJly2LWrFkGD3grX7489u3bh4SEBAwdOtR0yV3fRnlDbyhC\nr5iAgACytbWlM2fO6Hd1QQapqak0aNAg6t69e7GcWCkvGes0rlu3TrYyb9y4QQ4ODopNZbx06VIK\nCgqStcy5c+dS/fr1FZkeIjw8nBo3bkxff/11sevml5+tW7eSnZ2dXouFlDSpqanUp0+fPLuy5oTi\n1ismL0eOHCGVSlXoXOFyU6vVtHjxYpMMkAgLC6NBgwaZvbdMcHBwnoNAjBUYGEiOjo4GLw9mjF27\ndlFERITs5S5YsIDq1KlD9+/fl73s/Dx48IDq1KlDCxYssJqkvmrVKnJ0dDTZWr9eXl7k5+dnkrLz\nEhcXZ7KKZlpaGg0YMIC6d+9e4NTLVpHYidJrhUVdDac40Ol0VrNgcob79+9TnTp1yNPT0+RJyVxJ\nb9WqVdS0aVOzjCIODAwkJycns6xL8PfffxdaK5TDwoULqVatWkYvml6QU6dOyX7Glp+oqChq0aIF\nTZo0yWT70Gg0NHLkSGrdunW+feGtJrFbO2vpbx0REUHNmzencePGmfRsxMPDgw4ePGiy8rMyx8jU\nK1eukL29vdmas0aPHm3ygVk7duygBg0amLXvuakPwD179qSZM2eapeLyzTffkKura55zaXFiLwbu\n3LlDbm5uJvnPsnnz5jynPDCl2NhYcnd3p/fff99k83w8evTIas7gDh48SCqVKs8h9cWZWq02+6hR\nDw8Pk46MlmMudX38+OOP5OzsnG3NByIrTuz+/v70zTffGPz+nM6ePUsDBgxQrF3TVJM3/fzzz/Tg\nwQOTlF2QlJQUGjhwIL3zzjuyTbQVGhpqdXOOr127luzt7a2uWU4pYWFhZmliMicvLy+ys7PL9n/E\nahN7fHw8Xb161eD3Z/XXX3+RjY2N2U7tC5KSkkJ79uxROgxZaLVaGjduHDVq1IgePnxodHkTJkyg\nAwcOGB+YDE6ePGnUab8kSTRr1iyqU6eOQavUyy0lJUW235OlCAoKMro3m6XMlvm///2PbGxsMqf9\nsNrELgdJkujnn3+m6tWr05UrVxSNJUNoaChNmTLFanpESJJEv/zyCzk4OND58+eNLssSaDQa6tSp\nEw0YMMCgxJGamkofffQRtW7d2mJWp7p8+XK2xKGvgIAAi5us65tvvjGqsnbp0iXq1auXjBEZ59q1\na+Tk5ESLFi0qWYldnx++Wq2mTz/9lJo2bSpLbdJU9PlMN2/etNjV3Pfv3082Nja0bds2vd63cuVK\nCggIMFFUhstIzi1bttSrr3t4eDi1adOGBg0aZHFjIzISh76LXOzcuZNsbGzo+PHjJopMOZbWqeHx\n48f05ptvlqzE/v777xd5DVWdTkc//fRTgX1FlfbkyRPq1q1bkXqXZPy4vLy8zBCZYa5fv041atSg\nWbNmFbnHzIEDBwqdflcpkiTR/PnzqUaNGnTx4sVCt7906RI5OTnR3LlzLebsI6eYmJgix6bT6WjW\nrFnk7Oxs9jEm+lq5cmWxmW66MBqNpmQl9sDAQKpfvz598cUXFvvD0YckSXTr1q1Ct9PpdPThhx9a\nTHNSQZ4+fUqdOnWiHj165Fr8IkNUVFSx+vvt2bOHmjdvXmAvnc2bN1tVz5e4uDjq168fubm5mWRw\nmNyuX79eaAWhOC1QUqISO1H6f7idO3fKXq4lOHz4sFUst6fRaGjq1Knk4uJCly5dyvV6165dTTZK\n0VTyOwNJTk6m0aNHU7169YrdZ8qQV1PYwoULacyYMcWyB0pMTEy2axs6nY6WLFlCdnZ2xWa+9xKX\n2PMSExNDjx49Msu+TCU5OZk+/PBDi2460tfu3btJpVLR8uXLs9XQraV/emBgIDVu3JiGDRtmcW21\nRRUVFUXdunXL9TcpTmdUOW3dupVmz56d+finn36iNm3aWPS1tpxKfGL38/MjFxcXWrJkicn3ZS4L\nFy6kI0eOKB2GLO7evUstWrQge3t7kw47NydJkmjdunVUrVo1WrNmTbFOgtYq698kMTGx2FUmDEns\nFjVtr6GSk5MxceJEDB06FEOHDsX9+/eVDkk27u7u+Pnnn3Hu3DmlQzFavXr1cOHCBbzzzjto27Yt\n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\n", "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "fig, ax = plt.subplots()\n", "\n", "lines = []\n", "styles = ['-', '--', '-.', ':']\n", "x = np.linspace(0, 10, 1000)\n", "\n", "for i in range(4):\n", " lines += ax.plot(x, np.sin(x - i * np.pi / 2),\n", " styles[i], color='black')\n", "ax.axis('equal')\n", "\n", "# specify the lines and labels of the first legend\n", "ax.legend(lines[:2], ['line A', 'line B'],\n", " loc='upper right', frameon=False)\n", "\n", "# Create the second legend and add the artist manually.\n", "from matplotlib.legend import Legend\n", "leg = Legend(ax, lines[2:], ['line C', 'line D'],\n", " loc='lower right', frameon=False)\n", "ax.add_artist(leg);" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This is a peek into the low-level artist objects that comprise any Matplotlib plot.\n", "If you examine the source code of ``ax.legend()`` (recall that you can do this with within the IPython notebook using ``ax.legend??``) you'll see that the function simply consists of some logic to create a suitable ``Legend`` artist, which is then saved in the ``legend_`` attribute and added to the figure when the plot is drawn." ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "\n", "< [Histograms, Binnings, and Density](04.05-Histograms-and-Binnings.ipynb) | [Contents](Index.ipynb) | [Customizing Colorbars](04.07-Customizing-Colorbars.ipynb) >" ] } ], "metadata": { "anaconda-cloud": {}, "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.4.3" } }, "nbformat": 4, "nbformat_minor": 0 }