diff --git a/src/notebooks/web-histogram-with-annotations.ipynb b/src/notebooks/web-histogram-with-annotations.ipynb new file mode 100644 index 0000000000..962081c9a9 --- /dev/null +++ b/src/notebooks/web-histogram-with-annotations.ipynb @@ -0,0 +1,269 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": { + "tags": [] + }, + "source": [ + "## About\n", + "\n", + "This plot is a [histogram](https://python-graph-gallery.com/histogram/). Let's see what the final output will look like:\n", + "\n", + "ADD TEASER" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Libraries\n", + "\n", + "For creating this chart, we will need a whole bunch of libraries!" + ] + }, + { + "cell_type": "code", + "execution_count": 10, + "metadata": { + "tags": [] + }, + "outputs": [], + "source": [ + "import matplotlib.pyplot as plt # plotting the chart\n", + "import matplotlib.patches as patches # add yellow rectangle\n", + "import pandas as pd # data manipulation\n", + "from matplotlib.patches import Rectangle" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Dataset\n", + "\n", + "The data can be accessed using the **url below**. " + ] + }, + { + "cell_type": "code", + "execution_count": 11, + "metadata": { + "scrolled": true, + "tags": [] + }, + "outputs": [], + "source": [ + "url = 'https://raw.githubusercontent.com/holtzy/The-Python-Graph-Gallery/master/static/data/insee_salaries.csv'\n", + "\n", + "# remove the first one when merging\n", + "df = pd.read_csv('../../static/data/insee_salaries.csv')\n", + "#df = pd.read_csv(url)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Creating the chart\n", + "\n", + "Here's the following things we do in order to customize our [histogram](https://python-graph-gallery.com/histogram/):\n", + "\n", + "- We initialize a **polar coordinate layout** for the plot and sets the **background color** of both the plot and figure to `\"whitesmoke\"`\n", + "- Defines a **list of colors** to be used for each bar in the [histogram](https://python-graph-gallery.com/histogram/)\n", + "- Creates the horizontal [histogram](https://python-graph-gallery.com/histogram/) using the `ax.barh()` method, where `df['range']` represents the horizontal positions of the bars, and `df['people']` represents the heights of the bars. The specified colors are used for the bars\n", + "- Adds vertical **grid lines** to the chart with specified linestyle, opacity, and axis\n", + "- Sets the **title**, **subtitle**, and details/credit text for the chart using the `fig.text()` function. It also specifies the font size, color, and alignment for these text elements.\n", + "- Removes the `spines` (border lines) from the chart's top, right, and bottom edges to give it a **clean appearance**\n", + "- Changes the position and **labels** of the y-axis ticks and moves the x-axis ticks **to the top of the chart**\n", + "- Adds a **yellow rectangle** to the figure using Matplotlib's `patches.Rectangle()` to highlight a specific area\n", + "- Adds **percentage labels** at various positions on the chart using the `ax.text()` function\n", + "\n", + "Finally, it displays the chart using `plt.show()`." + ] + }, + { + "cell_type": "code", + "execution_count": 13, + "metadata": { + "tags": [] + }, + "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/var/folders/m2/jfzxyg4s0xz3jyw5f94r7tcm0000gn/T/ipykernel_2593/3108486060.py:62: UserWarning: FixedFormatter should only be used together with FixedLocator\n", + " ax.set_xticklabels(['0', '1M', '2M', '3M', '4M', '5M', '6M'])\n" + ] + }, + { + "data": { + "image/png": "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8iR333037dq14+zZs2RlZbFy5UoiIiJMa16fe+451qxZQ0REBMnJyTRr1oz58+dTVlZm+o9X48aNmTVrFmPHjiUuLo5Ro0Zx4MABkpKSCAkJYciQIUbs0KFDCQkJYeLEiZw/fx5vb28yMjLIyspixYoVpkeAvr6+zJw5k8TERE6dOkVkZCQeHh7s3r2bhQsXkpmZqQRUpBbnz5/n4MGDrF+//uduioiIwzhduHCh+or2X6B777231sfYVWsqi4qKePrpp/nyyy85efIk5eXldOzYkZEjR5KQkGBaq1jl1VdfZdmyZRw+fJg2bdoQExPD1KlTadq0qSnuhx9+ICkpiS1btlBSUkJAQADJycmEhITc1L6+//77vPrqq+Tl5VFYWIiLiwvdunXj4Ycf5qmnnqr2AtPBgweZPn0627Ztw263069fP2bNmlXjp0fXrVvHvHnz2LdvHxaLhYiICFJSUoydAaoUFxeTkpLCO++8Q1FREb6+vsTHx5se1V/po48+YuHCheTl5XHu3DkCAgJ45plnePDBB+vU53PnzmGz2Tjy/PO41/DFKpGbrekNLuGpSUVFBYcOHaJz587XffFObpzGt/5obOuPxrZuGkwCKrc2JaDiaEpAf/k0vvVHY1t/NLZ1o5EREREREYdSAioiIiIiDqUEVEREREQcSgmoiIiIiDiUElARERERcSgloCIiIiLiUEpARURERMShlICKiIiIiEM1mE9xyq9D47g4mnp4/NzNuKVoU2QREfml0X+NRERERMShlICKiIiIiEMpARURERERh1ICKiIiIiIOpQRURERERBxKCaiIiIiIOJS2YZJfFLf27fnNz92IW5B/LddKLlxwWDtERERAM6AiIiIi4mBKQEVERETEoZSAioiIiIhDKQEVEREREYdSAioiIiIiDqUEVEREREQcSgmoiIiIiDiUElARERERcagGk4B++eWXRERE0LVrVzw9PenQoQMDBw5kzZo1NcZ/8cUXhIWF0bp1a9q1a0dUVBSHDh2qMXbJkiX07t0bi8VCjx49SEtL48cff6wWd/LkScaNG0fHjh1p1aoVAwcOZOvWrTe1nwBHjx7l4Ycfxs/PDy8vL2w2G//xH//Ba6+9ht1uN8W+8MILuLq6VjusVmuNdWdkZBAUFITVasXHx4eEhASKi4urxRUXF5OQkICPjw9Wq5WgoCAy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y5bRuXNn1q1bx5gxY2q874033qCoqIjs7GzjgxEdO3Y0rn/77be4u7sTGRkJQHBwMF9//TX33nsvb731Fs2aNTN+T0REHE8zoCLys/n222/54YcfCA0NNcqcnZ35z//8T/7+979f87733nuPfv36MWnSJDp16kTfvn156aWXKC8vB8DHx4eLFy/yj3/8g8LCQnbt2kXPnj0pLCxk1qxZ15yNFRERx9AMqPyiFH//PU08PH7uZtxSfslf5fjhhx8AaNOmjam8devWHDly5Jr3ffvtt2zbto3Ro0ezYcMG9u/fz+TJk7Hb7fzxj3/EYrGwbNkynnrqKUpLS3nkkUcYPHgw48ePZ/z48Xz77beMGjWKH3/8kcTERB544IF67aeIiJgpARWRX5zKykqcnJyueb2iogIvLy8WLVpE48aN6d27N8ePH2fBggX88Y9/BCA8PJzw8HDjnu3bt5OXl8f8+fPx9/fn9ddfp02bNgQHB3P33XfTunXreu+XiIhc9suaDhGRX5Wqmc+qmdAqp06dqjUhbNu2LV26dKFx48ZGWdeuXfnhhx+4dOlStfiysjImTZrEwoULOXDgAHa7nXvuuQdfX1+6dOnCzp07b1KPRESkLpSAisjPplOnTrRp04bs7Gyj7NKlS+Tk5BAUFHTN+4KCgjh48CAVFRVG2f79+2nbti3NmjWrFv/iiy8yePBgevfuTXl5ubFWFODHH380nYuISP3TI3gRqVfFxcUcOHDAOP/222/58ssvsVqt3HbbbUyYMIG5c+fSpUsXfHx8eOmll2jevDkPPfTQNet86qmneO2110hISGD8+PEcOHCAl156iaeffrpabH5+Pm+//Taff/45cHmmtFGjRqxatYo2bdqwb98+7rzzzpvfcRERuSYloCJSr3bv3s2wYcOM8+effx6ARx99lGXLljF58mRKS0uZOHEiZ86cITAwkHfffZcWLVoY94wbN44jR44Ye3l26NCBd999l2nTptG/f3/atWvHhAkTmDx5sum3KysriYuLY/bs2bi6ugLQvHlzli5dyqRJkygrK2P+/PnG/qEiIuIYThcuXKj8uRshcu7cOWw2G99//z0eegv+pvolvwVfV/feey/33HMPiYmJP3dTTG6Fsf0l0/jWH41t/dHY1o1mQOUXxa19e37zczfCAUouXPi5m9BgnD9/noMHD7J+/fqfuykiInKTKAEVkV+0Fi1asG/fvp+7GSIichNpblhEREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEoZSAioiIiIhDKQEVEREREYdqMAnol19+SUREBF27dsXT05MOHTowcOBA1qxZUy123LhxuLq6Vjt69+5dY91Lliyhd+/eWCwWevToQVpaGj/++GO1uJMnTzJu3Dg6duxIq1atGDhwIFu3br3pfb1adna20YeCgoJq1w8dOkRUVBTt2rWjdevWjBgxgi+++KLGujIyMggKCsJqteLj40NCQgLFxcXV4oqLi0lISMDHxwer1UpQUBAZGRnXbGNWVhZhYWHYbDY8PT0JDQ2tNV5ERER+vRrMRvRnz56lQ4cOjBo1inbt2lFSUsLatWsZO3YsR44cYdq0aab45s2b8/7775vKXFxcqtU7Z84cUlNTmTJlCqGhoezatYvU1FSOHTvGokWLjLiysjLCwsI4e/Ysc+bMwcvLi2XLlnH//fezefNm7rnnnnrpd3FxMc888ww2m43jx49Xu37q1CkGDx6Mh4cHS5YswdnZmXnz5jFs2DC2b9+Or6+vEbt27VrGjBlDbGwss2fPZv/+/SQnJ7Nnzx42bdpkqjcqKordu3eTmppKly5dWLduHbGxsVRUVDB69GhT7OrVqxk/fjzDhg1jyZIlWCwWcnNzmTx5Mt26dcPf379exkZEREQapgb/Lfjf/e53HD9+nL179xpl48aNIzMzk5MnT9Z67+nTp/H19eWRRx7hlVdeMcpfeuklZsyYwY4dO+jevTsAy5YtY9KkSWRnZ9O/f38A7HY7QUFBuLq6sm3btnroHUyePJm///3v3HvvvcyePZvDhw/TqlUr43piYiKLFy/mn//8Jx07dgQuf1fd39+f4OBg3njjDQDKy8vx9fXFz8+Pd99917j/rbfe4sknn+Sdd95h6NChAGzZsoUHH3yQlStX8tBDDxmxI0eO5Ouvv2bv3r00btwYgKNHjxIQEMADDzzAihUrTG0/evQojRs3xmazXbefVd+CPwu4/7ShalAc+SlOfZe4/mhs65fGt/5obOuPxrZuGvzIeHp60qTJT5vIzcrKorS0lJiYGFN5dHQ0lZWVbN682Sh799138fX1NZJPgCZNmjB69Gh27tzJsWPHfloHavHpp5/y17/+lcWLFxsJ39U2bdpEcHCwkXwCuLu7Ex4ezvvvv4/dbgcgNzeXEydOVOtrREQEbm5uphnQTZs24ebmRkREhCk2JiaG48ePs2PHDuByUrt+/XrKysqIj4/HbrcbR0VFBR06dKhT8ikiIiK/Lg0uAa2oqMBut3Pq1CmWLVvG//zP/zB58uRqcRcvXqRz5860aNGC22+/ncmTJ1NYWGiKyc/PB8DPz89UbrPZaNWqFXl5eabYnj17VvudqsfLVXXdLBcvXuTpp59mwoQJ11y7evHiRQ4ePFhju3r27MnFixc5dOiQqX1XxzZt2hRfX19T+/Pz8+natWu1xL7q3vz8fAoKCvD09CQxMRGAvn370rJlS+NITk7+iT0XERGRW12DWQNaZeLEicaj3mbNmjF37lzGjBljivH398ff358ePXoAkJOTw6JFi/jb3/7G9u3bcXNzA6CwsBBnZ2dcXV2r/Y7FYjElrIWFhVgslhrjqq7fTKmpqZSXl5OUlHTNmDNnzlBZWVmndlX9ea3YI0eOGOeFhYV06tTpmnWePn2aZs2akZ2dTVxcHGfOnGH16tWmWG9v71r7V1ZWRllZmXF+/vz5WuNFRETk1tHgEtCEhARiY2M5efIkH3zwAZMnT+bChQtMnDjRiImLizPdExoaSq9evXj00UdZuXKl6bqTk9M1f+vqazcSe6XKykrKy8tNZbUtG9i5cyeLFy8mMzOT5s2bXzPup7TrWrE32ld3d3d69eqFm5sbpaWlBAQEGNcbNWp03XUvc+fOJS0trdYYERERuTU1uEfwt912G3369OHee+/l5Zdf5sknn+S//uu/OHXqVK33hYeH4+rqaqxfBLBarZSWllJSUlItvqioyDRbaLVaa5zlLCoqAmqeWaySnp5uejzdsmXLWts6fvx47rvvPvr06cOZM2c4c+YMpaWlwOWZwqrZQg8PD5ycnOrULqvVCtQ8U3ujfbVarcYj+JycHPbs2WPq28aNG2vtH0B8fDzHjx83jn379l33HhEREbk1NLgZ0Kvdeeed/OUvf+Hbb7/Fy8ur1tjKykrTzF7V2s+8vDwCAwON8hMnTlBQUGBaG+rn52daE1rlq6++MtVVk+HDh/PJJ5/UrUPA119/zddff80777xT7VrPnj3x9/fn73//O82bN8fHx6fGduXl5dG8eXM6d+5sal9eXp7xZj9cfpN/3759jBo1yijz8/MjIyMDu91umqmt+p0ePXoYj+DT09NZunQp69atM144qsu2S87Ozjg7O9dlOEREROQW0+BmQK+2fft2GjVqVOOaxStt2LCBkpIS+vXrZ5QNHjwYFxcX0tPTTbHp6ek4OTkxYsQIoyw8PJy9e/eaZlDtdjtr164lMDCw1re9PT096dOnj+mozQcffFDtePTRR4HL2ya9+uqrRuzIkSPZtm0bR48eNcrOnz/Pxo0bCQsLMxLIwMBA2rZtW62vGzZsoLi4mPDwcFOdxcXFZGZmmmLffPNNbDYbgYGBuLu706dPH8aPH0+jRo3YunWr0bemTZsCUFBQcN2ZaREREfn1aTAzoM888wwtWrSgb9++tG7dmtOnT7NhwwbWr1/PxIkTjdnPI0eO8MQTTxAZGYm3tzdOTk7k5OSwePFiunfvTmxsrFGn1Wpl2rRppKamYrFYjI3o09LSiI2NNc0UPvbYYyxdupTo6GhSU1Px8vJi+fLlfPPNN6btmm6GAQMGVCurmkENCgoy7QP63HPPsWbNGiIiIkhOTqZZs2bMnz+fsrIypk+fbsQ1btyYWbNmMXbsWOLi4hg1ahQHDhwgKSmJkJAQhgwZYsQOHTqUkJAQJk6cyPnz5/H29iYjI4OsrCxWrFhh2hLK19eXmTNnkpiYyKlTp4iMjMTDw4Pdu3ezcOFCMjMzrzszLSIiIr8uDSYB7devH+np6fx//9//x5kzZ3Bzc8Pf35+//OUvREVFGXEtWrSgdevWvPLKK5w8eZLy8nI6duzIH/7wBxISEqq98T516lTc3NxYtmwZL7/8Mm3atGHKlClMnTrVFOfs7Mx7771HUlIS8fHxlJSUEBAQwIYNG+rtK0h14eXlRVZWFtOnT2fcuHHY7Xb69evHBx98QNeuXU2xUVFRNG7cmHnz5pGeno7FYiEqKoqUlJRq9a5Zs4aUlBRmzpxJUVERvr6+vP7666ZH9VUmTpxIjx49WLhwIc8++yznzp0jICCAOXPm6CtIIiIiUk2D/xKS3Br0JaT6o69y1B+Nbf3S+NYfjW390djWjUZGRERERBxKCaiIiIiIOJQSUBERERFxKCWgIiIiIuJQSkBFRERExKGUgIqIiIiIQykBFRERERGHUgIqIiIiIg7VYL6EJL8Oxd9/TxMPj5+7GSIiIlKPNAMqIiIiIg6lBFREREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEoZSAioiIiIhDaR9Q+UX5a/v2uPzcjbjK0xcu/NxNEBERuaVoBlREREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEoZSAioiIiIhDKQEVEREREYdSAioiIiIiDtVgE9DXX38dV1dXWrduXeP1L774grCwMFq3bk27du2Iiori0KFDNcYuWbKE3r17Y7FY6NGjB2lpafz444/V4k6ePMm4cePo2LEjrVq1YuDAgWzduvWm9qsm2dnZuLq64urqSkFBgenaCy+8YFy78rBarTXWlZGRQVBQEFarFR8fHxISEiguLq4WV1xcTEJCAj4+PlitVoKCgsjIyLhmG7OysggLC8Nms+Hp6UloaGit8SIiIvLr1SC/hHTs2DGmT5+OzWbj3Llz1a7v3buXYcOGERAQwBtvvEFZWRkzZ85k8ODBfP7553h5eRmxc+bMITU1lSlTphAaGsquXbtITU3l2LFjLFq0yIgrKysjLCyMs2fPMmfOHLy8vFi2bBn3338/mzdv5p577qmXvhYXF/PMM89gs9k4fvz4NeMyMzNp2bKlcd6oUfV/W6xdu5YxY8YQGxvL7Nmz2b9/P8nJyezZs4dNmzaZYqOioti9ezepqal06dKFdevWERsbS0VFBaNHjzbFrl69mvHjxzNs2DCWLFmCxWIhNzeXyZMn061bN/z9/f/NURAREZFbSYNMQJ999lnuvvtuLBYLmZmZ1a7PmjULZ2dn1q9fj7u7OwC9e/cmICCAl19+mVmzZgFw+vRpZs+ezRNPPMGMGTMAGDBgAHa7nRkzZjBhwgS6d+8OwKpVq8jPzyc7O5v+/fsDEBwcTFBQEElJSWzbtq1e+vqnP/0JDw8P7r33XmbPnn3NuN69e9OqVatrXi8vLycxMZHQ0FAWL14MXG6/m5sbTz75JB9++CFDhw4FYMuWLWRnZ7Ny5UoeeughI/bIkSMkJiYSGRlJ48aNATh69CjPPfccDz/8MCtWrDB+Lzg4mKioKCNOREREpEqDewS/Zs0acnJyWLBgQY3X7XY7H3zwAffdd5+RfAJ07NiRAQMGmGb6srKyKC0tJSYmxlRHdHQ0lZWVbN682Sh799138fX1NZJPgCZNmjB69Gh27tzJsWPHblIP/8+nn37KX//6VxYvXvxvJ3K5ubmcOHGiWl8jIiJwc3MzjcumTZtwc3MjIiLCFBsTE8Px48fZsWMHcDmpXb9+PWVlZcTHx2O3242joqKCDh06YLPZ/q12i4iIyK2nQSWgJ0+eZNq0aaSmptK+ffsaYw4ePMjFixfp2bNntWs9e/bkwIEDlJaWApCfnw+An5+fKc5ms9GqVSvy8vKMsvz8/BrrrHq8XFXXzXLx4kWefvppJkyYQO/eva8b369fP1q0aEGnTp0YO3Ys3333nel6Vfuu7kPTpk3x9fU1tT8/P5+uXbvSpIl5grzq3vz8fAoKCvD09CQxMRGAvn370rJlS+NITk6+8U6LiIjIr0KDegQ/adIkbr/9dp566qlrxhQWFgJgsViqXbNYLFRWVlJUVITNZqOwsBBnZ2dcXV1rjK2qq6rea9V55e/eLKmpqZSXl5OUlFRrXOfOnUlJSSEgIAAXFxd27tzJggUL+Pjjj/n0009p166dqX3X6sORI0eM88LCQjp16lRjHFxeutCsWTOys7OJi4vjzJkzrF692hTr7e1da7vLysooKyszzs+fP19rvIiIiNw6GkwCmpmZyfvvv89nn32Gk5PTdeNri7nyWl3jbjT2SpWVlZSXl5vKrp5dvNLOnTtZvHgxmZmZNG/e/JpxAI888ojpPDg4mODgYAYOHMj8+fOZO3dundp5o311d3enV69euLm5UVpaSkBAgHG9UaNGNb4EdaW5c+eSlpZWa4yIiIjcmhrEI/ji4mImTZrE+PHjsdlsnDlzhjNnznDp0iUAzpw5w4ULFwCM7YdqmpEsKirCyckJDw8PI7a0tJSSkpIaY6+cLbRardesE2qeWaySnp5uejx95dvqNRk/fjz33Xcfffr0MfpatWzg/Pnz150t7Nu3L7fffruxVrOq/XDtcbmRvlqtVuMRfE5ODnv27DH1bePGjbW2DyA+Pp7jx48bx759+657j4iIiNwaGsQM6OnTpzl58iQLFy5k4cKF1a63b9+eESNG8NZbb+Ht7U3z5s1N6zer5OXl4ePjg4uLC/B/az/z8vIIDAw04k6cOEFBQYFpbaifn1+NdX711VemumoyfPhwPvnkkzr2Fr7++mu+/vpr3nnnnWrXevbsib+/P3//+99rraOystI0C3llX6ve7IfLL23t27ePUaNGmWIzMjKw2+2mmdqq/vfo0cN4BJ+ens7SpUtZt26d8cJRXbZdcnZ2xtnZ+bpxIiIicutpEAlomzZt+OCDD6qVz5s3j5ycHDZs2ICnpydw+dH28OHD2bhxI7NmzaJFixYAfPfdd2zfvp1nnnnGuH/w4MG4uLiQnp5uSkDT09NxcnJixIgRRll4eDgTJ05kx44dRqzdbmft2rUEBgbW+ra3p6en0b66qKmv6enpvPnmm7z11lvGus5ryc3NZf/+/fzhD38wygIDA2nbti3p6elERkYa5Rs2bKC4uJjw8HCjbOTIkaxcuZLMzExT7JtvvonNZiMwMJDGjRvTp08f3NzcWL58OVu3bq32uL+goIDKykrTvqsiIiIiDSIBdXFxYcCAAdXK09PTady4cbVriYmJfPjhh0RGRjJ58mRjI3pPT0+effZZI85qtRpv1VssFmMj+rS0NGJjY00zhY899hhLly4lOjqa1NRUvLy8WL58Od98841pu6aboaa+Vs2gBgUFmfb77N+/Pw8//DDdunXD2dmZXbt2sWDBAtq0acOkSZOMuMaNGzNr1izGjh1LXFwco0aN4sCBAyQlJRESEsKQIUOM2KFDhxISEsLEiRM5f/483t7eZGRkkJWVxYoVK0xbQvn6+jJz5kwSExM5deoUkZGReHh4sHv3bhYuXEhmZqYSUBERETFpEAnojeratStbtmwhKSmJ6OhomjRpQnBwMGlpadWSoalTp+Lm5sayZct4+eWXadOmDVOmTGHq1KmmOGdnZ9577z2SkpKIj4+npKSEgIAANmzYUG9fQaqLbt26sXLlSk6cOMGlS5ew2WxERkby/PPPV5uVrdoYft68eaSnp2OxWIiKiiIlJaVavWvWrCElJYWZM2dSVFSEr68vr7/+uulRfZWJEyfSo0cPFi5cyLPPPsu5c+cICAhgzpw5+gqSiIiIVON04cKFyp+7ESLnzp3DZrMxE3D5uRtzlaf/3wtuDVVFRQWHDh2ic+fO192dQG6MxrZ+aXzrj8a2/mhs60YjIyIiIiIOpQRURERERBxKCaiIiIiIOJQSUBERERFxKCWgIiIiIuJQSkBFRERExKGUgIqIiIiIQykBFRERERGHuiW/hCQN15Pff4+Hh8fP3QwRERGpR5oBFRERERGHUgIqIiIiIg6lBFREREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEobQPqPyi/LV9e1zq+TeevnChnn9BREREaqMZUBERERFxKCWgIiIiIuJQSkBFRERExKGUgIqIiIiIQykBFRERERGHUgIqIiIiIg6lBFREREREHEoJqIiIiIg4VINNQF9//XVcXV1p3bp1tWvjxo3D1dW12tG7d+8a61qyZAm9e/fGYrHQo0cP0tLS+PHHH6vFnTx5knHjxtGxY0datWrFwIED2bp1603v2+HDh2tsv6urKxkZGdXiDx06RFRUFO3ataN169aMGDGCL774osa6MzIyCAoKwmq14uPjQ0JCAsXFxdXiiouLSUhIwMfHB6vVSlBQUI2/XSUrK4uwsDBsNhuenp6EhobWGi8iIiK/Xg3yS0jHjh1j+vTp2Gw2zp07V2NM8+bNef/9901lLi7Vv7EzZ84cUlNTmTJlCqGhoezatYvU1FSOHTvGokWLjLiysjLCwsI4e/Ysc+bMwcvLi2XLlnH//fezefNm7rnnnpvbSeAPf/gDDz30kKnMx8fHdH7q1CkGDx6Mh4cHS5YswdnZmXnz5jFs2DC2b9+Or6+vEbt27VrGjBlDbGwss2fPZv/+/SQnJ7Nnzx42bdpkqjcqKordu3eTmppKly5dWLduHbGxsVRUVDB69GhT7OrVqxk/fjzDhg1jyZIlWCwWcnNzmTx5Mt26dcPf3/8mj4yIiIg0ZA0yAX322We5++67sVgsZGZm1hjTqFEj+vXrV2s9p0+fZvbs2TzxxBPMmDEDgAEDBmC325kxYwYTJkyge/fuAKxatYr8/Hyys7Pp378/AMHBwQQFBZGUlMS2bdtuXgf/nw4dOly3DwsWLKCgoIDs7Gw6duwIwF133YW/vz+zZs3ijTfeAKC8vJzExERCQ0NZvHix0X43NzeefPJJPvzwQ4YOHQrAli1byM7OZuXKlUYCHBwczJEjR0hMTCQyMpLGjRsDcPToUZ577jkefvhhVqxYYbQrODiYqKgoI05ERESkSoN7BL9mzRpycnJYsGDBv11XVlYWpaWlxMTEmMqjo6OprKxk8+bNRtm7776Lr6+vkXwCNGnShNGjR7Nz506OHTv2b7fnp9i0aRPBwcFG8gng7u5OeHg477//Pna7HYDc3FxOnDhRra8RERG4ubmZZkA3bdqEm5sbERERptiYmBiOHz/Ojh07gMtJ7fr16ykrKyM+Ph673W4cFRUVdOjQAZvNVl9dFxERkQaqQSWgJ0+eZNq0aaSmptK+fftaYy9evEjnzp1p0aIFt99+O5MnT6awsNAUk5+fD4Cfn5+p3Gaz0apVK/Ly8kyxPXv2rPY7VY+Xq+q6mebPn4+HhwetWrVi0KBBvPfee6brFy9e5ODBgzW2q2fPnly8eJFDhw6Z2nd1bNOmTfH19TW1Pz8/n65du9KkiXmCvOre/Px8CgoK8PT0JDExEYC+ffvSsmVL40hOTv43ey8iIiK3qgb1CH7SpEncfvvtPPXUU7XG+fv74+/vT48ePQDIyclh0aJF/O1vf2P79u24ubkBUFhYiLOzM66urtXqsFgspoS1sLAQi8VSY1zV9ZulWbNmPPHEE4SEhNC2bVu+++47XnvtNR566CEWL15MbGwsAGfOnKGysrJO7ar681qxR44cMc4LCwvp1KnTNes8ffo0zZo1Izs7m7i4OM6cOcPq1atNsd7e3rX2saysjLKyMuP8/PnztcaLiIjIraPBJKCZmZm8//77fPbZZzg5OdUaGxcXZzoPDQ2lV69ePProo6xcudJ0vba6rr52I7FXqqyspLy83FR29ezilWw2m+kFKLj8qDw4OJg//elPREdHm+6/GX240b66u7vTq1cv3NzcKC0tJSAgwLjeqFEjGjWqfXJ97ty5pKWl1RojIiIit6YG8Qi+uLiYSZMmMX78eGw2G2fOnOHMmTNcunQJuDwTeOHChVrrCA8Px9XV1Vi/CGC1WiktLaWkpKRafFFRkWm20Gq11jjLWVRUBNQ8s1glPT3d9Hi6ZcuWtXe4Bk2bNuXBBx/k9OnT7N+/HwAPDw+cnJzq1C6r1QrUPFN7o321Wq3GI/icnBz27Nlj6tvGjRuv25/4+HiOHz9uHPv27bvuPSIiInJraBAzoKdPn+bkyZMsXLiQhQsXVrvevn17RowYwVtvvVVrPZWVlaaZvaq1n3l5eQQGBhrlJ06coKCgwLQ21M/Pz7QmtMpXX31lqqsmw4cP55NPPqm1bXVRWVkJYMwuNm/eHB8fnxrblZeXR/PmzencubOpfXl5ecab/QB2u519+/YxatQoo8zPz4+MjAzsdrtpprXqd3r06GE8gk9PT2fp0qWsW7fOeOGoLtsuOTs74+zsfEP9FxERkVtDg5gBbdOmDR988EG1Y9CgQbi4uPDBBx/wpz/9qdY6NmzYQElJiWlbo8GDB+Pi4kJ6eropNj09HScnJ0aMGGGUhYeHs3fvXtMMqt1uZ+3atQQGBtb6trenpyd9+vQxHTfqxx9/5O2336ZVq1amvUBHjhzJtm3bOHr0qFF2/vx5Nm7cSFhYmJFABgYG0rZt22p93bBhA8XFxYSHh5vqLC4urrbF1ZtvvonNZiMwMBB3d3f69OnD+PHjadSoEVu3bjX61rRpUwAKCgo4derUDfdVREREbm0NYgbUxcWFAQMGVCtPT0+ncePGpmtHjhzhiSeeIDIyEm9vb5ycnMjJyWHx4sV0797deIEHLj9Krnqr3mKxGBvRp6WlERsba5opfOyxx1i6dCnR0dGkpqbi5eXF8uXL+eabb0zbNd0M06ZNw263ExQURJs2bTh69CivvfYa//znP3nttddMe2s+99xzrFmzhoiICJKTk2nWrBnz58+nrKyM6dOnG3GNGzdm1qxZjB07lri4OEaNGsWBAwdISkoiJCSEIUOGGLFDhw4lJCSEiRMncv78eby9vcnIyCArK4sVK1aYft/X15eZM2eSmJjIqVOniIyMxMPDg927d7Nw4UIyMzPx8vK6qeMjIiIiDVuDSEBvRIsWLWjdujWvvPIKJ0+epLy8nI4dO/KHP/yBhISEam+8T506FTc3N5YtW8bLL79MmzZtmDJlClOnTjXFOTs7895775GUlER8fDwlJSUEBASwYcOGm/4VpB49evDXv/6VdevWce7cOVq0aMGdd97Jxo0bGTRokCnWy8uLrKwspk+fzrhx47Db7fTr148PPviArl27mmKrNoafN28e6enpWCwWoqKiSElJqdaGNWvWkJKSwsyZMykqKsLX15fXX3/d9Ki+ysSJE+nRowcLFy7k2Wef5dy5cwQEBDBnzhx9BUlERESqcbpw4ULlz90IkXPnzmGz2ZgJVP9g6s319HVeWLvVVFRUcOjQITp37nzd3Qnkxmhs65fGt/5obOuPxrZuNDIiIiIi4lBKQEVERETEoZSAioiIiIhDKQEVEREREYdSAioiIiIiDqUEVEREREQcSgmoiIiIiDiUElARERERcahb7ktI0rA9+f33eHh4/NzN+NkdO3aMpKQksrKyuHjxIl26dGHJkiX07t27xvhx48bx5ptvVivv3r07ubm5AGRnZzNlyhROnjzJiBEjWLx4Mc2aNQPg7NmzDBgwgM2bN3PbbbfVX8dERETQDKjIL05RURGhoaE0bdqUDRs2sGvXLv785z/TsmXLa97z0ksvceDAAePYt28fVquVBx54ALj8ZY4xY8YwZswYPv74Y3bt2sXKlSuN+5OTkxkzZoySTxERcQjNgIr8wsyfP58OHTqwdOlSo+y3v/1trfe0bNnSlKBu2rSJoqIiYmJigMtJbUFBAePGjcPFxYXhw4ezZ88eAD7//HN2797Nf//3f9dDb0RERKrTDKjIL8z7779P7969iY6O5re//S3/8R//YZqtrItVq1YxcOBAOnbsCIDVaqVt27Z8/PHHXLx4kc8++4yePXty6dIlnnvuORYuXEjjxo3rozsiIiLVKAEV+YU5dOgQf/nLX/Dx8WHjxo2MHTuW+Pj4Gtd41uT48eN89NFHxMbGGmVOTk6sWrWKF198kTvvvJNevXrx2GOPMW/ePH73u9/h4uJCaGgod9xxB6+99lo99UxEROQyPYIX+YWpqKigT58+zJgxA4A77riDr7/+mr/85S88+uij170/PT0dDw8PRo4caSq/6667+OSTT4zzb775hjVr1vDZZ58xZMgQJkyYwODBgwkMDOTuu+/G39//5nZMRETk/9EMqMgvTNu2benWrZuprGvXrnz33XfXvbeyspLVq1fz8MMPG2+4XysuLi6OP//5z1RUVPDll1/ywAMP0Lp1a+655x5ycnL+7X6IiIhcixJQkV+YoKAgvvnmG1PZN998Y6znrM0nn3zCgQMHePzxx2uNW7VqFVarlbCwMMrLywH48ccfjT+rykREROqDHsHLL8pf27fH5d+s4+kLF25KW34ucXFxhISE8NJLLxEREcHOnTtZuXIlr7zyynXvXbVqFYGBgfj5+V0z5uTJk8yePZuPP/4YAIvFQrdu3Vi8eDGhoaH87W9/IyEh4ab1R0RE5GqaARX5hbnzzjtZu3Yt69atIzAwkNmzZzNnzhwefvhhI+aFF16ge/fupvvOnj3Lxo0brzv7mZCQwHPPPUe7du2MsqVLl7J+/XoiIyOZOHEiffv2vbmdEhERuYJmQEV+gYYNG8awYcOuef3w4cPcc889prKWLVtSUFBw3bpXrVpVraxv377s3r37xhsqIiLyEygBFWmAcnJy+Oijj37uZoiIiPwkSkBFGqD8/PyfuwkiIiI/mdaAioiIiIhDKQEVEREREYdSAioiIiIiDqUEVEREREQcqsEkoNu3b8fV1bXGIzc3t1r8F198QVhYGK1bt6Zdu3ZERUVx6NChGutesmQJvXv3xmKx0KNHD9LS0oyvwlzp5MmTjBs3jo4dO9KqVSsGDhzI1q1bb3pfDx8+fM2+ZmRkmGJfeOGFGuOsVmuNdWdkZBAUFITVasXHx4eEhASKi4urxRUXF5OQkICPjw9Wq5WgoKBqv32lrKwswsLCsNlseHp6EhoaWmu8iIiI/Ho1uLfgU1JSCA4ONpX16NHDdL53716GDRtGQEAAb7zxBmVlZcycOZPBgwfz+eef4+XlZcTOmTOH1NRUpkyZQmhoKLt27SI1NZVjx46xaNEiI66srIywsDDOnj3LnDlz8PLyYtmyZdx///1s3ry52p6MN8Mf/vAHHnroIVOZj49PjbGZmZm0bNnSOG/UqPq/LdauXcuYMWOIjY1l9uzZ7N+/n+TkZPbs2cOmTZtMsVFRUezevZvU1FS6dOnCunXriI2NpaKigtGjR5tiV69ezfjx4xk2bBhLlizBYrGQm5vL5MmT6datG/7+/j91CEREROQW1OAS0C5dutCvX79aY2bNmoWzszPr16/H3d0dgN69exMQEMDLL7/MrFmzADh9+jSzZ8/miSeeYMaMGQAMGDAAu93OjBkzmDBhgvG1mVWrVpGfn092djb9+/cHIDg4mKCgIJKSkti2bdtN72uHDh2u29cqvXv3plWrVte8Xl5eTmJiIqGhoSxevBi43H43NzeefPJJPvzwQ4YOHQrAli1byM7OZuXKlUYCHBwczJEjR0hMTCQyMpLGjRsDcPToUZ577jkefvhhVqxYYfxecHAwUVFRRpyIiIhIlQbzCL6u7HY7H3zwAffdd5+RfAJ07NiRAQMGmGb6srKyKC0tJSYmxlRHdHQ0lZWVbN682Sh799138fX1NZJPgCZNmjB69Gh27tzJsWPH6rFX/77c3FxOnDhRra8RERG4ubmZxmXTpk24ubkRERFhio2JieH48ePs2LEDuJzUrl+/nrKyMuLj47Hb7cZRUVFBhw4dsNls9d85ERERaVAaXAI6adIk3N3dadu2LeHh4Xz22Wem6wcPHuTixYv07Nmz2r09e/bkwIEDlJaWAv+3mbefn58pzmaz0apVK/Ly8oyy/Pz8GuuserxcHxuDz58/Hw8PD1q1asWgQYN47733rhnbr18/WrRoQadOnRg7dizfffed6XpV+67uQ9OmTfH19TW1Pz8/n65du9KkiXmCvOre/Px8CgoK8PT0JDExEbj8KceWLVsaR3Jy8k/vuIiIiNzSGswjeHd3d55++mkGDBiA1WrlwIEDvPzyy9x77728/fbbDB48GIDCwkIALBZLtTosFguVlZUUFRVhs9koLCzE2dkZV1fXGmOr6qqq91p1Xvm7N0OzZs144oknCAkJoW3btnz33Xe89tprPPTQQyxevJjY2FgjtnPnzqSkpBAQEICLiws7d+5kwYIFfPzxx3z66ae0a9fO1L5r9eHIkSOmvnbq1OmafT19+jTNmjUjOzubuLg4zpw5w+rVq02x3t7etfaxrKyMsrIy4/z8+fO1D4qIiIjcMhpMAnrHHXdwxx13GOd333034eHh9OvXj6SkJCMBreLk5HTNuq68Vte4G429UmVlJeXl5aayq2cXr2Sz2UwvQMHlR+XBwcH86U9/Ijo62rj/kUceMcUFBwcTHBzMwIEDmT9/PnPnzq1TO2+0r+7u7vTq1Qs3NzdKS0sJCAgwrjdq1KjGl6CuNHfuXNLS0mqNERERkVtTg3sEfyUPDw+GDRvGV199xcWLFwGM7YdqmpEsKirCyckJDw8PI7a0tJSSkpIaY6+cLbRardesE2qeWaySnp5uejx95dvqddW0aVMefPBBTp8+zf79+2uN7du3L7fffruxVrOq/XDtcbmRvlqtVuMRfE5ODnv27DH1bePGjdftT3x8PMePHzeOffv2XfceERERuTU0mBnQa6msrAT+b8bO29ub5s2bm9ZvVsnLy8PHxwcXFxfg/9Z+5uXlERgYaMSdOHGCgoIC09pQPz+/Guv86quvTHXVZPjw4XzyySc32rVqqvp6vdnFqtgr467sa9Wb/XD5pa19+/YxatQoU2xGRgZ2u900U1vV/x49ehiP4NPT01m6dCnr1q0zXjiqy7ZLzs7OODs7XzdOREREbj0Nega0qKiIDz74wFj/CJcfbQ8fPpyNGzea1hV+9913bN++nfDwcKNs8ODBuLi4kJ6ebqo3PT0dJycnRowYYZSFh4ezd+9e06yi3W5n7dq1BAYG1vq2t6enJ3369DEdN+rHH3/k7bffplWrVtfcC7RKbm4u+/fvNyXVgYGBtG3btlpfN2zYQHFxsWlcRo4cSXFxMZmZmabYN998E5vNRmBgIO7u7vTp04fx48fTqFEjtm7davStadOmABQUFHDq1Kkb7quIiIjc2hrMDGhsbCy33XYbffr0wdPTkwMHDrBw4UJOnjzJ0qVLTbGJiYl8+OGHREZGMnnyZGMjek9PT5599lkjzmq1Mm3aNFJTU7FYLMZG9GlpacTGxppmCh977DGWLl1KdHQ0qampeHl5sXz5cr755hvTdk03w7Rp07Db7QQFBdGmTRuOHj3Ka6+9xj//+U9ee+01096a/fv35+GHH6Zbt244Ozuza9cuFixYQJs2bZg0aZIR17hxY2bNmsXYsWOJi4tj1KhRHDhwgKSkJEJCQhgyZIgRO3ToUEJCQpg4cSLnz5/H29ubjIwMsrKyWLFihen3fX19mTlzJomJiZw6dYrIyEg8PDzYvXs3CxcuJDMz07Txv4iIiIjThQsXKn/uRtTF3Llzefvttzl8+DDFxcVYLBbuuusu4uPjufPOO6vFf/HFFyQlJZGbm0uTJk0IDg4mLS2txrezX331VZYtW8bhw4dp06YNMTExTJ061ZjJq/LDDz+QlJTEli1bKCkpISAggOTkZEJCQm5qX1etWsVf//pXDh48yLlz52jRogV33nkncXFxDBo0yBT7+OOP88UXX3DixAkuXbqEzWZjyJAhPP/88zXOyq5bt4558+axb98+LBYLERERpKSk4ObmZoorLi4mJSWFd955h6KiInx9fYmPjzc9qr/SRx99xMKFC8nLy+PcuXMEBATwzDPP8OCDD9apz+fOncNmszETcKnbMF3T0xcu/Js13FoqKio4dOgQnTt3rtPyDak7jW390vjWH41t/dHY1k2DSUDl1qYEtP7oL8P6o7GtXxrf+qOxrT8a27rRyIiIiIiIQykBFRERERGHUgIqIiIiIg6lBFREREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEoRrMpzjl1+HJ77/Hw8Pj526GiIiI1CPNgIqIiIiIQykBFRERERGHUgIqIiIiIg6lBFREREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lDaB1R+Uf7avj0uNxD/9IUL9dYWERERqR+aARURERERh1ICKiIiIiIOpQRURERERBxKCaiIiIiIOJQSUBERERFxKCWgIiIiIuJQSkBFRERExKGUgIqIiIiIQzWYBHT79u24urrWeOTm5ppix40bV2Nc7969a6x7yZIl9O7dG4vF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mgEVEREREYdSAioiIiIiDqUEVEREREQcSgmoiIiIiDiUElARERERcSgloCIiIiLiUNqGSX5R2rdvX2P5hQsXHNwSERERqS+aARURERERh1ICKiIiIiIOpQRURERERBxKCaiIiIiIOJQSUBERERFxKCWgIiIiIuJQSkBFRERExKGUgIqIiIiIQzW4BPSzzz7jgQceoH379nh6ehIQEMCLL75oihk3bhyurq7Vjt69e9dY55IlS+jduzcWi4UePXqQlpbGjz/+WC3u5MmTjBs3jo4dO9KqVSsGDhzI1q1bb3ofX3jhhRrbX3VkZGSY4g8dOkRUVBTt2rWjdevWjBgxgi+++KLGujMyMggKCsJqteLj40NCQgLFxcXV4oqLi0lISMDHxwer1UpQUFC1371SVlYWYWFh2Gw2PD09CQ0NrTVeREREfr0a1JeQ3nrrLcaOHUtERATLly/H1dWVQ4cOcfz48WqxzZs35/333zeVubi4VIubM2cOqampTJkyhdDQUHbt2kVqairHjh1j0aJFRlxZWRlhYWGcPXuWOXPm4OXlxbJly7j//vvZvHkz99xzz03rZ2xsLIMHD65WPmHCBA4dOmS6durUKQYPHoyHhwdLlizB2dmZefPmMWzYMLZv346vr68Ru3btWsaMGUNsbCyzZ89m//79JCcns2fPHjZt2mT6raioKHbv3k1qaipdunRh3bp1xMbGUlFRwejRo02xq1evZvz48QwbNowlS5ZgsVjIzc1l8uTJdOvWDX9//5s2NiIiItLwOV24cKHy525EXRw7dow77riDRx55hAULFtQaO27cODIzMzl58mStcadPn8bX15dHHnmEV155xSh/6aWXmDFjBjt27KB79+4ALFu2jEmTJpGdnU3//v0BsNvtBAUF4erqyrZt2/69Dl7H4cOH8fPzY/To0axYscIoT0xMZPHixfzzn/+kY8eOAJw7dw5/f3+Cg4N54403ACgvL8fX1xc/Pz/effdd4/633nqLJ598knfeeYehQ4cCsGXLFh588EFWrlzJQw89ZMSOHDmSr7/+mr1799K4cWMAjh49SkBAAA888ICpXVXXGjdujM1mu27/zp07V2ucPsX501VUVHDo0CE6d+5Mo0YN7qHHL5rGtn5pfOuPxrb+aGzrpsGMzOuvv86FCxeYPHnyTaszKyuL0tJSYmJiTOXR0dFU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06pVK7y9vfn973/P6dOnjesff/wxvXr1wmaz8dRTT3Hp0iXj2tmzZ+nVqxffffddvfRHRETk56QEVKQOLly4gL+/P/Pnz69T/GeffcZTTz3F448/zs6dO0lPT2fXrl1MmDABuPyW5JNPPsmYMWP4+OOP2bVrFytXrjTuT05OZsyYMdx222310h8REZGfU4PZiF7k5zR06FCGDh1a5/jc3Fx++9vf8vTTTwPQqVMnxowZw3//938Dl78SVVBQwLhx43BxcWH48OHs2bMHgM8//5zdu3cbsSIiIrcazYCK1IOgoCC+//57tmzZQmVlJT/88AOZmZnce++9AHh5edG2bVs+/vhjLl68yGeffUbPnj25dOkSzz33HAsXLrzm169EREQaOiWg8ovy/fffc+HChWpHQxMUFMRf//pXHn/8cTw8PPD29qZly5bMmzcPACcnJ1avXs2LL77InXfeSa9evXjssceYN28ev/vd73BxcSE0NJQ77riD11577WfujYiIyM2lR/Ai9eDrr78mPj6e559/nkGDBnHixAkSExN59tlnWbJkCQB33XUXn3zyiXHPN998w5o1a/jss88YMmQIEyZMYPDgwQQGBnL33Xfj7+//c3VHRETkplICKlIP5s6dy3/8x38wadIkAPz9/XF1dWXw4MH86U9/qvbZ0crKSuLi4vjzn/9MRUUFX375JQ888AC/+c1vuOeee8jJyVECKiIitww9ghepBxcvXqz2DeDa1nSuWrUKq9VKWFgY5eXlAPz444/Gn1VlIiIitwIloCJ1UFxczJdffsmXX34JwLfffsuXX355zX06hw0bxsaNG1m+fDmHDh3i888/Jz4+nr59+1ab/Tx58iSzZ89m7ty5AFgsFrp168bixYv53//9X/72t78RFBRUvx0UERFxICWgInWwe/du7rrrLu666y4Ann/+ee666y5mzpwJwAsvvED37t2N+JiYGF588UWWLl1KYGAg0dHR3H777axZs6Za3QkJCTz33HO0a9fOKFu6dCnr168nMjKSiRMn0rdv33ruoYiIiONoDahIHQwYMKDWt/EPHz7MPffcYyr7wx/+wB/+8Ifr1r1q1apqZX379mX37t033lAREZEGQAmoyE2Qk5PDRx999HM3Q0REpEFQAiq/KDGLP6WJy2+M8w1TBv6Mram7/Pz8n7sJIiIiDYbWgIqIiIiIQykBFRERERGHUgIqIiIiIg6lBFREREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEoRpMAjpu3DhcXV2veeTm5priv/jiC8LCwmjdujXt2rUjKiqKQ4cO1Vj3kiVL6N27NxaLhR49epCWlsaPP/5YLe7kyZOMGzeOjh070qpVKwYOHMjWrVtvel9feOGFWvuakZFx3Vir1Vpj3RkZGQQFBWG1WvHx8SEhIYHi4uJqccXFxSQkJODj44PVaiUoKMj0u1fLysoiLCwMm82Gp6cnoaGhtcaLiIjIr1eD+RLS888/z9ixY6uVjxo1imbNmnHnnXcaZXv37mXYsGEEBATwxhtvUFZWxsyZMxk8eDCff/45Xl5eRuycOXNITU1lypQphIaGsmvXLlJTUzl27BiLFi0y4srKyggLC+Ps2bPMmTMHLy8vli1bxv3338/mzZurfQf83xEbG8vgwYOrlU+YMIFDhw7VeC0zM5OWLVsa540aVf+3xdq1axkzZgyxsbHMnj2b/fv3k5yczJ49e9i0aZMpNioqit27d5OamkqXLl1Yt24dsbGxVFRUMHr0aFPs6tWrGT9+PMOGDWPJkiVYLBZyc3OZPHky3bp1w9/f/6cOhYiIiNyCGkwC6u3tjbe3t6nsk08+oaCggGnTptG4cWOjfNasWTg7O7N+/Xrc3d0B6N27NwEBAbz88svMmjULgNOnTzN79myeeOIJZsyYAcCAAQOw2+3MmDGDCRMm0L17dwBWrVpFfn4+2dnZ9O/fH4Dg4GCCgoJISkpi27ZtN62v7du3p3379qayw4cP8/XXXzN69Gg8PDyq3dO7d29atWp1zTrLy8tJTEwkNDSUxYsXG+13c3PjySef5MMPP2To0KEAbNmyhezsbFauXMlDDz1kxB45coTExEQiIyON8T569CjPPfccDz/8MCtWrDB+Lzg4mKioKNP/LiIiIiLQgB7B12TVqlU4OTnx2GOPGWV2u50PPviA++67z0g+ATp27MiAAQNMM31ZWVmUlpYSExNjqjc6OprKyko2b95slL377rv4+voaySdAkyZNGD16NDt37uTYsWP10UXDG2+8QWVlJbGxsT/p/tzcXE6cOFGtrxEREbi5uZnGZdOmTbi5uREREWGKjYmJ4fjx4+zYsQO4nNSuX7+esrIy4uPjsdvtxlFRUUGHDh2w2Ww/qb0iIiJy62qwCejZs2fJzMzkd7/7HZ06dTLKDx48yMWLF+nZs2e1e3r27MmBAwcoLS0FID8/HwA/Pz9TnM1mo1WrVuTl5Rll+fn5NdZZ9Xi5qq76UFFRQXp6Oj4+Ptd81N+vXz9atGhBp06dGDt2LN99953pelX7ru5D06ZN8fX1NbU/Pz+frl270qSJeYK86t78/HwKCgrw9PQkMTERgL59+9KyZUvjSE5O/vc6LSIiIresBvMI/moZGRlcvHiRxx9/3FReWFgIgMViqXaPxWKhsrKSoqIibDYbhYWFODs74+rqWmNsVV1V9V6rzit/tz78z//8D0ePHjWWCVypc+fOpKSkEBAQgIuLCzt37mTBggV8/PHHfPrpp7Rr187Uvmv14ciRI8Z5YWGhKam/Mg4uL11o1qwZ2dnZxMXFcebMGVavXm2KvXq5xNXKysooKyszzs+fP19rvIiIiNw6GmwCumrVKjw9PQkPD6/xupOT0zXvvfJaXeNuNPZKlZWVlJeXm8qunl2szRtvvEGTJk2Ijo6udu2RRx4xnQcHBxMcHMzAgQOZP38+c+fOrVM7b7Sv7u7u9OrVCzc3N0pLSwkICDCuN2rUqMaXoK40d+5c0tLSao0RERGRW1ODfAT/r3/9i927dzN69GicnZ1N16q2H6ppRrKoqAgnJyfjJR6r1UppaSklJSU1xl45W2i1Wq9ZJ9Q8s1glPT3d9Hj6yrfVr6egoID33nuPe++9l7Zt29bpnr59+3L77bcbazWr2g/XHpcb6avVajUewefk5LBnzx5T3zZu3HjdNsbHx3P8+HHj2LdvX536JiIiIg1fg5wBXbVqFUCNL+R4e3vTvHlz0/rNKnl5efj4+ODi4gL839rPvLw8AgMDjbgTJ05QUFBgWhvq5+dXY51fffWVqa6aDB8+nE8++aQOPatuzZo1XLp06YZfPqqsrDTNQl7Z16o3++HyS1v79u1j1KhRptiMjAzsdrtppraq/z169DAewaenp7N06VLWrVtnvHBUl22XnJ2dq/3jQURERH4dGtwMaFlZGW+99RZ9+/atMelr0qQJw4cPZ+PGjaZ1hd999x3bt283PbIfPHgwLi4upKenm+pIT0/HycmJESNGGGXh4eHs3bvXNKtot9tZu3YtgYGBtb7t7enpSZ8+fUxHXa1atQqbzcaQIUPqfE9ubi779+83JdWBgYG0bdu2Wl83bNhAcXGxaVxGjhxJcXExmZmZptg333wTm81GYGAg7u7u9OnTh/Hjx9OoUSO2bt1q9K1p06bA5dnbU6dO1bndIiIi8uvQ4GZAN23aRGFhIampqdeMSUxM5MMPPyQyMpLJkycbG9F7enry7LPPGnFWq5Vp06aRmpqKxWIxNqJPS0sjNjbWNFP42GOPsXTpUqKjo0lNTcXLy4vly5fzzTffmLZrupl27NjB119/TUJCwjX30+zfvz8PP/ww3bp1w9nZmV27drFgwQLatGnDpEmTjLjGjRsza9Ysxo4dS1xcHKNGjeLAgQMkJSUREhJiSnCHDh1KSEgIEydO5Pz583h7e5ORkUFWVhYrVqwwtcXX15eZM2eSmJjIqVOniIyMxMPDg927d7Nw4UIyMzNNG/+LiIiINLgEdNWqVbi6uhIZGXnNmK5du7JlyxaSkpKIjo6mSZMmBAcHk5aWVi0Zmjp1Km5ubixbtoyXX36ZNm3aMGXKFKZOnWqKc3Z25r333iMpKYn4+HhKSkoICAhgw4YNN/UrSFf31cnJqdqb/lfq1q0bK1eu5MSJE1y6dAmbzUZkZCTPP/98tVnZqo3h582bR3p6OhaLhaioKFJSUqrVu2bNGlJSUpg5cyZFRUX4+vry+uuvmx7VV5k4cSI9evRg4cKFPPvss5w7d46AgADmzJmjryCJiIhINU4XLlyo/LkbIXLu3DlsNhsh09fRxOU3RvmGKQN/xlbdGioqKjh06BCdO3e+7u4EcmM0tvVL41t/NLb1R2NbNxoZEREREXEoJaAiIiIi4lBKQEVERETEoZSAioiIiIhDKQEVEREREYdSAioiIiIiDqUEVEREREQcSgmoiIiIiDhUg/sSktzaVk+4Gw8Pj5+7GSIiIlKPNAMqIiIiIg6lBFREREREHEoJqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEoZSAioiIiIhDaR9Q+UWJWfwpTVx+A8CGKQN/5taIiIhIfdAMqIiIiIg4lBJQEREREXEoJaAiIiIi4lBKQEVERETEoZSAioiIiIhDKQEVEREREYdSAioiIiIiDqUEVEREREQcqsEkoOPGjcPV1fWaR25u7nVje/fuXWPdS5YsoXfv3lgsFnr06EFaWho//vhjtbiTJ08ybtw4OnbsSKtWrRg4cCBbt26tl/4eOHCAMWPG0LVrVzw9PenZsyfTpk3j9OnT1WIPHTpEVFQU7dq1o3Xr1owYMYIvvviixnozMjIICgrCarXi4+NDQkICxcXF1eKKi4tJSEjAx8cHq9VKUFAQGRkZ12xvVlYWYWFh2Gw2PD09CQ0NrTVeREREfr0azJeQnn/+ecaOHVutfNSoUTRr1ow777zTVN68eXPef/99U5mLi0u1++fMmUNqaipTpkwhNDSUXbt2kZqayrFjx1i0aJERV1ZWRlhYGGfPnmXOnDl4eXmxbNky7r//fjZv3sw999xzk3oKp06dYuDAgbRo0YLk5GRuu+02vvzyS1544QW2b9/Op59+SqNGjYzYwYMH4+HhwZIlS3B2dmbevHkMGzaM7du34+vra9S7du1axowZQ2xsLLNnz2b//v0kJyezZ88eNm3aZGpDVFQUu3fvJjU1lS5durBu3TpiY2OpqKhg9OjRptjVq1czfvx4hg0bxpIlS7BYLOTm5jJ58mS6deuGv7//TRsbERERafgaTALq7e2Nt7e3qeyTTz6hoKCAadOm0bhxY9O1Ro0a0a9fv1rrPH36NLNnz+aJJ55gxowZAAwYMAC73c6MGTOYMGEC3bt3B2DVqlXk5+eTnZ1N//79AQgODiYoKIikpCS2bdt2s7rKe++9x+nTp1m1ahUDBw40fqusrIyUlBT++c9/cscddwCwYMECCgoKyM7OpmPHjgDcdddd+Pv7M2vWLN544w0AysvLSUxMJDQ0lMWLFxt1urm58eSTT/Lhhx8ydOhQALZs2UJ2djYrV67koYceMmKPHDlCYmIikZGRxngfPXqU5557jocffpgVK1YYfQgODiYqKqra/y4iIiIiDeYRfE1WrVqFk5MTjz322E+6Pysri9LSUmJiYkzl0dHRVFZWsnnzZqPs3XffxdfX10g+AZo0acLo0aPZuXMnx44d+2mdqEGTJpf/XdCyZUtTuYeHB2Ceyd20aRPBwcFG8gng7u5OeHg477//Pna7HYDc3FxOnDhRra8RERG4ubmZZkA3bdqEm5sbERERptiYmBiOHz/Ojh07gMtJ7fr16ykrKyM+Ph673W4cFRUVdOjQAZvN9m+OhoiIiNxqGmwCevbsWTIzM/nd735Hp06dql2/ePEinTt3jud3GAAAOFdJREFUpkWLFtx+++1MnjyZwsJCU0x+fj4Afn5+pnKbzUarVq3Iy8szxfbs2bPa71Q9Xq6q62YYOXIkt912G3/84x/Jz8+nuLiYnJwc5s2bx/Dhw+nWrZvRx4MHD9bYrp49e3Lx4kUOHTpkat/VsU2bNsXX19fU/vz8fLp27WokwlfWWXW9oKAAT09PEhMTAejbty8tW7Y0juTk5Js0GiIiInKraTCP4K+WkZHBxYsXefzxx6td8/f3x9/fnx49egCQk5PDokWL+Nvf/sb27dtxc3MDoLCwEGdnZ1xdXavVYbFYTAlrYWEhFoulxriq6zdLy5Yt2bp1K48++iiBgYFGeUREBH/5y1+M8zNnzlBZWVmndlX9ea3YI0eOGOeFhYU1JvVV954+fZpmzZqRnZ1NXFwcZ86cYfXq1abYq5dLXK2srIyysjLj/Pz587XGi4iIyK2jwSagq1atwtPTk/Dw8GrX4uLiTOehoaH06tWLRx99lJUrV5quOzk5XfM3rr52I7FXqqyspLy83FR29ezilYqKihg9ejQlJSX89a9/pUOHDuTn5/Piiy8yatQo3nnnHdP9N6MPN9pXd3d3evXqhZubG6WlpQQEBBjXGzVqZLwkdS1z584lLS2t1hgRERG5NTXIR/D/+te/2L17N6NHj8bZ2blO94SHh+Pq6mqsXwSwWq2UlpZSUlJSLb6oqMg0W2i1Wmuc5SwqKgJqnlmskp6ebno8ffXazqvNnz+ff/7zn2zatInRo0dz991389RTT/HXv/6Vjz/+mLVr1wKX14Q6OTnVqV1WqxWoeab2RvtqtVqNR/A5OTns2bPH1LeNGzfW2j+A+Ph4jh8/bhz79u277j0iIiJya2iQM6CrVq0CIDY29obuq6ysNM3sVa39zMvLMz3qPnHiBAUFBaa1oX5+fqY1oVW++uorU101GT58OJ988kmd2/nPf/6Tdu3aVXuBp2qrqar1ms2bN8fHx6fGduXl5dG8eXM6d+5sal9eXp7xZj+A3W5n3759jBo1yijz8/MjIyMDu91ummmt+p0ePXoYj+DT09NZunQp69atM9pbl22XnJ2d6/yPBxEREbm1NLgZ0LKyMt566y369u1ba9J3tQ0bNlBSUmLammnw4MG4uLiQnp5uik1PT8fJyYkRI0YYZeHh4ezdu9c0g2q321m7di2BgYG1vu3t6elJnz59TEdtbDYb33//fbU36//3f/8XgPbt2xtlI0eOZNu2bRw9etQoO3/+PBs3biQsLMxIIAMDA2nbtm21vm7YsIHi4mLTUoaRI0dSXFxMZmamKfbNN9/EZrMRGBiIu7s7ffr0Yfz48TRq1IitW7cafWvatCkABQUFnDp1qta+ioiIyK9Pg5sB3bRpE4WFhaSmptZ4/ciRIzzxxBNERkbi7e2Nk5MTOTk5LF68mO7du5tmTa1WK9OmTSM1NRWLxWJsRJ+WlkZsbKxppvCxxx5j6dKlREdHk5qaipeXF8uXL+ebb74xbdd0M/z+97/nrbfeYuTIkUyePNlYAzp79mxat25t2gj+ueeeY82aNURERJCcnEyzZs2YP38+ZWVlTJ8+3Yhr3Lgxs2bNYuzYscTFxTFq1CgOHDhAUlISISEhDBkyxIgdOnQoISEhTJw4kfPnz+Pt7U1GRgZZWVmsWLHCtLenr68vM2fOJDExkVOnThEZGYmHhwe7d+9m4cKFZGZm4uXldVPHR0RERBo2pwsXLlT+3I24ESNHjuR///d/OXDgAC1atKh2vaioiKeffpovv/ySkydPUl5eTseOHRk5ciQJCQk1rr989dVXWbZsGYcPH6ZNmzbExMQwdepUYyavyg8//EBSUhJbtmyhpKSEgIAAkpOTCQkJuen9/Mc//sHs2bPZtWsXBQUFtGvXjuDgYP74xz/SoUMHU+zBgweZPn0627Ztw263069fP2bNmlXjp0fXrVvHvHnz2LdvHxaLhYiICFJSUoydAaoUFxeTkpLCO++8Q1FREb6+vsTHx5se1V/po48+YuHCheTl5XHu3DkCAgJ45plnePDBB+vU33PnzmGz2QiZvo4mLr8BYMOUgXW6V2pXUVHBoUOH6Ny583VfDpMbo7GtXxrf+qOxrT8a27ppcAmo3JqUgNYf/WVYfzS29UvjW380tvVHY1s3GhkRERERcSgloCIiIiLiUEpARURERMShlICKiIiIiEMpARURERERh1ICKiIiIiIOpQRURERERBxKCaiIiIiIOFSD+xSn3NpWT7gbDw+Pn7sZIiIiUo80AyoiIiIiDqUEVEREREQcSgmoiIiIiDiUElARERERcSgloCIiIiLiUEpARURERMShlICKiIiIiENpH1D5RWnf/hXA5abXe+FCwk2vU0RERH4azYCKiIiIiEMpARURERERh1ICKiIiIiIOpQRURERERBxKCaiIiIiIOJQSUBERERFxKCWgIiIiIuJQSkBFRERExKF+cQno6tWrcXV1NQ53d3duv/12fv/733Ps2DEjbvv27bi6urJ9+/afsbWXHT58GFdXV1avXn3T6jx37hwpKSn06tWLVq1a0aVLF6Kjo8nPz68WW1xcTEJCAj4+PlitVoKCgsjIyKix3i+++IKwsDBat25Nu3btiIqK4tChQzXGLlmyhN69e2OxWOjRowdpaWn8+OOPNcbu3buX2NhYOnXqhIeHB7179+all16itLT0pw+CiIiI3JJ+sV9Ceu211+jatSsXL17k008/Ze7cueTk5JCbm4urq+vP3bx6N2rUKHbv3s306dPp06cP33//PS+++CIhISHk5ubSsWNHIzYqKordu3eTmppKly5dWLduHbGxsVRUVDB69Ggjbu/evQwbNoyAgADeeOMNysrKmDlzJoMHD+bzzz/Hy8vLiJ0zZw6pqalMmTKF0NBQdu3aRWpqKseOHWPRokWmtn711VcMGjSI2267jdTUVDp16sTBgwdZtGgRrq6uPP300/U/YCIiItJg/OJmQKv4+fnRr18/goODmT59OpMmTeLbb79l06ZNP3fT6t2BAwfIyckhLi6OSZMmERwczCOPPMLy5cs5f/48GzduNGK3bNlCdnY2//3f/82YMWMIDg5m8eLFhISEkJiYSHl5uRE7a9YsnJ2dWb9+Pffeey/33Xcf77zzDgUFBbz88stG3OnTp5k9ezZPPPEEM2bMYMCAAUyaNInp06fz+uuv8/XXX5vaGxsbS7t27di6dSuPPfYYAwYMIDY2lk8//ZT//M//rP8B+4XIyckhMjISHx8fXF1d6/R/q2VlZaSkpNCtWzcsFgs9e/Zk1apVxvWPP/6YXr16YbPZeOqpp7h06ZJx7ezZs/Tq1YvvvvuuXvojIiJSX36xCejVAgMDAWr9j+29997LvffeW6183LhxdO/e3VS2fPly+vfvT+vWrWnTpg29e/fmv/7rv67bjuPHjxMTE0ObNm2w2Ww89thj/PDDDzXG7t69m1GjRtGhQwesViv/8R//wdtvv33d32jatCkA7u7upvKWLVsC4OLyf99K37RpE25ubkRERJhiY2JiOH78ODt27ADAbrfzwQcfcN9995nq7dixIwMGDDAlS1lZWZSWlhITE2OqMzo6msrKSjZv3gxARUUFu3bt4uuvv+YP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", + "text/plain": [ + "
" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "# Initialize layout in polar coordinates\n", + "fig, ax = plt.subplots(figsize=(6, 8))\n", + "\n", + "# Add grey background in the ax and fig\n", + "ax.set_facecolor('whitesmoke')\n", + "fig.set_facecolor('whitesmoke')\n", + "\n", + "# Define colors to use for each bar\n", + "colors = ['navy', 'steelblue', 'steelblue', 'black', 'black', 'darkred',\n", + " 'darkred', 'darkred', 'darkred', 'red', 'red', 'lightcoral', 'lightsalmon',\n", + " 'orange', 'yellow', 'lightyellow']\n", + "\n", + "# Create the plot\n", + "ax.barh(df['range'], df['people'],\n", + " color=colors, # colors that we want\n", + " zorder=2, # specify that the bars is drawn after the grid\n", + " )\n", + "\n", + "# Add a vertical grey line at the relative position\n", + "ax.grid(linestyle='-', # type of lines\n", + " alpha=0.5, # opacity\n", + " axis='x', # specify that we only want vertical lines\n", + " )\n", + "\n", + "# Title of our graph \n", + "title = 'La pyramide des salaires'\n", + "fig.text(-0.08, 1.01, # relative postion\n", + " title, \n", + " fontsize=25, # High font size for style\n", + " fontweight = 'bold',\n", + " ha='left', # align to the left\n", + " family='dejavu sans'\n", + " )\n", + "\n", + "# Subtitle of our graph\n", + "subtitle = 'Distribution des salaires mensuels nets en France,\\nen équivalent temps plein (et pourcentage) en 2021*'\n", + "fig.text(-0.08, 0.94, # relative postion\n", + " subtitle, \n", + " fontsize=13, # High font size for style\n", + " color='dimgrey',\n", + " ha='left', # align to the left\n", + " family='dejavu sans'\n", + " )\n", + "\n", + "# Details and Credit\n", + "text = '*France hors Mayotte, salariés du privé et des entreprises publiques\\nSource Insee'\n", + "fig.text(-0.08, 0.05, # relative postion\n", + " text, \n", + " fontsize=10, # High font size for style\n", + " color='dimgrey',\n", + " ha='left', # align to the left\n", + " family='dejavu sans'\n", + " )\n", + "\n", + "# Remove the spines (border lines) from the chart\n", + "ax.spines['top'].set_visible(False)\n", + "ax.spines['right'].set_visible(False)\n", + "ax.spines['bottom'].set_visible(False)\n", + "\n", + "# Change axis position and labels\n", + "ax.tick_params(axis='y', labelsize=12)\n", + "ax.set_xticklabels(['0', '1M', '2M', '3M', '4M', '5M', '6M'])\n", + "ax.xaxis.tick_top()\n", + "\n", + "# Add yellow rectangle\n", + "rectangle_color = 'gold'\n", + "rect = patches.Rectangle((-0.13, 0.93), 0.03, 0.13,\n", + " linewidth=1, edgecolor=rectangle_color,\n", + " facecolor=rectangle_color, transform=fig.transFigure)\n", + "fig.patches.append(rect)\n", + "\n", + "# Add percents\n", + "ax.text(0.6,0.93, # relative position\n", + " '19,5%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "ax.text(0.98,0.87, # relative position\n", + " '30,2%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "ax.text(0.62,0.8, # relative position\n", + " '18,6%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "ax.text(0.37,0.74, # relative position\n", + " '10,8%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "ax.text(0.25,0.65, # relative position\n", + " '10,6%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "ax.text(0.14,0.46, # relative position\n", + " '6,7%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "ax.text(0.08,0.22, # relative position\n", + " '1,8%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "ax.text(0.1,0.06, # relative position\n", + " '1,6%', # label\n", + " transform=ax.transAxes,\n", + " size=10, # text size\n", + " )\n", + "\n", + "# Display the final chart\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Going further\n", + "\n", + "This article explains how to reproduce a [histogram](https://python-graph-gallery.com/histogram/) with nice customization features and annotations.\n", + "\n", + "For more examples of **advanced customization**, check out this [other nice chart with annotations](https://python-graph-gallery.com/web-stacked-line-chart-with-labels/). Also, you might be interested in [adding an image](https://python-graph-gallery.com/513-add-logo-matplotlib/) to your chart. " + ] + } + ], + "metadata": { + "chartType": "histogram", + "description": "This Python code creates a histogram using the Matplotlib library to visualize data about salaries in France. It was originally produced by the INSEE.", + "family": "distribution", + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "keywords": "histogram, annotations, matplotlib, barplot, plot, chart", + "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.13" + }, + "seoDescription": "How to create a histogram with customization features and annotations", + "slug": "web-histogram-with-annotations", + "title": "Histogram with custom style and annotations" + }, + "nbformat": 4, + "nbformat_minor": 4 +} diff --git a/src/pages/histogram.js b/src/pages/histogram.js index bc49d926bd..8e9a9bbce8 100644 --- a/src/pages/histogram.js +++ b/src/pages/histogram.js @@ -236,6 +236,11 @@ export default function Histogram() { caption="Use small multiple to compare the distribution of several groups or several variables" linkTo="/506-histogram-with-small-mutliples" /> + diff --git a/static/data/insee_salaries.csv b/static/data/insee_salaries.csv new file mode 100644 index 0000000000..a983ce21bb --- /dev/null +++ b/static/data/insee_salaries.csv @@ -0,0 +1,16 @@ +range,people +Plus de 8000€,264120 +7500 - 8000€,48512 +7000 - 7500€,61386 +6500 - 7000€,81527 +6000 - 6500€,108558 +5500 - 6000€,148645 +5000 - 5500€,207089 +4500 - 5000€,298003 +4000 - 4500€,440008 +3500 - 4000€,674279 +3000 - 3500€,1073645 +2500 - 3000€,1787938 +2000 - 2500€,3128118 +1500 - 2000€,5078615 +Moins de 1500€,3058099 diff --git a/static/graph/web-histogram-with-annotations.png b/static/graph/web-histogram-with-annotations.png new file mode 100644 index 0000000000..607cf42077 Binary files /dev/null and b/static/graph/web-histogram-with-annotations.png differ