{ "cells": [ { "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 (see the following figure):" ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "tags": [] }, "outputs": [], "source": [ "import matplotlib.pyplot as plt\n", "plt.style.use('seaborn-whitegrid')" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "tags": [] }, "outputs": [], "source": [ "%matplotlib inline\n", "import numpy as np" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAWwAAAD0CAYAAAC/3RwjAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjQuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/MnkTPAAAACXBIWXMAAAsTAAALEwEAmpwYAAArfElEQVR4nO3dd3hU1dYG8HfSG6H33nIEBcVQAoKAiFIUEZWmUkXkKhZUEAEboiCifhcEKSpcQaqCgCJd9FICDHClhIOigqH3kmRCyv7+WAnNBDL1zE7e3/P4SKacWTs5s84+u9qUUiAiIv8XYHUARESUN0zYRESaYMImItIEEzYRkSaYsImINMGETUSkiSBvHdhut3O8IBGRC2JjY205Pe61hJ31oS69LyEhAbVq1fJwNP6NZS4YWOaCwZ0y2+32XJ9jkwgRkSaYsImINMGETUSkCSZsIiJNMGETEWmCCZuISBNM2EREmvDqOGwiIn80ZcoUbNiwAenp6bDZbBgyZAi+++479O7dG+XKlbM6vFwxYRNRgfL7779jzZo1mD17Nmw2GxISEjBkyBAsXrzY6tBuigmbiCzzn/8AX3zh2WP26QP06JH784UKFcLhw4exYMEC3H333ahVqxYWLFiAJ598Em+99RZ++OEHJCYm4tSpUzh8+DCGDh2KZs2aYfPmzfj4448RGBiIihUr4p133kFwcLBng78JtmETUYFSunRpTJo0Cdu2bUOXLl3Qpk0brF279prXhISEYNq0aRg2bBimT58OpRRGjBiBCRMmYObMmShdujQWLlzo89hZwyYiy/TocePasDccOHAAUVFReP/99wEAO3fuRL9+/VCyZMnLr8leB6RMmTK4dOkSTp8+jePHj+PFF18EADgcDjRp0sS3gcONhG0YRiCAqQAMAArAM6Zp7vJUYERE3mCaJubOnYtJkyYhJCQEVatWRXR0NAIDAy+/xma7drG8okWLokyZMpg4cSIKFSqE1atXIyIiwtehu1XDfhAATNO8yzCMFgBGAXjIE0EREXnLfffdh/379+PRRx9FREQElFIYPHgwZsyYket7AgICMGzYMDz99NNQSiEyMhIffPCBD6MWLids0zQXGYaxNOvHygDOeiQiIiIvGzBgAAYMGHDNY/feey8AYODAgZcfq169Or766isAQNOmTdG0aVPfBZkDm1Lu7TNgGMYM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", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "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 on the frame (see the following figure):" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "execution_count": 4, "metadata": {}, "output_type": "execute_result" } ], "source": [ "ax.legend(loc='upper left', frameon=True)\n", "fig" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "We can use the ``ncol`` command to specify the number of columns in the legend, as shown in the following figure:" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "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Sv3oUlRERFQorrZhvwsgDMD/WZYFAKeUUnd6LCoiIvoblxI2kzMRke9x4gwRkSGYsImIDMGETURkCCZsIiJDMGETERmCCZuIyBBM2EREhmDCJiIyBBM2EZEhmLCJiAzBhE1EZAgmbCIiQzBhExEZggmbiMgQTNhERIZgwiYiMgQTNhGRIZiwiYgMwYRNRGQIJmwiIkMwYRMRGYIJm4jIEEzYRESGCHLlRZZlRQKYCaAMgHMAHlRK7fNkYEREdClXa9gDATiVUrcAmA7gJc+FREREeXGphq2U+siyrMCcH2sAOOmxiIiIKE8OrfUVn2BZ1gAAz17264eUUpssy1oFoAGAdkqpbRc/wel06oiICJeCSktLQ1hYmEuvNVVxKPP8+fPx448/IisrCw6HA71798a6detw5513okKFCnaH5xMXf8579+7F1KlTkZ6ejrS0NMTFxaFnz55wOBwFOtbKlStRokQJNG3a1Jshu604nNuXc6fMKSkpiIuLy/sk0Fq79S8mJubamJiYPZf/fvPmzdpVO3fudPm1pirqZf7ll190jx49dHZ2ttZaytu+fXubo/K93M/51KlTukuXLvr333/XWmudmZmpn3jiCT1z5kwbo/OOon5u58WdMufkzjzzraudjq8CSFJKTQNwFkCWS5cSssV//gN89plnj9m/P9C3b/6PlyhRAvv378cXX3yBW265BbGxsRg1ahT69OmDYcOG4ZtvvkFSUhKOHTuG/fv349VXX0XLli2xceNGfPjhhwgMDET16tXx5ptvIjg42LPBA0Dr1n//XffuwOOPAykpQKdOf3+8Xz/5d/QocO+9lz723XdXfLuVK1eiWbNmqFWrFgAgMDAQI0eORHBwMEaMGAGn0wkA6NKlCx588EEsW7YMkyZNQlBQECpWrIgPP/wQH3/8McqXL486depg0qRJCA4ORlJSEjp16oTHHnsMBw4cwNChQ5Geno7Q0FAMHz4clStXLuxfhvyIq52OnwG437Ks7wDMAvCQxyKiIqlSpUoYP348tmzZgh49eqBDhw7YtGnTJc8JCQnB5MmTMXjwYEyZMgVaawwdOhRjx47F9OnTUalSJSxYsMCmEnjW4cOHUb169Ut+FxkZibVr1yIpKQlz587FzJkzsXjxYiilsHjxYgwYMACzZs1CmzZtcPbs2Uteu3//fowZMwZz5szB5MmTAQAjR45Enz59MG3aNAwYMADvv/++z8pH3uFqp+MhAB08HAv5SN++V64Ne8Off/6JqKgovPvuuwCA7du3o3///oiOjj7/nNjYWABAdHQ0zp07h+PHj+Pw4cN45plnAEi7YIsWLbwT4JVqxBERV368fPmr1qgvV6VKFezcufOS3/3111/YsWMHGjduDIfDgeDgYFx//fXYs2cPXn31VUyYMAHTp09HnTp1cNttt13y2piYGAQFBSEoKOh82+nu3bsxYcIETJ48WW6ng1z6upMf4cQZ8gmlFN58802cO3cOAFC7dm1ERkYiMDDw/HMu72wrU6YMoqOjMW7cOEybNg2PPvoo4uPjfRq3t7Rp0wY//PAD9u7dCwDIyMjAiBEjULJkyfPNIRkZGdi6dStq1qyJOXPm4KmnnsL06dMBAMuXL7/keHl1VNapUwcvvPACpk2bhjfeeAMdOrCOZTpecskn2rdvjz179uDee+9FREQEtNZ48MEHsWrVqnxfExAQgMGDB+ORRx6B1hqRkZF47733fBi190RFRWHEiBEYMmQItNZITk5GmzZt0KdPHxw4cAA9evRARkYGOnTogOuuuw6HDh3CoEGDEBkZiYiICLRu3fp88s7Pyy+/jGHDhp0fhTJ48GAflY685arD+lzldDp1XFycS69NTEw8f3tcXLDMxQPLXDy4U2an05nvsD42iRARGYIJm4jIEEzYRESGYMImIjIEEzYRkSGYsImIDMGETURkCCZsIiJDMGETERnCqzMdvXJgIqIiLr+Zjl5L2ERE5FlsEiEiMgQTNhGRIfxqeVXLsgIAjANwPYB0AA8rpX61NyrvsiwrGLKDTy0AoQDeUkottDUoH7AsqyIAJ2QD5112x+MLOVvrdQUQAmCcUupTm0PympzzeirkvM4CMLAof86WZTUDMFIp1dqyrLoApgDQAH4G8IRSKtsT7+NvNexuAMKUUs0BvAJgtL3h+MQDAI4ppVpCdvEZa3M8XpfzZZ4AINXuWHzFsqzWAFoAuAlAKwDVr/gC83UCEKSUagHgTQBv2xyP11iW9RKAyQByt0n/AMCQnO+0A8Cdnnovf0vYNwP4FgCUUhsANLY3HJ+YB2Bozv87AGTaGIuvvA/gEwD77Q7Eh24HsB3AAgCLACy2Nxyv2w0gKOeuuSSADJvj8aY9AO6+6Oc4AGty/n8JgNv+9goX+VvCLgng1EU/Z1mW5VfNNp6mlDqrlDpjWVYJAF8AGGJ3TN5kWVY/AEeUUkvtjsXHykMqIPcBeBTADMuy8hy6VUSchTSH7AIwCcC/bY3Gi5RS83HpBcmhlModfncGQClPvZe/JezTAEpc9HOAUqrI1zgty6oOYDWAaUqpmXbH42X9AbSzLOs7ADcA+I9lWdFXfEXRcAzAUqXUOaWUApAGoILNMXnTs5DyxkD6pKZalhV2ldcUFRe3V5cAcNJTB/a3hL0W0vYFy7LiIbeQRZplWZUALAPwslLqM7vj8Tal1C1KqVZKqdYAtgHoq5Q6aG9UPvE/AB0sy3JYllUFQCQkiRdVJ3Dhbvk4gGAAgfk/vUjZmtNnAQAdAfzgqQP7W3PDAkjtax2kPfchm+PxhdcAlAEw1LKs3LbsjkqpYtMhVxwopRZblnULgI2QitITSqksm8Pypg8BfGZZ1g+QUTGvKaWSbY7JV54HMMmyrBAAiZCmTo/gTEciIkP4W5MIERHlgwmbiMgQTNhERIZgwiYiMgQTNhGRIZiwiYgMwYRNRGQIJmwiIkP8P5DWUDLbej2+AAAAAElFTkSuQmCC", "text/plain": [ "
" ] }, "execution_count": 5, "metadata": {}, "output_type": "execute_result" } ], "source": [ "ax.legend(loc='lower center', ncol=2)\n", "fig" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "And 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 (see the following figure):" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "ax.legend(frameon=True, fancybox=True, framealpha=1,\n", " 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, by default the legend includes all labeled elements from the plot.\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", "`plt.plot` 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 (see the following figure):" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "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'], frameon=True);" ] }, { "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 (see the following figure):" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "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(frameon=True);" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "Notice that 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 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 (see the following figure):" ] }, { "cell_type": "code", "execution_count": 9, "metadata": {}, "outputs": [], "source": [ "# Uncomment to download the data\n", "# url = ('https://raw.githubusercontent.com/jakevdp/PythonDataScienceHandbook/'\n", "# 'master/notebooks/data/california_cities.csv')\n", "# !cd data && curl -O {url}" ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "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('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');" ] }, { "attachments": {}, "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", "Recall that the legend only lists plot elements that have a label specified.\n", "\n", "By plotting empty lists, we create labeled plot objects that 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." ] }, { "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 (`Artist` is the base class Matplotlib uses for visual attributes), and then using the lower-level `ax.add_artist` method to manually add the second artist to the plot (see the following figure):" ] }, { "cell_type": "code", "execution_count": 11, "metadata": { "collapsed": false, "jupyter": { "outputs_hidden": false } }, "outputs": [ { "data": { "image/png": "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KiYm5rbHP/74o/64Xbt2jIyM1B/HxsbSaDRa/H4lSUpK4oIFC9ixY0cCIABWq1aNjz/+ON99911u27aNp0+f5s2bN2/bNycnh1euXOHBgwe5aNEivvLKK7z33ntpMBgIgMHBwXz11Vf5yy+/8OTJk3Ypf1xcHGfMmMEmTZro5e/UqZO+/ejRo7xw4QIzMjJu21fTNF66dIm7d+/mJ598wuHDh7N+/fr85JNPSJKJiYmcPHkyT58+bVHZCp/nopw4cYJjxoxhaGioXv7mzZvz+eef5+XLl0mS6enpzMnJuW3fjIwMnjt3jtu3b+fs2bM5YMAABgcHEwBr165NTdNIktnZ2RaVvzSapjEtLY1k3mcUACdNmkQy73O1YsUKJiYmFrvvzZs39c/17t272adPH72es2bN4iOPPMKsrCy7lJ0kMzMzuXHjRvbt25eenp4EwEqVKrF79+6cMGEC161bxxMnTjApKUn/W+YzGo1MTEzk8ePHOWvWLI4fP55du3bVj+Pt7c1BgwZx69atdvv7Jycnc/HixezatStdXV157do1kuSWLVs4bdo0bt68maqqMiUl5bby5393Dx8+zC+++IKLFi0imXdeatasyWrVqnHkyJHcv3//bfuS5n22i/NP7Cwy5jpFwC4sIyODFy5cIEnevHmTfn5+fO211yx+v6KcPHmSI0aM0D9gDRo04JQpU3j06FGrfxwSExO5Zs0a9unTRz9+o0aNuGzZMmZmZlpddtMP0JAhQwiA7du358cff8wzZ84U+QEri/z6f/311/qPT/fu3bl9+/Yy/W2KO8+5ublct24d27ZtSwB0c3Nj7969uXTpUl65csWqsmuaxpiYGP7www8kyaysLN5999388MMPrTpuYVlZWWzYsCFHjRqlv++WLVt4+PBhmxx/3rx5HDhwoP5448aNPHPmjE2OffXqVb799tusXr06AbB69ep89dVXuWvXLos+n6bnOT09nd9++y2ff/55Vq1alQB411138d133y32x6usEhIS+NJLL9Hb25sAWL9+fU6aNMkmx8/NzeX69esZFRVFLy8vAmDTpk357bffFnidBOxiZGVlcc2aNTx27BhJMj4+nm+99RaTkpIseu9ff/2VjzzyCAHQy8uLzz33HKOjo60OcsVJTk7mZ599xnr16hEAQ0JC+Mknn1j0xcgPChERETx69CjJ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", "text/plain": [ "
" ] }, "metadata": { "needs_background": "light" }, "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'], loc='upper right')\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'], loc='lower right')\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 Jupyter 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." ] } ], "metadata": { "anaconda-cloud": {}, "jupytext": { "formats": "ipynb,md" }, "kernelspec": { "display_name": "Python 3 (ipykernel)", "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.9.2" } }, "nbformat": 4, "nbformat_minor": 4 }