{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "# TMLE Example Notebook" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "This notebook demonstrates the issue of using uplift curves without knowing true treatment effect and how to solve it by using TMLE as a proxy of the true treatment effect." ] }, { "cell_type": "code", "execution_count": 1, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:00:37.209142Z", "start_time": "2020-04-14T19:00:36.739696Z" }, "pycharm": { "is_executing": false } }, "outputs": [], "source": [ "%reload_ext autoreload\n", "%autoreload 2\n", "%matplotlib inline" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:00:37.956988Z", "start_time": "2020-04-14T19:00:37.212224Z" }, "pycharm": { "is_executing": false } }, "outputs": [], "source": [ "import logging\n", "from matplotlib import pyplot as plt\n", "import numpy as np\n", "import pandas as pd\n", "from sklearn.model_selection import train_test_split, KFold\n", "import sys\n", "import warnings\n", "warnings.simplefilter(\"ignore\", UserWarning)\n", "\n", "from lightgbm import LGBMRegressor" ] }, { "cell_type": "code", "execution_count": 3, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:00:39.276376Z", "start_time": "2020-04-14T19:00:37.959788Z" }, "pycharm": { "is_executing": false } }, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "0.7.0\n" ] }, { "name": "stderr", "output_type": "stream", "text": [ "/Users/jeong/.conda/envs/py36/lib/python3.6/site-packages/sklearn/utils/deprecation.py:144: FutureWarning: The sklearn.utils.testing module is deprecated in version 0.22 and will be removed in version 0.24. The corresponding classes / functions should instead be imported from sklearn.utils. Anything that cannot be imported from sklearn.utils is now part of the private API.\n", " warnings.warn(message, FutureWarning)\n" ] } ], "source": [ "import causalml\n", "\n", "from causalml.dataset import synthetic_data\n", "from causalml.inference.meta import BaseXRegressor, TMLELearner\n", "from causalml.metrics.visualize import plot\n", "from causalml.propensity import calibrate\n", "\n", "print(causalml.__version__)" ] }, { "cell_type": "code", "execution_count": 4, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:00:39.334893Z", "start_time": "2020-04-14T19:00:39.280409Z" } }, "outputs": [], "source": [ "logger = logging.getLogger('causalml')\n", "logger.setLevel(logging.DEBUG)\n", "plt.style.use('fivethirtyeight')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Generating Synthetic Data" ] }, { "cell_type": "code", "execution_count": 5, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:00:39.793117Z", "start_time": "2020-04-14T19:00:39.338017Z" } }, "outputs": [], "source": [ "# Generate synthetic data using mode 1\n", "y, X, treatment, tau, b, e = synthetic_data(mode=1, n=1000000, p=10, sigma=5.)" ] }, { "cell_type": "code", "execution_count": 6, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:00:40.108040Z", "start_time": "2020-04-14T19:00:39.796174Z" } }, "outputs": [], "source": [ "X_train, X_test, y_train, y_test, e_train, e_test, treatment_train, treatment_test, tau_train, tau_test, b_train, b_test = train_test_split(X, y, e, treatment, tau, b, test_size=0.5, random_state=42)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Calculating Individual Treatment Effect (ITE/CATE)" ] }, { "cell_type": "code", "execution_count": 7, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:01:41.773553Z", "start_time": "2020-04-14T19:00:40.111749Z" } }, "outputs": [], "source": [ "# X Learner\n", "learner_x = BaseXRegressor(learner=LGBMRegressor())\n", "learner_x.fit(X=X_train, treatment=treatment_train, y=y_train)\n", "cate_x_test = learner_x.predict(X=X_test, p=e_test, treatment=treatment_test).flatten()" ] }, { "cell_type": "code", "execution_count": 8, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:01:42.479937Z", "start_time": "2020-04-14T19:01:41.779961Z" } }, "outputs": [ { "data": { "image/png": "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hobGtz2o7duuPRERERERAQDi4+Nx8eJF9OrVCwAgkUjQp08fYVhebGwsatWqJQRLBens2bPo1q0bbG1tYW5ujl9++QXp6elITEws8LK+NvYwERERERF9B7Zs2YKsrCzUrl1b2CaTyQAAjx8/zne+EolEyEcuMzNT+P/Dhw/h6uqKAQMGYMqUKShfvjyuXbuGQYMGIT09Pd/lFhcMmIiIiIiIvnGZmZkIDg6Gt7c32rVrp7BvyJAh2L59O+rWrYuQkBC8fPlSZS+Tjo4OsrKylLZXqFABz549E14nJSUpvL569SrS09Ph5+cHTU1NAMCxY8cK6tSKHAMmIiIiIqJv3PHjx/Hy5Uv8+uuvKF++vMK+nj17IjAwEBcuXMCSJUvQr18/eHt7w9TUFLdu3UKZMmXQvHlzWFhY4NGjR4iJiUGlSpVQpkwZlChRAs2bN8f69evh4OCAzMxMzJs3DyVLlhTyr1q1KrKzs7Fq1Sp07twZly9fxurVq7/2W1BoGDAREREREX3GlzxI9mvYunUrmjVrphQsAUC3bt0wY8YMREVF4fDhw5g2bRrc3NyQkZGBatWqYc6cOQCALl26IDQ0FF27dkVKSgr8/f3Rv39/+Pr6YtSoUfjPf/6DChUqYNasWQrPd6pduzbmzp2LZcuWYfbs2bC3t4ePjw/c3d2/2vkXJklycrLs88moOImLi0P16tWLuhpUzLBdkJgfsW3EvCicMfN2FXQKJd+i8iO2DVLPj942UlJSULZs2aKuRrGUmpqq0Lv0Lcnv58pV8oiIiIiIiEQwYCIiIiIiIhLBgImIiIiIiEgEAyYiIiIiIiIRDJiIiIiIiIhEMGAiIiIiIvqETMaFpL8nX/J5MmAiIiIiIsqhZMmSeP/+fVFXgwqITCZDcnIydHV183U8H1xLRERERJRDiRIlkJmZiZSUlKKuSrHz+vVr6OvrF3U18kxPTw9aWvkLfRgwERERERF9Ir+9Ed+7pKQkVKpUqair8VVxSB4REREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkggETERERERGRCAZMREREREREIhgwERERERERiWDAREREREREJIIBExERERERkQgGTERERERERCIYMBEREREREYlgwERERERERCSCARMREREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkggETERERERGRCAZMREREREREIhgwERERERERiWDAREREREREJIIBExERERERkQgGTERERERERCIYMBEREREREYlgwERERERERCSCARMREREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkokgDpsjISLi5ucHGxgZSqRTbt28X9mVkZMDb2xtOTk4wNTWFtbU1Bg8ejEePHinkkZaWhgkTJsDKygqmpqZwc3NDQkKCQppHjx7B1dUVpqamsLKywsSJE5Genq6Q5ty5c2jRogWMjY1Rr149BAYGKtV3/fr1qFu3LoyNjdGiRQucP3++AN8NIiIiIiIqboo0YHr37h1sbW0xd+5clCpVSmHf+/fvce3aNXh6euLs2bMICgpCQkICevXqhczMTCHd5MmTERoaig0bNuDIkSN48+YNXF1dkZWVBQDIysqCq6sr3r59iyNHjmDDhg04ePAgpk6dKuRx//599OnTB/b29ggPD8e4ceMwceJEHDhwQEizd+9eeHl5Yfz48QgPD4e9vT169+6tFMAREREREdH3Q5KcnCwr6koAgJmZGebPn4/+/fuLprlz5w4cHR0RGRmJWrVqISUlBdWqVYO/vz/69OkDAHj8+DHq1KmD3bt3o1WrVggLC0OfPn1w/fp1mJubAwBCQkIwevRoxMXFQV9fH97e3ggNDcWVK1eEskaNGoU7d+4gLCwMANCqVSvUqlULy5cvF9I0aNAAXbt2hbe3d2G8JaLi4uJQvXr1r1omFX9sFyTmR2wbMS/SP58oH+wq6BRKvkXlR2wbpB62DRLzI7aNb2oO05s3bwAAUqkUABATE4OMjAy4uLgIaczNzWFtbY2oqCgAQHR0NKytrYVgCfgY/KSlpSEmJkZIkzMPeZqrV68iIyMD6enpiImJUUrj4uIilENERERERN8fraKugLrS09Mxbdo0tG/fHmZmZgCApKQkaGpqwsDAQCGtoaEhkpKShDSGhoYK+w0MDKCpqamQxtnZWSmPzMxMvHz5EjKZDFlZWUr55CxHlbi4uHydqzoKM2/6drFdkJgfrW08fCsplHx1XxWLQRkF6kdrG6Q+tg0S8721jc/1mH0TAVNmZiY8PDyQkpKC4ODgoq6O2gqru/JH7Aqlz2O7IDE/Ytt4V0hD8qpzSB79INg2SMyP2DaK/ZC8zMxMDBo0CDdv3sSBAwdQvnx5YZ+RkRGysrLw8uVLhWOeP38OIyMjIc3z588V9r98+RJZWVm5pnn+/Dm0tLRgYGAg9EipSiPPg4iIiIiIvj/FOmDKyMiAu7s7bt68idDQUBgbGyvst7Ozg7a2Nk6fPi1sS0hIwN27d+Hg4AAAsLe3x927dxWWGj99+jRKlCgBOzs7IU3OPORp6tevD21tbejo6MDOzk5lGnk5RERERET0/SnSIXlv375FfHw8ACA7OxuPHz9GbGwsypUrh4oVK+LXX3/F1atXERwcDIlEgsTERACAvr4+SpUqhbJly+KXX36Bt7c3DA0NUa5cOUydOhW1atUS5iS5uLjAxsYGQ4cOha+vL169eoXp06djwIAB0NfXBwC4u7tj3bp18PLygru7O6KiohAUFIT169cLdR0xYgSGDBmChg0bwsHBAYGBgXj27Bnc3d2/7ptGRERERERfTZEGTFevXkXnzp2F135+fvDz80Pfvn3h5eWFI0eOAIDSggz+/v7C8uN+fn7Q1NSEu7s7UlNT0bx5c6xevRqampoAAE1NTYSEhMDT0xPt27dHyZIl0bt3b/j4+Aj5WVpaYufOnZgyZQoCAwNhYmKCefPmoWvXrkKaHj164N9//8WCBQuQmJgIGxsb7Ny5ExYWFoX19hARERERURErNs9hIvX9iJPt6PPYLkjMj9g2+Bwm9fyIbYPUw7ZBYn7EtlGs5zAREREREREVJQZMREREREREIhgwERERERERiWDAREREREREJIIBExERERERkQgGTERERERERCIYMBEREREREYlgwERERERERCSCARMREREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkggETERERERGRCAZMREREREREIhgwERERERERiWDAREREREREJIIBExERERERkQitoq4AERH9mGJepBd1FYiIiD6LPUxEREREREQiGDARERERERGJYMBEREREREQkggETERERERGRCAZMREREREREIhgwERERERERiWDAREREREREJIIBExERERERkQgGTERERERERCIYMBEREREREYlgwERERERERCSCARMREREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkggETERERERGRCAZMREREREREIhgwERERERERiWDAREREREREJIIBExERERERkQgGTERERERERCIYMBEREREREYlgwERERERERCSCARMREREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkggETERERERGRCAZMREREREREIhgwERERERERidAq6goQERF9K2JepBda3nYVdAotbyIiyj/2MBEREREREYlgwERERERERCSCARMREREREZGIIg2YIiMj4ebmBhsbG0ilUmzfvl1hv0wmg5+fH2rWrAkTExN06tQJt2/fVkiTnJwMDw8PWFhYwMLCAh4eHkhOTlZIc/PmTXTs2BEmJiawsbHBvHnzIJPJFNIcOHAADg4OMDIygoODA0JDQ/NcFyIiIiIi+r4UacD07t072NraYu7cuShVqpTS/mXLlsHf3x/z5s3Dn3/+CUNDQ3Tv3h1v3rwR0gwePBixsbHYvXs3du/ejdjYWAwZMkTY//r1a3Tv3h1GRkb4888/MXfuXKxYsQIrV64U0kRHR2PgwIHo3bs3IiIi0Lt3b/z222+4fPlynupCRERERETflyINmNq2bYvp06eja9eu0NBQrIpMJkNAQAD++OMPdO3aFba2tggICMDbt2+xe/duAMDdu3dx8uRJLF26FPb29rC3t8eSJUtw/PhxxMXFAQB27dqFDx8+ICAgALa2tujatSvGjBmDVatWCb1MAQEBaNasGTw9PWFtbQ1PT0/89NNPCAgIULsuRERERET0/Sm2c5gePHiAxMREuLi4CNtKlSoFJycnREVFAfjYM1SmTBk4ODgIaRwdHaGrq6uQpkmTJgo9WK1atcLTp0/x4MEDAMClS5cUypGnkeehTl2IiIiIiOj7U2yfw5SYmAgAMDQ0VNhuaGiIp0+fAgCSkpJgYGAAiUQi7JdIJKhQoQKSkpKENKampkp5yPdZWloiMTFRZTnyPNSpiyryXq7CUJh507eL7YLEFMe28fCt5POJfiC6r2SfT1QIimPboOKBbYPEfG9to3r16rnuL7YB0/fgc29+fsXFxRVa3vTtYrsgMcW1bbwrxIfAfouqF8GDa4tr26Cix7ZBYn7EtlFsh+QZGxsDAJ4/f66w/fnz5zAyMgIAGBkZ4eXLlwor3slkMrx48UIhjao85PvkZeVWjjp1ISIiIiKi70+xDZgqV64MY2NjnD59WtiWmpqKCxcuCHOW7O3t8fbtW0RHRwtpoqOj8e7dO4U0Fy5cQGpqqpDm9OnTqFixIipXrgwAaNy4sUI58jTyPNSpCxERERERfX+KNGB6+/YtYmNjERsbi+zsbDx+/BixsbF49OgRJBIJhg0bhmXLluHgwYO4desWhg8fDl1dXfTq1QsAYG1tjdatW2Ps2LGIjo5GdHQ0xo4di3bt2gldhb169UKpUqUwfPhw3Lp1CwcPHsTSpUsxfPhwYe7T0KFDER4ejiVLluDvv//G4sWLERERgWHDhgGAWnUhIiIiIqLvT5HOYbp69So6d+4svPbz84Ofnx/69u2LgIAAjBkzBh8+fMCECROQnJyMhg0bYu/evdDT0xOOWb9+PSZOnIiePXsCADp06ID58+cL+8uWLYt9+/bB09MTLVu2hFQqxYgRIzBy5EghjYODAwIDA+Hr64s5c+agSpUqCAwMRKNGjYQ06tSFiIiIiIi+L5Lk5OSiWZaH8u1HnGxHn8d2QWKKa9uIZidHbAAAIABJREFU4aIPCuy46AMVI2wbJOZHbBvFdg4TERERERFRUWPAREREREREJIIBExERERERkQgGTERERERERCIYMBEREREREYlgwERERERERCSCARMREREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkggETERERERGRCAZMREREREREIhgwERERERERiWDAREREREREJIIBExERERERkQgGTERERERERCIYMBEREREREYlgwERERERERCSCARMREREREZEIBkxEREREREQiGDARERERERGJYMBEREREREQkQutLDk5LS0NoaChSUlLQrl07mJubF1S9iIiIiIiIipzaPUwTJkxAixYthNdZWVno0KEDPDw84OnpiSZNmuDmzZuFUkkiIiIiIqKioHbAdPLkSbRq1Up4vW/fPly9ehULFy5EWFgYDAwMsGDBgkKpJBERERERUVFQe0heYmIiLC0thdeHDx9G7dq1MXDgQADAwIEDsXr16gKvIBERERERUVFRu4dJR0cHHz58AADIZDKEh4cr9Dj9H3t3HhdVvf9x/D1iFmI2prKYIi64YG6ZoOYSkguauZJX67qHkqai5NK+mOZyXXIhC7QyK5XcMzWTDDfQui5ZKWZuRYgKKSrXhfn94YP5NcLRQRlm1Nfz8fDxcM75zjmfM3yzefM93+8xm806ffp0wVcIAAAAAE5id2AKCAjQ4sWLlZGRoQULFig9PV2tWrWy7j969KjKlCnjkCIBAAAAwBnsviVv9OjR6t69uypXrixJatSokR577DHr/nXr1umRRx4p+AoBAAAAwEnsDkwtWrTQpk2bFB8fr5IlS6pLly7Wfenp6WratKnat2/vkCIBAAAAwBny9Rym6tWrq3r16rm2lypVShMmTCiwogAAAADAFeT7wbXfffedEhISlJaWpiFDhqhatWrKzMzU7t27VatWLZnNZkfUCQAAAACFzu5FHy5cuKCuXbuqS5cumjZtmj799FOlpKRIurqCXu/evTV37lyHFQoAAAAAhc3uwPT2229r8+bN+uCDD7R3715ZLBbrvmLFiqlTp05au3atQ4oEAAAAAGewOzAtX75cAwYMULdu3eTu7p5rv7+/vw4fPlyQtQEAAACAU9kdmE6dOpXngg85TCaTsrKyCqQoAAAAAHAFdgem8uXLa//+/Yb7t2/fbn1GEwAAAADcCewOTGFhYfr444+1bds26zaTySRJio2N1fLly9WjR4+CrxAAAAAAnMTuZcVHjBihH374QU8++aSqVq0qk8mkMWPG6PTp00pNTVXbtm31/PPPO7JWAAAAAChUdgemYsWKacmSJVqyZImWL18uk8mky5cvq27duurcubO6d+9uHXECAAAAgDtBvh9cGxYWprCwMEfUAgAAAAAuxe45TAAAAABwtzEcYRo8eHC+D2YymTRr1qxbKggAAAAAXIVhYPr+++/zPSeJOUwAAAAA7iSGgWnv3r2FWQcAAAAAuBzmMAEAAACAgXyvknfo0CGtX79eR48elST5+vqqdevWqly5coEXBwAAAADOZHdgunLlikaPHq358+crOzvbZt/LL7+sPn36aNKkSXJzcyvwIgEAAADAGey+JW/cuHGKjY1VWFiY4uPjdfToUR09elTx8fEKCwvT/PnzNW7cOEfWCgAAAACFyu4RpoULF6pTp056//33bbbXq1dP77//vi5cuKCFCxfq9ddfL/AiAQAAAMAZ7B5hOn/+vJo2bWq4v3nz5jp//nyBFAUAAAAArsDuwNSkSRNt377dcP/27dvVpEmTAikKAAAAAFyB3YHpP//5j/bs2aORI0dq//79unTpki5duqT9+/drxIgR2rt3r6ZOnVqgxV25ckXjxo1TnTp15OXlpTp16mjcuHG6fPmytY3FYtGECRNUo0YNeXt7q3379vrll19s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80+Fh4fb/Z7Zs2fLz89PzZs3N2wzduxYnTx50vr6+++/18KFC/Xqq6+qfPny1u1Vq1a1/r18+fJ69dVXcx3Lw8Mj17aUlBTt2bNHr7zyinXbRx99pJEjR8rT01NPP/20qlSpovPnz2vr1q0aO3askpOTNWnSJJvjbNq0SX/99Zd8fX21ePFim1Gf++67L9d/P3PnztWBAwf0n//8x2b7I488Yv1769at1bVr11w1V65c2fp3Pz8/tWzZUjNnzlSLFi1ytQVQOAhMAJCHokWLqmjRm/sn8t577y3gahzLz89Pfn5+NtsGDhyoKlWqqHv37nYd49y5c3l+YYV9HnvsMT355JPXbZOWlqZixYrZhKWc7SVLlnRkefl24cIFxcXF3TBghYSE2Lw+d+6cFi5cqFatWqlOnTp5vsdsNtvdL7/55hu5u7urWbNmkqStW7dqxIgRaty4sb744gvdf//91raDBg3SgQMH9N133+U6zqJFi1S3bl317NlTr732mjIyMqwjrkWLFs1Vz1dffaXDhw/nWWdmZqYkqVq1anZdR+fOnTVkyBD9+eefKleunF3XDaBg3T6/AgUAAxEREfLy8tKff/6pnj176qGHHlKVKlX0yiuv6MqVKzZtMzIyFBERIV9fX/n6+mrQoEH6+++/cx3z2jlM3bt318MPPyyLxZKrbceOHW2+3OU1Z+iPP/5Qz549Va5cOVWtWlVjx47VxYsXcx3LaL5R+/bt1b59e+vrixcvavz48QoODlbFihXl7e2tli1bavXq1df5pArGG2+8IbPZrIMHD6p///6qWLGigoODrfv/+OMPRUREyN/fX56enmrUqJE++eQTm2NcuHBB48aNU4sWLeTr6ysfHx+1atVK69ats7bJuX3rypUrmj9/vvWWpZzfys+bN09ms1mJiYkaMWKEKlWqJF9fX40YMUKXLl1SRkaGwsPD5evrKz8/P7355pu5fn7Z2dmaNWuWGjVqJC8vL/n7+2vYsGHKyMiwaVetWjX17NlT33//vR5//HF5eXmpfv36+vLLL61t5s2bp4EDB0qSWrVqZa33n21uRs7n8PHHH+t///uf9bjTpk2T2WxWfHy8kpOTrdtzble199okaf369Wrfvr3Kly+v8uXLKzg4WJ9//rmkq7fBbdq0yeYcXl5e16158+bNOnPmjE2/cIZ169apefPmcnd3l3T1v+uiRYvqww8/tAlLOapVq5Yr5J0/f15fffWVunbtqs6dO+vy5ctauXJlodQvScHBwcrOztbXX39daOcEYIsRJgB3hOzsbHXr1k2PPPKI3n77bX333XeaNWuWKlWqpP79+0uSLBaLevbsqe3bt6tv376qXr261qxZY9eCCF26dNG6deuUlJRkc5tUWlqaNm/ebDPv4FoXLlxQx44ddfz4cQ0cOFDe3t5asmSJvv/++5u+3rNnz+qjjz5Sly5d9MwzzygrK0txcXF69tlntWTJErVq1eqmj22vZ599VpUrV9Zrr72my5cvS7p6C9QTTzwhNzc3hYeHq3Tp0vr22281dOhQ/f3339bP6fTp0/r000/VpUsX9erVS+fPn9eiRYv0r3/9S8uXL1eLFi1UrFgxzZ07VxEREWratKn19kBvb2+bOkaOHKly5crp5Zdf1vbt261BavPmzfLz89Prr7+ur7/+WtOmTVNAQIDCwsKs7x08eLDi4uL0zDPPaODAgTp69Kg++OAD7dq1S998842KFStmbXvw4EENGDBAvXv3Vs+ePfXxxx/rueeeU/369VW5cmW1aNFC/fv3V2xsrMaMGaNKlSpJkho2bHjDzzIzM1OnTp3Ktb1UqVLWz2HBggVKTEzUrFmzJEmNGzdWuXLlNH36dKWnp+vNN9+U9P+3dNl7bR9//LGGDx+umjVrKjIyUg888IB++uknrV+/Xj169NDYsWP1yiuv2JzDzc3tuteTmJioIkWKqG7duje89vzKzs7O87O69957VaJECevrixcvatOmTdaa//77b23ZskUhISH5Gqn56quvdO7cOXXp0kWenp5q1qyZFi1apF69et3SdWRlZeV5HSVKlLAZpfbx8ZGXl5cSExOt/5YBKFwEJgB3hEuXLqljx44aPXq0JKlfv35q3ry5FixYYP2SsWbNGm3dulVvvvmmhg0bJknq37+/OnbseMPjt2vXTu7u7lq6dKlNYFqxYoWuXLmiLl26GL73o48+0sGDBzV//nx17txZktSnT5/rzu24EbPZrL1799p8sQoPD1eLFi00a9asQglMDz/8sGJiYmy2vfHGGzKZTEpISFCpUqUkXf1ZhIeHa9KkSerXr588PDzk5eWlvXv36p577rG+97nnntNjjz2mOXPmqEWLFipSpIi6d++u559//rq3Bz700ENatGiR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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "alpha=0.2\n", "bins=30\n", "plt.figure(figsize=(12,8))\n", "plt.hist(cate_x_test, alpha=alpha, bins=bins, label='X Learner')\n", "plt.hist(tau_test, alpha=alpha, bins=bins, label='Actual')\n", "\n", "plt.title('Distribution of CATE Predictions by X-Learner and Actual')\n", "plt.xlabel('Individual Treatment Effect (ITE/CATE)')\n", "plt.ylabel('# of Samples')\n", "_=plt.legend()" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Validating CATE without TMLE" ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:01:42.542400Z", "start_time": "2020-04-14T19:01:42.485246Z" } }, "outputs": [], "source": [ "df = pd.DataFrame({'y': y_test, 'w': treatment_test, 'tau': tau_test, 'X-Learner': cate_x_test, 'Actual': tau_test})" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Uplift Curve With Ground Truth" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "If true treatment effect is known as in simulations, the uplift curve of a model uses the cumulative sum of the treatment effect sorted by model's CATE estimate.\n", "\n", "In the figure below, the uplift curve of X-learner shows positive lift close to the optimal lift by the ground truth." ] }, { "cell_type": "code", "execution_count": 10, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:01:44.896718Z", "start_time": "2020-04-14T19:01:42.545152Z" } }, "outputs": [ { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "plot(df, outcome_col='y', treatment_col='w', treatment_effect_col='tau')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Uplift Curve Without Ground Truth" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "If true treatment effect is unknown as in practice, the uplift curve of a model uses the cumulative mean difference of outcome in the treatment and control group sorted by model's CATE estimate.\n", "\n", "In the figure below, the uplift curves of X-learner as well as the ground truth show no lift incorrectly." ] }, { "cell_type": "code", "execution_count": 11, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:01:47.754106Z", "start_time": "2020-04-14T19:01:44.899377Z" } }, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAmsAAAIICAYAAAAxLKkQAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4xLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy8li6FKAAAgAElEQVR4nOzdd3gU1f7H8ffuphJSKElooYiANLtSVOxcERURsIOKVAFRRBQbCEj/eWmCDSxYLspVsQIqiCBd6R2kgyQEkpCydeb3B5fFYVGKZHeTfF7P4/OYc86c/YYh5uPMnDm2rKwsExEREREJS/ZQFyAiIiIif01hTURERCSMKayJiIiIhDGFNREREZEwprAmIiIiEsYU1kRERETCmMKaiIiISBhTWBMREREJYwprUiJs2bIl1CXIn+h8hBedj/Ci8yEnUlgTERERCWMKayIiIiJhTGFNREREJIwprImIiIiEsYhQF1ASeb1e8vLyQl1GiRITE0N2dnahzR8XF0dEhH6cRETk3NNvlyDzer0cOXKEpKQkbDZbqMspMaKjo4mJiSmUuU3TJCsri/j4eAU2ERE553QbNMjy8vIU1IoZm81GUlKSrpaKiEihUFgLAQW14kfnVERECovCmoiIiEgYU1gTERERCWMKayIiIiJhTGFNTothGLRo0YJ77rnH0p6fn8/ll1/Ok08+edLjdu7cSVJSEitWrAhGmSIiIsWOwpqcFrvdzqRJk1iwYAFTp071tw8YMACfz8eQIUNCWF0gj8dTaHO73e5Cm1tEROREeilUmEh6Z29QPy/rkcpnfEz16tUZPHgwzz//PNdeey3bt29nypQpfP3118TFxZ11Ld999x3Dhw9n48aNpKam0q5dO5555hmioqIAmDZtGq+//jpbtmwhJiaGq666imHDhlGpUiUA5s+fz+23384nn3zC8OHDWbNmDVOnTmXFihV8+eWX9O3bl0GDBpGZmUmzZs0YP3485cqV83/+Bx98wPjx49mxYwdVqlShY8eOdO/eHbv96P/LJCUlMWrUKObNm8ecOXPo2LFj2IVTEREpvnRlTc5Ix44dufzyy+natSs9evSgR48eNGnS5Kzn+/HHH+nSpQudO3dm8eLFTJgwgRkzZjBo0CD/GLfbTf/+/VmwYAHTpk0jMzOTRx99NGCugQMH8sILL7Bs2TIuv/xyAHbt2sVnn33GO++8w2effcbq1asZPHiw/5j33nuPwYMH89xzz7FkyRKGDBnC2LFjefvtty1zjxgxgubNm7Nw4UI6dep01t+viIjImdKVNTljr776Kpdccgk1atTg+eef/0dzjR49ml69evHggw8CUKNGDQYOHEjXrl0ZPHgwNpuN9u3b+8dXr16dV199lSuvvJK9e/dSufLxK4TPPPMMN9xwg2V+r9fLxIkT/TsYPPzww3z44Yf+/lGjRvHyyy/TqlUr//zbt29n8uTJdOnSxT+udevWdOjQ4R99ryIiImdDYU3O2AcffEBsbCz79u1j586d1K5dG4C2bduyaNEiANLS0li8ePEp51q1ahW//fYbY8eO9bcZhkFBQQEHDhygQoUKrFy5khEjRrBmzRqysrIwTROAPXv2WMLaJZdcEjB/WloaiYmJOJ1OACpUqMDBgwcBOHjwIHv27OHJJ5/kqaee8h/j9Xr9n/F3c4uISPG1Y9NKqte5ONRlAAprYeNsniELhd9++40xY8bw8ccfM3nyZLp3787s2bNxOByMGzfOH4pOd49MwzB45plnuPPOOwP6ypcvT15eHm3atOG6667jjTfeIDk5mczMTFq0aBHwoP/JnpuLjIy0fG2z2TAMw//ZcPRKYaNGjf62zn/yTJ6IiBQdhmkyb+7nXOF6E+rMDHU5gMKanAGn00m3bt24//77ufnmm7nwwgtp3LgxY8eOpU+fPv4H/s/ERRddxObNmznvvPNO2r927VoyMzN58cUXqV69OgBffvnlP/k2/FJSUqhYsSLbt2/nvvvuOydziohI0bU/38dvX/8f15X9EaLDZxtBhTU5bS+//DJOp5NXXnkFgNTUVEaPHk337t1p0aIFdevW/ctjt27disPhsLTVrl2bfv36cc8995CWlkbr1q2JiIhgw4YN/PrrrwwaNIgqVaoQHR3NW2+9RefOndm0aRNDhw49Z99T//796devH4mJiTRv3hyPx8OqVavYv38/ffr0OWefIyIi4e3rHUcos+g5rkvdAoRPUAOFNTlNv/zyC2+++SZffPEF8fHx/vY2bdrw5Zdf0r17d3744Ye/vP3ZuXPngLaFCxdy44038sknnzBq1CgmTJhAREQENWvW5P777weO3gqdNGkSgwYN4u2336Z+/fq88sortGnT5px8Xx06dKBU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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "plot(df.drop('tau', axis=1), outcome_col='y', treatment_col='w')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## TMLE " ] }, { "cell_type": "code", "execution_count": 12, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:01:47.798623Z", "start_time": "2020-04-14T19:01:47.756658Z" } }, "outputs": [], "source": [ "n_fold = 5\n", "n_segment = 5" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### TMLE Model Training" ] }, { "cell_type": "code", "execution_count": 13, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:01:47.844160Z", "start_time": "2020-04-14T19:01:47.800952Z" } }, "outputs": [], "source": [ "kf = KFold(n_splits=n_fold)" ] }, { "cell_type": "code", "execution_count": 14, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:02:39.248784Z", "start_time": "2020-04-14T19:01:47.847669Z" } }, "outputs": [ { "data": { "text/plain": [ "(array([0.48519038]), array([0.44700673]), array([0.52337404]))" ] }, "execution_count": 14, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tmle = TMLELearner(learner=LGBMRegressor(num_leaves=64, learning_rate=.05, n_estimators=300), \n", " cv=kf, calibrate_propensity=True)\n", "\n", "ate_all, ate_all_lb, ate_all_ub = tmle.estimate_ate(X=X_test, p=e_test, treatment=treatment_test, y=y_test)\n", "\n", "ate_all, ate_all_lb, ate_all_ub" ] }, { "cell_type": "code", "execution_count": 15, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:03:29.131036Z", "start_time": "2020-04-14T19:02:39.251831Z" } }, "outputs": [ { "data": { "text/plain": [ "(array([[0.23832289, 0.31886538, 0.49245553, 0.62525711, 0.74732071]]),\n", " array([[0.14385232, 0.24425482, 0.42198478, 0.53504789, 0.65116524]]),\n", " array([[0.33279346, 0.39347594, 0.56292628, 0.71546634, 0.84347617]]))" ] }, "execution_count": 15, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tmle = TMLELearner(learner=LGBMRegressor(num_leaves=64, learning_rate=.05, n_estimators=300), \n", " cv=kf, calibrate_propensity=True)\n", "\n", "ate_actual, ate_actual_lb, ate_actual_ub = tmle.estimate_ate(X=X_test, p=e_test, treatment=treatment_test, y=y_test, segment=pd.qcut(tau_test, n_segment, labels=False))\n", "\n", "ate_actual, ate_actual_lb, ate_actual_ub" ] }, { "cell_type": "code", "execution_count": 16, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:04:19.005066Z", "start_time": "2020-04-14T19:03:29.133747Z" } }, "outputs": [ { "data": { "text/plain": [ "(array([[0.25054712, 0.3684493 , 0.47452339, 0.61840324, 0.70596878]]),\n", " array([[0.15971414, 0.2884313 , 0.39486034, 0.53051316, 0.61611653]]),\n", " array([[0.34138009, 0.4484673 , 0.55418644, 0.70629331, 0.79582103]]))" ] }, "execution_count": 16, "metadata": {}, "output_type": "execute_result" } ], "source": [ "tmle = TMLELearner(learner=LGBMRegressor(num_leaves=64, learning_rate=.05, n_estimators=300), \n", " cv=kf, calibrate_propensity=True)\n", "\n", "ate_xlearner, ate_xlearner_lb, ate_xlearner_ub = tmle.estimate_ate(X=X_test, p=e_test, treatment=treatment_test, y=y_test, segment=pd.qcut(cate_x_test, n_segment, labels=False))\n", "\n", "ate_xlearner, ate_xlearner_lb, ate_xlearner_ub" ] }, { "cell_type": "markdown", "metadata": { "ExecuteTime": { "end_time": "2019-11-08T18:57:24.230391Z", "start_time": "2019-11-08T18:57:24.147391Z" } }, "source": [ "### Uplift Curve with TMLE as Ground Truth" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "By using TMLE as a proxy of the ground truth, the uplift curves of X-learner and the ground truth become close to the original using the ground truth." ] }, { "cell_type": "code", "execution_count": 17, "metadata": { "ExecuteTime": { "end_time": "2020-04-14T19:04:19.431780Z", "start_time": "2020-04-14T19:04:19.008535Z" } }, "outputs": [ { "data": { "text/plain": [ "Text(0, 0.5, 'Lift in GB')" ] }, "execution_count": 17, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "lift_actual = [0.] * (n_segment + 1)\n", "lift_actual[n_segment] = ate_all[0]\n", "\n", "lift_xlearner = [0.] * (n_segment + 1)\n", "lift_xlearner[n_segment] = ate_all[0]\n", "\n", "for i in range(1, n_segment):\n", " lift_actual[i] = ate_actual[0][n_segment - i] * .2 + lift_actual[i - 1]\n", " lift_xlearner[i] = ate_xlearner[0][n_segment - i] * .2 + lift_xlearner[i - 1] \n", "\n", "pd.DataFrame({'Population': np.linspace(0, 1, n_segment + 1),\n", " 'Actual': lift_actual,\n", " 'X-Learner': lift_xlearner,\n", " 'Random': np.linspace(0, 1, n_segment + 1)*lift_actual[-1]}).plot(x='Population', \n", " y=['X-Learner', 'Actual', 'Random'], \n", " figsize=(8, 8))\n", "plt.ylabel('Lift in GB')" ] } ], "metadata": { "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.6.0" }, "pycharm": { "stem_cell": { "cell_type": "raw", "metadata": { "collapsed": false }, "source": [] } }, "toc": { "base_numbering": 1, "nav_menu": {}, "number_sections": true, "sideBar": true, "skip_h1_title": true, "title_cell": "Table of Contents", "title_sidebar": "Contents", "toc_cell": false, "toc_position": {}, "toc_section_display": true, "toc_window_display": true } }, "nbformat": 4, "nbformat_minor": 2 }