{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Data Visualization in Python with [matplotlib](https://matplotlib.org/) and [pandas](https://pandas.pydata.org/)\n",
"----\n",
"## Table of Contents\n",
"\n",
"[1. Intro Slides and Plot Anatomy](#S1) \n",
"[2. Getting Started](#S2) \n",
"[3. pylab, object oriented, and Pandas approaches](#S3) \n",
"[4. Style Basics](#S4) \n",
"[5. Style Presets](#S5) \n",
"[6. Subplots](#S6) \n",
"[7. Legends](#S7) \n",
"[8. Pandas: Dates, groupby](#S8) \n",
"[9. Annotations, Layers & Mathtext](#S9) \n",
"[10. Statistical Visualization in Seaborn](#S10) \n",
"[11. Images and 3D plots](#S11) \n",
"[12. Palettable](#S12) \n",
"[13. Documentation and Resources](#S13) \n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## 1. Intro & Plot Anatomy\n",
"__[A few intro slides ](https://gitpitch.com/jimbopants/pythonvisualization#/)__\n",
"\n",
"\n",
"### Major packages used in this class:\n",
"* **Matplotlib**: Main plotting library in python. Itâs very powerful/flexible but sometimes requires fiddling to make things look perfect\n",
"* **Pandas**: Adds support to python for SQL/spreadsheet like data structures called dataframes. We will use this to speed up some data manipulation. It also has it's own plotting functionality that we will mostly ignore. \n",
"* **Seaborn**: This is a wrapper for matplotlib that prettifies the default settings, allows you to quickly specify options/style and adds a few new plot types/statistical overlays for data. \n",
"\n",
"### Figure Anatomy\n",
"* A **Figure** is a high-level container where axes are drawn. It can contain multiple multiple Axes, a subtitle (which is a centered title for the figure), a legend, a color bar, etc.\n",
"* An **Axes** is the area on which we plot our data and any labels/ticks associated with it. Each Axes has an X-Axis and a Y-Axis\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"
\n",
"
\n",
"
\n",
"
"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## 2. Getting Started\n",
"\n",
"* Import libraries \n",
"* Tell the notebook to show matplotlib plots inline. \n",
"* Use `%matplotlib notebook` instead for interactive plots; note that with interactive plots, you'll need to use `plt.close()` to close them afterward."
]
},
{
"cell_type": "code",
"execution_count": 14,
"metadata": {
"scrolled": false
},
"outputs": [],
"source": [
"# Array and dataframe manipulation\n",
"import pandas as pd\n",
"import numpy as np\n",
"\n",
"# Plotting interfaces, usuaully just import the pyplot module\n",
"import matplotlib.pyplot as plt\n",
"\n",
"import datetime as dt\n",
"import matplotlib.dates as dates\n",
"\n",
"# Seaborn\n",
"import seaborn as sns\n",
"\n",
"# Options for jupyter notebooks\n",
"%matplotlib inline\n",
"\n",
"# Usually we don't need the next line, but we'll set a standard size for all our plots. \n",
"# Make sure to run this line after the %matplotlib inline line\n",
"import matplotlib \n",
"matplotlib.rcParams['figure.figsize'] = (8, 5)\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Seaborn used to not be part of the Anaconda distribution, so if the above cell errors you'll need to install it. Copy the command below into a new cell and run it (only the first time you need to use it):\n",
"\n",
"```\n",
"!pip3 install seaborn\n",
"```\n",
"\n",
"Note that if you're running multiple versions of Python on your system, you might need to install the package from the command line instead into the correct environment. On mac/linux: Via the terminal, if you're using Anaconda, use `conda install seaborn`."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"### 2b. Loading Example Data\n",
"Read in [earthquakes data](http://www.ldeo.columbia.edu/~felixw/NCAeqDD/). It's on the large side, so it will take a minute to load.\n",
"\n",
"Note that there's a bunch of extra info at the start of the file, so we'll need to skip that. Also, some columns are combined under a single header, so we'll manually specify the header."
]
},
{
"cell_type": "raw",
"metadata": {},
"source": [
"From the file:\n",
"\n",
"FORMAT DESCRIPTION:\n",
"DATE......... Year, Month, Day\n",
"TIME......... Hour, Minute, Second\n",
"LAT/LON...... Location\n",
"DEP.......... Depth [km]\n",
"EH1/EH2/AZ... Horizontal major/minor axis [km] and azimuth of the 95% \n",
" relative location error ellipses. (-1 if not available).\n",
"EV........... Vertical relative location error [km] at the 95%\n",
" confidence level. (-1 if not available).\n",
"MAG.......... Magnitude, ML, as listed in the NCSN catalog. \n",
"ID........... CUSP event ID."
]
},
{
"cell_type": "code",
"execution_count": 2,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"text/html": [
"
\n",
"\n",
"
\n",
" \n",
"
\n",
"
\n",
"
YEAR
\n",
"
MONTH
\n",
"
DAY
\n",
"
HOUR
\n",
"
MINUTE
\n",
"
SECOND
\n",
"
LAT
\n",
"
LON
\n",
"
DEP
\n",
"
EH1
\n",
"
EH2
\n",
"
AZ
\n",
"
EV
\n",
"
MAG
\n",
"
ID
\n",
"
\n",
" \n",
" \n",
"
\n",
"
0
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
1
\n",
"
19
\n",
"
11.317
\n",
"
36.08781
\n",
"
-120.22869
\n",
"
10.897
\n",
"
0.020
\n",
"
0.010
\n",
"
96.0
\n",
"
0.022
\n",
"
1.8
\n",
"
1109386
\n",
"
\n",
"
\n",
"
1
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
1
\n",
"
58
\n",
"
2.420
\n",
"
36.87608
\n",
"
-120.90669
\n",
"
2.661
\n",
"
0.071
\n",
"
0.018
\n",
"
55.0
\n",
"
0.421
\n",
"
0.0
\n",
"
346
\n",
"
\n",
"
\n",
"
2
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
1
\n",
"
59
\n",
"
27.124
\n",
"
36.87000
\n",
"
-120.90889
\n",
"
1.592
\n",
"
0.110
\n",
"
0.016
\n",
"
66.0
\n",
"
0.727
\n",
"
1.5
\n",
"
1109389
\n",
"
\n",
"
\n",
"
3
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
2
\n",
"
28
\n",
"
4.240
\n",
"
37.51546
\n",
"
-118.75485
\n",
"
7.703
\n",
"
0.020
\n",
"
0.008
\n",
"
37.0
\n",
"
0.024
\n",
"
1.2
\n",
"
1109391
\n",
"
\n",
"
\n",
"
4
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
3
\n",
"
8
\n",
"
58.044
\n",
"
40.57227
\n",
"
-124.55933
\n",
"
20.407
\n",
"
1.009
\n",
"
0.083
\n",
"
103.0
\n",
"
0.080
\n",
"
2.0
\n",
"
1109392
\n",
"
\n",
"
\n",
"
5
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
3
\n",
"
15
\n",
"
36.690
\n",
"
37.56065
\n",
"
-118.84449
\n",
"
10.404
\n",
"
0.033
\n",
"
0.016
\n",
"
38.0
\n",
"
0.039
\n",
"
1.1
\n",
"
1109393
\n",
"
\n",
"
\n",
"
6
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
4
\n",
"
46
\n",
"
38.708
\n",
"
38.80774
\n",
"
-122.84761
\n",
"
1.824
\n",
"
0.009
\n",
"
0.005
\n",
"
175.0
\n",
"
0.011
\n",
"
1.1
\n",
"
1109395
\n",
"
\n",
"
\n",
"
7
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
5
\n",
"
1
\n",
"
53.594
\n",
"
36.24686
\n",
"
-120.39385
\n",
"
6.836
\n",
"
0.059
\n",
"
0.016
\n",
"
106.0
\n",
"
0.040
\n",
"
1.4
\n",
"
357
\n",
"
\n",
"
\n",
"
8
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
7
\n",
"
8
\n",
"
31.986
\n",
"
36.49920
\n",
"
-121.07855
\n",
"
13.020
\n",
"
0.042
\n",
"
0.020
\n",
"
100.0
\n",
"
0.102
\n",
"
1.4
\n",
"
1109397
\n",
"
\n",
"
\n",
"
9
\n",
"
1984
\n",
"
1
\n",
"
1
\n",
"
7
\n",
"
17
\n",
"
21.373
\n",
"
37.54467
\n",
"
-118.86678
\n",
"
7.245
\n",
"
0.042
\n",
"
0.015
\n",
"
74.0
\n",
"
0.043
\n",
"
0.7
\n",
"
363
\n",
"
\n",
" \n",
"
\n",
"
"
],
"text/plain": [
" YEAR MONTH DAY HOUR MINUTE SECOND LAT LON DEP EH1 \\\n",
"0 1984 1 1 1 19 11.317 36.08781 -120.22869 10.897 0.020 \n",
"1 1984 1 1 1 58 2.420 36.87608 -120.90669 2.661 0.071 \n",
"2 1984 1 1 1 59 27.124 36.87000 -120.90889 1.592 0.110 \n",
"3 1984 1 1 2 28 4.240 37.51546 -118.75485 7.703 0.020 \n",
"4 1984 1 1 3 8 58.044 40.57227 -124.55933 20.407 1.009 \n",
"5 1984 1 1 3 15 36.690 37.56065 -118.84449 10.404 0.033 \n",
"6 1984 1 1 4 46 38.708 38.80774 -122.84761 1.824 0.009 \n",
"7 1984 1 1 5 1 53.594 36.24686 -120.39385 6.836 0.059 \n",
"8 1984 1 1 7 8 31.986 36.49920 -121.07855 13.020 0.042 \n",
"9 1984 1 1 7 17 21.373 37.54467 -118.86678 7.245 0.042 \n",
"\n",
" EH2 AZ EV MAG ID \n",
"0 0.010 96.0 0.022 1.8 1109386 \n",
"1 0.018 55.0 0.421 0.0 346 \n",
"2 0.016 66.0 0.727 1.5 1109389 \n",
"3 0.008 37.0 0.024 1.2 1109391 \n",
"4 0.083 103.0 0.080 2.0 1109392 \n",
"5 0.016 38.0 0.039 1.1 1109393 \n",
"6 0.005 175.0 0.011 1.1 1109395 \n",
"7 0.016 106.0 0.040 1.4 357 \n",
"8 0.020 100.0 0.102 1.4 1109397 \n",
"9 0.015 74.0 0.043 0.7 363 "
]
},
"execution_count": 2,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"# if you are on google colab replace \"./datasets/NCAeqDD.v201112.1\" with \"url\"\n",
"\n",
"url = 'http://www.ldeo.columbia.edu/~felixw/NCAeqDD/NCAeqDD.v201112.1.gz'\n",
"df = pd.read_csv(\"./datasets/NCAeqDD.v201112.1\", \n",
" delim_whitespace=True, skiprows=79, na_values=[-1],\n",
" names=[\"YEAR\", \"MONTH\", \"DAY\", \"HOUR\", \"MINUTE\", \"SECOND\",\n",
" \"LAT\", \"LON\", \"DEP\", \"EH1\", \"EH2\", \"AZ\", \"EV\", \"MAG\", \"ID\"])\n",
"df.head(10)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## 3. Interfaces: Pylab vs. Pyplot vs. Pandas.plot\n",
"> There should be one-- and preferably only one --obvious way to do it. \n",
"> Zen of Python\n",
"\n",
"* Matplotlib (MPL) started as a port of MATLAB's state-based plotting interface (Pylab) that was then completely duplicated using a pythonic \"object oriented\" API (Pyplot).\n",
"* Pyplot makes it easy to work with subplots and making more than 1 plot at a time.\n",
"* Pandas replicates Matplotlib functions and adds support for labeled datasets and statistics. \n",
"\n",
"---\n",
"The next 3 cells demonstrate 3 different methods for creating a scatter plot of the magnitude vs depth for the first 50 earthquake observations with the data we just loaded. \n",
"\n",
"Throughout the class, we're going to use the matplotlib and pandas methods see the differences and similarities. The method (pandas or matplotlib) is marked for the cells so you can keep track of the different methods.\n",
"\n",
"We will mostly use matplotlib.pyplot (the 2nd method shown and the object oriented approach) directly. `plt` is the alias for `matplotlib.pyplot` that we imported above. See https://matplotlib.org/api/pyplot_api.html. `plot` will make a line plot. We use the `scatter` function for a scatter plot."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 3.1 Pylab / Functional Interface: (Forget this Immediately)"
]
},
{
"cell_type": "code",
"execution_count": 15,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"df[:50].plot(x='MAG', y='DEP', kind='scatter') # df.plot has a keyword called kind that controls plot type. (bar, line, etc)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Exercise On Plotting:\n",
"\n",
"Plot which magnitudes occurred during which hour of the day using an object orientated approach and DataFrame approach.\n",
"(Remember to only look at the first 50 data points)"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 3.4 Interface Notes\n",
"* All 3 plots are similar. \n",
"\n",
"* In the pyplot example (3.2), we used `plt.subplots()` to return an axis and figure instance. `plt.subplots()` is a convenience function that returns both figure and axes, instead of doing:\n",
"```\n",
"fig = plt.figure(figsize=(10, 3.5))\n",
"ax = plt.subplot(1,1,1) # or plt.subplot(111) is equivalent\n",
"```\n",
"* Remember, when use the pyplot interface, we get to specify an axes to plot on or change properties on using the method calls on that axis i.e (`ax.plot`, `ax.scatter`, etc.) This is really useful for making multiple plots and for incrementally adding to an existing plot. \n",
"\n",
"* For pandas:\n",
" * Line plot is the default (see https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.plot.html), but we can change that with the [`kind`](https://pandas.pydata.org/pandas-docs/stable/generated/pandas.DataFrame.plot.html) parameter. \n",
"\n",
"* Also note that we can omit the `Text(0.5,0,'Magnitude')` type output by putting a ; at the end of the plotting line. (Similar to MATLAB)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## ---\n",
"## 4. Style Options\n",
"In the next 2 examples, we will go over data aesthetics and axis options. The axis options are the same for any plot type but each plotting function has slightly different data aesthetic options. Luckily the [matptlotlib documentation](https://matplotlib.org/api/pyplot_summary.html#the-object-oriented-api) shows all the arguments for a given plot type. \n",
"\n",
"It can be annoying to figure out how to get everything perfect when you're learning matplotlib. Remember:\n",
"* If you don't know how to do something, you don't have to read the documentation! All you need is a rough idea of the plot anatomy you want to manipulate and google like so: `site:stackoverflow.com matplotlib \"thing I can't do\"` or simply `matplotlib \"thing I can't do\"`.\n",
"* If you really want a label/arrow/tick mark RIGHT THERE but you have no idea how to do that in matplotlib, save the plot and add that feature in gimp/illustrator/photoshop/powerpoint instead of spending hours doing it in python.\n",
"\n",
"### In matplotlib we can style the plot data as well as the visible parts of the axis:\n",
"#### Data aesthetics:\n",
"* color\n",
"* size\n",
"* scatter marker\n",
"* edge color\n",
"* And more for different plot types!\n",
"\n",
"#### Axis options: \n",
"* labels\n",
"* limits\n",
"* ticks\n",
"* ticklabels\n",
"* grids\n",
"* spines\n",
"\n",
"
\n",
"
\n",
"
\n",
"\n",
"We're aiming to make something like this plot:\n",
""
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 4.1 Data Aesthetics:"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"image/png": "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6JAxxpiDBw/6zk2aNMn8/e9/N8YY8+ijj5o+ffqY/Px8s2rVKhMbG2vmzp1rjDHmkksuMbNnzy6zro8++qh57rnnjDHGDBo0yPz222/GGGN+/PFHM3DgQF9eXH755cbj8Zi1a9ea5s2bG2OMmTlzprnwwguNx+Mxe/bsMVWqVDEzZ840xhjTuHFjk56e7ksH8OX/vffea5544olSumRmZpqCggJjjDFff/21ueyyy4wxxtx1113m/fffN8YYk5eXZ3JycoqF2717t2nYsKHZv3+/ycvLM7179/blc6g8LLI7lFxJAtUVYIUpg3+jW2IoiqIoEWHmirRSI2QlySv08uHyNO69oE254582bRp//etfAbjqqquYNm0aXbp0AaB79+7FtiFo3LgxPXv29B1/+OGHTJw4kcLCQvbs2cO6detISkriuuuu4/3332fs2LEsWbKEd999t1w6PfHEE/To0YOJEycCsHHjRtasWcN5550HWNOpdevWLRVuyZIlfPzxxwBcd9113HfffSHTSUxMJCYmhptuuolhw4b51rilpaVx5ZVXsmfPHvLz84vlwYUXXojb7aZjx454PB6GDBkC4BtNLKuuRWRnZ/PDDz8watQo37m8vDzf70suuQSHw0G7du18o0iLFi1i1KhROBwO6tSpU2xUrCRRUVE+u7p27crXX39dSiYzM5MxY8awadMmRMQ34terVy+eeuop0tLSuOyyy2jZsmWxcEuXLmXAgAHUrGl9E/zKK6/kt99+C5uH/pRV7kTQ6UtFURQlIhzJLSiTXFZe2eT8ycjIYN68edx00000adKE5557jhkzZmANQkB8fHwxef/jrVu3MmHCBL799lt++eUXhg0b5tu2YOzYsbz//vtMmzaNUaNG4XK5mD17NsnJySQnJ7NixYqQenXr1o2VK1dy8KC1Vs4YQ/v27Vm1ahWrVq3i119/5auvvgprX7i39lwuF8uWLWPkyJF88sknPgfr7rvv5q677uLXX3/ljTfeKLYdQ3R0NAAOhwO32+1Lw+FwUFhYWG5dvV4vVapU8cmvWrWK9evXl0qvKB/8/y8L/jo6nU4KCwtLyTzyyCMMHDiQNWvW8Omnn/rsveaaa5gzZw6xsbFccMEFzJs3r1TYYHkcKg+PR+5EUKdMURRFiQiJMWXbxTwhuvy7nc+aNYvrr7+e7du3s23bNnbu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\n",
"text/plain": [
"
"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"# Data aesthetics are passed to plotting functions for each dataset as either a constant or variable with the same length\n",
"f,ax = plt.subplots(figsize=(10, 3.5))\n",
"ax.scatter(range(0,100,2), y=[0]*50, s=range(0,200,4), label='Array-like of same length as data');\n",
"ax.scatter(range(0,100,2), y=[.5]*50, s=90, label='Constant aesthetic');\n",
"ax.set_ylim([-1,1])\n",
"\n",
"# Let's also introduce legend, a function that will put a box with line/markers matching all the calls to plot with \n",
"ax.legend()\n",
"\n",
"ax.set_title('Data aesthetics can either be constant or an iterable the same length (and order) as data');"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Marker sizes don't have to be a constant. They can be a function of other variables. \n",
"We could, for instance, make each marker size a function of the magnitude (not a great idea from a visualization perspective...but we'll do a better example next) \n",
"We can also change the [plot marker](https://matplotlib.org/api/markers_api.html). We can add the `marker` option to either pandas' `DataFrame.plot` or matplotlib's `scatter`. "
]
},
{
"cell_type": "code",
"execution_count": 9,
"metadata": {
"scrolled": true
},
"outputs": [
{
"data": {
"text/plain": [
"Text(0, 0.5, 'DEP')"
]
},
"execution_count": 9,
"metadata": {},
"output_type": "execute_result"
},
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"# Matplotlib\n",
"f, ax = plt.subplots()\n",
"\n",
"pts = ax.scatter(bigones['MAG'], bigones['DEP'], # data\n",
" # s = marker size\n",
" s=50, \n",
" \n",
" # Marker = [s, ., o, *, v, ...]\n",
" marker='s', \n",
" \n",
" # Adding an edge around the line and a bit of transparency can make it easier to distinguish overlapping points\n",
" edgecolors = 'k', lw = 1, alpha = .75,\n",
" \n",
" # c = Color\n",
" c=bigones['YEAR'], # Here we use the year column to color the points\n",
" cmap=\"winter\") # color scheme: https://matplotlib.org/users/colormaps.html\n",
"\n",
"# Add colormap \n",
"clrbar = plt.colorbar(pts); # Here we pass the scatter variable as the keyword argument\n",
"#print(type(clrbar.ax)) # By default, calling plt.colorbar on a collection of paths makes a new axis we can access that has the same methods as any other axis object. "
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Exercise On Data Aesthetics:\n",
"1. Color by a different variable instead: `EV`, which is an error estimate on depth (I think). Copy code from above, and make the changes you need. Also, go to https://matplotlib.org/users/colormaps.html and find your favorite colormap and apply it to the data.\n",
"2. In the plot above: Change the marker size to reflect the depth of the earthquake. For aesthetic reasons, make sure the points are large enough. \n"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"### 4.3 Demonstrating Axis Options in Matplotlib\n",
"\n",
"Matplotlib has options for all of the plot anatomy features we described before. Let's replot the last example while demonstrating what some of those are.\n",
"\n",
"* Keep in mind this is an example of what's possible, not a style guide. Please do not make yellow titles.\n",
"* For every `ax.set_xVAR()` there's an `ax.set_yVAR()` as well\n",
"* Note that to edit the colorbar title, we call a method on the `clrbar` axis we saved. \n",
"* Calling the ax.method() only changes that property on the current axis. We'll talk about `seaborn.set_style` and rcParams next.\n",
"* Many matplotlib functions have an optional fontdict argument. I demonstrate one use of it below but a full description is available [here](https://matplotlib.org/users/text_props.html)\n"
]
},
{
"cell_type": "code",
"execution_count": 14,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAZcAAAEqCAYAAADZMh2mAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDMuMC4yLCBodHRwOi8vbWF0cGxvdGxpYi5vcmcvOIA7rQAAIABJREFUeJzt3Xd4HNX18PHvkSwbG1nua1FsA6GZavCS0IJEN5iSl0DoPYEQSIDQHEJoCSUJgR8EEgKhh1BC6DU0yXRY04yxAWNwAcTauArjIum8f9y70lqeXe1Ks006n+fRo925U65mV3PmlrlXVBVjjDEmTGWFzoAxxpjux4KLMcaY0FlwMcYYEzoLLsYYY0JnwcUYY0zoLLgYY4wJnQUX0wnR3hD9DKIDCp2T7EXPhegNHazzE4h+DNEFEF0vL9nKSDQC0S8gOhuizRBtgehCiL4M0e1ycLwYREeHv9+Ux5sG0ZH5O57JJQsuGYlGIfoVRIe3W/YFRIdlsZ+fQPSdkPN2K0TvSJF2IkQfDeEY77oLWysF1gNGdH3fXRHtBdHfQ3QuRJf431UdbLQOsFbSPt51n0vr+3WAu4APgGOA2WHnOvi4GakC1gZeB84EjgR+g8trSxfz8yREx7RbuBbwva7tNyujgEiHa5lOEZF/icjF+Tper3wdqMQdC1QDe+EuPACH4/7R9wb+leF+ngY+DTlvGwI/hOhEiN3SLm0ZMB6ifSH2XReOsTWwERB3b2MrIQqwRhf22UXRMuAeYHfgMlzA+zMwFFicZsNeQFPS+xOBT5Le7wosAA6D2Iowc9xO++NmYpn/fQ7EPg83O2wGbA68m7RsJfn9jFcAiMjdwHJVPSGRICI1wIPAFqr6VR7zZAARWQ/4P2An3I3MX1T1T+m2sZJLZnbyv7dJWraL/51FtUFsMcQmhZSnhK+A+cA1EN2gXdp7uM94nRCOU2w3ImcC44BdIfYXiF0NDIPYjA62q8BdNL3YJPe5AET7AFvgSgL9XPVfriQft2gU+jNOXI9+BewrInsCiMgawM3AWakDS3RbiF4J0c8hmvail0xEyruU4x5ARHrhriH/xZUua4ELRGTbdNtZcOlQtBfuri5Oa3CJrguMxZVC2gWX6DG+vn4ZROsgunFS2ihfX16ZtOwMiM7x1TqXJi1/GaIHQfR2iM6H6OspMvgdcC9QD9znL5AJc/1vf7zo7hCd7PP2CET7+eVXQPR3EL0IorN89dK6EH3eHRuAJyDaBNFjk/Y/FKIPQvRbv26/pPyfDtEvIfqdy3t0M7/8ZIj+A6KnQfQT/3dHIbq+P29bQPRtn4fDg//kaAS4FDgDYu+1LY/5vEYFomdDdCZEl7qqwdYqzaSSS3Sgvxit4fPXCJyHKw0tAL5xaeCqjKKv+3M3sa2asDN/T/JxAaIV/sLY4Le/a9VzuZrREN0bosdD9Hz3t7aem40h+pT/uz+H6Akd5PMWiC4C1gVu8J/xhUnH6gfRf0K0EaKTIFqddKydIPqC//y/dN9lgOjNED0pab2r295H+/t8zPc/17nPC3CBH1X9Zrvt+v1+3XUrnvjww813By4aNKg8rjr2FIgub24eO/NHPxr4iIh8KiLzdtml/6fz5ze9DESamvTF3Xb7+BgRaRCRhSJSJyKt/6O+augGEXlaRL4Fftj+5IrIT0Vkqogs8cf4aVJaRESe9PueLyITU31IInK9iMwRkcUi8paI7Jhq3WyJyMkiMs3n8QMR2dov31xE6n3+JovI+DT7+LmITBeRb0TkYRFZyy/vJSIqIr8QkenANFV9RVXvUtWlqjoVd20ZnmrfYMElE1sBfYCbgG38P8JBuKqX61kluERPAO4AXgNOATbARfmEIbh/4qF+/YNxVTk3A1cBv4XoDn7ddYH/+Nc/B35A6gZ0xbUPDAWuS1q+xP8uxzWUPga8DZyBK42d7tPXAi7GVfGdgqueGAuc5Pc7F/gHcCiQ3IZzhz/mWX5//m+NHgD80f9dp+Au5ucmHeunwC+A84GpftshuKq354DJPq+/S/H3/gz4DLg1RfolwBXAI8AvcVVdW/u0MqDZvx6IuxOrBD4CaoBngIf9NjtCbBlE18RVac7z+1sH+H0X/p7k4wLc4vd7Cy64HYX7/NtLtHE96fNzHXCCy2u0DKJrAS/5/J2N+x4mLoyp8vk7XBXvNOAh4DDgn0nH/DPwfdxnvC7uuw9EtwdeAN705/Yl/zcBbAkkl/o2Adb2/zuPAT/Gfd+v8flJVL1V+H1v+uaboydsvPEa87fa6sMzgZMmTRq9Ie4G76RTTpn1WTzetP+GG/bZ7bXXNtlho436bLDjjtPegtgJhx8+48T33196sT/31bhS6F2s6gjcd6S/P0ftfQ2Mx7Vx/Qz4q4hs5dPOAWYAw/z+U31HAd7AXT8GAw8A/xGRPmnWz4iIHA5cgGtzq8J9JvNFpDfwOPCEz9+ZwH0ismHAPvbC3aAdjPu+fAnc3W61A4DtcJ9n8rbnAQKkDKxgwSUTewMNwL+BAbh66YNw/yQxYCN/Nya4uv8/QOxYiN0GLMdVWSUs8r8Tjc5nAVdA7BL3w0TclzrhHogdh7uYPIe7s04htgA4EDgi6U52uf8tuIv8Wz5vNwJ/bXesGcDuEHsC+B8wHWKfQuxxYCnwMsT+64+T8BWwh9/fDFqDJmfhvrjX4QLsaFyROvk81ELsP7gL1Ae4AI77O2PH4r7oa6f4Y/fy5yZg1NXoANwF+ucQ+5Vvh1qDts+hN75uf1WxZoi9ivusv4BYHcQm+8SjgG+BH0HsZv+3JZ+7Lvw90dHA0cCBEPstLiDCqt+bhD64kuqGQCXE+kNsQ4iNh1gL7qZhIbA9xP7m89H++9cun7EvIfYkLnC+DbEH3LJWTUANxP4BTKLtM74Y+BfEJkBsus9X4vs2hNb2OaAteIxzeaMGYpf7PCxLag8sw322rwPvrFyp329upvbggwc+vf76febjLoSN//vf4h3OOCPywiefLJu5/faV8y+6aO1ln322Ypfm5rFT/vOf7x08b17Tjaq6RFWX+XyOFZE1k/LzkKq+pqotqrqcdlT1MVWdoc4LwPO0lXBW4j7Hkaq6QlXrV/uU2vZzl6rOV9Um4E+4//vVLvSd8FPgSlWd5PP4sarOxt0s9Ab+rKorVfU54CncDUN7RwL/VNV3/XmaANSISPJNzeWqukBVW9trReQI3PdsnKp+my6TFlw6theuymka7g7+UGBn3J3Ie7gL9w64u5hq4PakbdtfxBLBpb//vQUuaCRMx/1jJjzsfsUaIbanuwCmE3sfd6G6AqJHtVt/C9w/SapjPdP2Tx47HmJT2u08qGH3gqRG72YgUX+9JbCjP0Y1sB3EHkva7lWIJToHTIDY87i7eXAXA3AXtVRtAMOBz1OkbebzkdzJIvlz6Etbw3imtgDqIZboCND+3HXl7xkDzIFY4nuQrhOBAi0+6Af9Y48B7ofY0hT7CspnsqDP+IqkG4rkz3hH2krW4C5qiTak5UnrkfR6DO4GJ/HdSspfa/vWH/xymThxk9nAvL32qkoE1anAObNnryg79NDPvu+qfiZ9usEGk1e2tGjzl1+uLGtu1vu22qrfPSIyQ0QW4z4raAuK0EEPQBHZT0Te8NVeC3HXgMT2VwIzged9ldk5afZzrq+6WoSrZl2zXT46awTBHYPWBmbpqkPdzyS4zXVtnwaAqi72eUxeN+g8nYFr+/q4o0xacEkr2ht3pzXR3yXX4e7Kl+EuxkuAD3HVQYnAkdSewpe0XWRg9eCyiFW6xbIRqS+aGYo9jKvuuh2iR7Q7dleO1Tdg2Zyk14txxX9wd3eLgc0gdpJrZI9uCNGgfSQMAL7yd8HgSml9CW5U/xxXXE8SPd23FSzCXcySj5X8OfSj7Q47U505d5n+PYv88sQFeB7u4jqQ1a2gteooZT7Tff86ks1n3IQLdglr4y5O4EotQRfRoPwlzkmiyvdHuM4ytbgSKC0tNOGC+QkQ276lhVmjRvXeT3VsVFUHNjVp1cqV2mvEiN6bX3tt/JN585r2AHbz+0yUFCTpuCnnGRGRvrgbxyuA4ao6EFeSF3AXYVU9U1XX83k9z/dka7+fXYFf46oABwKDcN8Bab9uJ8wmuIv4l8AIEUk+xkjgixTrJqoxEZH+Po/J6wadp7X8th0qdO+QYrcx7m7uff/+eeAQ4AFXFw+4etVxEDsfojFco+jNuHrmHXClHV+HHVvpGlpJFNEfAv7kqtUYiwtkR2aZx360BS0v9jfXaMydfsFKf6y7XSMvgqs7PiaL4yRdFFsvhEuT0j+n7R/5Adx5OgGic3AlmZNx/2iptLTbXwPu5mcDXKkx2Q3AQ65xnY9xpbVdcFV/03Ff/jsh+l8givsn2g1XSuxD+uDSm7Y2mYRHgN9A9DKfrwtxd7DppPt7kktOb+E+w3+6jgLU4gLIbrTddSfMcPmLnsmqd5VzIPY6roR9uf+MW3DVJxvT8bM/Ce0DXzmrf8aJHkKPAH+E6Eqf/x1wVa3g2q8Og+g3uOdWNsTdmE0Erofon3Gf6QG4c1KL+xzBVc3N8R0A7ujdW+a98ca3r5x88rCDgWMguv7hhw/68PPPVzzxwQffPb/FFtHZM2cu3+D66+d+/Oc/r/tpc7MOb2nRRcA3Pl+XZfi3J/Tx52Eu0Cwi++E6eMQARGR/3A3lDNz/XTOrf1/A3UA24W4WKoDf0vZ/31X/BK4UkVdxXcc3xH2nXvXHPEtErsVV5e2La59p7x7gDhG5F/d5XQG8pKpzfO+wVLZltetNMCu5pNeE+ydOPPj4CO4icW3SOvfTdjd2LO6f+q+4+s+zcEEmWaJ4DK5hdSJwNbAn8GOIJe4cvqCtt1c6X+O+7O3ELsfd+X0FzHDtJfwe18h3NnCZX4b/m9I9OzCbVYvhVcAsVr3A1dNWrXIWrhH158CNuMbxMyH2P5/foDufqbh2jYQvcY32AXd6scf833Es7lyvxNXj3+Sr6X6CK95fj3vY81xcwyr+70xcyBbiqgaS27IGtcsHEHsL17B7NO5i9W9cn386+fckHTc2F9fAvD3ue1WOa9MJ6OYZ+9of/1zgPly11F24qiRwF507cQ9WnoPrcPGm/9tT5TPhC1Z/7mYZ7sKT8BJtAeiXuIvZ3bjz0Zu2u96rcN+FW3Dn7FNgAcQ+wN0AHOTXmY37jMbi2obm0Fq1FrsH+E+/fmV9b7vtm6m4m5UxwA133rn+Nltv3ff9MWM+3LK8fNIJO+/80W69e8tpwMXHHjvkgblzm973f+sUn8eMqepC3HfrIZ+ng3GN5Amb4NqKGoFXgGtV9eWAXSXaST/BBeXFJP2PicixIvJe0vt/isj1Se8/EpFDU+TxHlyHmfv8fh8EBvn2o/1xba/zcG2eRwRVYanq07jv2UM+XyPJ7Mb2ZeAHGayH2EyU+RCtApa4qrXoh8B1vhHcFJ3opcArEHum0DkpHdEhuIvZSIjlaEQDU2qsWiw/HsFVqf0BV7JJV29uCip2YcfrmHYS7TrxtGuZHsWqxfLjHuBc1+jMaNyzJsZ0F4OBFRDLtqOE6YCIjBCRF/1DnVNE5HS/fLCIPCsin/jfg/zyTUXkNRFZLiJnt9vXOF/dNl1EJuQ67xZc8uNmXF34pcD/QeyVAufHmDA14tqYTPiacF1/R+Pa5U4Vkc1wz6U8r6ob4WpFEsFiPm74nKuSd+KHubkB2AfXXf9wv5+csTYXY4wpESLyCK4TxPVArap+5YdtqVPVTZLWuxhoVNWr/PsdgItVdW///jcAqnpFrvJqJRdjjCkBfmTibXCPPwxPDOLpf3c0VcE6rNZ9PZQBbVPqEQ3648aN06effrrQ2VjNa6+9xg477NDxiqaVnbPs2PnqlC496FgxbhPVeWlHRmnVPOmLKaz63NNNqnrTahkSqcQNoXSGqi5e9TnJjARtkNNqqx4RXObNm1foLARavtzaP7Nl5yw7dr7yT+d9S/83f5nRugvLJyxT1Wi6dUSkAhdY7lbVB/3ir0VkraRqsY566s1h1cn91iXDJ+07q0cEF2OMyZdmlEZd2fGKGfBDudwCTFXVq5OSHsU9RHyl//1IwObJ3gI2EpH1cQ+7HoZ7eDdnLLgYY0yIylWo1MzmmVvY8So74UY5mCwiiVlCz8cFlftF5ETcaBmHAIhINW6omiqgRUTOADbzVWmn4aaUKAduVdX2g9OGyoKLMcaETcMYnxL80DKpdrZ7wPoNBM8FhKo+iRuWJi8suBhjTNjsCQ8LLj1Fzf57E1+8IDAtUjWI+sdsKC1jwiGhlVxKmQWXHiK+eAHVj54ZmNZwwDV5zo0x3ZyVXCy4GGNMmJq1hcaWdBOK9gwWXIwxJkTllFGpfTJaN4PeYiXLgosxxoTN2lwsuBhjTOiszcWCizHGhEqxkgsWXHqMSNWglL3CIlWD8pwbY7qvZpTGlnCGfyllFlx6CHuOxZj8KCfU4V9KVtHO5yIia4jImyLynp/e8xK/fH0RecNP73mfiGT2KRpjTD6oZP7TjRVtcAGWA7up6tbAGGCciGwP/BG4xk/vuQA4sYB5NMYYE6Bog4s6jf5thf9RYDfgAb/8DuBHBcieMcakZiWX4m5zEZFyYBKwIXAD8CmwUFWb/Copp+oUkZOAkwCGDx9OXV1dzvObrcbGxqLMVzGzc5YdO1/Zq62t7fpOrCtycQcXVW0GxojIQOAhYHTQaim2vQm4CSAajWooX5iQ1dXVhfNF7kHsnGXHzlf+WW8xp6iDS4KqLhSROmB7YKCI9PKll5xP1WmMMdlwk4XZ8C9F2+YiIsN8iQUR6QvsAUwFXgQO9qtlMr2nMcbkl2b4040Vc8llLeAO3+5SBtyvqo+LyIfAvSLyB+Ad3PzSxhhTPLp5Y30mija4qOr7wDYBy2cA389/jowxJkPdvFSSiaINLsYYU5q6fzfjTFhwMcaYEDWr9RYDCy7GGBMqG1vMseBijDFhs2oxCy7GGBM6a9C34GKMMaHqAc+wZMKCizHGhMiGf3EsuBhjTIjKESqx4V8suBhjTNisWsyCizHGhM6CiwUXY4wJVQ+YCCwTFlyMMSZsVnKx4GKMMWFqRmlstt5iFlyMMSZE1lvMKdrJwowxpiRlOlFYBlVnIjJCRF4UkakiMkVETvfLB4vIsyLyif89yC8XEblORKaLyPsism3SvppF5F3/82i4f/TqLLgYY0zYEo36Hf10rAk4S1VH46Z5P1VENgMmAM+r6kbA8/49wD7ARv7nJODvSfv6TlXH+J8DQvpLU7LgYowxYQup5KKqX6nq2/71EtxU7+sABwJ3+NXuAH7kXx8I3KnO68BAEVkrnD8qOxZcjDEmbJmXXIaKSCzp56RUuxSR9XCz874BDFfVr8AFICDiV1sHmJ202Ry/DGANf4zXReRH5Jg16BtjTIiaNaveYvNUNdrRSiJSCfwXOENVF4ukrFILSkiUkUaq6pcisgHwgohMVtVPM81otiy4GGNMiMopo1LCmyxMRCpwgeVuVX3QL/5aRNZS1a98tVfcL58DjEjafF3gSwBVTfyeISJ1uFJQzoKLVYsZY0zYQmrQF1dEuQWYqqpXJyU9ChzrXx8LPJK0/Bjfa2x7YJEPQINEpI/f51BgJ+DDcP7YYFZyMcaYsIX3hP5OwNHAZBF51y87H7gSuF9ETgRmAYf4tCeBfYHpwFLgeL98NPAPEWnBFSquVFULLsYYU1JCGltMVV8muB0FYPeA9RU4NWD5q8CWoWQqQxZcjDEmRM2qNDbZ8C8WXIwxJkTlSKgN+qXKgosxxoTKhtwHCy7GGBM+G3LfgosxxoTOSi4WXIwxJlQZjhvW3VlwMcaYEDWjNDY1FTobBWfBxRhjQmS9xRwLLsYYEzarFrPgYowxobI2F8CCizHG5ID1FrPgYowxYbOSiwUXY4wJl0CLlVwsuBSRmr33Jb4guP9IZNBA6p95Ms85MsZ0ipVcLLgUk/iChVSf+dfAtIZrfpnn3BhjOkWxJ/Sx4GKMMeGzkosFF9Oxmr33JT5/Ucr0yOABVmXXTs0e+xGfF3zOIkMHUP/c43nOkckrCy4WXEzH4vMXUX3aDSnTG65fbeK7Hi8+bxHV4+8OTGt44sg858bkU7MqjSubC52NgrPg0kPU7Dme+Dcp7qSHDKD+2SfynCNjuqdyhMqyiozWteFfTMmLf7OI6sNuC0xruPf4POfGmG7OGvQtuBSTyKCBKXuFRQYNTNv2Ye0exhQRa3Ox4FJMOgoOo7fbKWXbh7V7GFMsbJpjsOBijDHhs5KLBRfTscjgAWlLRpHBA/KYm9IQGTogZa+wyFA7X91ZsyqNTdZbzIJLntXsN474ogUAnHbU8Zzyu/Na0yIDBlH/+NOFylpKuWzLqTlgb+JL5gemRfoPpv7RZ3J27Fyy51h6Lust5lhwybP4ogVU3z0BgIpp0voaoOHIK3N23MiQASl7hUWGFO5OOr5kPtUvnhaY1rDr9XnOjTEhsWoxCy49hT3HEq7uWuIyISnxBn0RWQ+4BtgRFypfAc5S1c8z3YcFlxKSru3D2j3yy0pcJq3SL7ncA9wEHOrfH+GX7ZDpDiy4lBB7jqV4zJw1m1lvvR2YprNm5zk3ppg0K91h+JcyVU1+6vp2ETklmx1YcDGmE5qbW+g3ZLPAtKXNLXnOjSkm3aRB/wURORu4F1cOOxR4TESqAFR1cUc7sOCSZzNnzWHWm+8AcED5prz55rTWNJ01p1DZMsaEqfSrxY7yv09vt/xk3F83sqMdWHDJt2Ut6Nm+u/FZa6N/eXqVtHRq9tmH+MIFgWmRgYOof+qpsHKZN5H+g1O2UUT6D85zbowJSYk36KvqiK7uo2iDi4iMAO4EqoEW4CZVvVZEBgP3AesBnwM/UdXgK24RGjVkU6pHPgfAmmu8xA82fa01rWHWHmm3jS9cQPVVlwemNZx9fniZzCPrVWW6HaXkSy4ickTQclX9d6b7KNrgAjThur69LSL9gUki8ixwHPC8ql4pIhOACcB5afZjTOjKV8LyA/6eMs30cCGVXLK9yRYRAa4F9gWWAsep6tt+X8cCF/hd/0FV70hz6B8mvV4D2A2YBJR+cFHVr4Cv/OslIjIVWAc4EKj1q90B1GHBxeTZqGGb2GRgJpCbLKwprN1le5O9D7CR//kB8HfgBz4YXQREceWqSSLyaKpaH1VdpWeYiAwCbs8m46Ja/OU3/0DPRGALYJaqDkxKW6CqgwK2OQk4CWD48OFj77333vxktgNTpnxMRe+NARg8qJH5Cypb01au+JjNN9849bbTplExYp3AtJWzv2DzTTcNN7NFqLGxkcrKyo5XzLGPPp5OU4rxo3r1KmeTjTfMc46CFcv5KiW1tbVdKnb02mAj7X/ptRmtu/Do8ZNUNZrpvkXkEeB6/1Orql+JyFpAnapuIiL/8K/v8et/hLsZr/Xrn+yXr7JeBsftBUxW1dGZ5rVoSy4JIlIJ/Bc4Q1UXu1Jfx1T1JtxDQESjUa2trc1ZHrNxyi8uaW1zOfzHL3HPf9tKnw2zLmHqhy+m3vY3E1K3ufzhdqa+9nq4mS1CdXV1FMNnWQx5yESxnC+T0lARiSW9v8lfu1bjb7K3Ad4AhvvaHXyAifjV1gGSH7Sa45elWh5IRB6ireWoDNgceDizP8kp6uAiIhW4wHK3qj7oF38tImslRex44XKYvUikf2vD/coVh9Mw65JV0owxJU7Jps1lXiYllyxusoMSNM3yVJK7cDYBM7MZ+gWKOLj4hqlbgKmqenVS0qPAscCV/vcjBchep9XXPdr6uq6uLm1Jpb3IwEEpe4VFBq5WM2iMKZQQWxuyvMmeAyR3I14X+NIvr223vC7VMVX1+a7mu2iDC7ATcDQwWUTe9cvOxwWV+0XkRGAWcEiB8pd3pfgcizE9T3gzUXbiJvtR4DQRuRfXoL/IB6BngMt9wzzAXsBvQslkCkUbXFT1ZYKLcgC75zMvxhiTqWZVGleENrZYtjfZT+K6IU/HdUU+HkBV54vI74G3/HqXqmrwsN4hKdrgYowxpagcobK8PKN1OxpbLNubbHXdfwOHTlfVW4FbM8pYCCy4GGNM2Ep8+BcReYfVW44WATHgikxKPRZcjDEmbMX/+GBHnsWVmBJP5B8GNAONuIcpD+hoBxZcTM7V7DGe+DfBI3RHhlRR/5zNkmm6mRIvuQA7qurOSe/fEZGXVXVnEZmcyQ4suJici3+zmOqD7gxMa3jwmDznxpjcam6BxhUlP6dPfxEZq6qTAERkW6DKp2U0to0FF2OMCVG5QGV5ZpfWIp4s7GTgLv+MjQArgBNFZE3gT5nswIKLMcaErcTbXFT1dWAzERmCG4NyXlJyRuORWXAxHarZdX/ic5ekTI8M60/9i4/lMUfGFLPwHqIsFBHpDfwIN6R/r8RwM6oaPLhhgIyCi4j0AX6cOFBiuapemnFuTcmKz11C9eapG90bpozPY26MKXLdYLIw4CFgGW4Ol049EZppyeURXB/nScDyzhzIGGN6jtIuuQCjVHWLruwg0+CyrqqO68qBTM8VGVKVsldYZEhV4HJjSlWzKo3LQxv+pVBeF5HNVPXDzu4g0+DyqohsqaoZ9W82Jpk9x2J6knIRKnuVfG+xH+CebZmOq60S3Ogy22a6g7RnwD8so36940VkRrsDbdXZnBtjTLdV4g36uMb8LukovO7X1QMYY0yPUsIN+iKypqp+C8zt6r7SBhdVnekPeJeqHt0uE3fhhoI23VxkWP+0PcIiw2wGzWJSs9t+rV3HTzvlCE755UWtaZFh/al/4fFCZa3nKN2SywPAPsAUVp/BUoGRme4o0zaXzZPfiEg5MDbTg5jSZs+wlJb43CVU7/AQABVrvtP6GqDhtf9XqGz1LCVaclHVffzvER2t25GO2lx+g5uYpq+ILKYtiq0AburqwY0xprtpVmhcXvJjiyEi+wK7+Ld1qvp0Ntt3VC12BXCFiFyhqjmdEtMYY7qDckq/t5iIXIabBTMx5P65IrKzql6Q6T4yrRY7X0QOAnbGFfheUtWHs8qt6bKaffYhviD46xgZNJD6p57Kc46MMYFKtFosyf7ANqraDCAitwJvA6GUx3V6AAAgAElEQVQHlxuADWkbsOznIrKnqgZOp2k6p6Y29RhekWH9iS9bSPXlfwxMbzj/vFxmzRiTjdJt0E9WBSzwr7PutZNpcKkBtvDzMyMidwD2QGXI4nOXUL3hM4FpDdP37sTHa4wpiNIvufwJeFtEnse1tdcCF2azg0yDy0e4Lmgz/fsRwPvZHMgYkx+RYf1be4WtHHMEDa9dukqaya3mltJv0FfVf4nIi7gn9QW4UFW/yGYfmQaXIcBUEXnTv98OeE1EHvUZ6XA+ZWNMfiQ/x1JXV8fUyfUFzE3PUy5QWVGe0bpF3KCfGH1luv89RER6AbNVNaPImWlwyao4ZIwxPVrpt7ncAozBPUwpwGjgA2CAiJykqs93tIOMgouq1ovIKGAjVX1ORPoCvVQ19QxSxhjTU5V+m8snwImq+j6AiGwJnAlcjnuKf0xHO8h0srCfAScBg4HvAesCNwK7dyrbplMigwam7BUWGTQwz7kxxgQr/ZkogdGJwAKgqpNFZFtVnZ6YlbIjmVaLnQp8H3jDH+gTEYlkm1uTXmRYf9crLEVa/VM2DIsxJaH0Sy6fishfgXv9+0OB6X5W4qZMdpBpcFmuqisSEcs37JT+6Ss2Zep+UqUZY4pec4vSuKzkJws7BvglMAHX5vIy8BtcYMmoxirT4FIvIokxxvYEfgHYbXTIkgccbM8GHDSmNJSLUFlR2sO/qOpS4I/+p71FmeyjLMNjTcCN7z8ZOBl4kiyGATDGmB5FJbOfbizT3mItIvIw8LCqdnkSGWOM6dasFjt9yUWci0VkHjAN+EhE5oqIPfdijDFBlG5VcvFxYM1st+uoWuwM3LDL26nqEFUdjBsOYCcRObMT+TTGmO5PM/wpUiJyp4hUiUg/3IOUn4nIr7PZR0fVYscAe6rqvMQCVZ0hIkcB/wOuyTbTJndqdk0/qrLNKGlM7jUrNC4r7bHFgC1VdbGIHIG71p8LxICrM91BR8GlIjmwJKjqXBGpyCqrpkPJAw4GpXUkPncJ1Zs/EZjWMGV8l/JmjMlMmL3F/Dwq+wFxVd3CL9sa9xB7JfA5cKQPBL2BfwBRoAU4XVXr/DZ1wFrAd37Xe6lqPM2he/tHTg4E/u4fRckqYnZ0BlZ0Ms10QvKAg8aYEhVuldftwPXAnUnL/gmc7YflOgE4B/gd8DMAVd3SP+T+lIhslzTQ5JGqGsvwuDcDs3DjidWLyEigMZuMdxRcthaRxQHLBVgjmwOZ0lWzx3ji3wR9DZzIkCrqnwsuMRnTM4XTWK+qE0VkvXaLNwEm+tfPAs/ggstmwPN+u7iILMSVYt4kCyJSjhv9eO2kZXOA3bLZT9rgoqqZjRtturX4N4upPujOlOkNDx6Tx9wYUwIyL7kMFZHk0sRNqnpTB9t8ABwAPAIcgptfC+A94EARudcvG+t/J4LLbSLSDPwX+ENi8sfVsq7aLCJn+PUSy1rIsrYq0yf0jTHGZKBZNZsG/XmqGs3yECcA1/lHQh6l7aJ/K25o/BhuYsdXaRsH7EhV/UJE+uOCxtGsWtXW3jM+wNwHfJtYqKqpqzDaseDSQ8yc9Smjt6wJTIsM62/tPcaEJNfDv6jqNGAvABHZGBjvlzfhhsXHp72KGzqfxCySqrpERP6NG4g4XXA52f8+K/nQuBmJM2LBpRuJDOufuleYVBRs3LKa3fcjPjf4hicyrIr65y2wmW4kx8+wiEjEt6mU4YbhutEv7weIqn7rx4BsUtUPfa+vgao6z/fy3Q94Lu2foDoiXXomLLh0I+meY0lVasmH+NzFVNc8EJjWUH9wnnNjTB6E9PS9iNwD1OLaZuYAFwGVInKqX+VB4Db/OoKrzmoBvsBVfQH08csrgHJcYLk5g2Nviusk0Np5S1X/nWneLbgYAGpqDiAeD34Ac+bXc6jOc36MKWkhlVxU9fAUSdcGrPs5ridZ++Xf4hr3MyYiF+Cq3jbF9UbbGzfsvgUXk514fAnV1S8Gps38ct20PcIiQ6pylS1jSlDpjBuWxqG4qYzfVtWjRWQt3AOaGbPgYjo0au2NmPpOcOAxxqzKTRZW8sO/fOe7JDf5HmYNwAbZ7MCCS57V1LaN/3XaL47glFMvbk2LDOtPfZ2N/2VMKXO9xTJ7RLBYJwsD3hGRgbjuzTFgMfB2Njuw4JJn8blLqN7wGQAq1ni19TVAw/S9c3bcjsYti3/1bWCaMaYTSrxaTFUTXZFvEJFngCpVteDSU9Xstj/xeIouv5Eqpk6uT7nt6NG75ipbRIZVpewVFhlm7TWmGyri4fQzJSKHAd9T1ctEZISIjFXVSZlub8GlG4nHF1O97aOBaQ1vH5Dn3LTJ5XMs6Xq5RSL9qa8PPh/G5FSJBxcRuR6oAHYBLsM9pX8jsF2m+7DgUkJqatNfSLsiEulPQ0Nw6aWr+86ldL3cUv09xuRSc0u3mM9lR1XdVkTeAVDV+X5I/4xZcMmzmXM/YmbjDwE4YI8TeOPd89oSv5uddtt4fAnVI4MfrG2YtUfH84qmYXf4xoSjXKCyd+6Gf8mTlX4EAAUQkSG4OWIyZsElz5p7Qb8rLwJA+jTRx78GWHrWTwuVLVNCavbYj/i8RYFpkaEDqH/OhtMpuBKvFgNuwA1wOUxELgF+AlySzQ4suORZeXkZK757DwDtvQErvpuxSpoxHYnPW0T1+LsD0xqeODLPuTGrK92HKEXkSeAXqnqniEwC9sBNTnOIqn6Qzb4suOTZqJEjqN5uDABrzmni+xuPaU1rGNnlseKMMcWgdEsutwP/E5E7gD+p6pTO7siCSzcSiVSl7BUWiXS+y2+6jgRu3/2pr7M2G2OAnI+KnEuqer+IPAFcCMRE5C6S2lpU9epM91W0wUVEbsUNDR1X1S38ssG4yWvWAz4HfqKqCwqVx2JT/0Junu5P15EAfGeCAinVXm6m+2pWpfG7ku4tthLX9bgP0J8sG/ITija44Ipn17PqhDYTgOdV9UoRmeDfnxewbUmaOXs2o6M7BaZFBg9wF9IUF/JCXkhnzvyU0ZvXBqblekgb6+Vmik25SMn2FhORccDVuBkut1XVpZ3dV9EGF1WdKCLrtVt8IG5uA4A7gDpKLLhEBgyk4eeXArDymONo+MPtbYkrmqn+2Y2B2zXc/HOmxl7JQw6z19zSa5VhbJLlckgbY4pWiVaLAb/FNd53uq0loWiDSwrDVfUrAFX9SkQihc5QtuqffLr1dV1dHVNfeb31fapSS6asi2rPEBk6IGWvsMjQAXnOjVmNUrK9xVT1h2HtS1SLN8T6ksvjSW0uC1V1YFL6AlUdlGLbk4CTAIYPHz723nvvzX2Gs9TY2EhlZWXr+3femwwD1wleeeEXbLP1lmn3N+XDj6gYuH5g2sqFn7H5ZqvNI5SRKVM+pqL3xinTG5d8QOWAzYOPu+wTNt889bbZan/OTHp2vrJXW1vbpcjQa8gW2n/f/2a07sJ/bTpJVaNdOV6xKrXg8hFQ60stawF1qtrhFTMajWosFstpXjNVs+844otcTetpxxzH9Xfe3pr20ZRpDDjypcDtlt6zL8vnp3+Cf/SYH6Z9/mHqu8H77sjozXZN26D/av1G7LjX1ODjTt+bqVPqOnXcIHV1ddTW1oa2v3SSp0dor1SmR8jn+epGuh5c9nkwo3UX3r1Jtw0upVYt9ihwLHCl//1IYbOTvfiihVTfeCEAFXOaWl8DTNs99WyPhZSuIwHk9uHPmt33Iz6vbaTn004+klNOd+csMrQqp4NiJk+P0J61JZlUmlso9d5ioSja4CIi9+Aa74eKyBzgIlxQuV9ETgRmAYcULoc9R0fPsKTqKRaG+LzFVO/ZVqVZUTWl9X3Ds4fl7LjGdFZ5mVDZp+QnC+uyog0uqnp4iqTd85qRfNIWFt25b2CSNHe6R2DORYb1T3knHxlmz5qYHqaEG/TDVLTBpUfScgYM/SQwaWnDZh1uPnPWHGa99W5g2rJZkxm9y/cD0yJVg6h/PLj6JxOl0PZgTF4Vb1N23lhw6UaWL12MvnJaYJpWCtUPnBOY1nDwn7t03O7Q8G1MqKzkYsGlmIjAimXBJY9MGs179amk3+51gWkLX81dhxRr+DamTXMLNC61Bn0LLnmW7gl9Wb4SXXlu8IayPA+5Kz4zGz5h5iP7t74/YL2f8sYjE9ybxV/m9NjWlmQ6o1ywBn0suORduif0+6y5Pn2+F9wza+nH26zWLTdZZGjnRz0uar3LkPMPantfNaj1vV74t5we2qrzTKdZtZgFl3yr2Xcf4gvdQM6nHXMcp5w/oTVthSygaUlw24WuXLlat9xk3bVb7qiRI6iObtP63s2B494Xcv6b5M+xvcjAQdQ/+VSec2SKijXoW3DJt/jCBVT/1VWLVXy9rPU1wLS9DqNlfvB8LJQXb1fkYlVTk3oemkikf5dGVE7+HNtr+OWFgctNT1G6M1GGyYJLMSkTeh0dPCpy0y0pgk6S8vIyVjRODt71iuaUvcIiVYHDs7VKd5EGmDl7DtUbdpi9vIvHl1Bd/WJgWqo5YIzpshKeLCxMFly6ke223Zx4PEUA2XbnTo+KnO4iDTBz1khr+DbGa25RGpdadLHg0o0Uakj9USO/x9QpqYOPMT2JDf/iWHDJs5mz5jDrTfcsywFDR/Hmm9PaEhValgVXa5VyDW5XHrJM7roNq3bfjgwYmGIrYwrMCi4WXPKtubmFfn22BkDKltPbvwZYClT13yZwu6UVFUSGVqXsFdbVrsgDh4/ku6bg/4im776lurrz++7KQ5bJXbdh9e7bxhSdENtcRORWYD8gnjT1yNbAjUAl8DlwpKouFpHewD+AKG7e+9NVtc5vMxY3dXxf4EmfltMQaMGlhHQ0vHzNbvsTj6d4DiZSRf0LqUsI3zUp/Y4PnsFg4U3Bg2n2ZJGBg1L2CosMTN9BwvQEodU13A5cD9yZtOyfwNmqWi8iJwDnAL8Dfgagqlv6WXqfEpHtVLUF+Dtu8sTXccFlHJDT/vIWXPKsvElZftFFAOi5x7H8T7e3Ja5YydJbDgzcrm+vjod/iccXU71tcPfahrc77m3W3UQi/VP2CotEutbRwJ5jMWmFVCZQ1Yl+0sRkmwAT/etngWdwwWUz4Hm/XVxEFgJREZkNVKnqawAicifwIyy4dC+jhm3aOqvjmmu8xA82f6U17Y03RjJqvVGB20UGD6Bmn32ILwhuAowMyl37g5C+625XL9S50pXnWLoql8/YmOLW3AKN3+a0xukD4ADcZImHAImnid8DDhSRe/2ysf53CzAnafs5QIr51MNjwaWINEsZ1T8Lfs6l4eafQ68Wqi//Y3D6+ecBvXOSr4qKCqZOtd5g2bBnbHqu8jKhco2Me4sNFZHkOdhvUtWbOtjsBOA6EbkQNzvvCr/8VmA0EANmAq8CTQTX0eW8y4EFF2OMCVN2DfrzVDWrIctVdRqwF4CIbAyM98ubgDMT64nIq8AnwAJg3aRdrAvkdtRXLLjkXfJ89CtXHE7DrEta08ozaFcpRTa6sOlxclguEJGIb1MpAy7A9RxDRPoBoqrfisieQJOqfujTlojI9sAbwDHAX3OXQ8eCS54lz0dfV1fH1A/bqk5GR3fK2XFnzvqU0VvtEpgWGVZF317C0ttSdSboWs8XG13Y9DjhdUW+B6jFVZ/NAS4CKkXkVL/Kg8Bt/nUEeEZEWoAvgKOTdnUKbV2RnyLHjflgwaVbiUSqUvcKK+tNdc0DgUkN9Qez8OtZOcyZMT2Ha9APZ1+qeniKpGsD1v0c15MsaD8xYItwcpUZCy7dSLrnWFKVWhJqxu2btida/dNPdilvxvQU5QKVa2RWxW3Dv5i8iAwe4HqFpUh7b8r7zDgy+An9vmVda6+JL1hI9YRrAtMarjwzcHkYujI0jDFFy4bct+BSVJrLYEWKLozNZay19iiqT7shMLnh+lMDlxe7rgwNU8xy+QCnKQE2tpgFl2ISn7s4bbsIffKcIdNp9pBkD2clFwsuPcXMmTOYef//C05cNpNRm47Mb4aM6c6s5GLBpZTMnDmHWW+8E5imM+cELk9obulFv23uC0xb+srOXc6bWVXNnuOJz18UmBYZPID6Z5/Ic45MvjS3QKPNSm7BpZQ0N7fQr3eKIfmbW9JuW15exoqFU1KmmXDF5y+i+tibA9Ma7vhZnnNj8qlcxHqLYcEl72r225v44gUAnHbkCZxy4bmtaTPnzqIL06aktbzsG3T2MYFpUraMyKBNU/YKy+WgmCa/asaPI75oQWBaZMAg6p94OjDNZMmqxSy45Ft88QKqHzgHgIr3e7W+Bpgx9pdpty3XFpbfE9wrrFzTl1xa+pTT66HLA9OaDjynYM+x2NAw+RVftIDq2y4ITGs4/g95zk03Zg36FlyKSXl5mesVFiAyrApWbtztRtq151hMt2QlFwsuxWTUyHWZOnFiyvTRo0szgBjToyhWcsGCizHGhCoPk4WVBAsuJaQrT32LQEtT8Gh6YjdZoYsMHpCyV1hk8IA858bkU3mZjS0GFlxKSkdPfdfsO474olRfV6Wqf2VgytJeFV3MWefV7Dme+DcpngcZUrrPg5Rqvk0YxKrFsOCSd5GqQTQc/GcAVh55Ag2X3rpKWlfEFy2k+sYLA9Om1R7Kwr3PCkwrX5G+p1kuxb9ZRPVhtwWmNdx7fJ5z0/1FBgxK2SssMqBr3z/jZTcTZbdlwSXP6h9vG6Sxrq6OqRPfzHjbmj3GE/9mcWBaZEhV2m17912THZ+6NTCt4eeXpj9umpGLwUYvLiX2HEueWMnFgkspiX+zmOqD7gxMa3jwGOiXo+OmGbkYSnv0YmPCZg36jgUXU9Jqdt+P+LwUpbmhVdQ//3i3Oq4pftag71hwMSUtPm8x1XveG5jW8GzwxGqlfFxTAqzNBbDgUlQ6mmrYGFMqrM3FgksR6Xiq4RSzVHqRAQNTNs6XtxTnrVRkyICUvcIiQ+x5EFOiivPfLa8suBSRmXOmM/P3Pw1O/PprRkU2Sbt9/ZOpewINHLEOr+5zQmBaX0kftHLJngcx3Y895wIWXIpKcy+h339OC0xbutuFRIZUuV5hATrqirzWOiOpvvyPgWkN55+Xdtt0Ixcn0o0xTnMLNDYWOheFZ8GlhNQ/V5i7fHuGxZjMlQtU9s2s5GK9xUxJqNl735RT6878cnbOJiIrpMjQqpS9syJD05fmjMkZa3Ox4NKdxOcvovq0GwLTZkzYN2fHrRm3D/GFKXq5DRxI/dNP5ezYhXqexIKaScvaXCy4FJPy8jJWzJyeMq1YxRcupPrCqwLTGi49O8+5yQ97SNKkZSUXCy7FZNSIEVSP3TYwrWFEfZ5zY4zpjOZmaGy0kosFlyISqRpEwwHBz7l0dcTk8hZN2SvMHtA0JjzlZdagDxZcikr9Y6kHh+yqUSM3YOrrr+Rs/8aYJFYtZsHFmFQ6muKgUF3DTbGzhyjBgktRqdl/b+JL5gemRfoPzmnJxqyuwykOjEnFSi4WXIpJfMl8qp85PTCtYe9rO9w+MngADdefmjItVyIDB6bsFRYZaO05pieykosFl26k/pknC3PcHD7HYkypaW6GxtQTt2ZFRG4F9gPiqrqFX7Y1cCNQCXwOHKmqi0WkAvgnsC3u2n6nql7ht/kcWAI0A02qGg0nh6kV78MTxhhTgsrLoLKfZPSTgduBce2W/ROYoKpbAg8B5/jlhwB9/PKxwMkisl7Sdruq6ph8BBaw4GKMMeFTyeyno92oTgTaN8RuAkz0r58FfpxYHVhTRHoBfYEVQHCPlDwoyeAiIuNE5CMRmS4iEwqdH2OMWYVm+NM5HwAH+NeHACP86weAb4GvgFnAVaqaCEwK/E9EJonISZ0+chZKrs1FRMqBG4A9gTnAWyLyqKp+WNicme6mK1McmB5MyaYr8lARiSW9v0lVb+pgmxOA60TkQuBRXAkF4Pu4NpW1gUHASyLynKrOAHZS1S9FJAI8KyLTfKkoZ0ouuOBO4HR/whCRe4EDAQsuJlT2HIvptMxLJfOybQNR1WnAXgAisjEw3icdATytqiuBuIi8AkSBGar6pd82LiIP4a6jFlzaWQeYnfR+DvCD9iv5ot9JAMOHD6euri4vmctGY2PjKvk646iTaLojuJtJr6NOKsq/Id/anzOTnp2v7NXW1nZp++YWoXFJ7roii0jEB4ky4AJczzFwVWG7ici/gH7A9sD/iciaQJmqLvGv9wKC50MPUSkGl6BPbbX7BF+0vAkgGo1qV78wuVBXV7fKF7kY81hs2p8zk56dr/xL9BbLxMKl6dNF5B6gFld9Nge4CKgUkcQDbQ8Ct/nXN/jXH+Cuk7ep6vsisgHwkIiAu+b/W1VTz4keklIMLnNoa8ACWBf4skB5McaYVXWtsX7VXakeniJptaeqVbUR18DffvkMYOtwcpS5Uuwt9hawkYisLyK9gcNwjVrGGFMcQuqKXMpKruSiqk0ichrwDFAO3KqqUwqcLWOMaWNji5VecAFQ1SeBwox1YowxHenmpZJMiGr3D7EiMheYWeh8BBgKzCt0JkqMnbPs2PnK3hqJcbw6Q0Sexp33TMxT1fbDu3QLPSK4FCsRieVrnJ/uws5Zdux8Zc/OWThKsUHfGGNMkbPgYowxJnQWXAqrozGEzOrsnGXHzlf27JyFwNpcjDHGhM5KLsYYY0JnwcUYY0zoLLgYY4wJXUk+od9diIioNXplxM6VyRUR2R7YCPgEeFtVV3SwicmAlVwKJPliKSLDRGRgofNUzJLO1Z4ismGh81Oq/BwgQct75HglInIArnfYHsDZwKjC5qj7sJJLgSRdLH8F7A0sEJHZqvqbwuasuCSCsIhU+Bn2zgP+BUwvcNZKkqq2AIjI8UAlMF9V7/bnuEeVDkVkCHAqcISqfiAitwJjRGQRsFhVlxU2h6XNSi4FJCKH4aZoPgr4FtiysDkqPkkXu7X87/uA5bDq3XZPvfPuDBH5MTAB9/9/pohcCu5c97Dz2AT0BTYVkSrcpFzHAP8HXOBnbTSdZM+5FJD/J58F7AjsC+ynqitFZBtVfaewuSssEfkB0EtVXxGRzYHHgJdxkx5V4AJyL+AjYEnijtykJyIH4krKt6nqWyLyPeC/wMOqenFBM1cAInIw8BtgJfCEqv5eRHbDBZlrVPW9gmawhFnJpQBE5HgR2QJoBp4F9lTVvX1g+Slwooj0LWwuCy4CfObnC5+Cu6s8H3ch3BQ4FPgLcAWuescECCiJbALsCmwlIr1V9VPgx8BxIvLbvGewwFT1AVx7y0vAO37ZC0B/rP2lS6zNJQ8C6rLXAs5V1WN8PW+NiIwG9gJOBA5X1e8KkddCE5EyVW1R1cdEZGvgRhG5DHhSVVtE5HLc1NbXAL8H+qnq4kLmuVi16zSyLW7aiauAL3Alvw9F5C1V/VREdsXNu97jqOoCEXkB+ImIrADWANYH3i9szkqbBZc8CGgkvQ84W0TWUdVfi8hVwJm4u6VDVXVq3jNZBPzFMNHg/AtgKfAAcDrQLCL1ftXRwIaq+jLQWJDMloCkwHIqbjrwl4CtVHU/EVkHVx10lYi8qqqfFTCrxeA1XHfk3wLLgONV9fOC5qjEWXDJId9/vklVYyJyFK6Y/Td/p/gdcDUumJzt1++lqk0FzHJBJV0MTwZOAA5U1S9EZAlwGq5e/EXgXtzdt+mAiNTiqr32AS7DVcWiqn/y3ZJ/CbyJa9zusVR1IXCdiNyGa4u20nAXWYN+jviGwr8DUdydUBWujeAzYAEusNwCXK2qrxUqn8XGtzXdgzt3b+MujOvi6sVXABcDE3tyEM6Grw7bETer+4HA/qq6XERqVbVORAap6oLC5tJ0R1ZyyQERGQocj2tDWQJcB9yO++feDFf0/i+wBe4CasHFU9XvRORJXEP9bOBjXFvBU/79dAssHRORQ3DVhzcAD+Oe29jCp50I7CsikyywmFyx4JIby4FyXO+mJlxd92FAf1V9CDhCRPYGdsF1sTWruhPXc+dTVZ3vqxQPAsbZ0BzBAjqNzMBVhX0HnAGcJSJn4hrtj8C1KSzJf05NT2FdkXPA/9M+j/vnnqyqfwNeB8aLyE/8Os8AF6jqB4XLaXFS1WWq+haw0N9lnwf8ygJLakntVYkeX3FgELCLqj4InANsjKuePVpVJxcko6bHsJJL7tyPu/u+XkTm4+7Gm4GDRGSFqj7ck4ba6KQ1gBbgJz21B102fHfiC0XkZ6o6XUT+DlwmItNU9VXg1QJn0fQg1qCfY75B9T7gSlwvp4OA51T1q4JmrET0tPGustH+3IjIANxYWdsA84CncW18b/uSsjF5YyWXHFPVt33PsRdw3ZLvKHSeSokFltSSqsJOAtbG9aa7Flcd9n3gElz39zcACy4mryy45IGqviciNbguycZ0iYj0U9Wl/vWvgANwoxVcA5Sr6u+BOSLyFlADxAqWWdNjWbWYMSVERPbFdXH/C/Alrrp1Am4Ugz1wgaY3LshYbzBTMNZbzJgSISL74Z7/qVPV2bjODusCdcDOuBENmoAjgT162PD5pshYcDGmBIhINXAW8FNVfVhE1vBtLrfjBkL9lx9V+zjg18D71l5lCsnaXIwpDctxY6stE5E1gAm+HW8JMB+4SUT2AcYAP/ZD6RtTMNbmYkwJ8FVcv8a1t2wOPIebPO1D4Ee4YXIeAspUdW6h8mlMggUXY0qEiFTipsIeATyiqonpnm/HPTv1rwJmz5hVWHAxpoT5ASon4EYxsKowUzSszcWYEiQia+Gmev4Zbk4gCyymqFjJxZgS5Oe92Q34SFWnFzo/xrRnwcUYY0zo7DkXY4wxobPgYowxJnQWXIwxxoTOgosxxpjQWXAxRUdEVETuSnrfS0TmisjjOTjWz0XkGP/6OBFZuxP7+FxEhoadN2NKmT3nYorRt8AWItJXVb8D9gS+yMWBVPXGpLfHAR/ghrI3xnSBlVxMsXoKGCYLJxUAAAJESURBVO9fHw7ck0gQke+LyKsi8o7/vYlf3k9E7heR90XkPhF5Q0SiPq1RRC4TkfdE5HURGe6XXywiZ/vZQqPA3SLyroj0TS6RiEhUROr86yEi8j9//H8AkpS3o0TkTb+Pf4hIec7PlDFFyIKLKVb3Aof5EYC3wk3VmzAN2EVVtwEuBC73y38BLFDVrXAzM45N2mZN4HVV3RqYiHuyvZWqPoCbsfFIVR3jS0ypXAS87I//KDASQERG456a30lVxwDNuLlVjOlxrFrMFCVVfV9E1sOVWp5slzwAuENENgIUqPDLd8bNIY+qfiAi7ydtswJItNlMwlW1ddYuwEH+OE+IyAK/fHdcQHvLz9PVF4h34TjGlCwLLqaYPQpcBdQCQ5KW/x54UVX/nw9AdX55upkXVyZNntVMZt/9JtpK92u0Swsa2kKAO1T1Nxns25huzarFTDG7FbhUVSe3Wz6Atgb+45KWvwz8BEBENsMNT5+NJUD/pPef01a19uOk5RPx1V1+gq5BfvnzwMEiEvFpg0VkVJZ5MKZbsOBiipaqzlHVawOS/gRcISKvAMkN5n8DhvnqsPOA94FFWRzyduDGRIM+cAlwrYi8hCvtJFwC7CIib+Mm75rl8/shcAHwP5+HZ3FTEBvT49jAlabb8D2zKlR1mYh8D1eS2FhVVxQ4a8b0ONbmYrqTfsCLIlKBa/84xQKLMYVhJRdjjDGhszYXY4wxobPgYowxJnQWXIwxxoTOgosxxpjQWXAxxhgTOgsuxhhjQvf/AdxSXKWFLAn8AAAAAElFTkSuQmCC\n",
"text/plain": [
"
"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"f, ax = plt.subplots()\n",
"colors = sns.color_palette('Set1') # A set of colors that look good together\n",
"\n",
"pts = ax.scatter(bigones['MAG'], bigones['DEP'], # Python will ignore line breaks after a comma so I like to group my scatter, line, and color options on different lines for readability.\n",
" s=50, marker='s', alpha = .75,\n",
" edgecolors = 'k', lw = 1, \n",
" c=bigones['YEAR'], cmap=\"winter\")\n",
"\n",
"# Add colormap \n",
"clrbar = plt.colorbar(pts); # Here we pass the scatter variable as the keyword argument\n",
"\n",
"\n",
"#######\n",
"# Axis options: \n",
"\n",
"# Labels with some basic text options:\n",
"ax.set_xlabel('Magnitude') # Default text settings are inferred from rcParams\n",
"ax.set_ylabel('Depth', labelpad=20) # Adds space between Label and axis\n",
"ax.set_title('Major Northern California Earthquakes', \n",
" fontsize=13, color=colors[5], # Change size and color, 'colors[]' accesses different colors\n",
" fontdict={'family':'fantasy'}) # Dictionary of font-properties like {'param':'val'} \n",
"\n",
"# Setting options on the colorbar (Note the colorbar object is NOT an axis, but it has a .ax attribute that is.)\n",
"clrbar.ax.set_title('Year as a... color?')\n",
"clrbar.ax.set_ylabel('Years going up')\n",
"\n",
"\n",
"# Limits:\n",
"ax.set_xlim([4.5,8]) # Overrides defaults\n",
"\n",
"\n",
"# Spines: Removing top and right spines\n",
"ax.spines['right'].set_visible(False)\n",
"ax.spines['top'].set_visible(False)\n",
"\n",
"\n",
"# Grid\n",
"ax.grid(True)\n",
"\n",
"\n",
"## Ticks: (Changing frequency and location can either be done with intervals or lists.\n",
"#1. List:\n",
"exact_y_ticks = [0, 10, 20,30]\n",
"ax.yaxis.set_ticks(exact_y_ticks)\n",
"\n",
"# 2. Iterator\n",
"loc = matplotlib.ticker.MultipleLocator(base=10) \n",
"ax.yaxis.set_major_locator(loc)\n",
"\n",
"# 3. Changing the tick labels to strings (Useful for categorical variables)\n",
"ax.xaxis.set_ticks([5,6,7,8])\n",
"ax.set_xticklabels(['five', 'six', 'Seven', '8'], rotation=45);\n",
"\n",
"# Hide left tickmarks but keep labels:\n",
"#ax.tick_params(left=False);\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Exercise Set 2. \n",
"Use axis and data options to change the above plot to have the same theme as the plot at the beginning of section 4 also shown below:\n",
"\n",
"\n",
"\n",
"Hint: The colormap is called 'cool'\n",
"\n",
"\n",
"### Exercise 2B.\n",
"Use google to change the grid frequency and add minorticklocators in the above plot.\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": []
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## 5. Styles and Context Presets in Seaborn & Matplotlib\n",
"\n",
"* Manually setting style options on a per axis basis is super annoying. There are several ways around this.\n",
"* Seaborn has a number of pre-built styles and contexts that can save a lot of time.\n",
"* **Context** controls readability by changing text and plot element size \n",
"* `sns.set(context)` changes context between: **\"notebook\", âpaperâ, âtalkâ, and âposterâ**\n",
"* **Style** controls background color, appearance of grids, ticks and spines\n",
"* `sns.set_style()` switches the axis style more quickly then manually setting evreything. Changes will apply to all plots made afterwards, although options can still be specified. Options are: **\"whitegrid\", \"darkgrid\", \"white\", \"dark\", \"ticks\"**\n",
"* You can change the default style of matplotlib plots. A list of available styles:\n",
"\n",
"Matplotlib has it's own styles as well based on things like *ggplot* and *538* graph settings. You can see examples at the end of this section.\n",
"\n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 5.1 Seaborn Contexts"
]
},
{
"cell_type": "code",
"execution_count": 16,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"# Plot Function\n",
"def sinplot(flip=1):\n",
" x = np.linspace(0, 14, 100)\n",
" for i in range(1, 7):\n",
" plt.plot(x, np.sin(x + i * .5) * (7 - i) * flip)\n",
"\n",
"# Possible contexts\n",
"contexts = ['paper', 'notebook', 'talk', 'poster']\n",
"\n",
"ind=1\n",
"for context in contexts: # Iterate \n",
" plt.subplot(2,2,ind) # Note using Ind here to change were we plot the function on the subplot\n",
" sns.set(context)\n",
" sinplot()\n",
" plt.gca().set_title(context) # plt.gca() = GetCurrentAxis. \n",
" # You can assign the axis to a new variable or set axis options on the fly\n",
" ind+=1\n",
"\n",
"# Adjust horizontal spacing so that labels don't overlap\n",
"plt.subplots_adjust(hspace=.4)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 5.2 Seaborn Styles"
]
},
{
"cell_type": "code",
"execution_count": 17,
"metadata": {
"scrolled": true
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"seaborn_styles = [\"whitegrid\", \"darkgrid\", \"white\", \"dark\", \"ticks\"]\n",
"sns.set('notebook')\n",
"\n",
"ind=1\n",
"for style in seaborn_styles:\n",
" sns.set_style(style)\n",
" plt.subplot(3,2,ind)\n",
" sinplot()\n",
" plt.gca().set_title(style) \n",
" ind+=1\n",
"\n",
"plt.subplots_adjust(hspace=.5)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 5.3 Matplotlib Style sheets\n",
"\n",
"* Matplotlib has its own style presets that are often combinations of seaborn styles, contexts, and colormaps without the need to import the seaborn library, or emulate other plotting styles like 538, ggplot, etc.\n",
"* You can see a gallery of what plots look like in the styles at https://tonysyu.github.io/raw_content/matplotlib-style-gallery/gallery.html\n",
"* You can also write your own styles: https://matplotlib.org/users/style_sheets.html\n"
]
},
{
"cell_type": "code",
"execution_count": 18,
"metadata": {
"scrolled": false
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"['bmh', 'classic', 'dark_background', 'fast', 'fivethirtyeight', 'ggplot', 'grayscale', 'seaborn-bright', 'seaborn-colorblind', 'seaborn-dark-palette', 'seaborn-dark', 'seaborn-darkgrid', 'seaborn-deep', 'seaborn-muted', 'seaborn-notebook', 'seaborn-paper', 'seaborn-pastel', 'seaborn-poster', 'seaborn-talk', 'seaborn-ticks', 'seaborn-white', 'seaborn-whitegrid', 'seaborn', 'Solarize_Light2', 'tableau-colorblind10', '_classic_test']\n"
]
}
],
"source": [
"print(matplotlib.style.available)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"* To just affect a single plot without changing future plots, indent the plot call in a `with plt.style.context(\"style\"):` block \n",
"* Seaborn styles can be accessed analogously using `with sns.axes_style(\"style\")`"
]
},
{
"cell_type": "code",
"execution_count": 19,
"metadata": {
"scrolled": true
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"with plt.style.context(('fivethirtyeight')):\n",
" pts = plt.scatter(bigones['MAG'], bigones['DEP'], # data\n",
" s=50, # marker size\n",
" cmap=\"cool\", # color scheme: https://matplotlib.org/users/colormaps.html\n",
" c=1.0*(bigones['YEAR']-1983)/28) # specific color for each point (range between 0 and 1)\n",
" plt.ylabel(\"Depth\")\n",
" plt.xlabel(\"Magnitude\")\n",
" plt.title(\"Large Earthquakes\")\n",
" clrbar = plt.colorbar(pts, ticks=[1.0/28, 27.0/28]) # data takes values from 1983=1/28, 2010=27/28 (none in 2011)\n",
" clrbar.ax.set_yticklabels(['1984', '2010'])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## Introducing Other Plot Types:\n",
"We don't have to use the scatter function. These are some common plot types supported in matplotlib or seaborn and what they are good for:\n",
"\n",
"### Linear relationships:\n",
"* scatter\n",
"* line \n",
"### Categorical data:\n",
"* bar\n",
"* area\n",
"* pie (Don't use these, they are hard to read, & bar charts can be more information dense)\n",
"### Distributions:\n",
"* histogram\n",
"* kernel plots\n",
"* violin (Use these instead of histograms to get published in high impact journals)\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": 20,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"text/html": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Basic Plots 1\n",
"with plt.rc_context({'figure.figsize' : (8.0, 3.5)}): # Locally set options for just one figure:\n",
"\n",
" # Make NxM array of subplots (don't worry about this for now )\n",
" f,axs = plt.subplots(1,2)\n",
" axs.ravel() # Flatten the array\n",
" \n",
" # Histogram Example:\n",
" axs[0].hist(diamonds['carat'], bins=25, density=True)\n",
" axs[0].set_xlabel('Carat')\n",
" axs[0].set_ylabel('Density');\n",
" axs[0].set_title('Simple histogram of Carat sizes')\n",
" \n",
" # Pie Chart Example:\n",
" #Use group by function to sort data\n",
" groups = diamonds.groupby('cut')\n",
" counts = [len(x[1]) for x in groups ] # Grabs the amount in each group\n",
" names = [x[0] for x in groups] # Grabs the labels of the groupby method\n",
" \n",
" axs[1].pie(counts, labels=names, autopct='%1.1f%%', shadow=True, startangle=90) #Notice house were using axs[1]\n",
" axs[1].set_title('Percentage of Diamonds by Cut')\n",
" "
]
},
{
"cell_type": "code",
"execution_count": 22,
"metadata": {
"scrolled": false
},
"outputs": [
{
"name": "stderr",
"output_type": "stream",
"text": [
"C:\\Users\\David Delgado\\Anaconda3\\lib\\site-packages\\scipy\\stats\\stats.py:1713: FutureWarning: Using a non-tuple sequence for multidimensional indexing is deprecated; use `arr[tuple(seq)]` instead of `arr[seq]`. In the future this will be interpreted as an array index, `arr[np.array(seq)]`, which will result either in an error or a different result.\n",
" return np.add.reduce(sorted[indexer] * weights, axis=axis) / sumval\n"
]
},
{
"data": {
"image/png": "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XmPjxo3lXxiSkpK46aabWLNmDUVFRcyZM4f27duTkpLCQw89RPfu3XnppZdYvnw5RqOR22+/nTFjxrBx40bmzZuH1WolLy+PiRMnkpyc7M1fTbWmAFZNfPrpp/Tp04d77rmHb7/9lk2bNrFgwQLefPNNoqKi+O6773juuef45z//SVJSEt27d6d37948+uijxMfHM27cOI4fP84dd9zB559/zuuvv05qaiodOnTg7bffZs+ePTRu3JhDhw7xr3/9Cz8/P55++mm+/PJL7r77bm8/falGbr75ZhYsWMDAgQM5cuQIxcXFzJ49mylTptC2bVsOHDjAgw8+yNdffw1AnTp1ePPNNzl58iR//etfWbRoEUVFRUycOJHi4uLyx/3pp594/vnnSUtLo1GjRowfP55vvvmG9PR0wsPDWbhwIVlZWdx22220bt26fLuSkhKeeOIJXnnlFTp06MDixYt54okn+M9//gPAddddx2uvvebZX5JUKxd6zbdt27b89iNHjrBq1SpCQkJ44YUXaN68OW+88QY7d+7k9ttvv+Bj1qlTh08//ZT33nuPt956q/yLCMCSJUtIT09nwYIF2Gw27rzzTm688Ubef/99Zs6cScuWLVm3bh2zZ89WAHMjBbBqIiEhgYcffpgffviBxMREEhMTef3113nggQfK71NQUPCb7davX8/MmTMBaNy4MR07dmT79u3069ePhx56iOTkZPr160fPnj0BeOaZZ/jkk084fPgw27Zto0mTJp55glJjJCYmMn36dAoKCli4cCE33ngjb7zxBhMnTiy/j8ViITs7G4AOHToA0LBhQ8xmMyNHjqRv37489dRTFeZB2rp1K126dClfoLishff1119n9uzZAERERNCvXz82btxIcHAwUPrhFxoaWr6fwYMHM2XKFPLz8yvsX+Rqnf+aL2u9KtO8eXNCQkIAWLt2LS+99BIAsbGxtGrV6oKP2bt3bwCuvfZali5dWuG2TZs2MXjwYPz9/fH39+eLL74ASo+JVatWsWTJErZv305hYWGlP1f5hQJYNREXF8eiRYtYvXo1X331FZ988gkxMTHlB5bD4eDs2bO/2e78IYAulwuHw8HYsWPp27cvq1atYu7cuezYsYPevXvz5JNPMnbsWAYOHIifn99vthf5o/z9/enbty8rV65kyZIlvPXWW/zjH/8ofy1DaZd7nTp1AAgICADAZDLxySefsHHjRr799ltGjhzJe++9V76NyWTCYDCUX87KygIufgyUcTqdv6nx1/cp27/I1brQa/7XAezXrzGj0XhZ77tlXz5+/Zovc/6xcOLECSIiIkhJSaFHjx706NGDhIQEnnrqqT/ytOQSdBZkNfHiiy/y5ZdfcuuttzJlyhT27t1Lbm4umzdvBuA///lP+cFkNBrLPzzi4+P59NNPATh+/Djp6el06tSJ2267jcLCQsaOHcvYsWPZs2cPmzZtonv37txxxx00a9aM1atXV/igEqksN998M++88w516tQhOjqaZs2alQewtWvXMmrUqN9ss2fPHkaPHk23bt145plnaNmyJYcPHy6/PTY2lm3btpGZmQnA7NmzWbFiRYVjICsrixUrVtC9e/fy7Vq0aEFOTg47duwA4KuvviIqKqo8AIpUhvNf8xeTkJDAggULANi3bx/79++/YMj6Pd26dWPp0qXYbDaKioq45557OHDgAEeOHOHRRx/lhhtuYMWKFXp/dzO1gFUTKSkpPPnkk6SlpWE0Gpk7dy5hYWHlA4eDg4OZM2cOANdffz0vv/wyISEhTJo0iSlTppCWlgbAzJkzadCgAU888QQTJkzAZDIRFBTEzJkzCQwMLB8sCtC+fXtOnDjhtecs1VdcXBz5+fnccccdQGnXSGpqKn//+9+pVasW8+bN+82HTtu2benUqRN/+tOfCAwMpEuXLtxwww3s3r0bKO2inDRpEn/+859xOp106tSJYcOGUVRURGpqKkOHDsXhcHD//ffTrl079u3bB5S2TsybN48ZM2ZQVFREWFgY8+bN8+wvRKq981/zF/Pggw8yceJEhg4dSpMmTahXr94Vt8L279+fXbt2MWzYMJxOJ3fddRcdOnRgxIgRDBkyBJPJRHx8PFarFYvFQlBQ0B95anIRmoZCRESkivjiiy+IiYkhLi6OU6dOMXr0aJYvX46fnzq0qhq1gImIiFQRLVq0YOrUqTidTvz8/Jg+fbrCVxWlFjARERERD1NsFhEREfEwBTARERERD1MAExEREfEwBTARqdHuvfdeDhw44O0yRKSG0SB8EREREQ/TNBQi4rMKCwuZOHEiR48exc/Pj3bt2jFkyBBefvlloqKiOHToEAEBAbzwwgu0bNmSkpISXnrpJTZt2oTD4aBt27ZMnjyZ4OBgDh8+zJQpU8jKysLPz48HHniAG2+8kaSkJF599VViY2NZuXIlb7zxBjabjYCAAJ555hk6d+7MwYMHmTRpEiUlJbhcLkaMGHHB2fhFRC6XuiBFxGctW7aMwsJCvvjii/Llgk6cOMGuXbtISUlhwYIFDBs2jPHjxwMwf/58jEYjaWlpfPnllzRo0KB84eInnniCQYMGsWjRIubPn8/LL79cYYH6I0eOMG/ePObPn8/nn3/OjBkzePjhh7FYLPzjH/8gKSmJtLQ05s+fz+bNmy+4RqSIyOVSC5iI+Ky4uDjmzZtHSkoK119/PWPGjCErK4vWrVvTtWtXAIYPH8706dPJzs5m9erV5Ofn8/333wNgs9moW7cuOTk57N27l9tuuw2AyMhIli9fXmFfa9eu5cyZM4wdO7b8OoPBwLFjx+jfvz/PPPMMO3bsICEhgcmTJ2vySxH5QxTARMRnNW7cmGXLlrFhwwbWr1/PuHHjmD59Okaj8Tf3NRqNOJ1Onn32WRITE4HSLszi4mJMptK3ul+vH3no0CGioqLKLzudThISEnjllVfKrzt9+jQNGjSgdevWfP3113z//fesW7eOv/3tb6SlpdGoUSN3PXURqeb0FU5EfNaHH37IxIkT6dWrF+PHj6dXr17s2bOHvXv3snfvXgD+/e9/07lzZ0JDQ+nVqxcffPABJSUlOJ1OnnvuOV5++WWCg4Np164dn3/+OVAarO644w7y8/PL95WQkMDatWs5ePAgAN988w033XQTVquVJ598kq+++oohQ4YwdepUgoODOXbsmOd/ISJSbegsSBHxWRaLhWeffZZ9+/YRGBhIZGQkt9xyC7NmzaJ169acPHmSiIgIZs2aRUxMDFarlTlz5rBx40YcDgdt2rRhxowZBAcHc/ToUaZNm8bZs2cxGAw8/PDDJCcnVxiEv3jxYt58801cLhcmk4lnn32Wrl27lg/Ct1gsGI1GEhISGD9+fIUWNRGRK6EAJiJVyoYNG5gxYwYLFy70dikiIldNXZAiIiIiHqYWMBEREREPUwuYiIiIiIcpgImIiIh4mAKYiIiIiIcpgImIiIh4mAKYiIiIiIcpgImIiIh42P8DVnuFVpKgrQMAAAAASUVORK5CYII=\n",
"text/plain": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Violin plots show distributions + categorical data\n",
"iris_data = sns.load_dataset('iris')\n",
"with plt.rc_context({'figure.figsize' : (10.0, 6.5)}): # Locally set options for just one figure:\n",
" ax = sns.violinplot(x=\"species\", y=\"sepal_length\", data=iris_data, palette=\"Set2\", cut=3)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Exercise on contexts and different types of graphs\n",
"\n",
"Change the above graph to have a \"poster\" context and a 'dark' style. Also change the palette to \"Set3.\" If you get done early feel free to explore different types of plots and styles."
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## 6. Subplot and Figure Options\n",
"We used the subplot function above, but not to create multiple plots. Let's actually make more than one. \n",
"\n",
"The syntax we've been using to get axes is `f,ax = plt.subplots()`. In this example, we are going to add arguments to return more than 1 axis. \n",
"\n",
"We can pass (nrows, ncols, index) to `plt.subplots` to create an array of axes and access the one located at the index location.\n",
"\n",
"\n",
"\n",
"\n",
"The marker/line type specification shortcuts used below can be seen at https://matplotlib.org/api/pyplot_api.html#matplotlib.pyplot.plot"
]
},
{
"cell_type": "code",
"execution_count": 24,
"metadata": {
"scrolled": true
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Function and arrays to generate some data\n",
"def f(t):\n",
" return np.exp(-t) * np.cos(2*np.pi*t)\n",
"\n",
"t1 = np.arange(0.0, 5.0, 0.1)\n",
"t2 = np.arange(0.0, 5.0, 0.02)\n",
"\n",
"# create a figure\n",
"plt.figure(1)\n",
"\n",
"plt.subplot(211) # 211 = 2 rows, 1 column, first plot\n",
"plt.plot(t1, f(t1), 'bo', \n",
" t2, f(t2), 'k') # bo = blue, o marker, Makes a line through the dots\n",
"\n",
"plt.subplot(212) # 212 = 2 rows, 1 column, second plot\n",
"plt.plot(t2, np.cos(2*np.pi*t2), 'r--'); # r-- = red, dashed line"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Exercise on Subplots\n",
"\n",
"Copy the code below and expand it to four subplots with the same two plots like the image below. Feel free to also change the markers,lines, etc. \n",
"\n",
""
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Object-orientated approach to subplots \n",
"\n",
"Now that we have worked with the `plt.subplot()` method a bit more, let's take a object orientated approach. This will allow us to cleanly organize multiple subplot figures and each of the graphs in those subplots. We'll first go through a single subplot and then extend into multiple subplots. "
]
},
{
"cell_type": "code",
"execution_count": 26,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"def f(t):\n",
" return np.exp(-t) * np.cos(2*np.pi*t)\n",
"\n",
"t1 = np.arange(0.0, 5.0, 0.1)\n",
"t2 = np.arange(0.0, 5.0, 0.02)\n",
"\n",
"fig, axes = plt.subplots(2,1)\n",
"\n",
"axes[0].plot(t1, f(t1), 'bo', \n",
" t2, f(t2), 'k')\n",
"axes[1].plot(t2, np.cos(2*np.pi*t2), 'r--');\n",
"\n",
"def f(t):\n",
" return np.exp(-t) * np.cos(4*np.pi*t)\n",
"\n",
"fig2, axes2 = plt.subplots(2,2)\n",
"\n",
"# Note that since we've gone to a 2 by 2 plot we need to tell the axes[] two numbers for its location \n",
"axes2[0,0].plot(t1, f(t1), 'bo', \n",
" t2, f(t2), 'k')\n",
"\n",
"axes2[0,1].plot(t2, np.cos(4*np.pi*t2), 'r--');\n",
"\n",
"axes2[1,0].plot(t1, f(t1), 'bo', \n",
" t2, f(t2), 'k')\n",
"axes2[1,1].plot(t2, np.cos(4*np.pi*t2), 'r--');"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Exercise on object orientated subplots\n",
"\n",
"Make a 3 by 1 and 1 by 3 plots all within one cell. If you get done early do some customization of the color schemes. Use what you have learned and google to add y and x labels to the axises. "
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## 7. Legends\n",
"\n",
"* Legends can usually be handled by adding a `label = 'str'` keyword argument to a matplotib.pyplot method call and then calling `ax.legend()` afterwards. Basics:\n",
" * `ax.legend()` looks for labeled data plotted on a given axis and adds a legend to that axis. \n",
" * `ax.legend()` has a `loc=` keyword that handles placement that takes 0-9 for default placements or a tuple of x,y coords\n",
"* If this is insufficient, there are methods to directly make [custom legends](https://matplotlib.org/gallery/text_labels_and_annotations/custom_legends.html)\n",
"* This is often useful for multiple plots or when there are multiple data aesthetics to explain at once\n",
"\n",
"* Legends are also objects and we can move them outside the axes if we want. If legends or other plot options made this way are cut off when saving, you can save the legend as a variable and manually add them when you save figures using `fig.savefig('path_to_file', bbox_extra_artists=(lgd,), bbox_inches='tight')`\n"
]
},
{
"cell_type": "code",
"execution_count": 29,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"text/html": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Standard legend creation and placement example:\n",
"colors = sns.color_palette('Set1')\n",
"spec_list = list(set(iris_data['species'])) #List to break data down by \n",
"\n",
"fig,axs = plt.subplots(1,2)\n",
"axs= axs.ravel() # Ravel flattens an array into a 1D iterable\n",
"\n",
"for species in spec_list: # Sets contain each unique value one time\n",
" print(species)\n",
" species_subset = iris_data[iris_data['species'] == species]\n",
" axs[0].scatter(species_subset['sepal_length'], species_subset['sepal_width'], label=species, marker='s')\n",
" axs[1].scatter(species_subset['petal_length'], species_subset['petal_width'], label=species)\n",
" \n",
"axs[0].legend(frameon=True, loc=0) # 0 = best, MPL tries to find a place where it doesn't overlap data\n",
"axs[1].legend(frameon= False, loc=4); # 4 = lower right, can manually set to any corner or midpoint using 1-9. Removed legend box."
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### 7.2 More legend customization "
]
},
{
"cell_type": "code",
"execution_count": 31,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"
"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# A bit more customization:\n",
"from matplotlib.patches import Patch\n",
"from matplotlib.lines import Line2D\n",
"\n",
"fig,axs = plt.subplots(1,2)\n",
"axs= axs.ravel() # Ravel flattens an array into a 1D iterable\n",
"\n",
"for species in list(set(iris_data['species'])): # Sets contain each unique value one time\n",
" species_subset = iris_data[iris_data['species'] == species] #Use loop to subset the data you are using. \n",
" axs[0].scatter(species_subset['sepal_length'], species_subset['sepal_width'], label=species, marker='s')\n",
" axs[1].scatter(species_subset['petal_length'], species_subset['petal_width'], label=species)\n",
"\n",
" \n",
"\n",
"species_legend_elements = [Patch(facecolor=colors[0], label=spec_list[0]),\n",
" Patch(facecolor=colors[1], label=spec_list[1]),\n",
" Patch(facecolor=colors[2], label=spec_list[2]),\n",
" ]\n",
"\n",
"# First two arguments is to fill the x and y data\n",
"anatomy_legend_elements = [Line2D( [0], [0], marker='s', color='w', label='Sepal',\n",
" markerfacecolor='k', markersize=10),\n",
" Line2D([0], [0], marker='o', color='w', label='Petal',\n",
" markerfacecolor='k', markersize=10)]\n",
"\n",
"# Handles are a group of keywords for more control over what is displayed in the legend i.e. patches\n",
"species_legend = axs[0].legend(handles=species_legend_elements, loc=(2.25,.65), title='Species', frameon=True)\n",
"anatomy_legend = axs[1].legend(handles=anatomy_legend_elements, loc=(1.05,.35), title='Anatomy Type',frameon=True)\n",
"\n",
"\n",
"# Saving:\n",
"fig.savefig('./legend_cut_off.png') # Will cut off objects outside the axes.\n",
"# Add extra artists explicitly when saving:\n",
"fig.savefig('./legend_example.png', bbox_extra_artists=(species_legend,anatomy_legend), bbox_inches='tight')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Example of the legend being cut off:\n",
"\n",
"\n",
"What we actually want to go into our papers:\n",
""
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Exercise on Legends\n",
"\n",
"Move the top legends in the figure above into the frame of the left hand side plot. Make sure the legend isn't overlapping with the data and turn off the box around the text.\n",
"\n",
"\n",
"\n",
"\n",
"If you get done early, try to add the the top outside legend to both figures in different locations as shown in the example below. This may require some googling which is just as, if not more, important skill to learn. \n",
"\n",
"\n"
]
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "code",
"execution_count": null,
"metadata": {
"scrolled": true
},
"outputs": [],
"source": []
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"---\n",
"## 8. Working with Dates, Aggregating, & Other Nifty Pandas Tricks\n",
"Matplotlib can understand dates as a datatype and automatically adjust the axis labels to handle dates. \n",
"For this example, we will use the groupby feature of pandas to group observations by a daterange.\n",
"Key points:\n",
"* **groupby** groups dataframe observations by the values in a particular column and returns an iterable of tuples composed of the groupname and a dataframe for each group.\n",
"\n",
"\n",
"* **datetime** objects and indices can be parsed using date ranges and **resampled** by pandas into day, month, or year ranges.\n",
"* The datetime object represented by the string '2018-06-12 15:07:01' has the format '%Y-%m-%d %H-%M:%S' (This is what we talked about in the earlier section)\n",
"* You can convert from strings to datetimes and vice versa using `datetime.datetime.strptime(string, format)` and `datetime.datetime.strftime(datetime, format)`\n",
"\n",
"\n",
"* When plotting data with date as the x-axis, use `ax.xaxis_date()` to automatically label the axis correctly\n",
"* We can alter the text style of a date axis using the `ax.xaxis.set_major_formatter(dates.DateFormatter('%format'))` syntax.\n",
"\n",
"\n",
"### Monthly Earthquake Counts\n",
"We will make the below plot of monthly earthquake counts for the last 4 years of the data.\n",
"\n",
""
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Make a proper date column (instead of the current multiple columns for each part of the date) in the data frame so that we can plot by date. Setting the new date column as an index lets us group by month easily."
]
},
{
"cell_type": "code",
"execution_count": 34,
"metadata": {
"scrolled": false
},
"outputs": [],
"source": [
"df['datetime'] = pd.to_datetime(df[df.columns[range(6)]]) # First 6 columns are year, month, day, hour, min, sec\n",
"df = df.set_index(\"datetime\")"
]
},
{
"cell_type": "code",
"execution_count": 35,
"metadata": {
"scrolled": false
},
"outputs": [
{
"data": {
"text/html": [
"