{ "cells": [ { "cell_type": "markdown", "id": "a3a985cc", "metadata": {}, "source": [ "# Adding outline stroke to plotnine annotations\n", "\n", "When you plot text on top of busy charts, sometimes the text blends in with the details in the chart underneath. In this guide we'll use matplotlib's `text_effects` to make text on top of a chart readable.\n", "\n", "## Read in our data\n", "\n", "We have two datasets: the original data, and the annotations we want to put on the graphic." ] }, { "cell_type": "code", "execution_count": 6, "id": "d7c0694f", "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
countrycontinentgdp_per_capitalife_expectancypopulation
0AfghanistanAsia66354.86322856302
1AlbaniaEurope419574.2003071856
2AlgeriaAfrica509868.96330533827
3AngolaAfrica244645.23413926373
4Antigua and BarbudaN. America1273873.54477656
\n", "
" ], "text/plain": [ " country continent gdp_per_capita life_expectancy \\\n", "0 Afghanistan Asia 663 54.863 \n", "1 Albania Europe 4195 74.200 \n", "2 Algeria Africa 5098 68.963 \n", "3 Angola Africa 2446 45.234 \n", "4 Antigua and Barbuda N. America 12738 73.544 \n", "\n", " population \n", "0 22856302 \n", "1 3071856 \n", "2 30533827 \n", "3 13926373 \n", "4 77656 " ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "import pandas as pd\n", "from plotnine import *\n", "\n", "df = pd.read_csv(\"countries.csv\")\n", "df.head()" ] }, { "cell_type": "code", "execution_count": 7, "id": "7631209e", "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
countrycontinentgdp_per_capitalife_expectancypopulation
3AngolaAfrica244645.23413926373
74IcelandEurope3109279.720281210
169TongaOceania488670.81097935
\n", "
" ], "text/plain": [ " country continent gdp_per_capita life_expectancy population\n", "3 Angola Africa 2446 45.234 13926373\n", "74 Iceland Europe 31092 79.720 281210\n", "169 Tonga Oceania 4886 70.810 97935" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" } ], "source": [ "annotations = df[df.country.isin(['Tonga', 'Angola', 'Iceland'])]\n", "annotations" ] }, { "cell_type": "markdown", "id": "3a913e61", "metadata": {}, "source": [ "## The problem\n", "\n", "When you plot text on top of busy charts, sometimes the text blends in with the details in the chart underneath." ] }, { "cell_type": "code", "execution_count": 8, "id": "084f9b6c", "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 8, "metadata": {}, "output_type": "execute_result" } ], "source": [ "(\n", " ggplot(df)\n", " + aes(x='gdp_per_capita', y='life_expectancy', label='country')\n", " + geom_point(color='black')\n", " + geom_point(annotations, color='red')\n", " + geom_text(annotations, ha='left', nudge_x=1000)\n", ")" ] }, { "cell_type": "markdown", "id": "0757bd04", "metadata": {}, "source": [ "To help the text stand out, we will add an outline to it.\n", "\n", "## Adding stroke to text annotations\n", "\n", "To add an outline to our text, we will use the [matplotlib's path effects](https://matplotlib.org/stable/tutorials/advanced/patheffects_guide.html). The simplest way is using `withStroke`." ] }, { "cell_type": "code", "execution_count": 26, "id": "8ee9efa5", "metadata": {}, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 26, "metadata": {}, "output_type": "execute_result" } ], "source": [ "import matplotlib.patheffects as path_effects\n", "\n", "(\n", " ggplot(df)\n", " + aes(x='gdp_per_capita', y='life_expectancy', label='country')\n", " + geom_point(color='black')\n", " + geom_point(annotations, color='red')\n", " + geom_text(annotations,\n", " ha='left',\n", " nudge_x=1000,\n", " path_effects=[\n", " path_effects.withStroke(linewidth=3, foreground='white')\n", " ])\n", ")" ] }, { "cell_type": "markdown", "id": "f2255ca9", "metadata": {}, "source": [ "By giving it a `linewidth` and a `foreground`, you get a certain thickness of border around your text label. Now you can read it!" ] }, { "cell_type": "code", "execution_count": null, "id": "39386773", "metadata": {}, "outputs": [], "source": [] } ], "metadata": { "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.7" } }, "nbformat": 4, "nbformat_minor": 5 }