Create Timeline of English Royals

royals.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "import pandas as pd\n",
    "import matplotlib.pyplot as plt\n",
    "import datetime"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "%matplotlib inline"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "royals = pd.read_csv('https://docs.google.com/spreadsheets/d/e/2PACX-1vTB0OcDi0JyEFfEPZWi1OYvSYFcqI_LTl36IKvpoQnC9U97o4o6WD9xR9LE-453amBt4SehV0wrzSSB/pub?gid=0&single=true&output=csv')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "def convert_to_year(date):\n",
    "    if isinstance(date, str):\n",
    "        datestr = str(date)\n",
    "        year = datestr[6:]\n",
    "        remaining_days = ((datetime.datetime.strptime(date, '%d/%m/%Y') - datetime.datetime.strptime('01/01/'+year, '%d/%m/%Y')).days + 1) / 365\n",
    "        return int(year) + (remaining_days / 365)\n",
    "    return float('NaN')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "royals['Born'] = royals['Born'].apply(convert_to_year)\n",
    "royals['Death'] = royals['Death'].apply(convert_to_year)\n",
    "royals['Ascent'] = royals['Ascent'].apply(convert_to_year)\n",
    "royals['End Reign'] = royals['End Reign'].apply(convert_to_year)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": [
    "house_colours = {\n",
    "    'Windsor': 'darkgreen',\n",
    "    'Saxe-Coburg-Gotha': 'dimgrey',\n",
    "    'Hanover': 'gold',\n",
    "    'Orange': 'darkorange',\n",
    "    'Stuart': 'darkblue',\n",
    "    'Tudor': 'crimson',\n",
    "    'York': 'sienna',\n",
    "    'Lancaster': 'lightgrey',\n",
    "    'Plantagenet': 'purple',\n",
    "    'Angevin': 'limegreen',\n",
    "    'Blois': 'hotpink',\n",
    "    'Normandy': 'royalblue'\n",
    "}\n",
    "\n",
    "today = convert_to_year(datetime.datetime.today().strftime('%d/%m/%Y'))\n",
    "houses = list(royals['House'].drop_duplicates())"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n1wHo2LEj7733Ht26dWP79u0AXL58mXfeeYfx48fTvn179u/fz+3bt4mPj6dXr16FXtve3p5evXrx\nj3/8A4DNmzczbNiwKrhrERGR2kUrWCIitUTnzp3zNbOIiooC4NSpUxw/fpzQ0FDgTvfCixcvAtC+\nfXsAmjVrRkpKCgDu7u7Y2dkB0KdPHzZv3kxOTg5du3Y1by9MUFAQCxcuxNvbm+vXr/Poo49a/iZF\nRERqOa1giYjUch4eHnh7exMTE8O6devw9/cvEFacV24eFtwpwJKSkoiLi2Po0KHFXueRRx7h5s2b\nvP/++wwZMsRi8xcREalLtIIlIvVKSd36aiNfX18OHTpESEgI6enp9O7du0z5VgEBAezatYs2bdqU\nOHbIkCFERkbyxRdfVGTKIiIidZYKLBGpN2xtbWnUqFGFz1PaIs3Dw6PInKmynrewPKpp06aZv4eH\nhxc4JiYmxvx9+PDh5u8bN27MNy47O5ugoKBCr5v3HHDnMcGixoqIiIgKLBGpZyraot1oNHLr1q1S\nn8fGxobs7OwSx507d67Y/Y888kix10xISCA2NrbAO1oeHh4FAorzyu0suHTp0hLneLe4uDgOHTrE\nwoULzdsSExOZM2cOGzZsKPP5RERE6gIVWCIiZVSWLK2anrs1adKkUq+w3a1///5ER0eTnp5ubtce\nFxen7oIiIlKvqcASEakHisrJuu+++0hNTS0yJ2vLli3s3r270Jyshg0b4uvry9///ncGDRpEVlYW\n8fHxvPrqq9V8tyIiItVHXQRFROqI8uRktWnTpticLC8vr2JzsoKDg9m6dSsAn3/+OT179qRBgwZV\neNciIiI1i1awRETqiPLkZHl4eABF52QFBQURExNTZE7Wo48+yvXr17l06RKbN29m+vTplXuTIiIi\nNZxWsERE6rjicrIMBkOB8Xlzsp544okSc7KGDh1KTEwMGRkZpWr1LiIiUpepwBIRKSOj0WjxT2Xy\n9fXFwcGBkJAQc0fBsuZkpaSkFFk8BQQEEBsbq/BhERER9IigiEiZlDVLy2Aw0LBhw2LHGI1G86N6\nJY0riqenJ56envnGTJo0CbjzSGDezKzcc7377rskJiZiNBrzrU6tX78+33mysrIIDAws8vr29vYc\nPny4xPmLiIjUByqwRETKqCxt10tq017aXK2ScrLKy8rKipMnTxa5f+nSpWRnZ7Nw4UJu3bpV6Bij\n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\ny+jRowkJCQHuFEjbt2+nWbNmvP7666xatYo333yTadOmMWLECIKCgjhy5AgjRowAIDg4mL59+/Lr\nr7/i4uLCxo0bee6556r+Fygi9Ya3tzdfffVVoftiYmIAmDBhgnnbn//85wLjPvvsswLbinoke/Dg\nwcycOTPftvbt27N7924A+vfvb94+fPjwQudbmsepK5KfZbLLwb7dI4Xua3Fxb7nOaWmJiYm0a9dO\nzThERCqZHhH8/6ysrIiMjGTz5s3mnBWA+Ph4Ro4cicFgwM7Ojueee474+Hjz/tz3BXL97ne/A6BF\nixY8/PDDNG3aFCsrK9zd3bl27RqOjo6sXLmSffv28be//Y2VK1eaV6Pgzl8amjVrZv5+7do1rl69\nysmTJxk0aBAAXl5etGnTBoB7772Xp59+mq1bt3Lt2jX2799PQEBA5fySRERqkdDQUM6ePVumY2xt\nbSv8+d3vfmderSvuU11y87Aq+hERkcJpBSuP5s2b85e//IXp06ebi5mcnBwMBoN5TE5ODtl5HiFx\ncHDId468f2gW9gfoL7/8wrBhwwgODsbLyws/Pz+++OIL8357e3vzd4PBYH4vAcj33SZPTsuIESOI\niIjAxsaGvn374ujoWKb7FhGRqmU0Gjl0KAkbm6ortH744Tq3bv1C584fWeR8WVmTtBomIlIIFVh3\n8fPzIz4+nnXr1tG/f398fHz44IMPmDlzJkajkY0bN9K1a9dyn/8///kPjRs35uWXXwZg5cqVwJ2A\nzaK4urry6KOPsmnTJkaMGMHx48c5deqUeb+npydWVla88847LF++vNxzExGpi3755RciIiLIzMzk\n119/Zdy4cfTu3ZuAgACeeOIJTp06RcuWLbn33ns5fPgwdnZ25pytWbNmcfXqVQBmz57NI488wowZ\nMzh//jyZmZmMGTOGfv36lWteNja2VVpg2djYVOn1RETqq2opsGp6TtXs2bM5cuSI+fvcuXMJCAjA\naDTSvXt3XnrppXKfu1u3bsTFxeHn54fBYOCpp56icePG/PTTT8Ue99e//pXw8HBiY2Np0aIFHh4e\n+fYHBgayY8cO2rZtW+65iYjURefOnWP06NF4e3vzzTffsHTpUnr37s3NmzcZMGCA+WmC8PBwpkyZ\nwsiRIzlz5gzbtm2jc+fOhISE8OOPPxIeHs7q1atJSEjg448/Bsj3SLmIiAhoBQt3d3eOHj2ab5uD\n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\nw8OJj4/XxP/elclnrrZYXFzMuHHjCA8PJzg4mB07dtR8/0U9xtKlS1VgYKB6+eWXlVJKDR8+XO3Z\ns0cppdSUKVPU9u3b1eHDh5XBYFClpaXq3LlzKigoqMJtq0NlMiqlVN++fVVpaWm5x5orY35+voqO\njla9evVSa9euVUopdfnyZRUYGKju3LmjCgoKjN/Hx8erf/7zn0oppZYsWaJWrVpltoxKKRUaGqry\n8/PLPbYmMj6cLyIiQh09elQppdS6devUjBkzNFdDUxmVMl8NTWUcOXKk2rdvn1JKqbi4OLV9+3bN\n1dFURqW0VUellDp69KgaMmSIcZ0561iZfEppq4YbNmxQK1asKLeN1o4vpjIqpa3jS1xcnNqyZYtS\nSqnMzEyVkZGhufe0qYxKaef4Uub69evqpZdeUpcuXdJcWzSVUSlttcXXXntNff7550oppWJjY9WO\nHTs01xZNZVRKW38bBw4cqLKyspRSSiUnJ6sPP/zQrO2xMvmUMl9bTE9PVwkJCUoppa5evar8/f1r\nvP/y2DNYzZs3Z/78+cblI0eO0K1bNwD8/PzYvXs3WVlZ9OjRA51OR9OmTSkpKeHq1asmt60OlcmY\nl5dHQUEBI0aMICwszPiJibky3rx5k9GjR9O/f3/juuzsbDp37kytWrWoW7cuzZs3Jycnh6ysLHr2\n7KmJjKWlpeTm5jJ16lRCQ0NJT08HqJGMD+dLTk42Tg5XUlJC7dq1NVdDUxnNWUNTGefPn0/Xrl25\ne/cuV65coUGDBpqro6mMWqvjtWvXmD17NhMnTjSuM2cdK5NPazU8fPgwn3/+OREREUycOJHCwkLN\nHV9MZdTa8eXAgQNcunSJyMhINm/eTLdu3TT3njaVUUvHlzLz589n8ODBODs7a64tmsqotbbo7u7O\n9evXUUpx8+ZNrKysNNcWTWXU2t/GS5cu4e3tDYC3tzdZWVlmbY+VyWfOtvj888/z+uuvG5ctLS1r\nvP/y2A7Wc889h5WVlXFZKYVOpwPA1taWGzduUFhYiJ2dnXGbsvWmtq0OlclYXFxMVFQUCxcuZMGC\nBcycOZP8/HyzZXR1dcXT07PcNoWFhdStW9e4bGtrS2FhYbn15s5469YtBg8eTFJSEsuXL2ft2rXk\n5OTUSMaH8zk7OwP3D9RpaWlERkZqroamMpqzhqYyWlpacu7cOQIDA7l27RotWrTQXB1NZdRSHUtK\nSpg0aRITJ07E1tbWuI0561iZfFqqIYCHhwdvvPEG77//Pq6urixcuFBzxxdTGbV2fDl37hz16tVj\n9erVNGnShGXLlmnuPW0qo5aOL3D/MsbMzEyCgoIANNcWTWXUWlt86qmnSExMpG/fvuTn5+Pr66u5\ntmgqo9b+Nrq6urJv3z4AMjIyKCoqMmt7rEw+c7ZFW1tb7OzsKCwsZMyYMcTExNR4/+VnD3JhYfHj\nQ27evEm9evWws7Pj5s2b5dbXrVvX5LY1wdR+nZycCA0NxcrKigYNGuDu7s6ZM2fMltGUiur44Hpz\nZ7S2tmbIkCFYW1tjZ2dH9+7dycnJMVvGrVu3Mm3aNJYuXYqjo6Mma/hwRq3VEMDFxYXt27cTFhbG\nrFmzNFnHhzNqqY5HjhwhNzeX6dOnExsby8mTJ0lMTNRMHSvKp6UaAvTp04dOnToZvz969Kjmji+m\nMmrt+FK/fn0CAgIACAgI4PDhw5ppiz+VUWvtcdu2bQQGBmJpaQlUfIw25/8RD2fUWltMTEzk/fff\nZ9u2bQwYMECTxxdTGbXWFmfMmMGSJUsYNmwYDRo0wMHBQVPt0VQ+c7fFCxcuMGTIEPr370+/fv1q\nvP/ysztYHTp0YO/evQB8+eWXdOnSBW9vb3bt2kVpaSnnz5+ntLQUR0dHk9vWBFP73b17NzExMcD9\nYp04cYKWLVuaLaMpHh4eZGVlcefOHW7cuMGpU6do27Yt3t7efPHFF8aMpmaMrinffvst4eHhlJSU\nUFxczIEDB+jYsaNZMn700UekpaWRmpqKq6sroL0amsqopRrC/ZtQv/32W+D+JzUWFhaaq6OpjFqq\no4eHB1u2bCE1NZXk5GRat27NpEmTNFPHivJpqYYA0dHRxpuMMzMzjVm0dHwxlVFrxxcfHx/j7++r\nr76idevWmmmLP5VRa+0xMzMTPz8/47LW2qKpjFpri/b29sYzBM7OzhQUFGiuLZrKqLW2+MUXXzBj\nxgyWLl3K9evX+dOf/qSp9mgqnznbYl5eHlFRUYwbN47g4GCg5vsvVo/fpLy4uDimTJlCcnIyLVu2\n5LnnnsPS0pIuXbowaNAgSktLmTp1aoXb1oSKMu7atYuQkBAsLCyIjY3F0dHRbBlNadiwIQaDgfDw\ncJRSjB07ltq1azNy5Eji4uLYsGEDDg4OzJkzx2wZW7VqRb9+/QgJCUGv19O/f3/atGlT4xlLSkpI\nTEykSZMmjB49GoCuXbsyZswYzdTwpzJqoYZlhg0bxvjx49Hr9VhbW5OQkKC5tmgqo7Ozs6bqaIrW\n6vgwrbyfy0yfPp34+Hj0ej1OTk7Ex8djZ2enqeNLRRm1dHyJi4tj8uTJrF+/Hjs7O+bMmYO9vb2m\n2mJFGbXUHs+cOWP8YAygU6dOmmqLpjL6+/trqi0mJCQwduxYrKys0Ov1xMfHa+7voqmMzZo101Rb\ndHNzY9iwYVhbW+Pr64u/vz+AZtpjRfnM1RbfffddCgoKWLRoEYsWLQJg0qRJJCQk1Fj/RaeUUlX6\nqoQQQgghhBDiCSUTDQshhBBCCCFEFZEOlhBCCCGEEEJUEelgCSGEEEIIIUQVkQ6WEEIIIYQQQlQR\n6WAJIYQQQgghRBWRDpYQQgghhBBCVBHpYAkhhBBCCCFEFfk/yXOGwIozZAAAAAAASUVORK5CYII=\n",
      "text/plain": [
       "<Figure size 864x360 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.style.use('seaborn-whitegrid')\n",
    "\n",
    "fig, ax = plt.subplots(1, figsize=(12, 5))\n",
    "\n",
    "for house_name in houses:\n",
    "    h = royals[royals['House']==house_name]\n",
    "    \n",
    "    # Plot lifespans\n",
    "    ax.barh(h.index, h['Death'] - h['Born'], left=h['Born'],\n",
    "            color=house_colours[house_name],\n",
    "            alpha=0.2, edgecolor='black', linewidth=0.2)\n",
    "    \n",
    "    # Plot reigns\n",
    "    ax.barh(h.index, h['End Reign'] - h['Ascent'], left=h['Ascent'],\n",
    "            color=house_colours[house_name],\n",
    "            label=house_name)\n",
    "\n",
    "# Plot the current monarch (until today)\n",
    "# Plot lifespan\n",
    "ax.barh(royals.index[-1], today - royals.iloc[-1]['Born'],\n",
    "        left=royals.iloc[-1]['Born'],\n",
    "        color=house_colours[royals.iloc[-1]['House']],\n",
    "        alpha=0.2)\n",
    "# Plot reign\n",
    "ax.barh(royals.index[-1], today - royals.iloc[-1]['Ascent'],\n",
    "        left=royals.iloc[-1]['Ascent'],\n",
    "        color=house_colours[royals.iloc[-1]['House']])\n",
    "\n",
    "# Label the monarchs\n",
    "for monarch in royals.iterrows():\n",
    "    # First half label after the bar\n",
    "    if monarch[1]['Death'] < 1500:\n",
    "        ax.text(monarch[1]['Death'] + 10,\n",
    "                monarch[0], monarch[1]['Name'],\n",
    "                horizontalalignment='left',\n",
    "                verticalalignment='center', fontsize=10)\n",
    "    # Second half before the bar\n",
    "    else:\n",
    "        ax.text(monarch[1]['Born'] - 10,\n",
    "                monarch[0], monarch[1]['Name'],\n",
    "                horizontalalignment='right',\n",
    "                verticalalignment='center',\n",
    "                fontsize=10)\n",
    "\n",
    "# Neater x and y limits, neater tick positions\n",
    "ax.set_xlim(1000, today)\n",
    "ax.set_ylim(-0.75, 40.75)\n",
    "ax.set_yticks([])\n",
    "ax.set_xticks([1000 + 50*i for i in range(21)])\n",
    "plt.gca().invert_yaxis() # Most recent at bottom\n",
    "\n",
    "# Legend for house colours\n",
    "leg = plt.legend(fontsize=12, loc=3,\n",
    "                 frameon=True, labelspacing=0.1,\n",
    "                 facecolor='white', edgecolor='black',\n",
    "                 title='House')\n",
    "leg.get_frame().set_linewidth(0.2)\n",
    "\n",
    "plt.tight_layout()\n",
    "plt.savefig('timeline.jpeg', dpi=800)\n",
    "plt.savefig('timeline.pdf')"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {
    "collapsed": true
   },
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "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": 2
}