C3_W1_Assignment__M.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "Ok1vxsLqqw3w"
   },
   "source": [
    "# Estimating Treatment Effect Using Machine Learning"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "B16h5bb8eFmw"
   },
   "source": [
    "Welcome to the first assignment of **AI for Medical Treatment**!\n",
    "\n",
    "You will be using different methods to evaluate the results of a [randomized control trial](https://en.wikipedia.org/wiki/Randomized_controlled_trial) (RCT).\n",
    "\n",
    "**You will learn:**\n",
    "- How to analyze data from a randomized control trial using both:\n",
    "  - traditional statistical methods\n",
    "  - and the more recent machine learning techniques\n",
    "- Interpreting Multivariate Models\n",
    "  - Quantifying treatment effect\n",
    "  - Calculating baseline risk\n",
    "  - Calculating predicted risk reduction\n",
    "- Evaluating Treatment Effect Models\n",
    "  - Comparing predicted and empirical risk reductions\n",
    "  - Computing C-statistic-for-benefit\n",
    "- Interpreting ML models for Treatment Effect Estimation\n",
    "  - Implement T-learner"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Table of Contents\n",
    "\n",
    "- [1. Dataset](#1)\n",
    "  - [1.1 Why RCT?](#1-1)\n",
    "  - [1.2 Data Processing](#1-2)\n",
    "      - [Exercise 1 - proportion_treated](#ex-1)\n",
    "      - [Exercise 2 - event_rate](#ex-2)\n",
    "  - [1.3 Train Test Split](#1-3)\n",
    "- [2. Modeling Treatment Effect](#2)\n",
    "  - [2.1 Constant Treatment Effect](#2-1)\n",
    "      - [Exercise 3 - extract_treatment_effect](#ex-3)\n",
    "  - [2.2 Absolute Risk Reduction](#2-2)\n",
    "      - [Exercise 4 - OR_to_ARR](#ex-4)\n",
    "  - [2.3 Model Limitations](#2-3)\n",
    "      - [Exercise 5 - base_risks](#ex-5)\n",
    "      - [Exercise 6 - lr_ARR_quantile](#ex-6)\n",
    "- [3. Evaluation Metric](#3)\n",
    "  - [3.1 C-statistic-for-benefit](#3-1)\n",
    "      - [Exercise 7 - c_for_benefit_score](#ex-7)\n",
    "      - [Exercise 8 - c_statistic](#ex-8)\n",
    "- [4. Machine Learning Approaches](#4)\n",
    "  - [4.1 T-Learner](#4-1)\n",
    "      - [Exercise 9 - TLearner()](#ex-9)\n",
    "      - [Exercise 10 - holdout_grid_search](#ex-10)\n",
    "      - [Exercise 11 - treatment_dataset_split](#ex-11)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "Tklnk8tneq2U"
   },
   "source": [
    "## Packages\n",
    "\n",
    "We'll first import all the packages that we need for this assignment. \n",
    "\n",
    "\n",
    "- `pandas` is what we'll use to manipulate our data\n",
    "- `numpy`  is a library for mathematical and scientific operations\n",
    "- `matplotlib` is a plotting library\n",
    "- `sklearn` contains a lot of efficient tools for machine learning and statistical modeling\n",
    "- `random` allows us to generate random numbers in python\n",
    "- `lifelines` is an open-source library that implements c-statistic\n",
    "- `itertools` will help us with hyperparameters searching\n",
    "\n",
    "## Import Packages\n",
    "\n",
    "Run the next cell to import all the necessary packages, dependencies and custom util functions."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:29:41.602385Z",
     "start_time": "2020-04-04T15:29:39.274097Z"
    },
    "colab": {},
    "colab_type": "code",
    "id": "Z5zOXfAIH-41"
   },
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "Using TensorFlow backend.\n"
     ]
    }
   ],
   "source": [
    "import pandas as pd\n",
    "import numpy as np\n",
    "import matplotlib.pyplot as plt\n",
    "import sklearn\n",
    "import random\n",
    "import lifelines\n",
    "import itertools\n",
    "from public_tests import *\n",
    "\n",
    "plt.rcParams['figure.figsize'] = [10, 7]"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "pVEHJZ79mvQx"
   },
   "source": [
    "<a name=\"1\"></a>\n",
    "## 1. Dataset\n",
    "<a name=\"1-1\"></a>\n",
    "### 1.1 Why RCT?\n",
    "\n",
    "In this assignment, we'll be examining data from an RCT, measuring the effect of a particular drug combination on colon cancer. Specifically, we'll be looking the effect of [Levamisole](https://en.wikipedia.org/wiki/Levamisole) and [Fluorouracil](https://en.wikipedia.org/wiki/Fluorouracil) on patients who have had surgery to remove their colon cancer. After surgery, the curability of the patient depends on the remaining residual cancer. In this study, it was found that this particular drug combination had a clear beneficial effect, when compared with [Chemotherapy](https://en.wikipedia.org/wiki/Chemotherapy). \n",
    "<a name=\"1-2\"></a>\n",
    "### 1.2 Data Processing\n",
    "In this first section, we will load in the dataset and calculate basic statistics. Run the next cell to load the dataset. We also do some preprocessing to convert categorical features to one-hot representations."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:29:41.612018Z",
     "start_time": "2020-04-04T15:29:41.602385Z"
    },
    "colab": {},
    "colab_type": "code",
    "id": "QOV_BJGyLtjR"
   },
   "outputs": [],
   "source": [
    "data = pd.read_csv(\"data/levamisole_data.csv\", index_col=0)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "RlqE8036sj3y"
   },
   "source": [
    "Let's look at our data to familiarize ourselves with the various fields. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:29:45.698204Z",
     "start_time": "2020-04-04T15:29:45.677460Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 221
    },
    "colab_type": "code",
    "id": "RPS1stb7si4N",
    "outputId": "a64b50c6-5df2-467a-abee-0d73f82d7825"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Data Dimensions: (607, 14)\n"
     ]
    },
    {
     "data": {
      "text/html": [
       "<div>\n",
       "<style scoped>\n",
       "    .dataframe tbody tr th:only-of-type {\n",
       "        vertical-align: middle;\n",
       "    }\n",
       "\n",
       "    .dataframe tbody tr th {\n",
       "        vertical-align: top;\n",
       "    }\n",
       "\n",
       "    .dataframe thead th {\n",
       "        text-align: right;\n",
       "    }\n",
       "</style>\n",
       "<table border=\"1\" class=\"dataframe\">\n",
       "  <thead>\n",
       "    <tr style=\"text-align: right;\">\n",
       "      <th></th>\n",
       "      <th>sex</th>\n",
       "      <th>age</th>\n",
       "      <th>obstruct</th>\n",
       "      <th>perfor</th>\n",
       "      <th>adhere</th>\n",
       "      <th>nodes</th>\n",
       "      <th>node4</th>\n",
       "      <th>outcome</th>\n",
       "      <th>TRTMT</th>\n",
       "      <th>differ_2.0</th>\n",
       "      <th>differ_3.0</th>\n",
       "      <th>extent_2</th>\n",
       "      <th>extent_3</th>\n",
       "      <th>extent_4</th>\n",
       "    </tr>\n",
       "  </thead>\n",
       "  <tbody>\n",
       "    <tr>\n",
       "      <th>1</th>\n",
       "      <td>1</td>\n",
       "      <td>43</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>5.0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>True</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>2</th>\n",
       "      <td>1</td>\n",
       "      <td>63</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1.0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>True</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>3</th>\n",
       "      <td>0</td>\n",
       "      <td>71</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>7.0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>False</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>4</th>\n",
       "      <td>0</td>\n",
       "      <td>66</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>6.0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>True</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "    <tr>\n",
       "      <th>5</th>\n",
       "      <td>1</td>\n",
       "      <td>69</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>22.0</td>\n",
       "      <td>1</td>\n",
       "      <td>1</td>\n",
       "      <td>False</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "      <td>0</td>\n",
       "      <td>1</td>\n",
       "      <td>0</td>\n",
       "    </tr>\n",
       "  </tbody>\n",
       "</table>\n",
       "</div>"
      ],
      "text/plain": [
       "   sex  age  obstruct  perfor  adhere  nodes  node4  outcome  TRTMT  \\\n",
       "1    1   43         0       0       0    5.0      1        1   True   \n",
       "2    1   63         0       0       0    1.0      0        0   True   \n",
       "3    0   71         0       0       1    7.0      1        1  False   \n",
       "4    0   66         1       0       0    6.0      1        1   True   \n",
       "5    1   69         0       0       0   22.0      1        1  False   \n",
       "\n",
       "   differ_2.0  differ_3.0  extent_2  extent_3  extent_4  \n",
       "1           1           0         0         1         0  \n",
       "2           1           0         0         1         0  \n",
       "3           1           0         1         0         0  \n",
       "4           1           0         0         1         0  \n",
       "5           1           0         0         1         0  "
      ]
     },
     "execution_count": 3,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "print(f\"Data Dimensions: {data.shape}\")\n",
    "data.head()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "ctvm6IEhauEd"
   },
   "source": [
    "Below is a description of all the fields (one-hot means a different field for each level):\n",
    "- `sex (binary): 1 if Male, 0 otherwise`\n",
    "- `age (int): age of patient at start of the study`\n",
    "- `obstruct (binary): obstruction of colon by tumor`\n",
    "- `perfor (binary): perforation of colon`\n",
    "- `adhere (binary): adherence to nearby organs`\n",
    "- `nodes (int): number of lymphnodes with detectable cancer`\n",
    "- `node4 (binary): more than 4 positive lymph nodes`\n",
    "- `outcome (binary): 1 if died within 5 years`\n",
    "- `TRTMT (binary): treated with levamisole + fluoroucil`\n",
    "- `differ (one-hot): differentiation of tumor`\n",
    "- `extent (one-hot): extent of local spread`"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "WTfGBXTOsq06"
   },
   "source": [
    "In particular pay attention to the `TRTMT` and `outcome` columns. Our primary endpoint for our analysis will be the 5-year survival rate, which is captured in the `outcome` variable."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "Mz2uT46QMQPc"
   },
   "source": [
    "<a name='ex-1'></a>\n",
    "### Exercise 1 - proportion_treated\n",
    "\n",
    "Since this is an RCT, the treatment column is randomized. Let's warm up by finding what the treatment probability is.\n",
    "\n",
    "$$p_{treatment} = \\frac{n_{treatment}}{n}$$\n",
    "\n",
    "- $n_{treatment}$ is the number of patients where `TRTMT = True`\n",
    "- $n$ is the total number of patients."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 8,
   "metadata": {},
   "outputs": [],
   "source": [
    "# UNQ_C1 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def proportion_treated(df):\n",
    "    \"\"\"\n",
    "    Compute proportion of trial participants who have been treated\n",
    "\n",
    "    Args:\n",
    "        df (dataframe): dataframe containing trial results. Column\n",
    "                      'TRTMT' is 1 if patient was treated, 0 otherwise.\n",
    "  \n",
    "    Returns:\n",
    "        result (float64): proportion of patients who were treated\n",
    "    \"\"\"\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "\n",
    "    proportion = df['TRTMT'].mean()\n",
    "    \n",
    "    ### END CODE HERE ###\n",
    "\n",
    "    return proportion"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 9,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Test Case 1:\n",
      "\n",
      "Example df:\n",
      "\n",
      "   outcome  TRTMT\n",
      "0        0      0\n",
      "1        1      1\n",
      "2        1      1\n",
      "3        1      1\n",
      "Proportion of patient treated: 0.75\n",
      "\n",
      "Test Case 2:\n",
      "\n",
      "Example df:\n",
      "\n",
      "   outcome  TRTMT\n",
      "0        0      0\n",
      "1        1      0\n",
      "2        0      0\n",
      "3        0      0\n",
      "Proportion of patient treated: 0.0\n",
      "\n",
      "Test Case 3:\n",
      "\n",
      "Example df:\n",
      "\n",
      "   outcome  TRTMT\n",
      "0        0      0\n",
      "1        1      1\n",
      "2        1      0\n",
      "3        1      0\n",
      "Proportion of patient treated: 0.25\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex1: you cannot edit this cell\n",
    "proportion_treated_test(proportion_treated)   "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "```\n",
    "Test Case 1:\n",
    "\n",
    "Example df: \n",
    "    outcome  TRTMT\n",
    "0        0      0\n",
    "1        1      1\n",
    "2        1      1\n",
    "3        1      1\n",
    "Proportion of patient treated: 0.75\n",
    "\n",
    "Test Case 2:\n",
    "\n",
    "Example df: \n",
    "    outcome  TRTMT\n",
    "0        0      0\n",
    "1        1      0\n",
    "2        0      0\n",
    "3        0      0\n",
    "Proportion of patient treated: 0.0\n",
    "\n",
    "Test Case 3:\n",
    "\n",
    "Example df: \n",
    "    outcome  TRTMT\n",
    "0        0      0\n",
    "1        1      1\n",
    "2        1      0\n",
    "3        1      0\n",
    "Proportion of patient treated: 0.25\n",
    "\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "BtHs90CWLinQ"
   },
   "source": [
    "Next let's run it on our trial data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 10,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:00.222152Z",
     "start_time": "2020-04-04T15:30:00.219183Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 34
    },
    "colab_type": "code",
    "id": "Oz9j9egVLh2k",
    "outputId": "3a2ce4a7-4747-4bce-efe1-f73bb8304910"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Proportion Treated: 0.49093904448105435 ~ 49%\n"
     ]
    }
   ],
   "source": [
    "p = proportion_treated(data)\n",
    "print(f\"Proportion Treated: {p} ~ {int(p*100)}%\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "DWvZ4Qvun8p1"
   },
   "source": [
    "<a name='ex-2'></a>\n",
    "### Exercise 2 - event_rate\n",
    "\n",
    "Next, we can get a preliminary sense of the results by computing the empirical 5-year death probability for the treated arm versus the control arm. \n",
    "\n",
    "The probability of dying for patients who received the treatment is:\n",
    "\n",
    "$$p_{\\text{treatment, death}} = \\frac{n_{\\text{treatment,death}}}{n_{\\text{treatment}}}$$\n",
    "\n",
    "- $n_{\\text{treatment,death}}$ is the number of patients who received the treatment and died.\n",
    "- $n_{\\text{treatment}}$ is the number of patients who received treatment.\n",
    "\n",
    "The probability of dying for patients in the control group (who did not received treatment) is:\n",
    "\n",
    "$$p_{\\text{control, death}} = \\frac{n_{\\text{control,death}}}{n_{\\text{control}}}$$\n",
    "- $n_{\\text{control,death}}$ is the number of patients in the control group (did not receive the treatment) who died.\n",
    "- $n_{\\text{control}}$ is the number of patients in the control group (did not receive treatment).\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 15,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:10.028882Z",
     "start_time": "2020-04-04T15:30:10.017885Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 221
    },
    "colab_type": "code",
    "id": "L7LhM4xNoVmW",
    "outputId": "e8516a6a-0a87-4e0f-8083-7f131656c2d2"
   },
   "outputs": [],
   "source": [
    "# UNQ_C2 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def event_rate(df):\n",
    "    '''\n",
    "    Compute empirical rate of death within 5 years\n",
    "    for treated and untreated groups.\n",
    "\n",
    "    Args:\n",
    "        df (dataframe): dataframe containing trial results. \n",
    "                          'TRTMT' column is 1 if patient was treated, 0 otherwise. \n",
    "                            'outcome' column is 1 if patient died within 5 years, 0 otherwise.\n",
    "  \n",
    "    Returns:\n",
    "        treated_prob (float64): empirical probability of death given treatment\n",
    "        untreated_prob (float64): empirical probability of death given control\n",
    "    '''\n",
    "    \n",
    "    treated_prob = 0.0\n",
    "    control_prob = 0.0\n",
    "        \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "    \n",
    "    treated_prob = df[df['TRTMT']==1]['outcome'].mean()\n",
    "    control_prob = df[df['TRTMT']==0]['outcome'].mean()\n",
    "    \n",
    "    ### END CODE HERE ###\n",
    "\n",
    "    return treated_prob, control_prob"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 16,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Test Case 1:\n",
      "\n",
      "Example df: \n",
      "    outcome  TRTMT\n",
      "0        0      1\n",
      "1        1      1\n",
      "2        1      1\n",
      "3        0      1\n",
      "4        1      0\n",
      "5        1      0\n",
      "6        1      0\n",
      "7        0      0\n",
      "\n",
      "Treated 5-year death rate: 0.5\n",
      "Control 5-year death rate: 0.75\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex2: you cannot edit this cell\n",
    "event_rate_test(event_rate)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "```\n",
    "Test Case 1:\n",
    "\n",
    "Example df: \n",
    "    outcome  TRTMT\n",
    "0        0      1\n",
    "1        1      1\n",
    "2        1      1\n",
    "3        0      1\n",
    "4        1      0\n",
    "5        1      0\n",
    "6        1      0\n",
    "7        0      0\n",
    "\n",
    "Treated 5-year death rate: 0.5\n",
    "Control 5-year death rate: 0.75\n",
    "\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "ShpX6ABSV_Pd"
   },
   "source": [
    "Now let's try the function on the real data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 17,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:17.279595Z",
     "start_time": "2020-04-04T15:30:17.273594Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 51
    },
    "colab_type": "code",
    "id": "7rw2yKymV-WD",
    "outputId": "9daebe7b-d0d1-4654-d3d1-764312b598d2"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Death rate for treated patients: 0.3725 ~ 37%\n",
      "Death rate for untreated patients: 0.4822 ~ 48%\n"
     ]
    }
   ],
   "source": [
    "treated_prob, control_prob = event_rate(data)\n",
    "\n",
    "print(f\"Death rate for treated patients: {treated_prob:.4f} ~ {int(treated_prob*100)}%\")\n",
    "print(f\"Death rate for untreated patients: {control_prob:.4f} ~ {int(control_prob*100)}%\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "yoTzaBUorB-3"
   },
   "source": [
    "On average, it seemed like treatment had a positive effect. \n",
    "\n",
    "#### Sanity checks\n",
    "It's important to compute these basic summary statistics as a sanity check for more complex models later on. If they strongly disagree with these robust summaries and there isn't a good reason, then there might be a bug. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "fywUHcbRnsQZ"
   },
   "source": [
    "<a name=\"1-3\"></a>\n",
    "### 1.3 Train Test Split\n",
    "\n",
    "We'll now try to quantify the impact more precisely using statistical models.  Before we get started fitting models to analyze the data, let's split it using the `train_test_split` function from `sklearn`. While a hold-out test set isn't required for logistic regression, it will be useful for comparing its performance to the ML models later on."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 18,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:22.034397Z",
     "start_time": "2020-04-04T15:30:21.942443Z"
    },
    "colab": {},
    "colab_type": "code",
    "id": "FUBvTfF0mQuH"
   },
   "outputs": [],
   "source": [
    "# As usual, split into dev and test set\n",
    "from sklearn.model_selection import train_test_split\n",
    "np.random.seed(18)\n",
    "random.seed(1)\n",
    "\n",
    "data = data.dropna(axis=0)\n",
    "y = data.outcome\n",
    "# notice we are dropping a column here. Now our total columns will be 1 less than before\n",
    "X = data.drop('outcome', axis=1) \n",
    "X_dev, X_test, y_dev, y_test = train_test_split(X, y, test_size = 0.25, random_state=0)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 19,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:23.071470Z",
     "start_time": "2020-04-04T15:30:23.068473Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 51
    },
    "colab_type": "code",
    "id": "6EeBLbfeFVnk",
    "outputId": "bd02e605-335a-4007-f1c0-46906dc0522c"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "dev set shape: (455, 13)\n",
      "test set shape: (152, 13)\n"
     ]
    }
   ],
   "source": [
    "print(f\"dev set shape: {X_dev.shape}\")\n",
    "print(f\"test set shape: {X_test.shape}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "2c8mLTMQEZxD"
   },
   "source": [
    "<a name=\"2\"></a>\n",
    "## 2. Modeling Treatment Effect"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "QxHy4RGA0Goi"
   },
   "source": [
    "<a name=\"2-1\"></a>\n",
    "### 2.1 Constant Treatment Effect\n",
    "\n",
    "First, we will model the treatment effect using a standard logistic regression. If $x^{(i)}$ is the input vector, then this models the probability of death within 5 years as \n",
    "$$\\sigma(\\theta^T x^{(i)}) = \\frac{1}{1 + exp(-\\theta^T x^{(i)})},$$\n",
    "\n",
    "where $ \\theta^T x^{(i)} = \\sum_{j} \\theta_j x^{(i)}_j$ is an inner product. \n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "For example, if we have three features, $TRTMT$, $AGE$, and  $SEX$, then our probability of death would be written as: \n",
    "\n",
    "$$\\sigma(\\theta^T x^{(i)}) = \\frac{1}{1 + exp(-\\theta_{TRTMT} x^{(i)}_{TRTMT} - \\theta_{AGE}x_{AGE}^{(i)} - \\theta_{SEX}x^{(i)}_{SEX})}.$$\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Another way to look at logistic regresion is as a linear model for the \"logit\" function, or \"log odds\": \n",
    "\n",
    "$$logit(p) = \\log \\left(\\frac{p}{1-p} \\right)= \\theta^T x^{(i)}$$\n",
    "\n",
    "- \"Odds\" is defined as the probability of an event divided by the probability of not having the event: $\\frac{p}{1-p}$.  \n",
    "\n",
    "- \"Log odds\", or \"logit\" function, is the natural log of the odds: $log \\left(\\frac{p}{1-p} \\right)$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In this example, $x^{(i)}_{TRTMT}$ is the treatment variable. Therefore, $\\theta_{TRTMT}$ tells you what the effect of treatment is. If $\\theta_{TRTMT}$ is negative, then having treatment reduces the log-odds of death, which means death is less likely than if you did not have treatment. \n",
    "\n",
    "Note that this assumes a constant relative treatment effect, since the impact of treatment does not depend on any other covariates. \n",
    "\n",
    "Typically, a randomized control trial (RCT) will seek to establish a negative $\\theta_{TRTMT}$ (because the treatment is intended to reduce risk of death), which corresponds to an odds ratio of less than 1.\n",
    "\n",
    "An odds ratio of less than one implies the probability of death is less than the probability of surviving.\n",
    "\n",
    "$$ \\frac{p}{1-p} < 1 \\rightarrow p < 1-p$$\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Run the next cell to fit your logistic regression model. \n",
    "\n",
    "You can use the entire dev set (and do not need to reserve a separate validation set) because there is no need for hyperparameter tuning using a validation set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 20,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:26.980302Z",
     "start_time": "2020-04-04T15:30:26.884988Z"
    },
    "colab": {},
    "colab_type": "code",
    "id": "U-2hcHYycgFJ"
   },
   "outputs": [],
   "source": [
    "from sklearn.linear_model import LogisticRegression\n",
    "\n",
    "lr = LogisticRegression(penalty='l2',solver='lbfgs', max_iter=10000).fit(X_dev, y_dev)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Calculating the Odds Ratio\n",
    "\n",
    "You are interested in finding the odds for treatment relative to the odds for the baseline.\n",
    "\n",
    "$$ OddsRatio = \\frac{Odds_{treatment}}{Odds_{baseline}}$$\n",
    "\n",
    "where\n",
    "$$Odds_{treatment} = \\frac{p_{treatment}}{1-p_{treatment}}$$\n",
    "\n",
    "and \n",
    "\n",
    "$$Odds_{baseline} = \\frac{p_{baseline}}{1-p_{baseline}}$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "If you look at the expression\n",
    "\n",
    "$$\\log \\left(\\frac{p}{1-p} \\right)= \\theta^T x^{(i)} = \\theta_{treatment} \\times x_{treatment}^{(i)} + \\theta_{age} \\times x_{age}^{(i)} + \\cdots$$\n",
    "\n",
    "Let's just let \"$\\theta \\times x_{age}^{(i)} + \\cdots$\" stand for all the other thetas and feature variables except for the treatment $\\theta_{treatment}^{(i)}$, and $x_{treatment}^{(i)}$ ."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Treatment\n",
    "To denote that the patient received treatment, we set $x_{treatment}^{(i)} = 1$.  Which means the log odds for a treated patient are:\n",
    "\n",
    "$$ log( Odds_{treatment}) = \\log \\left(\\frac{p_{treatment}}{1-p_{treatment}} \\right) = \\theta_{treatment} \\times 1 + \\theta_{age} \\times x_{age}^{(i)} + \\cdots$$\n",
    "\n",
    "To get odds from log odds, use exponentiation (raise to the power of e) to take the inverse of the natural log.\n",
    "\n",
    "$$Odds_{treatment} = e^{log( Odds_{treatment})} = \\left(\\frac{p_{treatment}}{1-p_{treatment}} \\right) = e^{\\theta_{treatment} \\times 1 + \\theta_{age} \\times x_{age}^{(i)} + \\cdots}$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Control (baseline)\n",
    "\n",
    "Similarly, when the patient has no treatment, this is denoted by $x_{treatment}^{(i)} = 0$.  So the log odds for the untreated patient is:\n",
    "\n",
    "$$log(Odds_{baseline}) = \\log \\left(\\frac{p_{baseline}}{1-p_{baseline}} \\right) = \\theta_{treatment} \\times 0 + \\theta_{age} \\times x_{age}^{(i)} + \\cdots$$\n",
    "\n",
    "$$ = 0 + \\theta_{age} \\times x_{age}^{(i)} + \\cdots$$\n",
    "\n",
    "To get odds from log odds, use exponentiation (raise to the power of e) to take the inverse of the natural log.\n",
    "\n",
    "$$Odds_{baseline} = e^{log(Odds_{baseline})} = \\left(\\frac{p_{baseline}}{1-p_{baseline}} \\right) = e^{0 + \\theta_{age} \\times x_{age}^{(i)} + \\cdots}$$\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Odds Ratio\n",
    "\n",
    "The Odds ratio is:\n",
    "\n",
    "$$ OddsRatio = \\frac{Odds_{treatment}}{Odds_{baseline}}$$\n",
    "\n",
    "Doing some substitution:\n",
    "\n",
    "$$ OddsRatio = \\frac{e^{\\theta_{treatment} \\times 1 + \\theta_{age} \\times x_{age}^{(i)} + \\cdots}}{e^{0 + \\theta_{age} \\times x_{age}^{(i)} + \\cdots}}$$\n",
    "\n",
    "Notice that $e^{\\theta_{age} \\times x_{age}^{(i)} + \\cdots}$ cancels on top and bottom, so that:\n",
    "\n",
    "$$ OddsRatio = \\frac{e^{\\theta_{treatment} \\times 1}}{e^{0}}$$\n",
    "\n",
    "Since $e^{0} = 1$, This simplifies to:\n",
    "\n",
    "$$ OddsRatio = e^{\\theta_{treatment}}$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "JVUl6hTRzA-w"
   },
   "source": [
    "<a name='ex-3'></a>\n",
    "### Exercise 3 - extract_treatment_effect\n",
    "\n",
    "Complete the `extract_treatment_effect` function to extract $\\theta_{treatment}$ and then calculate the odds ratio of treatment from the logistic regression model."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 21,
   "metadata": {},
   "outputs": [],
   "source": [
    "# UNQ_C3 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def extract_treatment_effect(lr, data):\n",
    "    '''\n",
    "    Args:\n",
    "        lr_model (model): logistic regression model\n",
    "        data (pandas DataFrame): records of records of individuals/patients\n",
    "  \n",
    "    Returns:\n",
    "        theta_TRTMT (float): the effect of treatment\n",
    "        TRTMT_OR (float): odds for treatment relative to the odds for the baseline\n",
    "    '''\n",
    "    \n",
    "    theta_TRTMT = 0.0\n",
    "    TRTMT_OR = 0.0\n",
    "    coeffs = {data.columns[i]:lr.coef_[0][i] for i in range(len(data.columns))}\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "    \n",
    "    # get the treatment coefficient\n",
    "    theta_TRTMT = coeffs.get('TRTMT')\n",
    "    \n",
    "    # calculate the Odds ratio for treatment\n",
    "    TRTMT_OR = np.exp(theta_TRTMT)\n",
    "    \n",
    "    ### END CODE HERE ###\n",
    "    \n",
    "    return theta_TRTMT, TRTMT_OR"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Theta_TRTMT: -0.2885162279475891\n",
      "Treatment Odds Ratio: 0.7493746442363785\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex3: you cannot edit this cell\n",
    "extract_treatment_effect_test(extract_treatment_effect, lr, X_dev)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "\n",
    "```\n",
    "Theta_TRTMT: -0.2885162279475891\n",
    "Treatment Odds Ratio: 0.7493746442363785\n",
    "\n",
    "All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "clf289SQtTzV"
   },
   "source": [
    "Based on this model, it seems that the treatment has a beneficial effect.  \n",
    "- The $\\theta_{treatment} = -0.29$ is a negative value, meaning that it has the effect of reducing risk of death.\n",
    "- In the code above, the $OddsRatio$ is stored in the variable `TRTMT_OR`.\n",
    "- The $OddsRatio = 0.75$, which is less than 1.  \n",
    "\n",
    "\n",
    "You can think of the $OddsRatio$ as a factor that is multiplied to the baseline odds $Odds_{baseline}$ in order to estimate the $Odds_{treatment}$.  You can think about the Odds Ratio as a rate, converting between baseline odds and treatment odds.\n",
    "\n",
    "$$Odds_{treatment} = OddsRatio \\times Odds_{baseline}$$\n",
    "\n",
    "In this case:\n",
    "\n",
    "$$Odds_{treatment} = 0.65 \\times Odds_{baseline}$$\n",
    "\n",
    "So you can interpret this to mean that the treatment reduces the odds of death by $(1 - OddsRatio) = 1 - 0.65 = 0.35$, or about 35%.\n",
    "\n",
    "You will see how well this model fits the data in the next few sections."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "kgv-HoPGsBP-"
   },
   "source": [
    "<a name=\"2-2\"></a>\n",
    "### 2.2 Absolute Risk Reduction"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "hVhcO3t2yj-4"
   },
   "source": [
    "<a name='ex-4'></a>\n",
    "### Exercise 4 - OR_to_ARR\n",
    "\n",
    "A valuable quantity is the absolute risk reduction (ARR) of a treatment. If $p$ is the baseline probability of death, and $p_{treatment}$ is the probability of death if treated, then \n",
    "$$ARR = p_{baseline} - p_{treatment} $$\n",
    "\n",
    "In the case of logistic regression, here is how ARR can be computed:  \n",
    "Recall that the Odds Ratio is defined as:\n",
    "\n",
    "$$OR = Odds_{treatment} / Odds_{baseline}$$\n",
    "\n",
    "where the \"odds\" is the probability of the event over the probability of not having the event, or $p/(1-p)$. \n",
    "\n",
    "$$Odds_{trtmt} = \\frac{p_{treatment}}{1- p_{treatment}}$$\n",
    "and\n",
    "$$Odds_{baseline} = \\frac{p_{baseline}}{1- p_{baseline}}$$\n",
    "\n",
    "In the function below, compute the predicted absolute risk reduction (ARR) given\n",
    "- the odds ratio for treatment \"$OR$\", and\n",
    "- the baseline risk of an individual $p_{baseline}$\n",
    "\n",
    "If you get stuck, try reviewing the level 1 hints by clicking on the cell \"Hints Level 1\".  If you would like more help, please try viewing \"Hints Level 2\"."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Hints Level 1</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li> Using the given $p$, compute the baseline odds of death.</li>\n",
    "    <li> Then, use the Odds Ratio to convert that to odds of death given treatment.</li>\n",
    "    <li> Finally, convert those odds back into a probability</li>\n",
    "</ul>\n",
    "</p>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Hints Level 2</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li> Solve for p_treatment starting with this expression: Odds_treatment = p_treatment / (1 - p_treatment).  You may want to do this on a piece of paper.</li>\n",
    "</ul>\n",
    "</p>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 23,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:41.842398Z",
     "start_time": "2020-04-04T15:30:41.826771Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 119
    },
    "colab_type": "code",
    "id": "mi-J2oxca3Nk",
    "outputId": "e9dbb7b2-bfaa-40d2-84b6-617952b7d541"
   },
   "outputs": [],
   "source": [
    "# UNQ_C4 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def OR_to_ARR(p, OR):\n",
    "    \"\"\"\n",
    "    Compute ARR for treatment for individuals given\n",
    "    baseline risk and odds ratio of treatment.\n",
    "\n",
    "    Args:\n",
    "        p (float): baseline probability of risk (without treatment)\n",
    "        OR (float): odds ratio of treatment versus baseline\n",
    "\n",
    "    Returns:\n",
    "        ARR (float): absolute risk reduction for treatment \n",
    "      \"\"\"\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "\n",
    "    # compute baseline odds from p\n",
    "    odds_baseline = p/(1-p)\n",
    "\n",
    "    # compute odds of treatment using odds ratio\n",
    "    odds_trtmt = OR * odds_baseline\n",
    "\n",
    "    # compute new probability of death from treatment odds\n",
    "    p_trtmt = odds_trtmt / (1 + odds_trtmt)\n",
    "\n",
    "    # compute ARR using treated probability and baseline probability \n",
    "    ARR = p - p_trtmt\n",
    "    \n",
    "    ### END CODE HERE ###\n",
    "    \n",
    "    return ARR"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 24,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Test Case 1:\n",
      "\n",
      "baseline p: 0.75, OR: 0.5\n",
      "Output: 0.15000000000000002\n",
      "\n",
      "\n",
      "Test Case 2:\n",
      "\n",
      "baseline p: 0.04, OR: 1.2\n",
      "Output: -0.007619047619047616\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex4: you cannot edit this cell\n",
    "OR_to_ARR_test(OR_to_ARR)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "\n",
    "```\n",
    "Test Case 1:\n",
    "\n",
    "baseline p: 0.75, OR: 0.5\n",
    "Output: 0.15000000000000002\n",
    "\n",
    "\n",
    "Test Case 2:\n",
    "\n",
    "baseline p: 0.04, OR: 1.2\n",
    "Output: -0.007619047619047616\n",
    "\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "LLxmh1h92FFe"
   },
   "source": [
    "#### Visualize the treatment effect as baseline risk varies\n",
    "\n",
    "The logistic regression model assumes that treatment has a constant effect in terms of odds ratio and is independent of other covariates. \n",
    "\n",
    "However, this does not mean that absolute risk reduction is necessarily constant for any baseline risk $\\hat{p}$. To illustrate this, we can plot absolute risk reduction as a function of baseline predicted risk $\\hat{p}$. \n",
    "\n",
    "Run the next cell to see the relationship between ARR and baseline risk for the logistic regression model."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 25,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:30:45.443881Z",
     "start_time": "2020-04-04T15:30:45.270615Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 458
    },
    "colab_type": "code",
    "id": "eQdG21ogqTWy",
    "outputId": "16531142-20c9-459e-8dde-f239c1e31203"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "ps = np.arange(0.001, 0.999, 0.001)\n",
    "theta_TRTMT, trtmt_OR = extract_treatment_effect(lr, X_dev)\n",
    "diffs = [OR_to_ARR(p, trtmt_OR) for p in ps]\n",
    "plt.plot(ps, diffs)\n",
    "plt.title(\"Absolute Risk Reduction for Constant Treatment OR\")\n",
    "plt.xlabel('Baseline Risk')\n",
    "plt.ylabel('Absolute Risk Reduction')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "OI4QLB5l2OyZ"
   },
   "source": [
    "Note that when viewed on an absolute scale, the treatment effect is not constant, despite the fact that you used a model with no interactions between the features (we didn't multiply two features together). \n",
    "\n",
    "As shown in the plot, when the baseline risk is either very low (close to zero) or very high (close to one), the Absolute Risk Reduction from treatment is fairly low.  When the baseline risk is closer to 0.5 the ARR of treatment is higher (closer to 0.10).\n",
    "\n",
    "It is always important to remember that baseline risk has a natural effect on absolute risk reduction."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "9bGTgLRkQZPR"
   },
   "source": [
    "<a name=\"2-3\"></a>\n",
    "### 2.3 Model Limitations\n",
    "\n",
    "We can now plot how closely the empirical (actual) risk reduction matches the risk reduction that is predicted by the logistic regression model. \n",
    "\n",
    "This is complicated by the fact that for each patient, we only observe one outcome (treatment or no treatment). \n",
    "- We can't give a patient treatment, then go back in time and measure an alternative scenario where the same patient did not receive the treatment.\n",
    "- Therefore, we will group patients into groups based on their baseline risk as predicted by the model, and then plot their empirical ARR within groups that have similar baseline risks.\n",
    "- The empirical ARR is the death rate of the untreated patients in that group minus the death rate of the treated patients in that group.\n",
    "\n",
    "$$ARR_{empirical} = p_{baseline} - p_{treatment}$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "y7sx9hZ85jNQ"
   },
   "source": [
    "<a name='ex-5'></a>\n",
    "### Exercise 5 - base_risks\n",
    "In the next cell, write a function to compute the baseline risk of each patient using the logistic regression model.\n",
    "\n",
    "The baseline risk is the model's predicted probability that the patient is predicted to die if they do not receive treatment.\n",
    "\n",
    "You will later use the baseline risk of each patient to organize patients into risk groups (that have similar baseline risks).  This will allow you to calculate the ARR within each risk group.\n",
    "\n",
    "$$p_{baseline} = logisticRegression(Treatment = False, Age = age_{i}, Obstruct = obstruct_{i}, \\cdots)$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Hints</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li> A patient receives treatment if their feature x_treatment is True, and does not receive treatment when their x_treatment is False.</li>\n",
    "    <li>For a patient who actually did receive treatment, you can ask the model to predict their risk without receiving treatment by setting the patient's x_treatment to False.</li>\n",
    "    <li>The logistic regression predict_proba() function returns a 2D array, one row for each patient, and one column for each possible outcome (each class).  In this case, the two outcomes are either no death (0), or death (1).  To find out which column contains the probability for death, check the order of the classes by using lr.classes_ </li>\n",
    "</ul>\n",
    "</p>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 26,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:01.326365Z",
     "start_time": "2020-04-04T15:31:01.305393Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 238
    },
    "colab_type": "code",
    "id": "U1KKz-NjQdL7",
    "outputId": "48cfa253-6752-45cf-e80a-e2d9d188746b"
   },
   "outputs": [],
   "source": [
    "# UNQ_C5 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def base_risks(X, lr_model):\n",
    "    \"\"\"\n",
    "    Compute baseline risks for each individual in X.\n",
    "\n",
    "    Args:\n",
    "        X (dataframe): data from trial. 'TRTMT' column\n",
    "                       is 1 if subject retrieved treatment, 0 otherwise\n",
    "        lr_model (model): logistic regression model\n",
    "    \n",
    "    Returns:\n",
    "        risks (np.array): array of predicted baseline risk\n",
    "                          for each subject in X\n",
    "    \"\"\"\n",
    "    \n",
    "    # first make a copy of the dataframe so as not to overwrite the original\n",
    "    X = X.copy(deep=True)\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "\n",
    "    # Set the treatment variable to assume that the patient did not receive treatment\n",
    "    X['TRTMT'] = 0\n",
    "    \n",
    "    # Input the features into the model, and predict the probability of death.\n",
    "    risks = lr_model.predict_proba(X)[:,1]\n",
    "    \n",
    "    # END CODE HERE\n",
    "\n",
    "    return risks"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 27,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Test Case 1:\n",
      "\n",
      "  sex age obstruct perfor adhere nodes node4 TRTMT differ_2.0 differ_3.0  \\\n",
      "0   1  60        0      0      0     3     0  True          1          0   \n",
      "1   1  60        0      0      0     3     0     0          1          0   \n",
      "\n",
      "  extent_2 extent_3 extent_4  \n",
      "0        0        1        0  \n",
      "1        0        1        0  \n",
      "  TRTMT\n",
      "0  True\n",
      "1     0\n",
      "\n",
      "\n",
      "Base risks for both rows should be the same.\n",
      "Baseline Risks: [0.43115868 0.43115868]\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex5: you cannot edit this cell\n",
    "base_risks_test(base_risks, X_dev, lr)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "\n",
    "```\n",
    "Test Case 1:\n",
    "\n",
    "  sex age obstruct perfor adhere nodes node4 TRTMT differ_2.0 differ_3.0  \\\n",
    "0   1  60        0      0      0     3     0  True          1          0   \n",
    "1   1  60        0      0      0     3     0     0          1          0   \n",
    "\n",
    "  extent_2 extent_3 extent_4  \n",
    "0        0        1        0  \n",
    "1        0        1        0  \n",
    "  TRTMT\n",
    "0  True\n",
    "1     0\n",
    "\n",
    "\n",
    "Base risks for both rows should be the same.\n",
    "Baseline Risks: [0.43115868 0.43115868]\n",
    "\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "JQsYKmVc6prz"
   },
   "source": [
    "<a name='ex-6'></a>\n",
    "### Exercise 6 - lr_ARR_quantile\n",
    "\n",
    "Since the effect of treatment varies depending on the baseline risk, it makes more sense to group patients who have similar baseline risks, and then look at the outcomes of those who receive treatment versus those who do not, to estimate the absolute risk reduction (ARR).\n",
    "\n",
    "You'll now implement the `lr_ARR_quantile` function to plot empirical average ARR for each quantile of base risk."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Hints</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li>Use pandas.cut to define intervals of bins of equal size.  For example, pd.cut(arr,5) uses the values in the list or array 'arr' and returns the intervals of 5 bins.</li>\n",
    "    <li>Use pandas.DataFrame.groupby to group by a selected column of the dataframe.  Then select the desired variable and apply an aggregator function.  For example, df.groupby('col1')['col2'].sum() groups by column 1, and then calculates the sum of column 2 for each group. </li>\n",
    "</ul>\n",
    "</p>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 28,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:24.712637Z",
     "start_time": "2020-04-04T15:31:24.677008Z"
    },
    "colab": {},
    "colab_type": "code",
    "id": "p4rI_ag9Huy2"
   },
   "outputs": [],
   "source": [
    "# UNQ_C6 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def lr_ARR_quantile(X, y, lr):\n",
    "    \"\"\"\n",
    "    Args:\n",
    "        X (dataframe): data from trial. 'TRTMT' column\n",
    "                       is 1 if subject retrieved treatment, 0 otherwise\n",
    "        y (array): array of true outcomes\n",
    "        lr_model (model): logistic regression model\n",
    "    \n",
    "    Returns:\n",
    "        arr_by_risk_group (pandas Series): empirical average ARR for each \n",
    "                                           quantile of base risk\n",
    "    \"\"\"\n",
    "    \n",
    "    # first make a deep copy of the features dataframe to calculate the base risks\n",
    "    X = X.copy(deep=True)\n",
    "    \n",
    "    # Make another deep copy of the features dataframe to store baseline risk, risk_group, and y\n",
    "    df = X.copy(deep=True)\n",
    "\n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "    # Calculate the baseline risks (use the function that you just implemented)\n",
    "    baseline_risk = base_risks(X, lr)\n",
    "    \n",
    "    # bin patients into 10 risk groups based on their baseline risks\n",
    "    risk_groups = pd.cut(baseline_risk, 10)\n",
    "        \n",
    "    # Store the baseline risk, risk_groups, and y into the new dataframe\n",
    "    df.loc[:, 'baseline_risk'] = baseline_risk\n",
    "    df.loc[:, 'risk_group'] = risk_groups\n",
    "    df.loc[:, 'y'] = y\n",
    "\n",
    "    # select the subset of patients who did not actually receive treatment\n",
    "    df_baseline = df[df['TRTMT'] == 0]\n",
    "    \n",
    "    # select the subset of patients who did actually receive treatment\n",
    "    df_treatment = df[df['TRTMT'] == 1]\n",
    "    \n",
    "    # For baseline patients, group them by risk group, select their outcome 'y', and take the mean\n",
    "    baseline_mean_by_risk_group = df_baseline.groupby('risk_group')['y'].mean()\n",
    "    \n",
    "    # For treatment patients, group them by risk group, select their outcome 'y', and take the mean\n",
    "    treatment_mean_by_risk_group = df_treatment.groupby('risk_group')['y'].mean()\n",
    "    \n",
    "    # Calculate the absolute risk reduction by risk group (baseline minus treatment)\n",
    "    arr_by_risk_group = baseline_mean_by_risk_group - treatment_mean_by_risk_group\n",
    "    \n",
    "    # Set the index of the arr_by_risk_group dataframe to the average baseline risk of each risk group \n",
    "    # Use data for all patients to calculate the average baseline risk, grouped by risk group.\n",
    "    arr_by_risk_group.index = df.groupby('risk_group')['baseline_risk'].mean()\n",
    "\n",
    "    ### END CODE HERE ###\n",
    "    \n",
    "    # Set the name of the Series to 'ARR'\n",
    "    arr_by_risk_group.name = 'ARR'\n",
    "    \n",
    "\n",
    "    return arr_by_risk_group\n",
    "\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 29,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "baseline_risk\n",
      "0.231595    0.089744\n",
      "0.314713    0.042857\n",
      "0.386342   -0.014604\n",
      "0.458883    0.122222\n",
      "0.530568    0.142857\n",
      "0.626937   -0.104072\n",
      "0.693404    0.150000\n",
      "0.777353    0.293706\n",
      "0.836617    0.083333\n",
      "0.918884    0.200000\n",
      "Name: ARR, dtype: float64 \n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex6: you cannot edit this cell\n",
    "lr_ARR_quantile_test(lr_ARR_quantile, X_dev, y_dev, lr)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "\n",
    "```Python\n",
    "baseline_risk\n",
    "0.231595    0.089744\n",
    "0.314713    0.042857\n",
    "0.386342   -0.014604\n",
    "0.458883    0.122222\n",
    "0.530568    0.142857\n",
    "0.626937   -0.104072\n",
    "0.693404    0.150000\n",
    "0.777353    0.293706\n",
    "0.836617    0.083333\n",
    "0.918884    0.200000\n",
    "Name: ARR, dtype: float64 \n",
    "```\n",
    "```\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Plot the ARR grouped by baseline risk"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 30,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:27.365631Z",
     "start_time": "2020-04-04T15:31:27.190715Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 458
    },
    "colab_type": "code",
    "id": "xtmp3BxtNR39",
    "outputId": "266dcffc-0c16-4456-c789-106465666b41"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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eR+33norv/jFL+qdP3bsWC6//PIa066++moGDx7M2LFjGTNmDK+99lr1vEmTJjFs2DDGjBnDCSecwNKlS5sc06GIW4Ixs3KCntbmEXRO9ZSZrZR0W3jHGMD1klZKWkpQDzM9XHclQYdaqwi6A/0vv4PMucNLcmLdp6/6pjemoqLpp5Bp06Zx440HPWFR7VATTENWr15NRUUFb775Jvv27asxb9asWSxdupTf/OY3XHfddTXmPfrooyxbtoxvfetbzJgxg9YQ1zoYM3vJzIaa2dFmdkc47SdmNjcc/q6ZHWtmY83sjDCxVK17R7jesIhe7Jxzh4k+makk1KozSJDok1mzw8aNGzcyfPhwrrzySkaMGMGll17K/v37gaD5qB/+8IeMHz+ep59+mldeeYWTTz6Z8ePH88UvfpGioqBTzb///e8MHz6c8ePH89xzz1Vve/bs2Vx//fUAbNu2jYsuuogxY8YwZswY3nnnHW688UY++ugjxo4dW31SnzVrFieccAKjR4/mlltuqd7WHXfcwdChQznllFNYu3Ztve/78ccf58tf/jKTJ0/mhRdeqHOZk08+mby8umsNGprX0g6rtsicc/H10xdXsmrz3sYXjFJ5pTGgexrXnDK4wbvI1q5dy0MPPcTEiRO55ppreOCBB/jBD34AQM+ePXn//ffZuXMnF198Ma+++irp6encdddd/OpXv+KGG27g61//Oq+//jrHHHMMl112WZ2xfOc73+H000/n+eefp6KigqKiImbOnMmKFSuqi6ReeeUV1q1bx7vvvouZMW3aNP75z3+Snp7OE088wdKlSykvL2f8+PEcf/zxde7nySefZP78+axZs4Z7772XL33pSwct8/e//50LL7ywjrUbntfSPME459qtTgmie3oyo/t3a3C5AQMGMHHiRACuuuoq7rnnnuoEU5UwFi5cyKpVq6qXKy0t5eSTT2bNmjUMHjyYIUOGVK//4IMPHrSP119/nT/96U8AJCYmkpmZye7du2ss88orr/DKK68wbtw4AIqKili3bh2FhYVcdNFFdO7cGQiK3uqyaNEievXqxcCBA8nOzuaaa64hPz+fHj16ADBjxgx+9KMfkZuby7/+VfOxwCuvvJLS0lKKioparQ7GE4xzrtXc8oVj47Lf2rffRo6np6cDwYOG55xzDo8//niNZVvyZGxm3HTTTXzjG9+oMf03v/lNVOs//vjjrFmzhqpuR/bu3cuzzz7L17/+dSAofrv00ku59957ueaaa1i8eHH1uo8++ijHH388M2bM4Nvf/naNor5YafPPwTjnXHN9+umn1b/oH3vsMU455ZSDljnppJN4++23Wb9+PQD79u3jww8/ZPjw4WzcuJGPPvoI4KAEVOWss87it7/9LRDcMLBnzx4yMjIoLCysXmbKlCk8/PDD1XU7eXl5bN++ndNOO405c+ZQXFxMYWEhL7744kHbr6ys5KmnnmL58uVs3LiRjRs38sILL9QZz/XXX09lZSXz5s2rMV0St99+OwsXLmTNmjWNHrfm8gTjnOvwhg0bxv3338+IESPYvXs33/zmNw9aJisri9mzZ3PFFVcwevTo6uKx1NRUHnzwQT7/+c8zfvx4evfuXec+7r77bhYsWMCoUaM4/vjjWbVqFT179mTixIkcd9xxzJgxg8mTJ/OlL32Jk08+mVGjRnHppZdSWFjI+PHjueyyyxgzZgznnnsuJ5xwwkHbf/PNN8nOzqZfv37V00477TRWrVrFli1baiwriZtvvpmf//znB20nLS2N73//+8yaNauph7HJZLUeVOrIcnJyzDscc651rV69mhEjRsRt/xs3buT8889nxYoVcYuhPanr85K02Mxymrotv4JxzjkXE55gnHMd2qBBg/zqJU48wTjnnIsJTzDOOediwhOMc865mPAE45xzLiY8wTjn3CH63Oc+d0jzGtJRmuoHTzDOOXfI3nnnnYOmlZeX1zuvudpTU/3gCcY518bMWZLHxJmvM/jGvzFx5uvMWdL8puX/8pe/MGHCBMaOHcs3vvGN6r5funTpwowZMzj22GM5++yzeffdd5k0aRJHHXUUc+cG/R/Onj2bCy64gEmTJjFkyBB++tOfVm+3S5cuQNAJ2amnnsq0adMYOXJkjXkAd911F6NGjWLMmDHV/cf8/ve/54QTTmDMmDFccskl1V0INKQ9NdUPnmCcc23InCV53PTccvIKijEgr6CYm55b3qwks3r1ap588knefvttli5dSmJiIo8++igQtDd25plnsnLlSjIyMrj55puZP38+zz//PD/5yU+qt/Huu+/y7LPP8sEHH/D0009TV4sg77//PnfffTcffvhhjekvv/wyL7zwAv/+979ZtmwZN9xwAwAXX3wx7733HsuWLWPEiBE89NBDjb6XJ598kssvv5wrrrii3jbR2kpT/RDn1pQlTQXuBhKBP5jZzFrzvwd8DSgHdgDXmNkn4bwKYHm46KdmVnf71s65dmPWvLUUl9XsWbK4rIJZ89Zy4bjsQ9rma6+9xuLFi6vb9youLq5uTyw5OZmpU6cCMGrUKFJSUkhKSmLUqFFs3LixehvnnHMOPXv2BILE8NZbb5GTU7PllAkTJjB48OCD9v/qq6/yla98pbop/qqm9VesWMHNN99MQUEBRUVFTJkypcH30d6a6oc4XsFISgTuB84FRgJXSBpZa7ElQI6ZjQaeASJbbisOe7oc68nFuY5hc0Fxk6ZHw8yYPn06S5cuZenSpaxdu5Zbb70VgKSkpOqm+xMSEkhJSakerqpLgYab+69S1ex/tK6++mruu+8+li9fzi233EJJSUmDy0c21X/00UdXN9VfZdasWXz44YfcddddXHPNNTXWffTRR9mwYQPTp0/n29/+dpPibI54FpFNANab2QYzKwWeAC6IXMDMFphZVcHkQqB/K8fonGtF/bqlNWl6NM466yyeeeYZtm/fDkB+fj6ffPJJk7Yxf/588vPzKS4uZs6cOdWdkkXjnHPO4Y9//GN1HUt+fj4AhYWF9O3bl7Kysuoiu/q0x6b6Ib4JJhvYFDGeG06rz1eBlyPGUyUtkrRQUr2FipKuDZdbtGPHjuZF7JyLqRlThpGWlFhjWlpSIjOmDDvkbY4cOZKf/exnTJ48mdGjR3POOecc1Lx9YyZMmMAll1zC6NGjueSSSw4qHmvI1KlTmTZtGjk5OYwdO7b6FuTbb7+dE088kYkTJzJ8+PAGt9Eem+qHODbXL+lSYKqZfS0c/zJwopldX8eyVwHXA6eb2YFwWraZ5Uk6CngdOMvMPmpon95cv3Otr6nN9c9ZkseseWvZXFBMv25pzJgy7JDrX1rC7NmzWbRoEffdd1/cYmhNLdlcfzwr+fOAARHj/cNpNUg6G/gxEckFwMzywr8bJL0BjAMaTDDOubbvwnHZcU0oruXEs4jsPWCIpMGSkoHLgbmRC0gaB/wOmGZm2yOmd5eUEg73AiYCq1otcufcYaOqMt41XdyuYMysXNL1wDyC25QfNrOVkm4DFpnZXGAW0AV4Orxro+p25BHA7yRVEiTJmWbmCca5NsrM6rzzyrUtLV1lEtfnYMzsJeClWtN+EjF8dj3rvQOMim10zrmWkJqayq5du+jZs6cnmTbMzNi1axepqaktts24JhjnXMfXv39/cnNz8bs4277U1FT692+5p0E8wTjnYiopKanOJ9xdx+dtkTnnnIsJTzDOOediwhOMc865mPAE45xzLiY8wTjnnIsJTzDOOediwhOMc865mPAE45xzLiY8wTjnnIsJTzDOOediwhOMc865mGi0LTJJWcDXgUGRy5vZNbELyznnXHsXTWOXLwBvAq8CFbENxznnXEcRTYLpbGY/jHkkzjnnOpRo6mD+Kum8WOxc0lRJayWtl3RjHfO/J2mVpA8kvSbpyIh50yWtC1/TYxGfc87F05wleUyc+TqDb/wbE2e+zpwlefEOqUmiSTDfJUgyJZIKw9fe5u5YUiJwP3AuMBK4QtLIWostAXLMbDTwDPDzcN0ewC3AicAE4BZJ3Zsbk3POtRVzluRx03PLySsoxoC8gmJuem55u0oyjSYYM8swswQzSw2HM8ysawvsewKw3sw2mFkp8ARwQa19LzCz/eHoQqCqq7UpwHwzyzez3cB8YGoLxOScc23CrHlrKS6rWe1dXFbBrHlr4xRR00XVo6WkacBp4egbZvbXFth3NrApYjyX4IqkPl8FXm5g3ey6VpJ0LXAtwMCBAw81Vueca1WbC4qbNL0tavQKRtJMgmKyVeHru5LujHVgtWK4CsgBZjV1XTN70MxyzCwnKyur5YNzzrkY6NctrUnT26Jo6mDOA84xs4fN7GGCoqjPt8C+84ABEeP9w2k1SDob+DEwzcwONGVd55xrr2ZMGUZaUmKNaWlJicyYMixOETVdtE/yd4sYzmyhfb8HDJE0WFIycDkwN3IBSeOA3xEkl+0Rs+YBkyV1Dyv3J4fTnHOuQ7hwXDZ3XjyK7G5pCMjulsadF4/iwnF11ga0SdHUwdwJLJG0ABBBXcxBtxQ3lZmVS7qeIDEkAg+b2UpJtwGLzGwuQZFYF+BpSQCfmtk0M8uXdDtBkgK4zczymxuTc861JReOy25XCaU2mVnjC0l9gRPC0XfNbGtMo4qRnJwcW7RoUbzDcM65dkXSYjPLaep69RaRSRoe/h0P9CW4UysX6BdOc8455+rVUBHZ9whu7/1lHfMMODMmETnnnOsQ6k0wZnZtOHiumZVEzpOUGtOonHPOtXvR3EX2TpTTnHPOuWr1XsFIOoLg6fi08HZhhbO6Ap1bITbnnHPtWEN1MFOAqwkeYvwlnyWYvcCPYhuWc8659q6hOphHgEckXWJmz7ZiTM455zqAaOpgjpdU/SR/+PT8z2IYk3POuQ4gmgRzrpkVVI2EzePHpAMy55xzHUc0CSZRUkrViKQ0IKWB5Z1zzrmo2iJ7FHhN0h/D8a8Aj8QuJOeccx1BownGzO6S9AFwVjjpdjPzloudc841KKoeLc3sZT7rTdI555xrVKMJRlIhQdtjAMlAErDPzLrGMjDnnHPtWzRFZBlVwwo6ZbkAOCmWQTnnnGv/ou3REgALzCF4yr/ZJE2VtFbSekkHdWIm6TRJ70sql3RprXkVkpaGr7m113XOORdf0RSRXRwxmgDkACX1LB41SYnA/cA5BP3MvCdprpmtiljsU4Lman5QxyaKzWxsc+Nwzh26OUvymDVvLZsLiunXLY0ZU4a16x4YXcuKppL/CxHD5cBGgmKy5poArDezDQCSngi3W51gzGxjOK+yBfbnnGtBc5bkcdNzyykuqwAgr6CYm55bDuBJxgHR1cF8JUb7zgY2RYznAic2Yf1USYsIkt7MsOjOOddKZs1bW51cqhSXVTBr3lpPMA5ouLn+e/ns7rGDmNl3YhJR9I40szxJRwGvS1puZh/VXkjStQQ9czJw4MDWjtF1cIdzEdHmguImTXeHn4Yq+RcBi4FUYDywLnyNJbhdubnygAER4/3DaVExs7zw7wbgDWBcPcs9aGY5ZpaTlZV16NE6V0tVEVFeQTHGZ0VEc5ZE/TVu1/p1S2vSdHf4qTfBmNkjYZP9o4FJZnavmd1L8ER/S1SuvwcMkTRYUjJwORDV3WBhi84p4XAvYCIRdTfOtYaGiogOBzOmDCMtKbHGtLSkRGZMGRaniFxbE81tyt0JerGs0iWc1ixmVg5cD8wDVgNPmdlKSbdJmgYg6QRJucAXgd9JWhmuPgJYJGkZsICgDsYTjGtVh3sR0YXjsrnz4lFkd0tDQHa3NO68eNRhU0ToGhfNXWQzgSWSFhD0ankacGtL7NzMXgJeqjXtJxHD7xEUndVe7x1gVEvE4Nyh6tctjbw6ksnhVER04bhsTyiuXo1ewZjZHwnu7noeeA44OSw6c+6w5kVEzjWs0QQTNg9zNjDGzF4AkiVNiHlkzrVxXkTkXMOiKSJ7AKgEzgRuAwqBZ4ETYhiXc+2CFxE5V79oEsyJZjZe0hIIukwO7/pyzjnn6hXNXWRlYbthBiApi+CKxjnnnKtXNFcw9xBU8PeWdAdwKfA/MY3KuUN0OD9Z71xbE01bZI9KWkzwgKWACwlaOXauTfHGF51rWxosIpOULSkH2GBm9wNPAV8maDLGuTblcH+y3rm2pt4EI+m/gaXAvcBCSV8jeOI+DTi+dcJzLnqH+5P1zrU1DRWRXQsMM7N8SQOBD4GJZra4dUJzrmn8yXrn2paGishKzCwfwMw+BdZ6cnFtmT9Z71zb0tAVTH9J90SM940cbwP9wThXQ1VFvt9F5lzb0L8VnwcAACAASURBVFCCmVFr3K9eXJvnT9Y713bUm2C8QUvnnHPNEc2T/M4551yTeYJxzjkXE9E019+jjmmDW2LnkqZKWitpvaQb65h/mqT3JZVLurTWvOmS1oWv6S0Rj3POuZYTzRXMi5Kqu0yWNBJ4sbk7DhvQvB84FxgJXBFuO9KnwNXAY7XW7QHcQtAR2gTgFknN7sbZOedcy4kmwfwvQZLpIul44GngqhbY9wRgvZltMLNS4AnggsgFzGyjmX3Awa03TwHmm1m+me0G5gNTWyAm55xzLSSaxi7/JikJeAXIAC4ysw9bYN/ZwKaI8VyCK5JDXdfvTXXOuTak3gQj6V7CPmBCmcBHwPWS2s2DlpKuJWj2hoEDB8Y5GuecO3w0dAWzqNZ4Sz9omQcMiBjvH06Ldt1JtdZ9o64FzexB4EGAnJwcq2sZ55xzLa9JD1qGFekDwnqR5noPGBLekZYHXA58Kcp15wH/G1GxPxm4qQViiinvDMs5dziJ5jblNyR1De/ceh/4vaRfNXfHZlYOXE+QLFYDT5nZSkm3SZoW7vsESbnAF4HfSVoZrpsP3E6QpN4DbqtqmLOtquoMK6+gGOOzzrDmLIn2os0559oXmTVcaiRpiZmNC/uDGWBmt0j6wMxGt06ILScnJ8cWLapd8tc6Js58vc6m5LO7pfH2jWfGISLnnIuOpMVmltPU9Rq9iwzoJKkv8B/Aj5scmQO8Myzn2iMv1m6eaJ6DuY2gGGu9mb0n6Si8y+Qmq6/TK+8My7m2yYu1m6/RBGNmT5vZaDP7Vji+wcwuiX1oHYt3huVc+zJr3lqKyypqTCsuq2DWvLVxiqj9aeg5mBvM7Od1PA8DeIdjTeWdYTnXvnixdvM1VAezOvwbn1rxDsg7w3Ku/ejXLa3OG3O8WDt6DT0H82L4t67nYfyReOdchzZjyjBuem55jWIyL9ZumgbrYCSdLOlSSb3D8dGSHgPebpXonHMuTi4cl82dF48iu1saInik4M6LR3kpRBM0VAczCzgfWAr8UNI84GvAncA1rROec7FXUWmUlFVwoLyS0qpXRQWl5UZ5ZSVlFZWUlhsVlUaFGRWVlVRUQqUZZkalQe3HySRIEEgiQSJBkJggOiUkBH8TRVJiAkmJIjkxgaTEBFKSEkjplEhypwRSOyXQKdH7A4w3L9ZunobqYD4PjDOzkrBJlk3AcWa2sVUic64BB8or2LO/jL0lZewpLmdvcTBcWFJO0YFyCkvKKCopZ19pBfsOBNP2l1awv7SC4tJguLisggNllZRW1O4Nom1IShSpSYmkJSXSOTmRtOROpCcnkpacSJeUTsErtRMZKZ3ISE2ia1onuqYm0TUticzw1a1zEl1SOiEp3m/HHYYaSjAlZlYCYGa7Ja3z5OJiobLSyN9fyq6iUnYVHWDnvlLyiw6Qv6+U/P2l7N5XRv6+UnbvL2VPcRkF+8sOun20tsQEkZ6cSEZqEp2TE0lP6UR6SiLdOyfTOTk4YacmVb0SSE1KJKXTZ1cQyZ0SSK6+ykigU+JnVx+JCSJRIiGB8OpE1D5/B1c3n/397OrHKK8IrozKK4zSiuAKqSrRlZZXVl9NlZQFSbA4TIb7DlSwv7ScvSXlbNlTEiTQA+UUlZYfdAVV+1h075xE987JdE9PpkfnZHp2SaZnlxR6dUmmZ3oKWRmfvdKTEz0huRbRUII5StLciPHBkeNmNi12YbmOoKyikh2FB9i2tyR8BcM7Cg+wPXztKDxA/r4DVNZxgpSge+dkunVOokfnZPp378yo7OBXebfOydW/1LumdiIzLSn4FZ8a/JpPTUo4bE6SlZVGUWk5hSXhlVxxWZCIi8vYs7+MguJSdu8vY/e+UvL3lbJ+RxHvbgwSdl2JKS0pkT5dU+jTNZU+XVM5IjOVI7qm0jczGO7XLY2sLikkJBwex9cduoYSzAW1xn8Zy0Bc+1JZaewsOkBuQTFbCkrYXFBMXkExW/eUsGVPMVv2lLCj6MBBJ7DEBJHVJYXeXVPol5nKmP6ZZGWk0KtLCj27JAd/05PpkZ5Mt87JJPpJrFEJCQqKxlKTyG7CLbQVlcbu/aXsLAoSfdVr294DbC8sYfveA3yQW8C8lSUcKK9ZjJiUKPpmppHdLY3s7mn0757GgO6d6d89jYE9O9MnI9UTkGvwNuV/tGYgrm0xM/L3lfJp/n427S5mU/5+cnfvJ3d3Mbm7g2RSWuukk56cSN9uafTNTGXYERkckZnGEV1TOSIzhd4Zwa/hnunJfuJpIxITRK8uQXIffkT9y5kZBfvL2BL+eNi8p4S83cXVPyreXLeDbXsP1FgnpVMCA3p05sgenTmyZzqDe1X9TadftzT/4XCYiKaxS9dBVVYa2wpL2LhzPxt37WPjrn18snM/n+TvZ1P+fooOlNdYvmd6Mv27pzGyb1cmj+xDdvc0+mUGv2D7dUuja6pXJndEkuieHtTfjOzXtc5lDpRXkLe7mE27i4MfJfn7+WTXPj7ZtZ93PtpVo84suVMCR/VK56isdI7O6sIxvbtwdFbwSktOrHP7rn3yBHMY2FNcxoYdRWzYsY8NO4v4eOc+NuwI/vlr/OMnJtC/RxpH9ujMiYN7MKBHZwaGr/7d00hP8a+Lq1tKp0SOyurCUVldDppnZmwvPMDHO/dVvz7aXsTqLYXMW7mNirACToL+3dMY2juDoUdkMLRPF4b2yeCY3l1I6eSJpz2K+owhqbOZ7Y9lMO7QmRk7Cg+wbnsR67YVsn5HEeu3F/HRjn3sKPys+CIxQQzs0ZnBvdKZeEwvBvVKZ3DPdI7s2dmLLlxMSKq+YeCko3rWmFdaXsnGXftYvz34vn64rZB124r4x4c7KA8TT2KCODorneFHdGVE366M7NeVkX27kpWREo+345qg0QQj6XPAH4AuwEBJY4BvVLWu3BySpgJ3A4nAH8xsZq35KcCfgOOBXcBlZrZR0iCCttKqmjVdaGbXNTee9mJn0QE+3FbIh1sLWbstSCjrthexp7isepmM1E4c07sLk4ZmcXRYBHFUVjoDe3QmyR/gc21EcqcEhvbJYGifjBrTqxLPmq2FrN26lzVbCln8yW7mLttcvUxWRgrH9uvKqOxMju2Xyaj+mfTLTPVi2jYkmiuYXwNTgLkAZrZM0mnN3bGkROB+4BwgF3hP0lwzWxWx2FeB3WZ2jKTLgbuAy8J5H5nZ2ObG0ZaVlFWwfnsRq7fsZc3WQtZs3cvarYXsLCqtXqZb5ySG9s7g/NF9q4sThvTuQlZGiv+juXarRuIZ0696+p79ZazaspdVW/aycvMeVm3ey5vrdlYXs/VMT2ZU/0xG9+/GmP6ZjBnQjV5d/EonXqIqIjOzTbVOVg0/5RadCQSdmG0AkPQEwa3RkQnmAuDWcPgZ4D510LPmrqID4T/NXlZt3svqLXvZsHNf9T9OSvgPd8aw3gw7IqP6ldXFE4k7fGR2TuLko3ty8tGfFbWVlFWwesteVuTt4YPc4PXPD9dVP1s1oEcaYwd0Z9yAbow/sjsj+3YluZNfxbeGaBLMprCYzCQlAd/ls6b8myOboPmZKrnAifUtY2blkvYAVd+swZKWAHuBm83szbp2Iula4FqAgQPj3wi0mbF1bwkr8oJ/iJWb97Aiby9b95ZUL9MvM5URfbsy5dgjGNG3K8P7ZjCoZ7rXjzhXh9SkRMYN7M64gd2rp+07UM6KvD0syy1gyacFLNqYz4th8VpKpwRG989k/JHdyTmyBzlHdqd7enK8wu/Qokkw1xHUk2QDecArQLPrX5ppCzDQzHZJOh6YI+lYM9tbe0EzexB4ECAnJ6eBBjViY+ueEj7ILWB53p7glbuHXfuCIq4EwdFZXTjpqB4c2y+TY/sFlZix/LJ7H+PucJCe0okTj+rJiRE3FWzdU8L7n+7m/U92s/jT3Tz81sf87h8bABjSuws5g3owYXB3Thzc0/t8aSHRJJhhZnZl5ARJE2l+k/15wICI8f7htLqWyZXUCcgEdpmZAQcAzGyxpI+AocS5c7Q9+8tYllvAsk0FLMvdwwe5BWwP7+BKTBBDenfhjOG9GZWdyXHZmYzom0Hn5Na79beqj/GqW5Or+hgHPMm4Du+IzFTOG9WX80b1BYKitQ9y9/DexnwWbcznrx9s5vF3PwWCYrUTB/fkpKOC4rimtJDgPhPN2e1eYHwU05rqPWCIpMEEieRy4Eu1lpkLTAf+BVwKvG5mJikLyDezCklHAUOADc2Mp0nKKipZs6WQJZt2s+TTIKls2Lmvev5RWcFtwKP7ZzK6fyYj+2bG/SGyhvoY9wTjDjepSYlMGNyDCYN7AEHTOWu27uXfG/J59+N8Xlu9jWcW5wIwsEdnTj6qJ587picTj+nlNw5EqaH+YE4GPgdkSfpexKyuBLcVN0tYp3I9MC/c3sNmtlLSbcAiM5sLPAT8WdJ6IJ8gCQGcBtwmqQyoBK4zs/zmxtSQ7XvDy+tPC3j/k90sz9tT3T5TVkYKYwd045Lj+zN2QDdG9c+ka2pSLMM5JN7HuHP1S0xQWFSdyTWnDKay0vhweyHvrN/Fvzbs4uUVW3hyUVBtPPyIDE45phenDs1iwqAecf/x2FbJ6mnnW9LpwCSCOpj/i5hVCLxoZutiHl0Ly8nJsUWLml6KdsF9b7Esdw8QPO1+XHbXsFKxG+MGdm83995PnPl6nX2MZ3dL4+0bz4xDRM61HxWVxoq8Pbz90U7eXr+T9zbuprS8kuROCUwY1INTh/Ri0rDeDO3TpV2cD5pC0mIzy2nyevUlmIgNH2lmnxxyZG3IoSaYB95YT3JiAuMGdue47K7tttmK2nUwEDTN7t3AOtd0JWUVvPtxPm+u28Gb63ayZmshAH0zUzl9aBaThmVxypAsunSAJpZimWAWAActZGbt7ifvoSaYjsTvInMuNrbuKeEfH27njbU7eGvdTgoPlJOUKCYM7sEZw3pz1og+DO6VHu8wD0ksE8zxEaOpwCVAuZnd0NSdxZsnGOdcayirqGTxJ7tZsGY7r6/ZzrrtRQAcnZXO2SP7cM6IPowb2L3dPNsWswRTz87eNbMJTV4xzjzBOOfiYVP+fl5bvY1XV29n4YZdlFcaPdOTOXtEHyYf24eJx/QiNantFr3H8gqmR8RoAkHDk/eY2bCm7izePME45+Jtb0kZ/1i7g/mrtrFgzXYKD5TTOTmRM4b1ZupxR3DG8N5trt7mUBNMNO9iMUEdjIBy4GOCRiidc841UdfUJL4wph9fGNOPA+UVLNyQz7yVW3ll5Tb+tnwLyZ0SOG1IFp8ffQRnj+hDRht85CFah1RE1l75FYxzrq2qqDQWbczn5RVbmbdyK1v2lJCcmMBpQ7M4f3Rfzh7ZJ25XNi1eRCbp4oZWNLPnmrqzePME45xrDyorjSWbdvO3D7by0vItbN1bQkqnBM4a0ZsvjO7HGcN7t2qdTSwSzB8bWM/M7Jqm7izePME459qbykpj8ae7+euyzfxt+RZ2FpXSJaUTU449ggvH9eNzR/eK+d1orXoXWXvlCcY5156VV1SycEM+c5fl8fLyrRQeKCcrI4UvjO7HxeOzObZf15i0IhDLu8gygVsI2v8C+Adwm5ntaXKUceYJxjnXUZSUVbBgzXbmLM1jwZodlFZUMqxPBheNz+bCsdkckZnaYvuKZYJ5FlgBPBJO+jIwxswarKNpizzBOOc6ooL9pfz1gy08934u739aQILglCFZfPH4/pwzsk+z62timWCWmtnYxqa1B55gnHMd3cc79/Hc+7k8uziXzXtKyExLYtqYfnx/8lC6dT60zgwPNcFE0zF1saRTInY0EfD23Z1zrg0a3Cud708exps/PJM/f3UCk4Zl8erqbXHpUiCam6q/CTwS1sWIoF+Wq2MZlHPOueZJTBCnDsni1CFZlFVUkpQYzfVEy2o0wZjZUmCMpK7h+EH93jvnnGu74pFcIIoiMknfDZNLIfArSe9LmtwSO5c0VdJaSesl3VjH/BRJT4bz/y1pUMS8m8LpayVNaYl4nHPOtZxo0to14VXLZKAnwV1kM5u7Y0mJwP3AucBI4ApJI2st9lVgt5kdA/wauCtcdyRB98nHAlOBB8LtOeecayOiSTBVT+2cB/zJzFZGTGuOCcB6M9tgZqXAE8AFtZa5gM9uj34GOEvBU0QXAE+Y2QEz+xhYH27POedcGxFNglks6RWCBDNPUgZQ2QL7zgY2RYznhtPqXMbMyoE9BFdR0awLgKRrJS2StGjHjh0tELZzzrloRJNgvgrcCJxgZvuBZOArMY2qBZnZg2aWY2Y5WVlZ8Q7HOecOG9HcRVYZVq5fJcmAt8zs+RbYdx4wIGK8fzitrmVyJXUCMoFdUa7rnHMujqK5i+wB4DpgOUGTMd+QdH8L7Ps9YIikwZKSCSrt59ZaZi4wPRy+FHjdgqYH5gKXh3eZDQaGAO+2QEzOOedaSDQPWp4JjAhP7Eh6BFjV3B2bWbmk64F5QCLwsJmtlHQbsMjM5gIPAX+WtJ7gAc/Lw3VXSnoqjKMc+C8zq2huTK7lzVmSx6x5a9lcUEy/bmnMmDKMC8fVWV3mnOtgokkw64GBwCfh+ABgXUvs3MxeAl6qNe0nEcMlwBfrWfcO4I6WiMPFxpwledz03HKKy4Lcn1dQzE3PLQfwJOPcYaDeIjJJL0qaC2QAqyW9IWkBsDqc5lyDZs1bW51cqhSXVTBr3to4ReSca00NXcH8ooF5h08vZe6QbS6ou03U+qY75zqWehOMmf2jrulhy8pXAP+MVVCuY+jXLY28OpJJv25pcYjGOdfaomoBTdI4SbMkbQRuJygmc65BM6YMI61WR0dpSYnMmDIsThE551pTvVcwkoYSXKlcAewEniTooOyMVorNtXNVFfl+F5lzh6eG6mDWAG8C55vZegBJ/69VonIdxoXjsj2hOHeYaqiI7GJgC7BA0u8lnUXLNHLpnHPuMFBvgjGzOWZ2OTAcWAD8N9Bb0m9bqj8Y55xzHVejlfxmts/MHjOzLxC0+bUE+GHMI3POOdeuNakfTTPbHbZOfFasAnLOOdcxxKejZueccx2eJxjnnHMx4QnGOedcTHiCcc45FxOeYJxzzsWEJxjnnHMxEZcEI6mHpPmS1oV/u9ez3PRwmXWSpkdMf0PSWklLw1fv1oveOedcNOJ1BXMj8JqZDQFeC8drkNQDuAU4EZgA3FIrEV1pZmPD1/bWCNo551z04pVgLgAeCYcfAS6sY5kpwHwzyzez3cB8YGorxeecc66Z4pVg+pjZlnB4K9CnjmWygU0R47nhtCp/DIvH/kdSvY1wSrpW0iJJi3bs2NHswJ1zzkWnoeb6m0XSq8ARdcz6ceSImZmkpnbBfKWZ5UnKAJ4Fvgz8qa4FzexB4EGAnJwc7+rZOedaScwSjJmdXd88Sdsk9TWzLZL6AnXVoeQBkyLG+wNvhNvOC/8WSnqMoI6mzgTjnHMuPuJVRDYXqLorbDrwQh3LzAMmS+oeVu5PBuZJ6iSpF4CkJOB8YEUrxOycc64J4pVgZgLnSFoHnB2OIylH0h8AzCwfuB14L3zdFk5LIUg0HwBLCa50ft/6b8E551xDZHb4VEvk5OTYokWL4h2Gc861K5IWm1lOU9fzJ/mdc87FhCcY55xzMeEJxjnnXEx4gnHOORcTnmCcc87FhCcY55xzMeEJxjnnXEx4gnHOORcTnmCcc87FhCcY55xzMeEJxjnnXEx4gnHOORcTnmCcc87FhCcY55xzMeEJxjnnXEx4gnHOORcTcUkwknpImi9pXfi3ez3L/V1SgaS/1po+WNK/Ja2X9KSk5NaJ3DnnXLTidQVzI/CamQ0BXgvH6zIL+HId0+8Cfm1mxwC7ga/GJErnnHOHLF4J5gLgkXD4EeDCuhYys9eAwshpkgScCTzT2PrOHa7mLMlj4szXGXzj35g483XmLMmLd0juMNQpTvvtY2ZbwuGtQJ8mrNsTKDCz8nA8F8iub2FJ1wLXAgwcOPAQQnWufZmzJI+bnltOcVkFAHkFxdz03HIALhxX77+Kcy0uZlcwkl6VtKKO1wWRy5mZARarOMzsQTPLMbOcrKysWO3GuTZj1ry11cmlSnFZBbPmrY1TRO5wFbMrGDM7u755krZJ6mtmWyT1BbY3YdO7gG6SOoVXMf0Bv/53LrS5oLhJ052LlXjVwcwFpofD04EXol0xvOJZAFx6KOs719H165bWpOnOxUq8EsxM4BxJ64Czw3Ek5Uj6Q9VCkt4EngbOkpQraUo464fA9yStJ6iTeahVo3euDZsxZRhpSYk1pqUlJTJjyrA4ReQOV3Gp5DezXcBZdUxfBHwtYvzUetbfAEyIWYDOtWNVFfmz5q1lc0Ex/bqlMWPKMK/gd60uXneROedi6MJx2Z5QXNx5UzHOOediwhOMc865mPAE45xzLiY8wTjnnIsJTzDOOediQsFzi4cHSTuAT2Kw6V7AzhhstyV4bIfGYzs0HtuhacuxpQK5Zja1qSseVgkmViQtMrOceMdRF4/t0Hhsh8ZjOzQdNTYvInPOORcTnmCcc87FhCeYlvFgvANogMd2aDy2Q+OxHZoOGZvXwTjnnIsJv4JxzjkXE55gnHPOxYQnmCaQNFXSWknrJd1Yx/zvSVol6QNJr0k6sg3Fdp2k5ZKWSnpL0si2ElvEcpdIMkmtdrtmFMftakk7wuO2VNLX6tpOPGILl/mP8Du3UtJjbSU2Sb+OOGYfSipoQ7ENlLRA0pLwf/W8NhTbkeG54wNJb0jq30pxPSxpu6QV9cyXpHvCuD+QND6qDZuZv6J4AYnAR8BRQDKwDBhZa5kzgM7h8DeBJ9tQbF0jhqcBf28rsYXLZQD/BBYCOW0lNuBq4L42+n0bAiwBuofjvdtKbLWW/zbwcFuJjaDS+pvh8EhgYxuK7Wlgejh8JvDnVortNGA8sKKe+ecBLwMCTgL+Hc12/QomehOA9Wa2wcxKgSeACyIXMLMFZrY/HF0ItMqvjyhj2xsxmg601t0djcYWuh24CyhppbiaEls8RBPb14H7zWw3gJltb0OxRboCeLxVIosuNgO6hsOZwOY2FNtI4PVweEEd82PCzP4J5DewyAXAnyywEOgmqW9j2/UEE71sYFPEeG44rT5fJcj4rSGq2CT9l6SPgJ8D32krsYWX2wPM7G+tFFOVaD/TS8JigWckDWid0KKKbSgwVNLbkhZKanJTHjGMDQiKfIDBfHbSjLVoYrsVuEpSLvASwRVWa4gmtmXAxeHwRUCGpJ6tEFtjmnr+AzzBxISkq4AcYFa8Y4lkZveb2dHAD4Gb4x0PgKQE4FfA9+MdSz1eBAaZ2WhgPvBInOOJ1ImgmGwSwVXC7yV1i2tEB7sceMbMKuIdSIQrgNlm1p+g6OfP4fewLfgBcLqkJcDpQB7Qlo5dk7SVg9oe5AGRv177h9NqkHQ28GNgmpkdaEuxRXgCuDCmEX2msdgygOOANyRtJCjfndtKFf2NHjcz2xXxOf4BOL4V4ooqNoJfkXPNrMzMPgY+JEg4bSG2KpfTesVjEF1sXwWeAjCzfxE05tirLcRmZpvN7GIzG0dwHsHMWu0GiQY09RwTaI0KpI7wIvi1uIHgcr+qgu7YWsuMI6jEG9IGYxsSMfwFYFFbia3W8m/QepX80Ry3vhHDFwEL21BsU4FHwuFeBEUYPdtCbOFyw4GNhA90t6Hj9jJwdTg8gqAOJuYxRhlbLyAhHL4DuK0Vj90g6q/k/zw1K/nfjWqbrRV8R3gRXE5/GCaRH4fTbiO4WgF4FdgGLA1fc9tQbHcDK8O4FjR0km/t2Got22oJJsrjdmd43JaFx214G4pNBMWLq4DlwOVtJbZw/FZgZmvF1ITjNhJ4O/xMlwKT21BslwLrwmX+AKS0UlyPA1uAMoIr468C1wHXRXzX7g/jXh7t/6g3FeOccy4mvA7GOedcTHiCcc45FxOeYJxzzsWEJxjnnHMx4QnGOedcTHiCce2apIqwxd5lkt6X9LkW3v5sSZeGw39oiVaoJU2StCeMe42kX0TMm9ZIi9NXS7qvke1HtgC9RtL/a27Mzh2KTvEOwLlmKjazsQCSphA8t3J6LHZkZi3ZVP+bZna+pDRgiaTnzextM5sLzG2B7T9pZteH7VitlfSMmW1qdC3nWpBfwbiOpCuwG0BSl7BfjffDfnAuCKenS/pbeMWzQtJl4fTjJf1D0mJJ8+pqKTbsnyMnHC6SdEe4nYWS+oTTsyQ9K+m98DWxoYDNrJjgYb/scP3qKxRJXwxjXCbpn3XE83lJ/5JUbzMnZrYLWA/0Ddf5SRjXCkkPSlLEe7tL0rth/y2nhtM7S3pKQZ8zz0v6d8QxmBzu/31JT0vq0tB7dYcfTzCuvUurKgoiePL59nB6CXCRmY0n6Kfnl+HJdCqw2czGmNlxwN8lJQH3Apea2fHAwwTNdDQknaDZmDEE/dh8PZx+N/BrMzsBuCSMqV6SuhO0H3ZQAgF+AkwJ9zGt1noXATcC55nZzga2P5Cgra0Pwkn3mdkJ4XtPA86PWLyTmU0A/hu4JZz2LWC3mY0E/oewLbYwqd0MnB0e40XA9xp6r+7w40Vkrr2LLCI7GfiTpOMImrb4X0mnAZUEVwh9CJq5+KWku4C/mtmb4fLHAfPDH/SJBM1mNKQU+Gs4vBg4Jxw+GxgZbgegq6QuZlZUa/1TJS0jSC6/MbOtdezjbWC2pKeA5yKmn0nQWvdkq9nPT6TLwvc+HLjezKr62TlD0g1AZ6AHQTM4L4bzqvaxmKBdKoBTCJImZrZCUlWiOomwyZXwvSYD/6onFneY8gTjOgwzqyouyiJo8ykLON7MysKWmlPN7EMF/c+cB/xM0mvA88BKMzu5Cbsrs8/aWargs/+lBOCkiBN6farqYAYDCyU9ZWZLa72f6ySdSNDQ4GJJVS05V/WKOJTgyqEuVXUwOcArkuYCBcADIcQuqwAAAapJREFUBO1IbZJ0K8HVTZWqVqMj3099BMw3sysaWc4dxryIzHUYkoYTXH3sIuipcHuYXM4AjgyX6QfsN/v/7d29K4VhHMbx75XOwmxXRxQpyab8FbIosRr4D1jOQHYpm5ckfwEpk3fDCYnRzGKz6Ge4b45OOedJPYNcn/E5d8+5n+nqfun3i21Sv54R4BHozisgJFUkDf5yGod8a2AlabjV4Ehl9pdJPXqav6caERcRsQg80yiX/kTafttsN8+IuAa2gAUaYfKSz0smCnzPCTCZ5zMADOXn58CYpN78W5ekvgLvs3/EAWN/3ecZTB3YI/Uzfwd2gFFJt8A08JDHDwGXefwSUIvUvnYCWMnbVnXgt9ed5/P/3ki6J1WkbWcdGJfU0/R8NV9QuANOSdV/AYiIB2AK2JdUbfP+FWCWtDLZAO6AA+CqwNzWSOF7D9RIW2qvEfEMzAC7edvsjLQdZ/bF1ZTN7EeSOoBKRLzlIDsC+nMom7XkMxgza6UTOM437QTMOVysKK9gzMysFD6DMTOzUjhgzMysFA4YMzMrhQPGzMxK4YAxM7NSfAAIRPUY8JXcNwAAAABJRU5ErkJggg==\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "abs_risks = lr_ARR_quantile(X_dev, y_dev, lr)\n",
    "plt.scatter(abs_risks.index, abs_risks, label='empirical ARR')\n",
    "plt.title(\"Empirical Absolute Risk Reduction vs. Baseline Risk\")\n",
    "plt.ylabel(\"Absolute Risk Reduction\")\n",
    "plt.xlabel(\"Baseline Risk Range\")\n",
    "ps = np.arange(abs_risks.index[0]-0.05, abs_risks.index[-1]+0.05, 0.01)\n",
    "diffs = [OR_to_ARR(p, trtmt_OR) for p in ps]\n",
    "plt.plot(ps, diffs, label='predicted ARR')\n",
    "plt.legend(loc='upper right')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "fz8Es6q98Kjw"
   },
   "source": [
    "In the plot, the empirical absolute risk reduction is shown as circles, whereas the predicted risk reduction from the logistic regression model is given by the solid line.\n",
    "\n",
    "If ARR depended only on baseline risk, then if we plotted actual (empirical) ARR grouped by baseline risk, then it would follow the model's predictions closely (the dots would be near the line in most cases).\n",
    "\n",
    "However, you can see that the empirical absolute risk reduction (shown as circles) does not match the predicted risk reduction from the logistic regression model (given by the solid line). \n",
    "\n",
    "This may indicate that ARR may depend on more than simply the baseline risk.  "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "aAgIlK6Z8s2p"
   },
   "source": [
    "<a name=\"3\"></a>\n",
    "## 3. Evaluation Metric"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "oCASYrsI1EFI"
   },
   "source": [
    "<a name=\"3-1\"></a>\n",
    "### 3.1 C-statistic-for-benefit (C-for-benefit)\n",
    "\n",
    "You'll now use a measure to evaluate the discriminative power of your models for predicting ARR. Ideally, you could use something like the regular Concordance index (also called C-statistic) from Course 2. Proceeding by analogy, you'd like to estimate something like:\n",
    "\n",
    "$$P(A \\text{ has higher predicted ARR than } B| A \\text{ experienced a greater risk reduction than } B).$$\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### The ideal data cannot be observed\n",
    "\n",
    "The fundamental problem is that for each person, you can only observe either their treatment outcome or their baseline outcome. \n",
    "- The patient either receives the treatment, or does not receive the treatment.  You can't go back in time to have the same patient undergo treatment and then not have treatment.\n",
    "- This means that you can't determine what their actual risk reduction was. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Estimate the treated/untreated patient using a pair of patients\n",
    "\n",
    "What you will do instead is match people across treatment and control arms based on predicted ARR. \n",
    "- Now, in each pair, you'll observe both outcomes, so you'll have an estimate of the true treatment effect.\n",
    "- In the pair of patients (A,B), \n",
    "    - Patient A receives the treatment \n",
    "    - Patient B does not receive the treatment.\n",
    "- Think of the pair of patients as a substitute for the the ideal data that has the same exact patient in both the treatment and control group."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### The C-for-benefit\n",
    "\n",
    "$$P(\\text{$P_1$ has a predicted ARR greater than $P_2$} | \\text{$P_1$ experiences greater risk reduction than $P_2$}),$$\n",
    "\n",
    "- Pair 1 consists of two patients (A,B), where A receives treatment, B does not.\n",
    "- Pair 2 is another pair of two patients (A,B), where A receives treatment, B does not.\n",
    "\n",
    "The risk reduction for each pair is:\n",
    "- -1 if the treated person A survives and the untreated B person does not (treatment helps).  \n",
    "- 1 if the treated person A dies and the untreated person B doesn't (treatment harms)\n",
    "- 0 otherwise (treatment has no effect, because both patients in the pair live, or both die)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Details for calculating C-for-benefit\n",
    "\n",
    "The c-for-benefit gives you a way to evaluate the ability of models to discriminate between patient profiles which are likely to experience greater benefit from treatment. \n",
    "- If you are better able to predict how likely a treatment can improve a patient's outcome, you can help the doctor and patient make a more informed decision when deciding whether to undergo treatment, considering the possible side-effects and other risks associated with treatment.\n",
    "\n",
    "Please complete the implementation of the C-statistic-for-benefit below.  \n",
    "\n",
    "The code to create the pairs is given to you. \n",
    "```CPP\n",
    "obs_benefit_dict = {\n",
    "        (0, 0): 0,\n",
    "        (0, 1): -1,\n",
    "        (1, 0): 1,\n",
    "        (1, 1): 0,\n",
    "    }\n",
    "```\n",
    "Here is the interpretation of this dictionary for a pair of patients, (A,B), where A receives treatment and B does not:  \n",
    "- When patient A does not die, and neither does patient B, `(0, 0)`, the observed benefit of treatment is 0.\n",
    "- When patient A does not die, but patient B does die, `(0, 1)`, the observed benefit is -1 (the treatment helped).\n",
    "- When patient A dies, but patient B does not die, `(1, 0)`, the observed benefit is 1 (the treatment was harmful)\n",
    "- When patient A dies and patient B dies, `(1, 1)`, the observed benefit of treatment is 0.\n",
    "\n",
    "Each patient in the pair is represented by a tuple `(ARR, y)`.\n",
    "- Index 0 contains the predicted ARR, which is the predicted benefit from treatment.\n",
    "- Index 1 contains the actual patient outcome: 0 for no death, 1 for death.\n",
    "\n",
    "So a pair of patients is represented as a tuple containing two tuples:\n",
    "\n",
    "For example, Pair_1 is `( (ARR_1_A, y_1_A),(ARR_1_B, y_1_B))`, and the data may look like:\n",
    "`( (0.60, 0),(0.40, 1))`.  \n",
    "- This means that patient A (who received treatment) has a predicted benefit of 0.60 and does not die.\n",
    "- Patient B (who did not receive treatment) has a predicted benefit of 0.40 and dies."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a name='ex-7'></a>\n",
    "### Exercise 7 - c_for_benefit_score\n",
    "In `c_for_benefit_score`, you will compute the C-for-benefit given the matched pairs.\n",
    "\n",
    "$$\\text{c for benefit score} = \\frac{concordant + 0.5 \\times risk\\_ties}{permissible}$$"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Click here for Hints!</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li>A pair of patients in this case are two patients whose data are used to represent a single patient.</li>\n",
    "    <li> A pair of pairs is similar to what you think of as just a \"pair\" in the course 2 concordance index.  It's a pair of pairs of patients (four patients total).</li>\n",
    "    <li>Each patient is represented by a tuple of two values.  The first value is the predicted risk reduction, and the second is the patient's outcome.</li>\n",
    "    <li>observed benefit: for each patient pair, the first patient is assumed to be the one who received treatment, and second in the pair is the one who did not receive treatment.  Observed benefit is either 0 (no effect), -1 (treatment helped), 1 (treatment harmed)</li>\n",
    "    <li>predicted benefit: for each patient pair, take the mean of the two predicted benefits.  This is the first value in each patient's tuple.</li>\n",
    "    <li>permissible pair of pairs: observed benefit is different between the two pairs of pairs of patients.</li>\n",
    "    <li>concordant pair: the observed benefit and predicted benefit of pair 1 are both less than those for pair 2; or, the observed and predicted benefit of pair 1 are both greater than those for pair 2.  Also, it should be a permissible pair of pairs.</li>\n",
    "    <li>Risk tie: the predicted benefits of both pairs are equal, and it's also a permissible pair of pairs.</li>\n",
    "</ul>\n",
    "</p>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 31,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:38.967898Z",
     "start_time": "2020-04-04T15:31:38.956876Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 68
    },
    "colab_type": "code",
    "id": "edk8jABOyZlH",
    "outputId": "5ab4c92f-9f02-41ed-924e-fcc8a797b8fb"
   },
   "outputs": [],
   "source": [
    "# UNQ_C7 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def c_for_benefit_score(pairs):\n",
    "    \"\"\"\n",
    "    Compute c-statistic-for-benefit given list of\n",
    "    individuals matched across treatment and control arms. \n",
    "\n",
    "    Args:\n",
    "        pairs (list of tuples): each element of the list is a tuple of individuals,\n",
    "                                the first from the control arm and the second from\n",
    "                                the treatment arm. Each individual \n",
    "                                p = (pred_outcome, actual_outcome) is a tuple of\n",
    "                                their predicted outcome and actual outcome.\n",
    "    Result:\n",
    "        cstat (float): c-statistic-for-benefit computed from pairs.\n",
    "    \"\"\"\n",
    "    \n",
    "    # mapping pair outcomes to benefit\n",
    "    obs_benefit_dict = {\n",
    "        (0, 0): 0,\n",
    "        (0, 1): -1,\n",
    "        (1, 0): 1,\n",
    "        (1, 1): 0,\n",
    "    }\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None', 'False', and 'pass' with your code) ###\n",
    "\n",
    "    # compute observed benefit for each pair\n",
    "    obs_benefit = [obs_benefit_dict[p[0][1], p[1][1]] for p in pairs]\n",
    "\n",
    "    # compute average predicted benefit for each pair\n",
    "    pred_benefit = [(p[0][0] + p[1][0]) / 2 for p in pairs]\n",
    "\n",
    "    concordant_count, permissible_count, risk_tie_count = 0, 0, 0\n",
    "\n",
    "    # iterate over pairs of pairs\n",
    "    for i in range(len(pairs)):\n",
    "        for j in range(i + 1, len(pairs)):\n",
    "            \n",
    "            # if the observed benefit is different, increment permissible count\n",
    "            if obs_benefit[i] != obs_benefit[j]:\n",
    "\n",
    "                # increment count of permissible pairs\n",
    "                permissible_count += 1\n",
    "                \n",
    "                # if concordant, increment count\n",
    "                \n",
    "                if (pred_benefit[i] > pred_benefit[j] and obs_benefit[i] > obs_benefit[j]) or (pred_benefit[i] < pred_benefit[j] and obs_benefit[i] < obs_benefit[j]): # change to check for concordance\n",
    "                    \n",
    "                    concordant_count += 1\n",
    "\n",
    "                # if risk tie, increment count\n",
    "                if (pred_benefit[i] == pred_benefit[j]): #change to check for risk ties\n",
    "                    risk_tie_count += 1\n",
    "\n",
    "\n",
    "    # compute c-statistic-for-benefit\n",
    "    cstat = (concordant_count + (risk_tie_count/2)) / permissible_count\n",
    "    \n",
    "    # END CODE HERE\n",
    "    \n",
    "    return cstat"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 32,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Test Case 1:\n",
      "\n",
      "pairs: [((0.64, 1), (0.54, 0)), ((0.44, 0), (0.4, 1)), ((0.56, 1), (0.74, 0)), ((0.22, 0), (0.22, 1)), ((0.22, 1), (0.22, 0))]\n",
      "\n",
      "Output: 0.75\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex7: you cannot edit this cell\n",
    "c_for_benefit_score_test(c_for_benefit_score)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "\n",
    "```\n",
    "Test Case 1:\n",
    "\n",
    "pairs: [((0.64, 1), (0.54, 0)), ((0.44, 0), (0.4, 1)), ((0.56, 1), (0.74, 0)), ((0.22, 0), (0.22, 1)), ((0.22, 1), (0.22, 0))]\n",
    "\n",
    "Output: 0.75\n",
    "\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a name='ex-8'></a>\n",
    "### Exercise 8 - c_statistic\n",
    "\n",
    "You will implement the function `c_statistic`, which prepares the patient data and uses the c-for-benefit score function to calculate the c-for-benefit:\n",
    "\n",
    "- Take as input:\n",
    "    - The predicted risk reduction `pred_rr` (ARR)\n",
    "    - outcomes `y` (1 for death, 0 for no death)\n",
    "    - treatments `w` (1 for treatment, 0 for no treatment)\n",
    "- Collect the predicted risk reduction, outcomes and treatments into tuples, one tuple for each patient.\n",
    "- Filter one list of tuples where patients did not receive treatment.\n",
    "- Filter another list of tuples where patients received treatment.\n",
    "\n",
    "- Make sure that there is one treated patient for each untreated patient.\n",
    "    - If there are fewer treated patients, randomly sample a subset of untreated patients, one for each treated patient.\n",
    "    - If there are fewer untreated patients, randomly sample a subset of treated patients, one for each untreated patient.\n",
    "    \n",
    "- Sort treated patients by their predicted risk reduction, and similarly sort the untreated patients by predicted risk reduction.\n",
    "    - This allows you to match the treated patient with the highest predicted risk reduction with the untreated patient with the highest predicted risk reduction.  Similarly, the second highest treated patient is matched with the second highest untreated patient.\n",
    "    \n",
    "- Create pairs of treated and untreated patients."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Hints</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li> Use zip(a,b,c) to create tuples from two or more lists of equal length, and use list(zip(a,b,c)) to store that as a list data type.</li>\n",
    "    <li> Use filter(lambda x: x[0] == True, some_list) to filter a list (such as a list of tuples) so that the 0th item in each tuple is equal to True. Cast the result as a list using list(filter(lambda x: x[0] == True, some_list)) </li>\n",
    "    <li>Use random.sample(some_list, sub_sample_length) to sample a subset from a list without replacement.</li>\n",
    "    <li>Use sorted(some_list, key=lambda x: x[1]) to sort a list of tuples by their value in index 1.</li>\n",
    "</ul>\n",
    "</p>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 33,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:40.551120Z",
     "start_time": "2020-04-04T15:31:40.544150Z"
    }
   },
   "outputs": [],
   "source": [
    "# UNQ_C8 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def c_statistic(pred_rr, y, w, random_seed=0):\n",
    "    \"\"\"\n",
    "    Return concordance-for-benefit, the proportion of all matched pairs with\n",
    "    unequal observed benefit, in which the patient pair receiving greater\n",
    "    treatment benefit was predicted to do so.\n",
    "\n",
    "    Args: \n",
    "        pred_rr (array): array of predicted risk reductions\n",
    "        y (array): array of true outcomes\n",
    "        w (array): array of true treatments \n",
    "    \n",
    "    Returns: \n",
    "        cstat (float): calculated c-stat-for-benefit\n",
    "    \"\"\"\n",
    "    assert len(pred_rr) == len(w) == len(y)\n",
    "    random.seed(random_seed)\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "    # Collect pred_rr, y, and w into tuples for each patient\n",
    "    tuples = list(zip(pred_rr, y, w))\n",
    "    \n",
    "    # Collect untreated patient tuples, stored as a list\n",
    "    untreated = [t for t in tuples if t[2] == 0]\n",
    "    \n",
    "    # Collect treated patient tuples, stored as a list\n",
    "    treated = [t for t in tuples if t[2] == 1]\n",
    "\n",
    "    # randomly subsample to ensure every person is matched\n",
    "    \n",
    "    # if there are more untreated than treated patients,\n",
    "    # randomly choose a subset of untreated patients, one for each treated patient (length of treated patients).\n",
    "\n",
    "    if len(treated) < len(untreated):\n",
    "        untreated = random.sample(untreated, len(treated))\n",
    "        \n",
    "    # if there are more treated than untreated patients,\n",
    "    # randomly choose a subset of treated patients, one for each untreated patient (length of untreated patients).\n",
    "    if len(untreated) < len(treated):\n",
    "        treated = random.sample(treated, len(untreated))\n",
    "        \n",
    "    assert len(untreated) == len(treated)\n",
    "\n",
    "    # Sort the untreated patients by their predicted risk reduction\n",
    "    untreated = sorted(untreated, key=lambda x: x[0])\n",
    "    \n",
    "    # Sort the treated patients by their predicted risk reduction\n",
    "    treated = sorted(treated, key=lambda x: x[0])\n",
    "    \n",
    "    # match untreated and treated patients to create pairs together\n",
    "    pairs = [(untreated[i], treated[i]) for i in range(len(untreated))]\n",
    "\n",
    "    # calculate the c-for-benefit using these pairs (use the function that you implemented earlier)\n",
    "    cstat = c_for_benefit_score(pairs)\n",
    "    \n",
    "    ### END CODE HERE ###\n",
    "    \n",
    "    return cstat"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 34,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Test Case:\n",
      "\n",
      "C-for-benefit calculated: 0.6\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex8: you cannot edit this cell\n",
    "c_statistic_test(c_statistic)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "```\n",
    "C-for-benefit calculated: 0.6\n",
    "\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "XH_yDTAq3D42"
   },
   "source": [
    "### Predicted risk reduction\n",
    "In order to compute the c-statistic-for-benefit for any of your models, you need to compute predicted risk reduction from treatment (predicted risk reduction is the input `pred_rr` to the c-statistic function).\n",
    "\n",
    "- The easiest way to do this in general is to create a version of the data where the treatment variable is False and a version where it is True.\n",
    "- Then take the difference $\\text{pred_RR} = p_{control} - p_{treatment}$\n",
    "\n",
    "We've implemented this for you."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 35,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:43.624458Z",
     "start_time": "2020-04-04T15:31:43.619458Z"
    },
    "colab": {},
    "colab_type": "code",
    "id": "arBYI7rR4lqr"
   },
   "outputs": [],
   "source": [
    "def treatment_control(X):\n",
    "    \"\"\"Create treatment and control versions of data\"\"\"\n",
    "    X_treatment = X.copy(deep=True)\n",
    "    X_control = X.copy(deep=True)\n",
    "    X_treatment.loc[:, 'TRTMT'] = 1\n",
    "    X_control.loc[:, 'TRTMT'] = 0\n",
    "    return X_treatment, X_control\n",
    "\n",
    "def risk_reduction(model, data_treatment, data_control):\n",
    "    \"\"\"Compute predicted risk reduction for each row in data\"\"\"\n",
    "    treatment_risk = model.predict_proba(data_treatment)[:, 1]\n",
    "    control_risk = model.predict_proba(data_control)[:, 1]\n",
    "    return control_risk - treatment_risk"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "E4g3JazHF1G9"
   },
   "source": [
    "Now let's compute the predicted risk reductions of the logistic regression model on the test set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 36,
   "metadata": {},
   "outputs": [],
   "source": [
    "X_test_treated, X_test_untreated = treatment_control(X_test)\n",
    "rr_lr = risk_reduction(lr, X_test_treated, X_test_untreated)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "uv0Yr96aGaeL"
   },
   "source": [
    "Before we evaluate the c-statistic-for-benefit, let's look at a histogram of predicted ARR."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 37,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:51.575460Z",
     "start_time": "2020-04-04T15:31:51.420183Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 444
    },
    "colab_type": "code",
    "id": "Oa0gA4rCGZtU",
    "outputId": "8f8b1896-8276-4101-f488-1453389c62bc"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.hist(rr_lr, bins='auto')\n",
    "plt.title(\"Histogram of Predicted ARR using logistic regression\")\n",
    "plt.ylabel(\"count of patients\")\n",
    "plt.xlabel(\"ARR\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "rTI2xcriG4vi"
   },
   "source": [
    "Note that although it predicts different absolute risk reduction, it never predicts that the treatment will adversely impact risk. This is because the odds ratio of treatment is less than 1, so the model always predicts a decrease in the baseline risk. Run the next cell to compute the c-statistic-for-benefit on the test data."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 38,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:53.895737Z",
     "start_time": "2020-04-04T15:31:53.880107Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 34
    },
    "colab_type": "code",
    "id": "HTgU2BLbGX1B",
    "outputId": "44bd6144-31ca-4a02-e4ce-8f11f139f46d"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Logistic Regression evaluated by C-for-Benefit: 0.5412\n"
     ]
    }
   ],
   "source": [
    "tmp_cstat_test = c_statistic(rr_lr, y_test, X_test.TRTMT)\n",
    "print(f\"Logistic Regression evaluated by C-for-Benefit: {tmp_cstat_test:.4f}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "##### Expected Output\n",
    "```CPP\n",
    "Logistic Regression evaluated by C-for-Benefit: 0.5412\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "o6YQq4LLZdBj"
   },
   "source": [
    "Recall that an c statistic ranges from 0 to 1, and is closer to when the model being evaluated is doing a good job with its predictions.\n",
    "\n",
    "You can see that the model is not doing a great job of predicting risk reduction, given a c-for-benefit of around 0.43."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Regular c-index\n",
    "Let's compare this with the regular C-index which you've applied in previous assignments. Note that the regular c-statistic does not look at pairs of pairs of patients, and just compares one patient to another when evaluating the model's performance.  So the regular c-index is evaluating the model's ability to predict overall patient risk, not necessarily measuring how well the model predicts benefit from treatment."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:31:55.406270Z",
     "start_time": "2020-04-04T15:31:55.400272Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 34
    },
    "colab_type": "code",
    "id": "JRtzA6qyJ5sn",
    "outputId": "4ada7ef3-b746-4ba1-c208-828cf6c8f674"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Logistic Regression evaluated by regular C-index: 0.7785\n"
     ]
    }
   ],
   "source": [
    "from lifelines.utils import concordance_index\n",
    "tmp_regular_cindex = concordance_index(y_test, lr.predict_proba(X_test)[:, 1])\n",
    "print(f\"Logistic Regression evaluated by regular C-index: {tmp_regular_cindex:.4f}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "##### Expected output\n",
    "```CPP\n",
    "Logistic Regression evaluated by regular C-index: 0.7785\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "qRYEhMCOLDjs"
   },
   "source": [
    "You can see that even though the model accurately predicts overall risk (regular c-index), it does not necessarily do a great job predicting benefit from treatment (c-for-benefit). "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "Z_4ogidoLqGd"
   },
   "source": [
    "You can also visually assess the discriminative ability of the model by checking if the people it thinks benefit the most from treatment empirically (actually) experience a benefit. \n",
    "\n",
    "Since you don't have counterfactual results from individuals, you'll need to aggregate patient information in some way. \n",
    "\n",
    "You can group patients by deciles (10 groups) of risk."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:32:02.277354Z",
     "start_time": "2020-04-04T15:32:02.107132Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 458
    },
    "colab_type": "code",
    "id": "aP8ST7ycL-I6",
    "outputId": "6c02ef30-8683-45b3-f3f1-dea8b39c4f79"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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k8aFizh7wowqRWRmRThpWFXMmtPYof5m3UVdXR1Dhw5l66235oADDmDOnDkAvPjii9TX1zN06FAGDx7Ml770JRYuXNjl8TlpWFX0613fof5mtWTRokXtD7SU6uvrmTp1Kk888QR9+vRh7Nixi8s+/vGPM3XqVKZNm8bMmTO57rrrKhZHW3xNw6ritBGDml3TAKjvUcdpIwZVMSqrtCMufLBVv/2HbMCROw+kccEijv7TI63KD9tuQw4fthGz5y3gq1dMblZ27Qk7tzvNUaNG8corrzB//nxOOeUUjj/+eC644AKee+45zj77bAAuu0Au1WsAABCXSURBVOwyJk2axHnnnccVV1zBmDFjWLBgATvuuCN/+MMfqKurY/XVV+eEE07g9ttvZ+zYsdx5553cdNNNNDY2sssuu3DhhRciiYkTJ3Lsscey0korMXz4cP7+97/zxBNPsGjRIk4//XTuvvtuPvjgA0466SROOOGEsrHvvPPOPP74463619XVscMOO9DQ0NDu/Hc2n2lYVYzapj+/POQT9O9dj4D+vev55SGf8EVw63SXXnopkydPZtKkSYwZM4a33nqLQw89lBtvvHHxMNdeey2jR49m+vTpXHvttdx///1MnTqVuro6rrzySgDmzZvHjjvuyGOPPcZuu+3GySefzMSJE3niiSdobGzk5ptvBuCYY47hwgsvXPz9JpdccglrrbUWEydOZOLEiVx88cW88MILbca9aNEi7rjjDg488MBWZfPnz+fhhx9m5MiRnbWYCvOZhlXNqG36O0l0M+XODOpXqStb3me1VQqdWbQ0ZsyYxQnilVde4ZlnnmGnnXZi00035aGHHmLzzTfn6aefZtddd2Xs2LFMnjyZ7bffHoDGxkbWW289IDu6P/TQQxeP96677uLXv/4177//PrNnz2arrbZi9913Z+7cuey8cxbn5z//+cXJ5LbbbuPxxx/n+uuvB+Cdd97hmWeeafU8RWNjI0OHDqWhoYEtt9yS4cOHLy577rnnGDp0KC+88AL77bcfQ4YM6fDyWFYVTRqSRgLnAHXAHyPirBblqwJ/BrYD3gKOiIgXKxlTNdXKcwm1Eoct4XVSGXfffTe33347Dz74IL169WLPPfdc/HT66NGjue6669hiiy04+OCDkUREcNRRR/HLX/6y1bh69uy5+Mxh/vz5fO1rX2PSpEls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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "def quantile_benefit(X, y, arr_hat):\n",
    "    df = X.copy(deep=True)\n",
    "    df.loc[:, 'y'] = y\n",
    "    df.loc[:, 'benefit'] = arr_hat\n",
    "    benefit_groups = pd.qcut(arr_hat, 10)\n",
    "    df.loc[:, 'benefit_groups'] = benefit_groups\n",
    "    empirical_benefit = df.loc[df.TRTMT == 0, :].groupby('benefit_groups').y.mean() - df.loc[df.TRTMT == 1].groupby('benefit_groups').y.mean()\n",
    "    avg_benefit = df.loc[df.TRTMT == 0, :].y.mean() - df.loc[df.TRTMT==1, :].y.mean()\n",
    "    return empirical_benefit, avg_benefit\n",
    "\n",
    "def plot_empirical_risk_reduction(emp_benefit, av_benefit, model):\n",
    "    plt.scatter(range(len(emp_benefit)), emp_benefit)\n",
    "    plt.xticks(range(len(emp_benefit)), range(1, len(emp_benefit) + 1))\n",
    "    plt.title(\"Empirical Risk Reduction vs. Predicted ({})\".format(model))\n",
    "    plt.ylabel(\"Empirical Risk Reduction\")\n",
    "    plt.xlabel(\"Predicted Risk Reduction Quantile\")\n",
    "    plt.plot(range(10), [av_benefit]*10, linestyle='--', label='average RR')\n",
    "    plt.legend(loc='lower right')\n",
    "    plt.show()\n",
    "\n",
    "emp_benefit, avg_benefit = quantile_benefit(X_test, y_test, rr_lr)\n",
    "plot_empirical_risk_reduction(emp_benefit, avg_benefit, \"Logistic Regression\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "YZM3WZ2fPvOn"
   },
   "source": [
    "If the model performed well, then you would see patients in the higher deciles of predicted risk reduction (on the right) also have higher empirical risk reduction (to the top).  \n",
    "\n",
    "This model using logistic regression is far from perfect. \n",
    "\n",
    "Below, you'll see if you can do better using a more flexible machine learning approach."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "JL8ET3lk9r02"
   },
   "source": [
    "<a name=\"4\"></a>\n",
    "## 4. Machine Learning Approaches "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "-oOkd5juz5To"
   },
   "source": [
    "<a name=\"4-1\"></a>\n",
    "### 4.1 T-Learner\n",
    "\n",
    "Now you will see how recent machine learning approaches compare to the more standard analysis. The approach we'll look at is called [T-learner](https://arxiv.org/pdf/1706.03461.pdf).\n",
    "- \"T\" stands for \"two\". \n",
    "- The T-learner learns two different models, one for treatment risk, and another model for control risk.\n",
    "- Then takes the difference of the two risk predictions to predict the risk reduction.\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a name='ex-9'></a>\n",
    "### Exercise 9 - TLearner()\n",
    "\n",
    "- The constructor `__init__()` sets the treatment and control estimators based on the given inputs to the constructor.\n",
    "- The `predict` function takes the featuers and uses each estimator to predit the risk of death.  Then it calculates the risk of death for the control estimator minus the risk of death from the treatment estimator, and returns this as the predicted risk reduction."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:32:06.599363Z",
     "start_time": "2020-04-04T15:32:06.589258Z"
    },
    "colab": {},
    "colab_type": "code",
    "id": "DNu5yqylUtN8"
   },
   "outputs": [],
   "source": [
    "# UNQ_C9 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "class TLearner():\n",
    "    \"\"\"\n",
    "    T-Learner class.\n",
    "\n",
    "    Attributes:\n",
    "      treatment_estimator (object): fitted model for treatment outcome\n",
    "      control_estimator (object): fitted model for control outcome\n",
    "    \"\"\"                               \n",
    "    def __init__(self, treatment_estimator, control_estimator):\n",
    "        \"\"\"\n",
    "        Initializer for TLearner class.\n",
    "        \"\"\"\n",
    "        ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "        # set the treatment estimator\n",
    "        self.treatment_estimator = treatment_estimator\n",
    "        \n",
    "        # set the control estimator \n",
    "        self.control_estimator = control_estimator\n",
    "        \n",
    "        ### END CODE HERE ###\n",
    "\n",
    "    def predict(self, X):\n",
    "        \"\"\"\n",
    "        Return predicted risk reduction for treatment for given data matrix.\n",
    "\n",
    "        Args:\n",
    "          X (dataframe): dataframe containing features for each subject\n",
    "    \n",
    "        Returns:\n",
    "          preds (np.array): predicted risk reduction for each row of X\n",
    "        \"\"\"\n",
    "        ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "        # predict the risk of death using the control estimator\n",
    "        risk_control = self.control_estimator.predict_proba(X)[:,1]\n",
    "        \n",
    "        # predict the risk of death using the treatment estimator\n",
    "        risk_treatment = self.treatment_estimator.predict_proba(X)[:,1]\n",
    "        \n",
    "        # the predicted risk reduction is control risk minus the treatment risk\n",
    "        pred_risk_reduction =  risk_control - risk_treatment\n",
    "        \n",
    "        ### END CODE HERE ###\n",
    "                \n",
    "        return pred_risk_reduction"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Tune the model with grid search\n",
    "\n",
    "In order to tune your two models, you will use grid search to find the desired parameters.\n",
    "- You will use a validation set to evaluate the model on different parameters, in order to avoid overfitting to the training set.\n",
    "\n",
    "To test models on all combinations of hyperparameters, you can first list out all of the values in a list of lists.\n",
    "For example:\n",
    "```CPP\n",
    "hyperparams = {\n",
    "    'n_estimators': [10, 20],\n",
    "    'max_depth': [2, 5],\n",
    "    'min_samples_leaf': [0.1, 0.2]\n",
    "}\n",
    "```\n",
    "You can generate a list like this:\n",
    "```CPP\n",
    "[[10, 20],\n",
    " [2, 5], \n",
    " [0.1, 0.2]\n",
    "]\n",
    "```\n",
    "\n",
    "Next, you can get all combinations of the hyperparameter values:\n",
    "```CPP\n",
    "[(10, 2, 0.1),\n",
    " (10, 2, 0.2),\n",
    " (10, 5, 0.1),\n",
    " (10, 5, 0.2),\n",
    " (20, 2, 0.1),\n",
    " (20, 2, 0.2),\n",
    " (20, 5, 0.1),\n",
    " (20, 5, 0.2)]\n",
    "```\n",
    "\n",
    "To feed the hyperparameters into an random forest model, you can use a dictionary, so that you do not need to hard code the parameter names.\n",
    "For example, instead of\n",
    "```CPP\n",
    "RandomForestClassifier(n_estimators= 20, max_depth=5, min_samples_leaf=0.2)\n",
    "```\n",
    "\n",
    "You have more flexibility if you create a dictionary and pass it into the model.\n",
    "```CPP\n",
    "args_d = {'n_estimators': 20, 'max_depth': 5, 'min_samples_leaf': 0.2}\n",
    "RandomForestClassifier(**args_d)\n",
    "```\n",
    "This allows you to pass in a hyperparameter dictionary for any hyperpameters, not just `n_estimators`, `max_depth`, and `min_samples_leaf`.\n",
    "\n",
    "So you'll find a way to generate a list of dictionaries, like this:\n",
    "```CPP\n",
    "[{'n_estimators': 10, 'max_depth': 2, 'min_samples_leaf': 0.1},\n",
    " {'n_estimators': 10, 'max_depth': 2, 'min_samples_leaf': 0.2},\n",
    " {'n_estimators': 10, 'max_depth': 5, 'min_samples_leaf': 0.1},\n",
    " {'n_estimators': 10, 'max_depth': 5, 'min_samples_leaf': 0.2},\n",
    " {'n_estimators': 20, 'max_depth': 2, 'min_samples_leaf': 0.1},\n",
    " {'n_estimators': 20, 'max_depth': 2, 'min_samples_leaf': 0.2},\n",
    " {'n_estimators': 20, 'max_depth': 5, 'min_samples_leaf': 0.1},\n",
    " {'n_estimators': 20, 'max_depth': 5, 'min_samples_leaf': 0.2}]\n",
    "```\n",
    "\n",
    "Notice how the values in both the list of tuples and list of dictionaries are in the same order as the original hyperparams dictionary.  For example, the first value in each is n_estimarors, then max_depth, and then min_samples_leaf:\n",
    "```CPP\n",
    "# list of lists\n",
    "(10, 2, 0.1)\n",
    "\n",
    "# list of dictionaries\n",
    "{'n_estimators': 10, 'max_depth': 2, 'min_samples_leaf': 0.1}\n",
    "```\n",
    "\n",
    "\n",
    "\n",
    "Then for each dictionary of hyperparams:\n",
    "- Train a model.\n",
    "- Use the regular concordance index to compare their performances.  \n",
    "- Identify and return the best performing model."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<a name='ex-10'></a>\n",
    "### Exercise 10 - holdout_grid_search\n",
    "\n",
    "Implement hold out grid search.  \n",
    "##### Note\n",
    "In this case, you are not going to apply k-fold cross validation.  Since `sklearn.model_selection.GridSearchCV()` applies k-fold cross validation, you won't be using this to perform grid search, and you will implement your own grid search.\n",
    "\n",
    "Please see the hints if you get stuck."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Hints</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li>You can use the .items() or .values() method of a dictionary to get its key, value pairs or just values.  Use a list() to store them inside a list.</li>\n",
    "    <li>To get all combinations of the hyperparams, you can use itertools.product(*args_list), where args_list is a list object.</li>\n",
    "    <li>To generate the list of dictionaries, loop through the list of tuples.</li>\n",
    "</ul>\n",
    "</p>\n"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 42,
   "metadata": {},
   "outputs": [],
   "source": [
    "# UNQ_C10 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def holdout_grid_search(clf, X_train_hp, y_train_hp, X_val_hp, y_val_hp, hyperparam, verbose=False):\n",
    "    '''\n",
    "    Conduct hyperparameter grid search on hold out validation set. Use holdout validation.\n",
    "    Hyperparameters are input as a dictionary mapping each hyperparameter name to the\n",
    "    range of values they should iterate over. Use the cindex function as your evaluation\n",
    "    function.\n",
    "    \n",
    "    Input:\n",
    "        clf: sklearn classifier\n",
    "        X_train_hp (dataframe): dataframe for training set input variables\n",
    "        y_train_hp (dataframe): dataframe for training set targets\n",
    "        X_val_hp (dataframe): dataframe for validation set input variables\n",
    "        y_val_hp (dataframe): dataframe for validation set targets\n",
    "        hyperparam (dict): hyperparameter dictionary mapping hyperparameter\n",
    "                                                names to range of values for grid search\n",
    "    \n",
    "    Output:\n",
    "        best_estimator (sklearn classifier): fitted sklearn classifier with best performance on\n",
    "                                                                                 validation set\n",
    "    '''\n",
    "    # Initialize best estimator\n",
    "    best_estimator = None\n",
    "    \n",
    "    # initialize best hyperparam\n",
    "    best_hyperparam = {}\n",
    "    \n",
    "    # initialize the c-index best score to zero\n",
    "    best_score = 0.0\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "    \n",
    "    # Get the values of the hyperparam and store them as a list of lists\n",
    "    hyper_param_l = [v for v in hyperparam.values()]\n",
    "    \n",
    "    # Generate a list of tuples with all possible combinations of the hyperparams\n",
    "    combination_l_of_t = list(itertools.product(*hyper_param_l))\n",
    "    \n",
    "    # Initialize the list of dictionaries for all possible combinations of hyperparams\n",
    "    combination_l_of_d = []\n",
    "    \n",
    "    # loop through each tuple in the list of tuples\n",
    "    for val_tuple in combination_l_of_t: # complete this line\n",
    "        param_d = {}\n",
    "        \n",
    "        # Enumerate each key in the original hyperparams dictionary\n",
    "        for i, k in enumerate(hyperparam.keys()): # complete this line\n",
    "            \n",
    "            # add a key value pair to param_d for each value in val_tuple\n",
    "            param_d[k] = val_tuple[i]\n",
    "        \n",
    "        # append the param_dict to the list of dictionaries\n",
    "        combination_l_of_d.append(param_d)\n",
    "        \n",
    "    \n",
    "    # For each hyperparam dictionary in the list of dictionaries:\n",
    "    for param_d in combination_l_of_d: # complete this line\n",
    "        \n",
    "        # Set the model to the given hyperparams\n",
    "        estimator = clf(**param_d)\n",
    "        \n",
    "        # Train the model on the training features and labels\n",
    "        estimator.fit(X_train_hp,y_train_hp)\n",
    "        \n",
    "        # Predict the risk of death using the validation features\n",
    "        preds = estimator.predict(X_val_hp)\n",
    "        \n",
    "        # Evaluate the model's performance using the regular concordance index\n",
    "        estimator_score = concordance_index(y_val_hp, preds)\n",
    "        \n",
    "        # if the model's c-index is better than the previous best:\n",
    "        if estimator_score > best_score: # complete this line\n",
    "\n",
    "            # save the new best score\n",
    "            best_score = estimator_score\n",
    "            \n",
    "            # same the new best estimator\n",
    "            best_estimator = estimator\n",
    "            \n",
    "            # save the new best hyperparams\n",
    "            best_hyperparam = param_d\n",
    "                \n",
    "    ### END CODE HERE ###\n",
    "\n",
    "    if verbose:\n",
    "        print(\"hyperparam:\")\n",
    "        display(hyperparam)\n",
    "        \n",
    "        print(\"hyper_param_l\")\n",
    "        display(hyper_param_l)\n",
    "        \n",
    "        print(\"combination_l_of_t\")\n",
    "        display(combination_l_of_t)\n",
    "        \n",
    "        print(f\"combination_l_of_d\")\n",
    "        display(combination_l_of_d)\n",
    "        \n",
    "        print(f\"best_hyperparam\")\n",
    "        display(best_hyperparam)\n",
    "        print(f\"best_score: {best_score:.4f}\")\n",
    "        \n",
    "    return best_estimator, best_hyperparam"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 43,
   "metadata": {
    "deletable": false,
    "editable": false,
    "scrolled": false
   },
   "outputs": [
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "/opt/conda/lib/python3.6/site-packages/sklearn/ensemble/weight_boosting.py:29: DeprecationWarning: numpy.core.umath_tests is an internal NumPy module and should not be imported. It will be removed in a future NumPy release.\n",
      "  from numpy.core.umath_tests import inner1d\n"
     ]
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "hyperparam:\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "{'n_estimators': [10, 20],\n",
       " 'max_depth': [2, 5],\n",
       " 'min_samples_leaf': [0.1, 0.2],\n",
       " 'random_state': [0]}"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "hyper_param_l\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "[[10, 20], [2, 5], [0.1, 0.2], [0]]"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "combination_l_of_t\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "[(10, 2, 0.1, 0),\n",
       " (10, 2, 0.2, 0),\n",
       " (10, 5, 0.1, 0),\n",
       " (10, 5, 0.2, 0),\n",
       " (20, 2, 0.1, 0),\n",
       " (20, 2, 0.2, 0),\n",
       " (20, 5, 0.1, 0),\n",
       " (20, 5, 0.2, 0)]"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "combination_l_of_d\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "[{'n_estimators': 10,\n",
       "  'max_depth': 2,\n",
       "  'min_samples_leaf': 0.1,\n",
       "  'random_state': 0},\n",
       " {'n_estimators': 10,\n",
       "  'max_depth': 2,\n",
       "  'min_samples_leaf': 0.2,\n",
       "  'random_state': 0},\n",
       " {'n_estimators': 10,\n",
       "  'max_depth': 5,\n",
       "  'min_samples_leaf': 0.1,\n",
       "  'random_state': 0},\n",
       " {'n_estimators': 10,\n",
       "  'max_depth': 5,\n",
       "  'min_samples_leaf': 0.2,\n",
       "  'random_state': 0},\n",
       " {'n_estimators': 20,\n",
       "  'max_depth': 2,\n",
       "  'min_samples_leaf': 0.1,\n",
       "  'random_state': 0},\n",
       " {'n_estimators': 20,\n",
       "  'max_depth': 2,\n",
       "  'min_samples_leaf': 0.2,\n",
       "  'random_state': 0},\n",
       " {'n_estimators': 20,\n",
       "  'max_depth': 5,\n",
       "  'min_samples_leaf': 0.1,\n",
       "  'random_state': 0},\n",
       " {'n_estimators': 20,\n",
       "  'max_depth': 5,\n",
       "  'min_samples_leaf': 0.2,\n",
       "  'random_state': 0}]"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "best_hyperparam\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "{'n_estimators': 20,\n",
       " 'max_depth': 2,\n",
       " 'min_samples_leaf': 0.1,\n",
       " 'random_state': 0}"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    },
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "best_score: 0.5986\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex10: you cannot edit this cell\n",
    "holdout_grid_search_test(holdout_grid_search, X_dev, y_dev)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "T-Learner is a convenient framework because it does not restrict your choice of base learners.\n",
    "- You will use random forests as the base learners, but are able to choose another model as well."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "\n",
    "```\n",
    "hyperparam:\n",
    "{'n_estimators': [10, 20],\n",
    " 'max_depth': [2, 5],\n",
    " 'min_samples_leaf': [0.1, 0.2],\n",
    " 'random_state': [0]}\n",
    "hyper_param_l\n",
    "[[10, 20], [2, 5], [0.1, 0.2], [0]]\n",
    "combination_l_of_t\n",
    "[(10, 2, 0.1, 0),\n",
    " (10, 2, 0.2, 0),\n",
    " (10, 5, 0.1, 0),\n",
    " (10, 5, 0.2, 0),\n",
    " (20, 2, 0.1, 0),\n",
    " (20, 2, 0.2, 0),\n",
    " (20, 5, 0.1, 0),\n",
    " (20, 5, 0.2, 0)]\n",
    "combination_l_of_d\n",
    "[{'n_estimators': 10,\n",
    "  'max_depth': 2,\n",
    "  'min_samples_leaf': 0.1,\n",
    "  'random_state': 0},\n",
    " {'n_estimators': 10,\n",
    "  'max_depth': 2,\n",
    "  'min_samples_leaf': 0.2,\n",
    "  'random_state': 0},\n",
    " {'n_estimators': 10,\n",
    "  'max_depth': 5,\n",
    "  'min_samples_leaf': 0.1,\n",
    "  'random_state': 0},\n",
    " {'n_estimators': 10,\n",
    "  'max_depth': 5,\n",
    "  'min_samples_leaf': 0.2,\n",
    "  'random_state': 0},\n",
    " {'n_estimators': 20,\n",
    "  'max_depth': 2,\n",
    "  'min_samples_leaf': 0.1,\n",
    "  'random_state': 0},\n",
    " {'n_estimators': 20,\n",
    "  'max_depth': 2,\n",
    "  'min_samples_leaf': 0.2,\n",
    "  'random_state': 0},\n",
    " {'n_estimators': 20,\n",
    "  'max_depth': 5,\n",
    "  'min_samples_leaf': 0.1,\n",
    "  'random_state': 0},\n",
    " {'n_estimators': 20,\n",
    "  'max_depth': 5,\n",
    "  'min_samples_leaf': 0.2,\n",
    "  'random_state': 0}]\n",
    "best_hyperparam\n",
    "{'n_estimators': 10,\n",
    " 'max_depth': 2,\n",
    " 'min_samples_leaf': 0.1,\n",
    " 'random_state': 0}\n",
    " \n",
    "best_score: 0.5928\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "O-BkhCwzIEYT"
   },
   "source": [
    "<a name='ex-11'></a>\n",
    "### Exercise 11 - treatment_dataset_split\n",
    "\n",
    "- Unlike logistic regression, the machine learning algorithms used for base learners will generally require hyperparameter tuning, which means that you need to split your dev set into a training and validation set. \n",
    "- You need to also split each of the training and validation sets into *treatment* and *control* groups to train the treatment and control base learners of the T-Learner.\n",
    "\n",
    "The function below takes in a dev dataset and splits it into training and validation sets for treatment and control models, respectively. \n",
    "Complete the implementation. \n",
    "\n",
    "#### Note\n",
    "- The input X_train and X_val have the 'TRTMT' column.  Please remove the 'TRTMT' column from the treatment and control features that the function returns."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "<details>    \n",
    "<summary>\n",
    "    <font size=\"3\" color=\"darkgreen\"><b>Hints</b></font>\n",
    "</summary>\n",
    "<p>\n",
    "<ul>\n",
    "    <li> To drop a column, set the axis to 1 when calling pandas.DataFrame.drop(...). Axis=0 is used to drop a row by its index label)</li>\n",
    "</ul>\n",
    "</p>"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 44,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:32:18.317025Z",
     "start_time": "2020-04-04T15:32:18.270158Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 136
    },
    "colab_type": "code",
    "id": "_bY3HlR0f67D",
    "outputId": "e76019bd-67ef-48c3-a53d-c405ab48b926"
   },
   "outputs": [],
   "source": [
    "# UNQ_C11 (UNIQUE CELL IDENTIFIER, DO NOT EDIT)\n",
    "def treatment_dataset_split(X_train, y_train, X_val, y_val):\n",
    "    \"\"\"\n",
    "    Separate treated and control individuals in training\n",
    "    and testing sets. Remember that returned\n",
    "    datasets should NOT contain the 'TRTMT' column!\n",
    "\n",
    "    Args:\n",
    "        X_train (dataframe): dataframe for subject in training set\n",
    "        y_train (np.array): outcomes for each individual in X_train\n",
    "        X_val (dataframe): dataframe for subjects in validation set\n",
    "        y_val (np.array): outcomes for each individual in X_val\n",
    "    \n",
    "    Returns:\n",
    "        X_treat_train (df): training set for treated subjects\n",
    "        y_treat_train (np.array): labels for X_treat_train\n",
    "        X_treat_val (df): validation set for treated subjects\n",
    "        y_treat_val (np.array): labels for X_treat_val\n",
    "        X_control_train (df): training set for control subjects\n",
    "        y_control_train (np.array): labels for X_control_train\n",
    "        X_control_val (np.array): validation set for control subjects\n",
    "        y_control_val (np.array): labels for X_control_val\n",
    "    \"\"\"\n",
    "    \n",
    "    ### START CODE HERE (REPLACE INSTANCES OF 'None' with your code) ###\n",
    "    \n",
    "    # From the training set, get features of patients who received treatment\n",
    "    X_treat_train = X_train[X_train['TRTMT'] == 1]\n",
    "    \n",
    "    # drop the 'TRTMT' column\n",
    "    X_treat_train = X_treat_train.drop(['TRTMT'], axis=1)\n",
    "    \n",
    "    # From the training set, get the labels of patients who received treatment\n",
    "    y_treat_train = y_train[X_train['TRTMT'] == 1]\n",
    "\n",
    "    # From the validation set, get the features of patients who received treatment\n",
    "    X_treat_val = X_val[X_val['TRTMT'] == 1]\n",
    "                        \n",
    "    # Drop the 'TRTMT' column\n",
    "    X_treat_val = X_treat_val.drop(['TRTMT'], axis=1)\n",
    "                        \n",
    "    # From the validation set, get the labels of patients who received treatment\n",
    "    y_treat_val = y_val[X_val['TRTMT'] == 1]\n",
    "                        \n",
    "# --------------------------------------------------------------------------------------------\n",
    "                        \n",
    "    # From the training set, get the features of patients who did not received treatment\n",
    "    X_control_train = X_train[X_train['TRTMT'] == 0]\n",
    "                        \n",
    "    # Drop the TRTMT column\n",
    "    X_control_train = X_control_train.drop(['TRTMT'], axis=1)\n",
    "                        \n",
    "    # From the training set, get the labels of patients who did not receive treatment\n",
    "    y_control_train = y_train[X_train['TRTMT'] == 0]\n",
    "    \n",
    "    # From the validation set, get the features of patients who did not receive treatment\n",
    "    X_control_val = X_val[X_val['TRTMT'] == 0]\n",
    "    \n",
    "    # drop the 'TRTMT' column\n",
    "    X_control_val = X_control_val.drop(['TRTMT'], axis=1)\n",
    "\n",
    "    # From the validation set, get teh labels of patients who did not receive treatment\n",
    "    y_control_val = y_val[X_val['TRTMT'] == 0]\n",
    "    \n",
    "    ### END CODE HERE ###\n",
    "\n",
    "    return (X_treat_train, y_treat_train,\n",
    "            X_treat_val, y_treat_val,\n",
    "            X_control_train, y_control_train,\n",
    "            X_control_val, y_control_val)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 45,
   "metadata": {
    "deletable": false,
    "editable": false
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Tests:\n",
      "\n",
      "Didn't lose any subjects: True\n",
      "\n",
      "TRTMT not in any splits: True\n",
      "\n",
      "Treated splits have all treated patients: True\n",
      "\n",
      "All subjects in control split are untreated: True\n",
      "\n",
      "No overlap between treat_train and treat_val: True\n",
      "\n",
      "No overlap between control_train and control_val: True\n",
      "\n",
      "--> Expected: All statements should be True\n",
      "\n",
      "\u001b[92m All tests passed.\n"
     ]
    }
   ],
   "source": [
    "### test cell ex11: you cannot edit this cell\n",
    "treatment_dataset_split_test(treatment_dataset_split)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "#### Expected Output:\n",
    "```\n",
    "Tests:\n",
    "\n",
    "Didn't lose any subjects: True\n",
    "\n",
    "TRTMT not in any splits: True\n",
    "\n",
    "Treated splits have all treated patients: True\n",
    "\n",
    "All subjects in control split are untreated: True\n",
    "\n",
    "No overlap between treat_train and treat_val: True\n",
    "\n",
    "No overlap between control_train and control_val: True\n",
    "\n",
    "--> Expected: All statements should be True\n",
    "\n",
    " All tests passed.\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "You will now train a T-learner model on the patient data, and evaluate its performance using the c-for-benefit.\n",
    "\n",
    "First, get the training and validation sets."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 46,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Import the random forest classifier to be used as the base learner\n",
    "from sklearn.ensemble import RandomForestClassifier\n",
    "\n",
    "# Split the dev data into train and validation sets\n",
    "X_train, X_val, y_train, y_val = train_test_split(X_dev, \n",
    "                                                  y_dev, \n",
    "                                                  test_size = 0.25,\n",
    "                                                  random_state = 0)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Split the training set into a treatment and control set.  \n",
    "Similarly, split the validation set into a treatment and control set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 47,
   "metadata": {},
   "outputs": [],
   "source": [
    "# get treatment and control arms of training and validation sets\n",
    "(X_treat_train, y_treat_train, \n",
    " X_treat_val, y_treat_val,\n",
    " X_control_train, y_control_train,\n",
    " X_control_val, y_control_val) = treatment_dataset_split(X_train, y_train,\n",
    "                                                         X_val, y_val)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Choose a set of hyperparameters to perform grid search and find the best model.  \n",
    "- Please first use these given hyperparameters so that you can get the same c-for-benefit calculation at the end of this exercise. \n",
    "- Afterwards, we encourage you to come back and try other ranges for these hyperparameters. \n",
    "\n",
    "```CPP\n",
    "# Given hyperparams to do grid search\n",
    "hyperparams = {\n",
    "    'n_estimators': [100, 200],\n",
    "    'max_depth': [2, 5, 10, 40, None],\n",
    "    'min_samples_leaf': [1, 0.1, 0.2]\n",
    "    'random_state': [0]\n",
    "}\n",
    "```"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "metadata": {},
   "outputs": [],
   "source": [
    "# hyperparameter grid (we'll use the same one for both arms for convenience)\n",
    "# Note that we set the random_state to 0\n",
    "# in order to get consistent outputs each time the code is run,\n",
    "hyperparams = {\n",
    "    'n_estimators': [100, 200],\n",
    "    'max_depth': [2, 5, 10, 40, None],\n",
    "    'min_samples_leaf': [1, 0.1, 0.2],\n",
    "    'random_state': [0]\n",
    "}"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Train the treatment base learner.  \n",
    "- Perform grid search to find a random forest classifier and associated hyperparameters with the best c-index (the regular c-index)."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "metadata": {},
   "outputs": [],
   "source": [
    "# perform grid search with the treatment data to find the best model \n",
    "treatment_model, best_hyperparam_treat  = holdout_grid_search(RandomForestClassifier,\n",
    "                                      X_treat_train, y_treat_train,\n",
    "                                      X_treat_val, y_treat_val, hyperparams)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Train the control base learner."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "metadata": {},
   "outputs": [],
   "source": [
    "# perform grid search with the control data to find the best model \n",
    "control_model, best_hyperparam_ctrl = holdout_grid_search(RandomForestClassifier,\n",
    "                                    X_control_train, y_control_train,\n",
    "                                    X_control_val, y_control_val, hyperparams)\n"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Combine the treatment and control base learners into the T-learner."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 51,
   "metadata": {},
   "outputs": [],
   "source": [
    "# Save the treatment and control models into an instance of the TLearner class\n",
    "t_learner = TLearner(treatment_model, control_model)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "For the validation set, predict each patient's risk reduction."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 52,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "X_val num of patients 114\n",
      "rr_t_val num of patient predictions 114\n"
     ]
    }
   ],
   "source": [
    "# Use the t-learner to predict the risk reduction for patients in the validation set\n",
    "rr_t_val = t_learner.predict(X_val.drop(['TRTMT'], axis=1))\n",
    "\n",
    "print(f\"X_val num of patients {X_val.shape[0]}\")\n",
    "print(f\"rr_t_val num of patient predictions {rr_t_val.shape[0]}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "xYX1rN1tIv4w"
   },
   "source": [
    "Now plot a histogram of your predicted risk reduction on the validation set. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 53,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:32:34.703743Z",
     "start_time": "2020-04-04T15:32:34.529749Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 444
    },
    "colab_type": "code",
    "id": "XISgvb6IiXnl",
    "outputId": "6850488a-51aa-4bad-a151-1bcf9a7573bc"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "plt.hist(rr_t_val, bins='auto')\n",
    "plt.title(\"Histogram of Predicted ARR, T-Learner, validation set\")\n",
    "plt.xlabel('predicted risk reduction')\n",
    "plt.ylabel('count of patients')\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "V89cP4pxQhNo"
   },
   "source": [
    "Notice when viewing the histogram that predicted risk reduction can be negative.\n",
    "- This means that for some patients, the T-learner predicts that treatment will actually increase their risk (negative risk reduction). \n",
    "- The T-learner is more flexible compared to the logistic regression model, which only predicts non-negative risk reduction for all patients (view the earlier histogram of the 'predicted ARR' histogram for the logistic regression model, and you'll see that the possible values are all non-negative)."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "noMOc9kOI5cw"
   },
   "source": [
    "Now plot an empirical risk reduction plot for the validation set examples. "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 54,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:32:38.119651Z",
     "start_time": "2020-04-04T15:32:37.941488Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 458
    },
    "colab_type": "code",
    "id": "S-0nbpSkJFmZ",
    "outputId": "13afaa75-71e8-4f7f-fa25-78da6cefe18a"
   },
   "outputs": [
    {
     "data": {
      "image/png": "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W17TgKOBM9L/vxVZZgbQV9KWEbEY+AjQXLsQzawW5s+fz6abbsqQIUOQVO9w1msRwcsvv8z8+fMZOnRoxddfr2soZwAHSJoH7J/GkdQk6Q8AEbEa+BZwi6Q5gIDz6xSvmVXJ8uXL2WKLLZxMakASW2yxRdXOButyhhIRLwP7FZneDHwhb/wmYFQNQzOzOnAyqZ1qbms/KW9mZhXhhGJm1oM0NDQwevRodtppJw455BCWLl0KwDPPPENjYyOjR49m5MiRfP7zn2flypU1jc0JxcyswlavXl21dTc2NjJ79mwefvhh+vfvzznnnLNm3rvf/W5mz57NnDlzmD9/PldeeWXV4ijGPTaaWbdy1Ln3tJl28Kht+NxeQ2hZsZpj/nh/m/kf33Uwn2jaliXLVvClS2a2mnfFiXuVLG/8+PE899xzLF++nJNPPpkTTjiB3//+9zz55JNMnjwZgIsuuojm5mbOPvtsLrnkEs4880xWrFjBHnvswW9/+1saGhrYZJNNOPHEE7n55ps555xzuPXWW7nmmmtoaWnh/e9/P+eeey6SmDFjBscddxwbbLABBxxwADfccAMPP/wwq1ev5tRTT+X222/n3//+N1/5ylc48cQTS8a+11578dBDD7WZ3tDQwO67786CBQtKvr7SfIZiZm9rF154ITNnzqS5uZkzzzyTl19+mSOPPJKrr756zTJXXHEFEyZM4LHHHuOKK67g7rvvZvbs2TQ0NPCXv/wFgGXLlrHHHnvw4IMP8oEPfICTTjqJGTNm8PDDD9PS0sK1114LwLHHHsu555675vU5F1xwAZtvvjkzZsxgxowZnH/++Tz99NPtxr169WpuueUWDj300Dbzli9fzn333ce4ceMqtZnK4jMUM+tWSp1RNG7UUHJ+/4036vCMpNCZZ565Jnk899xzzJs3jz333JN3vetd3HvvvQwbNozHH3+cvffem3POOYeZM2ey2267AdDS0sJWW20FZGcFRx555Jr13nbbbfziF7/gzTffZMmSJey444588IMf5PXXX2evvbIYP/3pT69JNDfeeCMPPfQQV111FQCvvvoq8+bNa/O8SEtLC6NHj2bBggWMGDGCAw44YM28J598ktGjR/P0009z0EEHMWpUbW+SdUKxbmvqrAVMnj6XhUtbGNi3kYljhzN+zKB6h2Xrkdtvv52bb76Ze+65hz59+rDvvvuueUZjwoQJXHnlleywww4cfvjhSCIiOProozn99NPbrKt3795rzjiWL1/Ol7/8ZZqbm9l222057bTTOnz2IyI466yzGDt2bMnlctdQ3nzzTcaOHcs555zD1772NWDtNZSXXnqJvffem2nTphU9g6kWV3lZtzR11gImTZnDgqUtBLBgaQuTpsxh6qza1gnb+u3VV1+lX79+9OnTh8cff5x77713zbzDDz+cv/3tb1x22WVMmDABgP3224+rrrqKF1/MWotasmQJzz77bJv15pLHgAEDeOONN9acdfTt25dNN92U++67D4DLL798zWvGjh3L7373uzV3Zv3zn/9k2bJl7cbep08fzjzzTH75y1+yatWqVvMGDBjAGWecUTTxVZMTinVLk6fPpWVl6ztlWlauZvL0uXWKyNZH48aNY9WqVYwYMYJTTz2VPffcc828fv36MWLECJ599ll23313AEaOHMlPf/pTPvrRjzJq1CgOOOAAFi1a1Ga9ffv25fjjj2ennXZi7Nixa6rIILtWcvzxxzN69GiWLVvG5ptvDsAXvvAFRo4cyS677MJOO+3EiSee2CZRFBozZgyjRo3isssuazNv/PjxvPnmm9x1113rtG3WhSLWr8Z5m5qaornZTX71dENPvY5ie6aAp884qNbhWBU99thjjBgxot5h1Mwbb7zBJptsAsAZZ5zBokWL+M1vflPTGIptc0kzI6KpK+v1NRTrlgb2bWTB0pai0816suuuu47TTz+dVatWsf3223PRRRfVO6SKcUKxbmni2OFMmjKnVbVXY68GJo4dXseozLruqKOO4qijjqp3GFXhhGLdUu5uLt/l9fYQEW4gskaqeZnDCcW6rfFjBjmBvA307t2bl19+2U3Y10CuP5TevXtXZf1OKGZWV4MHD2b+/PksXry43qG8LeR6bKwGJxQzq6tevXpVpfdAqz0/h2JmZhXhhGJmZhXhhGJmZhWx3j0pL2kx0LZxnfINAF6qUDg9OQZwHIUcR2vdIY7uEAOsH3FsHxFbdqXw9S6hdJWk5q42P7A+xOA4HEdPiKM7xOA41nKVl5mZVYQTipmZVYQTSlvn1TsAukcM4DgKOY7WukMc3SEGcByAr6GYmVmF+AzFzMwqwgnFzMwqwgklkXShpBclPVzHGLaVdJukRyU9IunkOsXRW9L9kh5McfyoHnGk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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "empirical_benefit, avg_benefit = quantile_benefit(X_val, y_val, rr_t_val)\n",
    "plot_empirical_risk_reduction(empirical_benefit, avg_benefit, 'T Learner [val set]')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "w8F2N-Zje8dB"
   },
   "source": [
    "Recall that the predicted risk reduction is along the horizontal axis and the vertical axis is the empirical (actual risk reduction).\n",
    "\n",
    "A good model would predict a lower risk reduction for patients with actual lower risk reduction.  Similarly, a good model would predict a higher risk reduction for patients with actual higher risk reduction (imagine a diagonal line going from the bottom left to the top right of the plot).\n",
    "\n",
    "The T-learner seems to be doing a bit better (compared to the logistic regression model) at differentiating between the people who would benefit most treatment and the people who would benefit least from treatment."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "CzcjvmxKJWlN"
   },
   "source": [
    "Compute the C-statistic-for-benefit on the validation set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 55,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:32:40.675054Z",
     "start_time": "2020-04-04T15:32:40.671084Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 34
    },
    "colab_type": "code",
    "id": "blwOcph5JVnV",
    "outputId": "4f359278-db85-4296-a717-87d6175465cc"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "C-for-benefit statistic of T-learner on val set: 0.5123\n"
     ]
    }
   ],
   "source": [
    "c_for_benefit_tlearner_val_set = c_statistic(rr_t_val, y_val, X_val.TRTMT)\n",
    "print(f\"C-for-benefit statistic of T-learner on val set: {c_for_benefit_tlearner_val_set:.4f}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "##### Expected output\n",
    "\n",
    "```CPP\n",
    "C-for-benefit statistic of T-learner on val set: 0.5043\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "yWo27MRmJoa0"
   },
   "source": [
    "Now or the test set, predict each patient's risk reduction"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 56,
   "metadata": {},
   "outputs": [],
   "source": [
    "# predict the risk reduction for each of the patients in the test set\n",
    "rr_t_test = t_learner.predict(X_test.drop(['TRTMT'], axis=1))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Plot the histogram of risk reduction for the test set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 57,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Plot a histogram of the predicted risk reduction\n",
    "plt.hist(rr_t_test, bins='auto')\n",
    "plt.title(\"Histogram of Predicted ARR for the T-learner on test set\")\n",
    "plt.xlabel(\"predicted risk reduction\")\n",
    "plt.ylabel(\"count of patients\")\n",
    "plt.show()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Plot the predicted versus empircal risk reduction for the test set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 58,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "image/png": "iVBORw0KGgoAAAANSUhEUgAAAZYAAAEWCAYAAABFSLFOAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjAsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8GearUAAAgAElEQVR4nO3dd5hdVbnH8e+PIZAJLYQEJKEkKAZCxARCkyIKmCAtNMm1UKQqCFhQUK8ieiXKtdCkY1CkiRACiKGXS01CAqFFWoAUagglTEzhvX/sdcKemTNnziSnzITf53nmmd3OXu/ZZ5/z7rXLWooIzMzMKmWFegdgZmbLFycWMzOrKCcWMzOrKCcWMzOrKCcWMzOrKCcWMzOrKCeWFiS9L2mjEvPPl/Tfy1jGzpJmLMPrb5F0SBnLhaRPLW05S0vS3ZKOqMJ6fyzp4kqvtyvKf7aV2CfLLPNQSf/XzjL3Sxpa7Vg6M0l9JD0jqbHesSwtSetIelrSyrlp35H0m3Je3yUSi6TpkprSj37h75xqlBURq0bECyXmHxMRv6xG2QXpR2Neep8zJf1eUkMuht0j4rIKltc/lVnYttMlnVyp9S9lTK2Sb0T8OiIqnrCqIcX/Ydqe70maJumwapRV7j5ZrYSfW/9ewHsRMTklu8L+tEDSwtz4LUVeu0wHW53MycCYiGiCym33am6j9J3ftTAeEa8BdwFH5Ra7CPiapLXbW1+XSCzJXulHv/B3XK0DyP+418BnI2JV4PPAQcA3a1Bmz1TmAcB/S9qtBmUuz2al7bk68CPgIkmDWi4kacWaR1YdxwB/hSXJbtX0/n8NXJ377u5ej+AqvZ2LrS8d4R8CXF7Jsurkb8DRhZGImA/cAhzc3gu7UmIpKlXP75f0B0lzJb0g6XNp+iuSXs+fNpI0Jh1N3ZaOJO+RtGFufv4UwxhJ50n6p6R5wBfStF/llt9H0hRJ70p6XtKINP2wVJV8L8V0NEshIp4D7geG5MpccgQk6VPpPbwj6U1JV7exnXZI22PnMsqcCDzZosxvpvfztqTxLbbZbqnq/06qSSo371RJl+fGC7WjFdN4L0l/ljQrrXuspFXIduC+uaPcvkXWtbekJ9PnfrekTXPzpkv6gaTHU1xXS+peZLusnF4/ODetj7Ia8tqSeku6KS0zR9J9kjr0vYnMWOBtYFCLffYt4NQUx/9KelnSa2kfXXIqRdJJkman7dTsIKOcfVLS/wA7AucoV+OXtEn6LsxRVqv6Sm49a0kal9bzCPDJtt6jpJWALwL3dGTblCN99v+Q9IakFyUdn5u3taQH0+czW9I5KZbC/JB0rKRngWeVjvolfV/Zb8Ns5WqSpT6H3Gt/JOlV4M9Fwt0GmBsRM9Jrlma7f1nSU8p+O2am/bjod6LItmr12ty8PdN+MVfSA5I2T9P/CmwA3JjW+8P0koeBjZT7rgN3A3u0+6FFRKf/A6YDu7Yx71BgEXAY0AD8CngZOBdYGfgS8B6walp+TBrfKc0/E/i/3PoC+FRu2XeA7cmScPc07Vdp/tZp/m5pfj9gkzRvD7IvoshqHR8AW6R5OwMzSrzffAybALOB7+bm3w0ckYavBH6Si2+HlusBRgCvAFu3UV7/tOyKaXzbFO++aXwf4DlgU2BF4KfAA2le77Q9DwC6Ad9Nn0chvlOBy0uUdTNwNbBmev3n29pG+XUBnwbmpW3fDfhhinGl3D7zCNAX6AU8DRzTxvu/FPif3PixwL/S8OnA+amMbmQ/Eipjn10Sf/ps9gUWAgP5aJ/9TtqejcAfgHEp1tWAG4HT0+tHAK8Bg4FVgCtovZ+Ws0/eXfhc0vgqab84LMUxFHgTGJTmXwVck5YbDMwk911p8X43A+a1Ma/ZPtDe9moxfQVgEvAzYCVgI+AFYHiavyXZ/roi2b71NHBii+/AbWm7NqZyFgGnpc/zy2T7+ppp+VKfQ+G1vyH77WgsEu+xwM0tpnV0u88GdkzDa1Lm70Y7rx0KvE6W+BrIalXTgZVL/cYCjwN758a3AOa0u/+3t0Bn+Etv+n1gbu7vyDTvUODZ3LKfSTvTOrlpbwFDcl/Cq3LzVgUWA+vndsT8F/YvLWIZw0df4guAP5T5HsYCJ5Szg6QY3iX74Qyy5LFysR0V+AtwIbBeG+s5BXgJGFyivP5p2blAUxr+X9IPKNmR0uEtvuwfABuSVYsfys0TMIMyEguwLvAh6UvdIqZW24jmieW/gWtaxDQT2Dm3z3w9N/+3wPltvP9dgedz4/cDB6fh04AbCvtEB/bZndN7mwvMAaYAo3L77Mstttk84JO5adsBL6bhS4HRuXmfpu3E0uY+SesfuIOA+1oscwHwc7Ifn4WkpJTm/Zq2E8v2wKttzGu2D5TYXsUSyzb5bZWmnQL8uY31nAhc3+I78MUW5TSRDmzStNfJklN7n8POwAKge4n38RNyvy8d3e5p+GWyU1Crl7ONWizT1mvPA37ZYto0PjqQm07xxLLku5DGNwYWt7f/d6VTYSMjomfu76LcvNdyw02w5OJTftqqufFXCgMR8T7ZF79VtbLlskWsDzxfbIak3SU9lKq6c8mOjHqXWFdLW6SYDyL7cq3SxnI/JPtCPJJOC7W8FnMi2Q/wE2WU2TuV+X2ynbhbmr4hcGaqQhd+KEV2NNyX5tszKL3N8tYnO/p5u8zl8/qSJcxCuR+mcvvllnk1N/wBzfeBvLuAHpK2kdSf7BTg9WneGWQ1oVuVndLsyE0Ns9K+2isihkTEVbl5+W3UB+gBTMpt43+l6dBiG5N730W0uU8WsSGwTaHMVO7XgE+kslfsQLlvkx3hV9qGZKd/8jH+GFgHQNKn06nKVyW9S5b8Wn7PWu6Pb0XEotx4Yd9o73MAeCOyaw1tKWc7lNruAPuT/V68pOw093btrC+vrdduCHy/RZnr0/bvXsFqZAdH+fF32guiKyWWSlq/MCBpVbJq76w2lo0S63mFIuedlV3A+wfZUf86EdET+Ce5aw/liMw1wINkpwKKLfNqRBwZEX3JjlT+pOa3GB8IjJR0QpllLo6I3wPzgW+nya8AR7dI7I0R8QBZ1Tu/PZUfJzsC7JEb/0Ru+BWgl6SexUJpJ9RZZF+WluXObOd1rQuKWEx2yue/0t9NEfFemvdeRHw/IjYC9ga+J2mXjpZRrNjc8JtkBz+b5bbvGpFd+IYW25jsfHhbiu6TRcosLHtPi8911Yj4FvAG2Wmfcst9juxj6FdimaXxClmNIR/jahHx5TT/POAZYOOIWJ0s6bT8nrW3LxW09zmUs67HyWqUpcovtd2JiAkRsQ+wNtmZjmvKfR8lXvsK2enefJk9IuLKttat7Drop4DHcpM3bTFe1Mc1sXxZ2cXslYBfkp3KKfcoO+8S4DBJu0haQVI/SZuQnQtemfTllLQ72bWepTUaOFLSJ1rOkHSgpPXS6NtkO8iHuUVmAbsAJ0j6VgfL/KGyC97nA6dI2iyVuYakA9NyNwObSdov7YjH0zx5TAF2krSBpDXITmMAEBGzyU6z/UnSmpK6SdopzX4NWCu9pphrgD3Stu9GVsv6D/BAB95j3hVktcOvpWHSe91T2Q0SIjtSW0zz7bvMUm3rIuAPSrdypn1peFrkGuBQSYMk9SA7VdWWtvZJyLZp/hmtm4BPS/pG2vbdJG0ladOUbK8ju7Ggh7K72Q4p8R4WALeTXU9capK65//IrpO9p+yCeaOkBkmDJW2VXrIa2Wnj99P77Mg+3vI9tPc5lOMRoGeLBFv2dpe0kqSvSVojIham9/Zhbj1tfifaee1FwDGpVi5Jq0jaQ9JquXW3fH5va2B6RORrqp8n+86W1JUSS+GOhcLf9e2/pE1XkH0555Bd/Pv60qwkIh4huwD3B7IfnXuADdPR7vFkPwhvA18luyC4VCJiKnAvcFKR2VsBD0t6P5VxQrR4DiciXiZLLier/Pvpb06xHxkR15NdsLwqnW54Atg9rftNslrRaLJrWRuTnZctlH0b2cX5x8kuwt7UopxvkJ3Lf4bsXPeJ6XXPkF1beiFV3ZtV2SNiGtnndjbZkeZeZLekLyjz/TUTEQ+T1a760vyLszHZD+b7ZDXHP0XEXbDkQdUfL015RfyI7Kj/obSNbye70E9E3AL8EbgzLXNnifdRdJ9Ms88EDlB2991ZaT/9EjCK7ADkVT66MA1wHNkpolfJruP8uZ33cAHZ57m0+pHVGPJ/A4A9yU5Pvkj2WV8MFH5cf0D2/XqP7Mez6F2RHdDm51COtP+NoflvSke3+zeA6an8Y8gOdtr9TrTz2onAkcA5ZN/r58iu9RWcDvw0rbdwJ9nXyA4qgSzpk51ma/cZusLF2Y8NSWPILoD9tN6xmC1vJN0PHBcRk+sdS71I6gPcBwyN9JBkV5NqbPeQvYf5adp3yG5y+mHJF+PEYmZmFdaVToWZmVkX8LGrsZiZWXW5xmJmZhW1vDR+t0Tv3r2jf//+9Q7DzKxLmTRp0psR0af9Jdu33CWW/v37M3HixHqHYWbWpUgq1bJCh/hUmJmZVZQTi5mZVZQTi5mZVZQTi5mZVZQTi5mZVdRyd1eY2fJq7OSZnDF+GrPmNtG3ZyMnDR/IyKGVbqXebNk5sZh1AWMnz+SU66bStHAxADPnNnHKdVMBnFys06nrqTBJIyRNk/Sc2uiZT9JXJD2lrHfEK4otY7a8O2P8tCVJpaBp4WLOGD+tThGZta1uNRZJDcC5wG5kfaRPkDQuIp7KLbMxWcdQ20fE24XOd8w+bmbNLd76elvTzeqpnjWWrYHnIuKF1DnOVcA+LZY5Eji30Cd6RLxe4xjNOoW+PRs7NN2snuqZWPqR9cNcMCNNy/s0WRee90t6SNKIYiuSdJSkiZImvvHGG1UK16x+Tho+kMZuDc2mNXZr4KThZXduaFYznf3i/YpkXcPuDKwH3CvpMxExN79QRFwIXAgwbNgw9wNgy53CBXrfFWZdQT0Ty0xg/dz4emla3gzg4YhYCLwo6d9kiWZCbUI06zxGDu3nRGJdQj1PhU0ANpY0QNJKwChgXItlxpLVVpDUm+zU2Au1DNLMzDqmboklIhYBxwHjgaeBayLiSUmnSdo7LTYeeEvSU8BdwEkR8VZ9IjYzs3Isd10TDxs2LNwfi5lZx0iaFBHDKrEutxVmZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYV5cRiZmYVVdfEImmEpGmSnpN0conl9pcUkobVMj4zs1LGTp7J9qPvZMDJN7P96DsZO3lmvUPqFFasV8GSGoBzgd2AGcAESeMi4qkWy60GnAA8XPsozcyKGzt5JqdcN5WmhYsBmDm3iVOumwrAyKH96hla3dWzxrI18FxEvBARC4CrgH2KLPdL4DfA/FoGVw8++jHrOs4YP21JUiloWriYM8ZPq1NEnUe7NRZJKwP7A/3zy0fEactYdj/gldz4DGCbFmVvAawfETdLOqlEjEcBRwFssMEGyxhWffjox6xrmTW3qUPTP07KqbHcQFaTWATMy/1VlaQVgN8D329v2Yi4MCKGRcSwPn36VDu0qvDRj1nX0rdnY4emf5yUc41lvYgYUYWyZwLr58tJ0wpWAwYDd0sC+AQwTtLeETGxCvHUlY9+zLqWk4YPbHaWAaCxWwMnDR9Yx6g6h3JqLA9I+kwVyp4AbCxpgKSVgFHAuMLMiHgnInpHRP+I6A88BCyXSQV89GPW1Ywc2o/T9/sM/Xo2IqBfz0ZO3+8zPnVNeTWWHYBDJb0I/AcQEBGx+bIUHBGLJB0HjAcagEsj4klJpwETI2Jc6TUsX3z0Y9b1jBzaz4mkiHISy+7VKjwi/gn8s8W0n7Wx7M7ViqMzKOycZ4yfxqy5TfTt2chJwwd+rHfasZNnenuYdUHtJpaIeEnSZ4Ed06T7IuKx6ob18eSjn4/4LjmzrqvdayySTgD+Bqyd/i6X9J1qB2Yfb75LzqzrKudU2OHANhExD0DSb4AHgbOrGZh9vPkuObOuq5y7wgTkDx0Xp2lmVeO75My6rnISy5+BhyWdKulUstt+L6lqVPaxd9LwgTR2a2g2zXfJmXUN5Vy8/72ku8luOwY4LCImVzUq+9jzXXJmXVebiUXS6hHxrqRewPT0V5jXKyLmVD88+zjzXXJmXVOpGssVwJ7AJCBy05XGN6piXGZm1kW1mVgiYs/0f0DtwjEzs66unOdY7ihnmpmZGZS+xtId6AH0lrQmH91ivDpZXypmZmatlLrGcjRwItCX7DpLIbG8C5xT5bjMzKyLKnWN5UzgTEnfiQg/ZW9mZmUp5wHJDyX1LIxIWlPSt6sYk5mZdWHlJJYjI2JuYSQi3gaOrF5IZmbWlZWTWBqU+gYGkNQArFS9kMzMrCsrp3XjfwFXS7ogjR+dppmZmbVSTmL5EVky+VYavw24uGoRmZlZl1ZOI5QfAuelPzMzs5LaTSySXqR5W2EARITbCjMzs1bKORU2LDfcHTgQ6FWdcMzMrKtr966wiHgr9zczIv4I7FGD2MzMrAsq51TYFrnRFchqMOXUdMzM7GOonATxu9zwIrIOv75SlWjMzKzLK+eusC/UIhAzM1s+lGo2/3ulXhgRv698OGZm1tWVqrGslv4PBLYCxqXxvYBHqhmUmZl1XaWazf8FgKR7gS0i4r00fipwc02iMzOzLqeci/frAAty4wvStGUmaQRwJtAAXBwRo1vM/x5wBNlNA28A34yIlypRdlsOuuDBVtP23HxdvrFdf5oWLObQP7eurB2w5XocOGx95sxbwLcun9Rq/te33ZC9PtuXWXOb+O7VU1rNP3LHjdh10Do8/8b7/Pi6qa3mf+eLG7PDxr15ctY7nHbjU63m/3DEQLbcsBeTXprDb/81rdX8n+01iM36rsH/PfsmZ9/5bKv5v97vM3yyz6rc/tRrXHTfC63m/+GgIfTt2ciNj83i8odab/7zvr4lvVZZib9PfIVrJ81oNX/MYVvTuFIDf31wOjc9PrvV/KuP3g6AC+99njuefr3ZvO7dGrjsm1sDcNYdz3L/c282m79mj5U4/xtbAvCbfz3Doy+93Wz+umt054+jhgLwixuf5KlZ7zabv1GfVTh9v80BOOW6x3nhjXnN5g/quzo/32szAE68ajKz35nfbP4WG67Jj0ZsAsAxf53E2x8saDZ/+0/15vhdNgbgkEsfYf7Cxc3m77Lp2hy10ycB73ve95Z93yu8n3orJ7H8BXhE0vVpfCRw2bIWnFpJPhfYDZgBTJA0LiLye+9kYFhEfCDpW8BvgYOWtWyzjhg7eSZnjJ/GzLlNrNSwAuv3aqT3qivXOyyzTksRrVprab1Q9izLjmn03oiYvMwFS9sBp0bE8DR+CkBEnN7G8kOBcyJi+1LrHTZsWEycOHFZwzMDsqRyynVTacrVNBq7NXD6fp9h5NB+dYzMrLIkTYqIYe0v2b5y+mMB6AG8m7orniFpQAXK7ge8khufkaa15XDglmIzJB0laaKkiW+88UYFQjPLnDF+WrOkAtC0cDFnjG992sfMMu0mFkk/J2s6/5Q0qRtweTWDKhLD18me+D+j2PyIuDAihkXEsD59+tQyNFvOzZrb1KHpZlbeNZZ9gaHAowARMUvSaqVfUpaZwPq58fXStGYk7Qr8BPh8RPynAuWala1vz0ZmFkkifXs21iEas+IK1wFnzW2ib89GTho+sK6nass5FbYgsgsxASBplQqVPQHYWNIASSsBo/joWRlSWUOBC4C9I+L1Iuswq6qThg+ksVtDs2mN3Ro4afjAOkVk1lzhOuDMuU0EMHNuE6dcN5Wxk1sdp9dMOYnlmtQtcU9JRwJ3UIEeJCNiEXAcMB54GrgmIp6UdJqkvdNiZwCrAn+XNEXSuDZWZ1YVI4f24/T9PkO/no0I6Nez0RfurVPpjNcBy70rbDfgS4CA8RFxW7UDW1q+K8zMPk4GnHxz654YyX6sXxxdfg8nlbwrrOQ1lvSsyZopkdyWTlkdKunpiNi0EgGYmdnS64zXAds8FSZpFDAHeFzSPZK+BLwA7A58rUbxmZlZCZ3xOmCpGstPgS0j4rn0gOSDwAERcWNtQjMzs/YUrvd1prvCSiWWBRHxHEBEPCrpWScVM7POZ+TQfp3qhpJSiWXtFn2y9MyPuz8WMzMrplRiuYiP+mQpNm5mZtZKu/2xmJmZdUS5jVCamZmVpZy2wszMOpXO1jaWNdduYpG0csvGHyX1iog51QvLzKy4ln3kFNrGApxcOolyToVdJ6lbYUTSukCnbdLFzJZvnbFtLGuunMQylqwhygZJ/ckajTyl5CvMzKrEfeR0fu2eCouIi1IbYWOB/sDREfFAtQMzMyumM7aNZc2Vaivse4U/oDuwATAF2LbFg5NmZjXTGdvGsuZK1VhaPgx5XRvTzcxqpjO2jWXNldUfy5KFpRWAVSPi3eqFtGzcH4uZWcdVsj+Wdi/eS7pC0uqpS+IngKcknVSJwq1zGjt5JtuPvpMBJ9/M9qPvrGsXp2bW9ZRzV9igVEMZCdwCDAC+UdWorG46Y//ZZta1lJNYuqXnWEYC4yJiIRTtCdOWA35GwMyWVTmJ5QJgOrAKcK+kDYFOe43Flo2fETCzZdVuYomIsyKiX0R8OTIvAV+oQWxWB209C+BnBMysXG3ebizp6xFxeYlnVtzR13LopOEDm7XDBH5GwMw6ptRzLKuk/35u5WPEzwiY2bLq0HMsS14krRIR86oQzzLzcyxmZh1Xs+dYJPWTNCy1FYaktSX9Gni2EoWbmdnyp1RbYSeStQ12NvCQpCOAp4FGYMvahGdmZl1NqWssRwEDI2KOpA2AfwPbR8Sk2oRmZmZdUalTYfMLvURGxMvANCcVMzNrT6kay3qSzsqNr5sfj4jjl7VwSSOAM4EG4OKIGN1i/srAX8hOvb0FHBQR05e1XDMzq55SiaVlQ5MVra1IagDOBXYDZgATJI2LiKdyix0OvB0Rn5I0CvgNcFAl4zAzs8pqM7FExGVVLntr4LmIeAFA0lXAPkA+sewDnJqGrwXOkaRYmnukzcysJtrtmriK+gGv5MZnANu0tUxELJL0DrAW8GZ+IUlHkd1swAYbbLBUwYydPNMPBZqZVUA5jVB2ehFxYUQMi4hhffr06fDr3VS8mVnl1DOxzATWz42vl6YVXUbSisAaZBfxK8pNxZuZVU6pRijPpkS/KxW4K2wCsLGkAWQJZBTw1RbLjAMOAR4EDgDurMb1FTcVb2ZWOaWusVS1wa10zeQ4YDzZ7caXRsSTkk4DJkbEOOAS4K+SngPmkCWfiuvbs5GZRZKIm4o3M+u4et4VRkT8E/hni2k/yw3PBw6sdhxuKt7MrHLavStMUh/gR8AgoHthekR8sYpx1ZSbijczq5xybjf+G3A1sAdwDNk1jzeqGVQ9jBzaz4nEzKwCyrkrbK2IuARYGBH3RMQ3geWmtmJmZpVVTo1lYfo/W9IewCygV/VCMjOzrqycxPIrSWsA3yfrm2V14LtVjcrMzLqsdhNLRNyUBt8BvlDdcMzMrKtr9xqLpMsk9cyNrynp0uqGZWZmXVU5F+83j4i5hZGIeBsYWr2QzMysKysnsawgac3CiKRe1LdVZDMz68TKSRC/Ax6U9HdAZG12/U9VozIzsy6rnIv3f5E0kY+eXdmvRS+PZmZmS5Rq3Xj1iHg3nfp6FbgiN69XRMypRYBmZta1lKqxXAHsSdbXfb6peqXxjaoYl5mZdVGlWjfeU5KAz0fEyzWMyczMurCSd4WlTrVurlEsZma2HCjnduNHJW1V9UjMzGy5UM7txtsAX5P0EjCPdI0lIjavamRmZtYllZNYhlc9CjMzW260e7sx8F4N4zEzsy6uI7cbKzfPtxubmVlRJW83Tv8H1C4cMzPr6spqTFLSfsAOZDWV+yJibFWjMjOzLquc/lj+BBwDTAWeAI6RdG61AzMzs66pnBrLF4FN08OSSLoMeLKqUZmZWZdVzgOSzwEb5MbXT9PMzMxaKafGshrwtKRH0vhWwERJ4wAiYu9qBWdmZl1POYnlZ1WPwszMlhvldPR1D2QPTOaXd38sZmZWTLuJRdJRwGnAfOBD3B+LmZmVUM7F+5OAwRHRPyI2iogBEbFMSUVSL0m3SXo2/V+zyDJDJD0o6UlJj0s6aFnKNDOz2ignsTwPfFDhck8G7oiIjYE70nhLHwAHR8RmwAjgj5J6VjgOMzOrsHIu3p8CPCDpYeA/hYkRcfwylLsPsHMavgy4G/hRfoGI+HdueJak14E+wNxlKNfMzKqsnMRyAXAn2ZP3H1ao3HUiYnYafhVYp9TCkrYGViKrPRWbfxRwFMAGG2xQbBEzM6uRchJLt4j4XkdXLOl24BNFZv0kPxIRISlKrGdd4K/AIRFRNLFFxIXAhQDDhg1rc11mZlZ95SSWW1KN4EaanworebtxROza1jxJr0laNyJmp8TxehvLrQ7cDPwkIh4qI1YzM6uzchLLf6X/p+SmLevtxuOAQ4DR6f8NLReQtBJwPfCXiLh2GcoyM7MaKucByWr0xzIauEbS4cBLwFcAJA0DjomII9K0nYC1JB2aXndoREypQjxmZlYhbd5uLOmHueEDW8z79bIUGhFvRcQuEbFxROxaOK0WERNTUiEiLo+IbhExJPfnpGJm1smVeo5lVG74lBbzRlQhFjMzWw6USixqY7jYuJmZGVA6sUQbw8XGzczMgNIX7z8r6V2y2kljGiaNd696ZGZm1iW1mVgioqGWgZiZ2fKhnEYozczMyubEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFeXEYmZmFVqi5CMAABHUSURBVLVivQMws4+3hQsXMmPGDObPn1/vUD4WunfvznrrrUe3bt2qVkZdEoukXsDVQH9gOvCViHi7jWVXB54CxkbEcbWK0cxqY8aMGay22mr0798fSfUOZ7kWEbz11lvMmDGDAQMGVK2cep0KOxm4IyI2Bu5I4235JXBvTaIys5qbP38+a621lpNKDUhirbXWqnrtsF6JZR/gsjR8GTCy2EKStgTWAW6tUVxmVgdOKrVTi21dr8SyTkTMTsOvkiWPZiStAPwO+EF7K5N0lKSJkia+8cYblY3UzMw6pGqJRdLtkp4o8rdPfrmICCCKrOLbwD8jYkZ7ZUXEhRExLCKG9enTp0LvwMys82loaGDIkCEMHjyYvfbai7lz5wIwffp0GhsbGTJkCIMGDeLggw9m4cKFdYmxaoklInaNiMFF/m4AXpO0LkD6/3qRVWwHHCdpOvC/wMGSRlcrXjOzSlm8eHHV1t3Y2MiUKVN44okn6NWrF+eee+6SeZ/85CeZMmUKU6dOZcaMGVxzzTVVi6OUet1uPA44BBid/t/QcoGI+FphWNKhwLCIKHWR38yWAwdd8GCraXtuvi7f2K4/TQsWc+ifH2k1/4At1+PAYeszZ94CvnX5pGbzrj56u5LljRw5kldeeYX58+dzwgkncNRRR3H++efz/PPPc8YZZwAwZswYJk6cyDnnnMPll1/OWWedxYIFC9hmm23405/+RENDA6uuuipHH300t99+O+eeey533nknN954I01NTXzuc5/jggsuQBITJkzg8MMPZ4UVVmC33Xbjlltu4YknnmDx4sWcfPLJ3H333fznP//h2GOP5eijjy4Z+3bbbcfjjz/eanpDQwNbb701M2fOLPn6aqnXNZbRwG6SngV2TeNIGibp4jrFZGYfQ5deeimTJk1i4sSJnHXWWbz11lvsv//+XH/99UuWufrqqxk1ahRPP/00V199Nffffz9TpkyhoaGBv/3tbwDMmzePbbbZhscee4wddtiB4447jgkTJvDEE0/Q1NTETTfdBMBhhx3GBRdcsOT1BZdccglrrLEGEyZMYMKECVx00UW8+OKLbca9ePFi7rjjDvbee+9W8+bPn8/DDz/MiBEjKrWZOqQuNZaIeAvYpcj0icARRaaPAcZUPTAzq7tSNYzGlRpKzu+1ykrt1lBaOuuss5YkkVdeeYVnn32Wbbfdlo022oiHHnqIjTfemGeeeYbtt9+ec889l0mTJrHVVlsB0NTUxNprrw1ktYT9999/yXrvuusufvvb3/LBBx8wZ84cNttsM3bccUfee+89ttsui/GrX/3qkoRz66238vjjj3PttdcC8M477/Dss8+2et6kqamJIUOGMHPmTDbddFN22223JfOef/55hgwZwosvvsgee+zB5ptv3qFtUSl+8t7MOmTs5JmcMX4as+Y20bdnIycNH8jIof3qHdZSufvuu7n99tt58MEH6dGjBzvvvPOSZzxGjRrFNddcwyabbMK+++6LJCKCQw45hNNPP73Vurp3776kBjJ//ny+/e1vM3HiRNZff31OPfXUdp8diQjOPvtshg8fXnK5wjWWDz74gOHDh3Puuedy/PHHAx9dY3nzzTfZfvvtGTduXNEaTbW5rTAzK9vYyTM55bqpzJzbRAAz5zZxynVTGTu5Pufyl9U777zDmmuuSY8ePXjmmWd46KGHlszbd999ueGGG7jyyisZNWoUALvssgvXXnstr7+e3W80Z84cXnrppVbrLSSR3r178/777y+phfTs2ZPVVluNhx9+GICrrrpqyWuGDx/Oeeedt+ROrn//+9/Mmzevzdh79OjBWWedxe9+9zsWLVrUbF7v3r0ZPXp00QRYC04sZla2M8ZPo2lh8zuemhYu5ozx0+oU0bIZMWIEixYtYtNNN+Xkk09m2223XTJvzTXXZNNNN+Wll15i6623BmDQoEH86le/4ktf+hKbb745u+22G7Nnz2613p49e3LkkUcyePBghg8fvuTUGWTXUo488kiGDBnCvHnzWGONNQA44ogjGDRoEFtssQWDBw/m6KOPbpUwWho6dCibb745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\n",
      "text/plain": [
       "<Figure size 432x288 with 1 Axes>"
      ]
     },
     "metadata": {},
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Plot the predicted versus empirical risk reduction for the test set\n",
    "empirical_benefit, avg_benefit = quantile_benefit(X_test, y_test, rr_t_test)\n",
    "plot_empirical_risk_reduction(empirical_benefit, avg_benefit, 'T Learner (test set)')"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Evaluate the T-learner's performance using the test set."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 59,
   "metadata": {
    "ExecuteTime": {
     "end_time": "2020-04-04T15:32:45.849067Z",
     "start_time": "2020-04-04T15:32:45.502487Z"
    },
    "colab": {
     "base_uri": "https://localhost:8080/",
     "height": 970
    },
    "colab_type": "code",
    "id": "tGFuQSpLJnym",
    "outputId": "6cc2307e-7abf-40be-df49-8be92147e4c1"
   },
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "C-for-benefit statistic on test set: 0.4900\n"
     ]
    }
   ],
   "source": [
    "# calculate the c-for-benefit of the t-learner on the test set\n",
    "c_for_benefit_tlearner_test_set = c_statistic(rr_t_test, y_test, X_test.TRTMT)\n",
    "print(f\"C-for-benefit statistic on test set: {c_for_benefit_tlearner_test_set:.4f}\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "##### Expected output\n",
    "\n",
    "```CPP\n",
    "C-for-benefit statistic on test set: 0.5250\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "ihGyqKsEfJa0"
   },
   "source": [
    "The c-for-benefit of the two models were evaluated on different test sets.  However, we can compare their c-for-benefit scores to get a sense of how they perform:\n",
    "- logistic regression: 0.5412\n",
    "- T-learner: 0.5250\n",
    "\n",
    "The T-learner doesn't actually do better than the logistic regression in this case.  You can try to tune the hyperparameters of the T-Learner to see if you can improve it.\n",
    "\n",
    "### Note\n",
    "While the more flexible ML techniques may improve predictive power, the sample size is too small to be certain. \n",
    "- Models like the T-learner could still be helpful in identifying subgroups who will likely not be helped by treatment, or could even be harmed by treatment.  \n",
    "- So doctors can study these patients in more detail to find out how to improve their outcomes. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "colab_type": "text",
    "id": "PHjwt4UYoqy7"
   },
   "source": [
    "## Congratulations\n",
    "\n",
    "You've finished the assignment for Course 3 Module 1! We've seen that machine learning techniques can help determine when a treatment will have greater treatment effect for a particular patient."
   ]
  }
 ],
 "metadata": {
  "colab": {
   "collapsed_sections": [
    "sn8ODLuvXAyn"
   ],
   "include_colab_link": true,
   "name": "C3M1_Assignment.ipynb",
   "provenance": [],
   "toc_visible": true
  },
  "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.3"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}