{ "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": {}, "outputs": [ { "data": { "image/png": "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\nlEOSAAAAAElFTkSuQmCC\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": {}, "outputs": [ { "data": { "image/png": "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\nUQAAAABJRU5ErkJggg==\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": {}, "outputs": [ { "data": { "image/png": "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\nRK5CYII=\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": {}, "outputs": [ { "data": { "image/png": "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\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": {}, "outputs": [ { "data": { "image/png": "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\nGzc1kP8H5MVbQOB0TvcAAAAASUVORK5CYII=\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": {}, "outputs": [ { "data": { "image/png": "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\nGzc1kP8H5MVbQOB0TvcAAAAASUVORK5CYII=\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": 11, "metadata": {}, "outputs": [ { "data": { "image/png": "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\nS/jGGLNA/D9fFfQtyfo25QAAAABJRU5ErkJggg==\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": 12, "metadata": {}, "outputs": [ { "data": { "image/png": "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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.6.1" } }, "nbformat": 4, "nbformat_minor": 1 }