{ "cells": [ { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "# Example 1: Interaction Indices for a Gradient Boosted Tree on the Folktables Income data set" ] }, { "cell_type": "code", "execution_count": 1, "metadata": {}, "outputs": [], "source": [ "import xgboost\n", "\n", "from folktables import ACSDataSource, ACSIncome\n", "\n", "from sklearn.preprocessing import StandardScaler\n", "from sklearn.model_selection import train_test_split\n", "from sklearn.metrics import accuracy_score\n", "\n", "import matplotlib.pyplot as plt\n", "import seaborn as sns\n", "\n", "sns.set_style(\"whitegrid\")\n", "sns.set_context(\"notebook\", rc={'axes.linewidth': 2, 'grid.linewidth': 1}, font_scale=1.5)\n", "\n", "import nshap" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Load the data" ] }, { "cell_type": "code", "execution_count": 2, "metadata": { "tags": [] }, "outputs": [], "source": [ "data_source = ACSDataSource(survey_year='2016',\n", " horizon = '1-Year', \n", " survey = 'person',\n", " root_dir = '../data/')\n", "data = data_source.get_data(states=[\"CA\"], download=True)\n", "X, Y, _ = ACSIncome.df_to_numpy(data) \n", "feature_names = ACSIncome.features\n", " \n", "# zero mean and unit variance for all features\n", "X = StandardScaler().fit_transform(X)\n", "\n", "# train-test split\n", "X_train, X_test, Y_train, Y_test = train_test_split(X, Y, train_size=0.8, random_state=0)" ] }, { "cell_type": "code", "execution_count": 3, "id": "3335e3aa", "metadata": {}, "outputs": [], "source": [ "# reduce input dimension to speed up computation\n", "X_train = X_train[:, 0:8]\n", "X_test = X_test[:, 0:8]\n", "feature_names = feature_names[0:8]" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Train the classifier" ] }, { "cell_type": "code", "execution_count": 4, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Accuracy: 0.830\n" ] } ], "source": [ "gbtree = xgboost.XGBClassifier()\n", "gbtree.fit(X_train, Y_train)\n", "print(f'Accuracy: {accuracy_score(Y_test, gbtree.predict(X_test)):0.3f}')" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Define the value function" ] }, { "cell_type": "code", "execution_count": 5, "metadata": {}, "outputs": [], "source": [ "vfunc = nshap.vfunc.interventional_shap(gbtree.predict_proba, X_train, target=0)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Compute n-Shapley Values" ] }, { "cell_type": "code", "execution_count": 6, "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "CPU times: total: 58min 39s\n", "Wall time: 4min 7s\n" ] } ], "source": [ "%%time\n", "n_shapley_values = nshap.n_shapley_values(X_test[0, :], vfunc) # with 8 variables, this takes about 5 minutes" ] }, { "cell_type": "code", "execution_count": 7, "id": "62d41183", "metadata": {}, "outputs": [], "source": [ "n_shapley_values.save('n-shapley-values.json')" ] }, { "cell_type": "code", "execution_count": 8, "id": "e5f98d36", "metadata": {}, "outputs": [], "source": [ "n_shapley_values = nshap.load('n-shapley-values.json') # load the pre-computed result instead" ] }, { "cell_type": "code", "execution_count": 9, "metadata": { "tags": [] }, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 9, "metadata": {}, "output_type": "execute_result" } ], "source": [ "n_shapley_values.plot(feature_names = feature_names)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "#### From the n-Shapley Values, we can obtain the 3-Shapley Values" ] }, { "cell_type": "code", "execution_count": 10, "metadata": {}, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "n_shapley_values.k_shapley_values(3).plot(feature_names = feature_names)\n", "plt.show()" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "#### ... Shapley Interaction Values (with the interventaional Shap Value function, these the SHAP interaction values from the shap package)" ] }, { "cell_type": "code", "execution_count": 11, "metadata": {}, "outputs": [ { "data": { "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfoAAAGlCAYAAAASzTRrAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjUuMSwgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/YYfK9AAAACXBIWXMAAAsTAAALEwEAmpwYAABfVUlEQVR4nO3deVxN+f8H8NdtE5WKyERUUqaQRKlk3yoMxjZj+NpmjHVkEtmGmTGWMXZDhCEiYYyt7GXfQmPLllSWQrTXvXXP7w+/e8dVDOO693Z7PR+PeYzOdt/33rqv+/mcz/kckSAIAoiIiEgr6ai7ACIiIvp4GPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU8aRSqVYvPmzejTpw+aNGmCxo0bw9/fHwsXLkR2drbCtpMmTYKjo6PKa1Tl4y5btgyOjo6Iiop663Y9e/aEl5cXioqK3um4jo6OmDRpkjJKJCINx6AnjRIUFISffvoJ1tbWCAgIwIQJE9CoUSOEhoaiV69eeP78ubpLVKlu3boBAKKjo9+4zf3793Ht2jX4+flBT09PVaURURnBTwXSGBcvXsTu3bsxadIkDB48WGFdy5YtMW7cOISGhmLChAlqqlD1ateuDRcXFxw7dgz5+fmoWLFiiW327dsH4J8vBUREr2KLnjTGpUuXAADe3t4l1vn6+sLS0hKXL19WcVXq161bN+Tl5eHYsWOlrt+3bx9sbGzQqFEjFVdGRGUBg56Upm3btpg+fTr++usv+Pv7o2HDhujYsSM2bdr0TvsbGRkBALZu3QqpVFpi/aFDh0o91pUrVzBgwAA0atQI3t7e+OWXX1BYWKiwzenTpzFs2DB4eHjA2dkZPj4+mD59OrKysuTbTJo0CR06dMClS5fQs2dPNGrUCJ07d8bmzZv/tfbHjx8jKCgIzZs3R8OGDdG9e3fs2rVLvv748eNwdHQstf5x48ahRYsWKC4uLvXYsi75/fv3l1h39+5d3Lp1S96al0gkCAkJQbdu3dC4cWM0atQI3bp1w7Zt295a/5vO2Ze2/OjRo+jXrx9cXFzQrFkzjBkzBvfu3VPY5uHDhxgzZgxatGiBhg0bws/PD6tXry71fSWij4tBT0p1/PhxzJo1C506dUJwcDAqVqyIH3/8EbGxsf+6b8eOHWFqaoqwsDC0b98ec+fOxbFjx5CXlwcAMDAwKHW///3vf6hbty4mT56Mhg0bYv369Zg/f758/YkTJzBkyBDk5+dj7NixmDJlCho1aoSIiAjMnj1b4VgvXrzAsGHDYGNjg6CgIFSvXh0zZsxASEjIG+tOS0tD7969cerUKQwYMAATJ06Eubk5JkyYgNDQUACAl5cXqlatWuJce15eHmJiYtC5c2fo6uqWevwqVarA29sbR48eLfEFZs+ePQD+6bYPDg7GkiVL4O7ujilTpmD06NHIy8vDlClTcO7cuTc+h3e1Y8cOjBgxAhUrVsSECRMwaNAgXLp0CX369JGHvUQiwbBhw3Dt2jUMGjQI06ZNg62tLebPn49Vq1Z9cA1E9J4EIiVp06aN4OjoKNy4cUO+LD09XXB0dBTGjx//Tse4fPmy0K5dO8HBwUH+n7OzszB8+HAhPj5eYduJEycKDg4Owrp16+TLiouLhQ4dOgitWrWSLxs6dKjQpk0bobCwUGH/Pn36CK6uriWO9/PPP8uXFRUVCf379xcaNWokvHjxQmG7V/dzd3cX0tLSFI4/fvx4oUGDBsLTp08FQRCEn376Sahfv76Qnp4u32b37t2Cg4ODcPny5be+Lrt27RIcHByEgwcPKizv2LGj0LdvX0EQ/nmt58+fr7DN3bt3BQcHB+Gnn36SL3NwcBAmTpz4xp9LW56dnS00adJECAgIUNgmPT1daNasmTBy5EhBEAQhPj5ecHBwEKKiouTbSKVSYciQIUJQUNBbnycRKR9b9KRUtra2qF+/vvznatWqwcLCAk+fPn2n/V1cXBAdHY2QkBD07dsXtWrVgkQiwdGjR9G3b1/s3r27xD7+/v7yf+vo6MDJyUnh8UJCQrB9+3aFHoHnz5/D2NhY3lvwquHDh8v/rauri4EDB6KgoACnTp0qsa1UKsWhQ4fQtGlT6OnpISMjQ/5fx44dIRaLcfLkSQBAly5dIJVKFbrg9+7dC2tra7i4uLz1dWnfvj0qVaqk0CNw/fp1JCUlyVvz1apVQ1xcHEaOHCnfRhAE+SV3ubm5b32Mf3Py5Enk5OSgffv2Cs9TV1cXzZs3x4kTJ1BUVITq1atDJBIhJCQEx48fh1gshkgkwpo1azB37twPqoGI3h9H3ZNSValSpcQyAwMD+bnZgoKCEtfDV6pUSX5+HgD09PTQunVrtG7dGgCQmJiI8PBwhIWF4eeff0aHDh1gaGgo375q1aoKxzM0NIREIpH/rKuri5SUFCxevBh37txBcnIy0tLSSq3fzMwMFhYWCsvq1KkDAHjw4EGJ7Z8/f47s7GwcOnQIhw4dKvWYjx49AgA0btwY1tbWiI6OxldffYXs7Gz5aYV/U7FiRbRv3x5HjhyBWCyGgYEB9u7dC319ffj6+sq3MzAwwK5du3DixAkkJSXh/v378oAXPvCO1MnJyQCAgICAN26TkZGBGjVqYMKECViwYAGGDRuGSpUqwdPTE35+fvD19X3jKQoi+jgY9KRUOjpv7yTat28fgoODFZaNHj0aY8aMwbJly2BpaYnevXsrrLezs8PUqVMhkUiwZcsW3LlzBw0aNHjnx9yyZQt++OEH2NraomnTpujYsSNcXFwQFhZWoodAX1+/xP6yLymlBZRsAF2nTp3Qr1+/Uh/f2tpa/u8uXbogJCQE6enpOHHiBMRiMbp06fLW+mW6du0qD/G2bdsiKioKPj4+MDc3BwCIxWIMHToUcXFx8PDwgKenJwYNGgR3d3f5l6b38frgQNnr8NNPP6FWrVql7mNqagoAGDp0KLp06YKDBw8iNjYWJ0+exOHDh7Fz5075uAUiUg0GPalUixYtsG7dOoVlsiDcuXMnAKBXr14QiUQl9nVwcACAUq8lf5PCwkLMmTMHHh4eWLt2rcKEMosXLy6x/dOnT5Gbm6vQw5CUlATgn5b9q6pUqYKKFSuiqKgIXl5eCusePnyI69evK9TbtWtXrFixAjExMYiNjYWjoyPq1av3Ts/F29sbFhYWOHjwIKpVq4YHDx4ozCmwb98+nDt3DrNmzUKvXr3ky9/Ue/EqHR0diMVihWWvn26pWbOm/Dm//lzPnj0LqVQKAwMDvHjxAgkJCWjSpAm++uorfPXVV8jLy8OkSZOwf/9+3Lx5Uy0zGhKVVzxHTypVvXp1eHl5KfwnC/quXbsiJSUFK1euLLFfYWEhdu7cCRsbG9jZ2b3z4xUUFCA/Px82NjYKIX/jxg35KPRXp40VBEHhEriioiKsX78eJiYm8PT0LHF8PT09tGzZErGxsUhISFBYN2fOHIwaNUphNr+6devCyckJhw4dwunTp9+5NQ+87FHw9fXFsWPHcPjwYRgbG6Nt27by9S9evAAA2NvbK+y3YcOGEs/zdRYWFkhISFDo3pdNxCPj5eWFChUqIDQ0VOHUSFpaGkaOHIn58+dDJBLh5MmT+N///ocjR47It6lUqZL8ixq77olUiy160hjDhw/H2bNnsWjRIsTGxqJdu3aoUqUKHj16hN27d+Px48dYu3Ztqa39NzE1NYWLiwt27NgBY2Nj2Nra4vbt24iMjJR3+efm5sq7nAHg999/x4MHD1CvXj1ERUXh0qVLmDVr1ht7EgIDA3H27Fn0798f/fv3h5WVFWJiYuQDCF9vsXfp0gXz5s2DSCRSGEj4Lrp164awsDBs2rQJnTp1QoUKFeTrvLy8oKenh6CgIPTv3x96eno4evQoTpw4AX19/bcOxuvSpQvWrl2L0aNHo3Xr1rh27RqioqIUxlxUqVIF48ePx+zZs9G3b19069YNRUVFCA8PR2FhISZOnAgAaNOmDWxtbTFlyhRcu3YNtWvXRmJiIjZt2oTmzZuX+CJCRB8Xg540hqGhITZs2IDNmzcjKioKoaGhyM3NlXcVDx8+HLa2tu993MWLF2P27NnYvn07xGIxatasiW+++QZ169bFmDFjcObMGXTq1Em+/Zo1azBjxgz8+eefsLe3x7Jly9ChQ4c3Hr927drYunUrlixZgq1btyIvLw/W1tYIDg7GgAEDSmzfpUsXzJ8/Hy4uLvLu8HfVqFEj2NjYKIy2l3FwcMCSJUuwbNkyLFiwAEZGRqhXrx7WrVuH8PBwnDt3DhKJpNRxCN999x2Kioqwd+9enDhxAi4uLli/fj0CAwMVths0aBAsLS2xbt06LFy4EIaGhnB2dsavv/4KNzc3AC9b72vXrsWSJUuwe/duPH36FNWqVcOXX36J0aNHv9fzJaIPJxI+dCgukZaYNGkS/vzzT9y8efOjPk56ejpatWqFadOm4csvv/yoj0VExHP0RCq2detWGBgYvHe3PRHRf8GueyIV+e2333D79m3Exsaif//+CuMCiIg+FrboiVQkLy8PZ86cQfv27TF+/Hh1l0NE5USZP0cfFxen7hKIiMos2SBK0l7suiciolJlZmbi6dOnJSZTIs2hq6sLExMTVKlSReFy21dpTdB/7G+lcXFxGv/NlzV+OE2vD9D8GjW9PoA1yo7/NgUFBUhLS0OtWrVQsWLF95q/glRDEARIJBJkZWUhOTkZtWvXLjXseY6eiIhKePLkCapVq4ZKlSox5DWUSCSCgYEBLCwsYG5ujoyMjFK3Y9ATEVEJBQUFMDY2VncZ9I4qV65c4s6gMgx6IiIqoaioSOH+EKTZ9PX1S9xxUoZBT0REpWKXfdnxtveKQU9ERKTF2C9DRETvrOnPB/E058Mut7MwNsCFqW++URQpF1v0RET0zj405JV1DHp3DHoiItI4AwYMgKOjI7766qs3bvPFF1/A0dERS5cufefjtm3bFlOmTFFGiWUGu+6JiEgjiUQixMXFya/pf9Xjx49x6dKl9z7msmXLYGJioqwSywS26ImISCM1aNAAenp6OHDgQIl10dHRqFevHnR1dd/rmE5OTrC2tlZWiWUCg56IiDSSsbExWrRogejo6BLr9u3bB19fX4VlKSkpmDBhAlq0aAFnZ2d4eXlh0qRJyMzMlG/zatd9amoqHB0dceDAAYwePRqurq5wd3fHtGnTkJ+f/3GfnAox6ImISGP5+voiLi4Oz549ky978OAB/v77b/j7+8uX5efn46uvvkJSUhJmzJiBNWvWYMCAAdi9ezcWLlz41seYOnUqrK2t8fvvv2Po0KGIjIxESEjIR3tOqsZz9EREpLHatm0LPT09HDx4EP369QMAREVFwcnJCXXq1JFvl5iYiJo1a2LevHmoVasWAKB58+aIj4/H+fPn3/oYbdq0wcSJEwEAnp6eOHnyJGJiYjBu3LiP86RUjEFPREQa69Xue1nQ79u3D35+fgrbOTs7Izw8HFKpFElJSbh//z7u3LmDxMTEf32MJk2aKPxco0YNpKWlKe9JqBmDnoiINJqvry8mTpyIjIwM5OTk4Pr161i2bFmJ7datW4eVK1fixYsXsLCwQIMGDVCxYkXk5eW99fiGhoYKP+vo6EAqlSr1OagTg56IiDSarPv+8OHDyMjIQOPGjWFlZaWwze7duzFnzhwEBQWhR48eqFKlCgDgu+++w/Xr19VRtsZg0BMRkUYzMjKCj48P9u/fj4yMDHTv3r3ENnFxcTA3N8fQoUPly3JzcxEXF4cKFSqosFrNw1H3RESk8Xx9fXHmzBncuHEDnTt3LrG+UaNGeP78OebNm4dz585h165d6N+/P54+fapVl8r9F2zRExGRxmvTpg10dXXh6uqK6tWrl1jfo0cPpKamYvv27di4cSMsLS3RqlUrfPnll5g2bRru3bsHW1tbNVSufgx6IiJVkRQA+ob/vh0ANzc3pR+zLAkLC1P42cjICPHx8SW2e/X8+9ixYzF27NgS2/Tp00f+7yNHjsj/XatWLdy8ebPE9nPmzPlPNWsqBj0RkaroGwIzTJV7zBmZ/76NElkYGyjlNrWkOgx6IiJ6Z7yPfNmj1MF4e/bsgb+/Pxo1agRfX1/s3Lnzrdunp6cjMDAQnp6eaNKkCUaOHIn79+8rsyQiIqJyTWlBHxUVhcDAQHh7e2P58uVwd3fHxIkTS70ZAQAUFhZi2LBhuHLlCqZPn47ffvsN6enp+Oqrr5CVlaWssoiIiMo1pXXdL1iwAL6+vpg8eTIAwMfHB5mZmVi8eHGpl0IcPXoUN2/exPbt29GgQQMAQL169dCuXTvs378fvXv3VlZpRERE5ZZSWvQpKSlITk5Gx44dFZZ36tQJiYmJSElJKbFPixYtEB4eLg95ANDX1wcAiMUfNtCDiIiIXlJK0MtuGvD6NYqyOwvdu3evxD7Gxsbyy0ckEgkSEhIwadIkmJmZoUMHDvYgIiJSBqV03WdnZwN4Gd6vMjIyAgDk5OS8df8xY8bg6NGj0NHRwaxZs0qdDOHfxMXFvfc+mvgYH4o1fjhNrw/Q/Bo1vT5APTW+87Xx76ksvN6kPkoJekEQAAAikajU5To6b+84+Prrr/G///0Pu3btQnBwMACgZ8+e71XDx/oDkomLi/voj/GhWOOH0/T6AM2vUdPrA8pGje/jvzwXfjkoP5QS9CYmJgBKttxzc3MV1r+J7JfU09MTDx48QEhIyHsHPRERqcCv9YDc9A87hlF1YMJt5dRD/0op5+hl5+aTk5MVlsuuiS9tfuHr169j7969JZY7OzsjPf0Df4mIiOjj+NCQV9Yx6J0pJejr1KmDWrVqlbhm/sCBA7CxsSlx32AAOHPmDL7//nuFLwfFxcU4c+YMHBwclFEWERGVUVKpFJs3b0bXrl3h6uqK9u3bY/bs2f865utdOTo64vfff1fKsd7Fjh074OjoiMePH6vsMWWUdh39qFGjEBwcDFNTU7Ru3RpHjhxBVFQUFi5cCADIyMhAcnIy7O3tYWxsjJ49eyIsLAwjRozAmDFjYGhoiE2bNuHWrVtYu3atssoiIqIyKDQ0FIsWLcLQoUPh6emJe/fuYcmSJbhz5w7WrFmj7vLKFKUFfc+ePSEWi7F27VpERkbC2toac+fOhZ+fHwAgJiYGwcHB2LBhAzw8PGBmZoaNGzdi/vz5+PHHH5Gbm4tGjRph/fr1aNq0qbLKIiKiMkYQBISGhqJv3774/vvvAQBeXl4wNzdHQEAAbty4gU8//VTNVZYdSr2pTb9+/dCvX79S1/Xs2bPEALuaNWvKW/xERETAy4Hc3bp1g6+vr8JyOzs7AC/Hg3366acYMGAAbG1tUbNmTYSHhyMjIwPOzs6YMmUKGjZsKN/v3Llz+O2335CQkIAaNWrghx9+eKc6YmNjsWLFCty8eROGhoZo164dvv/+e5ibmwMAli5dir1798LPzw+bNm2CmZkZduzYgYoVK2LlypXYunUrnj9/Dm9vbzRr1qzE8c+fP49Fixbh6tWrMDQ0RIcOHRAUFITKlSsDeNnd/8MPP2DKlClYsmQJDAwMEBYWBmtr6/d6PXn3OiIi0ijGxsaYOnVqieWHDh0CANjb28uX7du3D/b29pg2bRoEQcDcuXPx3Xff4dChQ9DR0cG1a9cwZMgQNG/eHEuWLEFqairGjx//rzVs374dkydPxmeffYaRI0fi8ePHWLx4MeLj47F161ZUrFgRwMuZYY8ePYoFCxYgKysLRkZGmDt3LjZs2IARI0bAxcUF0dHR+O233xSOf/78eQwePBheXl5YvHgxnj17hoULF+LmzZvYvHkz9PRexrNEIkFoaChmz56N58+fv3fIAwx6IiIqA+Lj47Fq1Sq0b98edevWlS8vLi5GaGiofMK23NxcTJw4Ebdu3UL9+vUREhKCatWqYcWKFfJp1mWnAN5EKpViwYIFaN26NebNmydfXr9+ffTu3Rs7duxA//79AQBFRUWYNGkSPDw8AABZWVkICwvDkCFDMHr0aAAv7/2SlpaG48ePy4/122+/oW7duli5cqV8rhknJyf06NED+/btQ7du3QC8PI0xcuRItGrV6j+/dkq9TS0REZGyxcXFYdiwYahVqxZ+/vlnhXWOjo4Ks7JaWloCAPLy8uT7+vj4yEMeADp27AhdXd03Pt69e/fw9OlT+Pv7Kyxv1KgR6tSpg7Nnzyosf/VKscuXL0MikaBdu3YK27x6GiI/Px/x8fFo3bo1pFIpioqKUFRUhHr16sHKygqnTp164/H/C7boiYhIY+3btw+TJk2CjY0NQkND5efHZQwNDRV+lrWOpVIpACAzMxNVqlRR2EZPT6/EcV714sULAEC1atVKrKtatarCJX66uroKx8rMzASAEo/56rGysrIglUqxcuVKrFy5ssRjvD6XjIWFxRtrfRcMeiIi0kjr1q3D3Llz4e7ujuXLl//rLKulMTMzw7NnzxSWCYIgD+TSmJqaAgCePHlSYt2TJ0/g4uLyxn1lof/06VPUrl1bvlz25QF4eR8YkUiEIUOGlBhwKFuvTOy6JyIijRMZGYk5c+bA19cXoaGh/ynkgZdTqx89ehQFBQXyZcePH4dEInnjPnZ2drCwsCgxe+vff/+NlJQUNGnS5I37urq6wtDQsMQEckePHpX/29jYGE5OTkhKSkLDhg3l/9na2mLRokWIj49/36f5VmzRExGRRnn27BlmzZqFmjVron///rh+/brC+tq1a5foGn+TUaNG4dChQ/j6668xZMgQPH36FIsXL1Y4Z/86HR0djBs3DlOnTkVQUBC6dOmCtLQ0LF68GLa2tujRo8cb9zUyMsLIkSOxaNEiGBoawt3dHTExMQpBDwDfffcdvv32W0yaNAl+fn4Qi8VYvXo1bt26hYkTJ77Tc3tXDHoiItIox48fR35+Ph48eCAf3f6qefPm4bPPPnunY9nY2GDjxo2YM2cOxo0bh6pVq2LixImYM2fOW/fr3bs3KlWqhNWrV2PkyJEwNTVFu3btEBAQgEqVKr113+HDh6NSpUpYv3491q1bB1dXV0ycOBEzZsyQb9OqVSuEhoZi2bJlGDNmDCpUqICGDRtiw4YNSp8GXiTI7iVbRslutcjb1LJGZdD0+gDNr1HT6wPUXOMMUyUf783nmt/m3z473zj7nLLq/49105u96T3jOXoiInp3RtU14xj0zth1T0RE7473kS9z2KInIiLSYgx6IiIiLcagJyIi0mIMeiIiKlUZvyirXHnbe8WgJyKiEvT19ZGfn6/uMugd5efno0KFCqWuY9ATEVEJ1atXx4MHD5CXl8eWvYYSBAESiQQZGRlITU1F1apVS92Ol9cREVEJlStXBgA8fPjwrfPCk3rp6enB0NAQtWvXLnEnP/k2Kq6JiIjKiMqVK8sDn8oudt0TERFpMQY9ERGRFmPQExERaTGeoyciUhFBUgCRku/aJkgKINIvfRAWEcCgJyJSGZG+IWwm7VXqMZPm+Cv1eKR92HVPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFlBr0e/bsgb+/Pxo1agRfX1/s3Lnzrds/efIEU6dORZs2beDq6oqePXsiKipKmSURERGVa3rKOlBUVBQCAwMxcOBA+Pj44NChQ5g4cSIMDQ3RuXPnEtuLxWIMGzYM2dnZGDt2LKpXr479+/dj3LhxKC4uRpcuXZRVGhERUbmltKBfsGABfH19MXnyZACAj48PMjMzsXjx4lKD/tixY0hISEBkZCQaNWoEAPD29sbDhw+xevVqBj0REZESKKXrPiUlBcnJyejYsaPC8k6dOiExMREpKSkl9jEyMkLfvn3RsGFDheV2dnZITk5WRllERETlnlJa9ImJiQAAW1tbheV16tQBANy7dw/W1tYK6zw9PeHp6amwTCKRIDY2FvXq1VNGWUREROWeUoI+OzsbAGBsbKyw3MjICACQk5PzTseZP38+kpKSsHz58veuIS4u7r330cTH+FCs8cNpen2A5teo6fUB6qnRzc3toxy3LLzepD5KCXpBEAAAIpGo1OU6Om8/QyAIAn799Vf88ccfGDp0KNq3b//eNXysPyCZuLi4j/4YH4o1fjhNrw/Q/Bo1vT6gbNT4Pv7Lc+GXg/JDKUFvYmICoGTLPTc3V2F9acRiMSZNmoS9e/di6NChCAoKUkZJREREBCUFvezcfHJyMhwdHeXL79+/r7D+dTk5ORg+fDguXryIyZMn43//+58yyiEiIqL/p5RR93Xq1EGtWrUQHR2tsPzAgQOwsbGBlZVViX2Ki4sxYsQIxMfHY8GCBQx5IiKij0Bp19GPGjUKwcHBMDU1RevWrXHkyBFERUVh4cKFAICMjAwkJyfD3t4exsbG2LJlC86dO4e+ffvik08+weXLl+XHEolEcHFxUVZpRERE5ZbSgr5nz54Qi8VYu3YtIiMjYW1tjblz58LPzw8AEBMTg+DgYGzYsAEeHh7Yv38/ACAiIgIREREKx9LV1cX169eVVRoREVG5pbSgB4B+/fqhX79+pa7r2bMnevbsKf95w4YNynxoIiIiKgXvXkdERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPRERERajEFPRESkxRj0REREWoxBLyl4p83c3NyUfkwiIqKPTU/dBaidviEww1S5x5yRqdzjERER/Uds0RMREWkxBj0REZEWY9ATERFpMQY9ERGRFmPQExERaTEGPRERkRZj0BMREWkxBj0REZEWK/cT5giSAoiUPMGNICmASN9QqcckIiL6L8p90Iv0DWEzaa9Sj5k0x1+pxyMiIvqv2HVPRESkxRj0REREWoxBT0REpMUY9ERERFqMQU9ERKTFGPREpD0kBe+0mZubm1KPR6TJyv3ldUSkRfQNgRmmyjuekufYIFIHtuiJiIi0GIOeiIhIizHoiYiItBiDnoiISIsx6ImIiLQYg56IiEiLMeiJiIi0mFKDfs+ePfD390ejRo3g6+uLnTt3vvO+c+fOxaBBg5RZDhERUbmntAlzoqKiEBgYiIEDB8LHxweHDh3CxIkTYWhoiM6dO791340bN2Lt2rXw9PRUVjlEVA4JkgKIlDjJjSApgEjfUGnHI1IHpQX9ggUL4Ovri8mTJwMAfHx8kJmZicWLF78x6NPS0jBv3jzs27cPJiYmyiqFiMopkb4hbCbtVdrxkub4K+1YROqilK77lJQUJCcno2PHjgrLO3XqhMTERKSkpJS638KFC3H9+nWsW7cOn376qTJKISIiolcoJegTExMBALa2tgrL69SpAwC4d+9eqfsNGzYMe/fuRfPmzZVRBhEREb1GKV332dnZAABjY2OF5UZGRgCAnJycUvezt7dXxsMDAOLi4v7Tfu98F6v39F/rKauP+z40vUZNrw/Q/BrVVd/H+HtW5nPRts8bKhuUEvSCIAAARCJRqct1dD7+VXwf6w/ov1JHPXFxcRr3OrxO02vU9PoAza9R0+t7X2XhufyXGvnloPxQSgLLBtK93nLPzc1VWE9ERESqpZSgl52bT05OVlh+//59hfVERESkWkoJ+jp16qBWrVqIjo5WWH7gwAHY2NjAyspKGQ9DRERE70lp19GP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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 11, "metadata": {}, "output_type": "execute_result" } ], "source": [ "n_shapley_values.k_shapley_values(2).plot(feature_names = feature_names)" ] }, { "cell_type": "markdown", "metadata": { "tags": [] }, "source": [ "#### ... and the usual Shapley Values" ] }, { "cell_type": "code", "execution_count": 12, "id": "91f44f14", "metadata": {}, "outputs": [ { "data": { "image/png": "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0KABnJ2d1VUqERGR5NQyBJ2amoqUlBR06dJFZbu3tzcSEhKQmppa5nGBgYG4du0aQkND0ahRozLbXL9+HQ4ODuook4iISGuoJYATEhIAADY2NirbraysAACJiYllHjdixAjs2rULbdq0KXN/SUkJbt26hQcPHqBXr15o0qQJvLy8sGrVKgiCoI7SiYiIJKGWIeicnBwAgJGRkcp2Q0NDAEBubm6Zx9nZ2b32vImJiSgoKEBiYiImTJgAU1NTHDhwAPPmzUNubi7Gjh37VnXGxcW9Vft3pamv8660vT5A+2vU9voA7a9R2+sDpKmxRYsW7+W85eH1/rdRSwAre6MymazM7To679bRtrCwQEhICBo1aoTq1asDANzc3FBQUICQkBAMGzasVOi/zvv6h/2iuLg4jXydd6Xt9QHaX6O21wdof43aXh9QPmp8G+/yvTC03y+1DEErJ1C93NPNy8tT2f+2jIyM0K5dOzF8lby8vCCXy185tE1ERKTt1BLAymu/KSkpKtuTk5NV9r+tGzduICwsDAqFQmV7QUEBAMDU1PSdzktERCQ1tQSwlZUV6tSpg+joaJXte/fuhbW1NSwtLd/pvMnJyQgICMCRI0dUtu/evRt16tRB7dq137lmIiIiKantPuDRo0fD398fJiYm8PLywsGDBxEVFYXAwEAAQGZmJlJSUmBnZ/fG1229vLzQpEkTTJs2DZmZmahZsyZ27NiBgwcPYsmSJaWuORMREZUXagtgX19fyOVyrFq1ChEREahbty7mzp2Lbt26AQAOHz4Mf39/rF27Fq1bt36jc+rr6yMkJASLFi1CUFAQMjMz0aBBAwQFBaFTp07qKp2IiEjj1BbAANC/f3/079+/zH2+vr7w9fV95bHr1q0rc7uZmRlmzJihlvqIiIi0BZ+GREREJAEGMBERkQQYwERERBJgABMREUmAAUxERCQBBjAREZEEGMBEREQSYAATERFJgAFMREQkAQYwERGRBBjAREREEmAAExERSYABTEREJAEGMBERkQQYwERERBJgABMREUmAAUxERCQBBjAREZEEGMBEREQSYAATERFJgAFMREQkAQYwERGRBBjAREREEmAAExERSYABTEREJAEGMBERkQQYwERERBJgABMREUmAAUxERCQBBjAREZEEGMBEREQSYAATERFJgAFMREQkAQYwERGRBBjA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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 12, "metadata": {}, "output_type": "execute_result" } ], "source": [ "n_shapley_values.k_shapley_values(1).plot(feature_names = feature_names)" ] }, { "cell_type": "code", "execution_count": 13, "metadata": {}, "outputs": [ { "data": { "text/html": [ "
" ], "text/plain": [ "" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "import shap\n", "shap.initjs()" ] }, { "cell_type": "code", "execution_count": 14, "metadata": {}, "outputs": [ { "data": { "text/html": [ "\n", "
\n", "
\n", " Visualization omitted, Javascript library not loaded!
\n", " Have you run `initjs()` in this notebook? If this notebook was from another\n", " user you must also trust this notebook (File -> Trust notebook). If you are viewing\n", " this notebook on github the Javascript has been stripped for security. If you are using\n", " JupyterLab this error is because a JupyterLab extension has not yet been written.\n", "
\n", " " ], "text/plain": [ "" ] }, "execution_count": 14, "metadata": {}, "output_type": "execute_result" } ], "source": [ "shap.force_plot(vfunc(X_test[0,:], []), n_shapley_values.shapley_values())" ] }, { "cell_type": "markdown", "metadata": { "tags": [] }, "source": [ "### Let's compare this to the Shapley Values from the shap package" ] }, { "cell_type": "code", "execution_count": 15, "metadata": {}, "outputs": [], "source": [ "explainer = shap.KernelExplainer(gbtree.predict_proba, shap.kmeans(X_train, 25))\n", "\n", "shap_values = explainer.shap_values(X_test[0, :])" ] }, { "cell_type": "code", "execution_count": 16, "metadata": {}, "outputs": [ { "data": { "text/html": [ "\n", "
\n", "
\n", " Visualization omitted, Javascript library not loaded!
\n", " Have you run `initjs()` in this notebook? If this notebook was from another\n", " user you must also trust this notebook (File -> Trust notebook). If you are viewing\n", " this notebook on github the Javascript has been stripped for security. If you are using\n", " JupyterLab this error is because a JupyterLab extension has not yet been written.\n", "
\n", " " ], "text/plain": [ "" ] }, "execution_count": 16, "metadata": {}, "output_type": "execute_result" } ], "source": [ "shap.force_plot(explainer.expected_value[0], shap_values[0])" ] }, { "attachments": {}, "cell_type": "markdown", "id": "955c2411", "metadata": {}, "source": [ "### Now, let us repeat this exercise with the the Shapley Taylor interaction index" ] }, { "cell_type": "code", "execution_count": 17, "id": "3058d8ef", "metadata": {}, "outputs": [], "source": [ "shapely_taylor = nshap.shapley_taylor(X_test[0, :], vfunc)" ] }, { "cell_type": "code", "execution_count": 18, "id": "c400d654", "metadata": {}, "outputs": [], "source": [ "shapely_taylor.save('shapley-taylor.json')" ] }, { "cell_type": "code", "execution_count": 19, "id": "37d0f0aa", "metadata": {}, "outputs": [], "source": [ "shapely_taylor = nshap.load('shapley-taylor.json')" ] }, { "cell_type": "code", "execution_count": 20, "id": "e1acc94c", "metadata": {}, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 20, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# for n=d, both n-Shapley Values and the Shapley Taylor interaction index are equal to the Möbius transform, so we get the same picture as above\n", "shapely_taylor.plot(feature_names = feature_names)" ] }, { "cell_type": "code", "execution_count": 21, "id": "8ce7a9fb", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 21, "metadata": {}, "output_type": "execute_result" } ], "source": [ "nshap.allclose(n_shapley_values, shapely_taylor)" ] }, { "cell_type": "code", "execution_count": 22, "id": "324a2b02", "metadata": {}, "outputs": [], "source": [ "# more useful functions for the shapley taylor interaction index might come in the future. for now, we have to compute the index again for every order\n", "k_shapely_taylor = nshap.shapley_taylor(X_test[0, :], vfunc, 3)" ] }, { "cell_type": "code", "execution_count": 23, "id": "a85161b3", "metadata": {}, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 23, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# this plot, again, is almost the same as for 3-Shapley Values. A very close comparison of the two figures reveal, however, that they are not exactly the same\n", "k_shapely_taylor.plot()" ] }, { "cell_type": "code", "execution_count": 24, "id": "6bc5cdcd", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "False" ] }, "execution_count": 24, "metadata": {}, "output_type": "execute_result" } ], "source": [ "nshap.allclose(n_shapley_values.k_shapley_values(3), k_shapely_taylor) # this confirms that the interaction indices are not exactly the same" ] }, { "attachments": {}, "cell_type": "markdown", "id": "dac5dce7", "metadata": {}, "source": [ "### Now, the same exercise for Faith-Shap interaction index" ] }, { "cell_type": "code", "execution_count": 25, "id": "8318d612", "metadata": {}, "outputs": [], "source": [ "faith_shap = nshap.faith_shap(X_test[0, :], vfunc)" ] }, { "cell_type": "code", "execution_count": 26, "id": "a5d5ef87", "metadata": {}, "outputs": [], "source": [ "faith_shap.save('faith-shap.json')" ] }, { "cell_type": "code", "execution_count": 27, "id": "2350e940", "metadata": {}, "outputs": [], "source": [ "faith_shap = nshap.load('faith-shap.json')" ] }, { "cell_type": "code", "execution_count": 28, "id": "6f022474", "metadata": {}, "outputs": [ { "data": { "image/png": "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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 28, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# for n=d, both n-Shapley Values and the Faith-Shap index are equal to the Möbius transform, so we get the same picture as above\n", "faith_shap.plot(feature_names = feature_names)" ] }, { "cell_type": "code", "execution_count": 29, "id": "192665ed", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "True" ] }, "execution_count": 29, "metadata": {}, "output_type": "execute_result" } ], "source": [ "nshap.allclose(n_shapley_values, faith_shap)" ] }, { "cell_type": "code", "execution_count": 30, "id": "fa1e883b", "metadata": {}, "outputs": [], "source": [ "# more useful functions for the Faith-Shap interaction index might come in the future. for now, we have to compute the index again for every order\n", "k_faith_shap = nshap.faith_shap(X_test[0, :], vfunc, 3)" ] }, { "cell_type": "code", "execution_count": 31, "id": "f0a1a121", "metadata": {}, "outputs": [ { "data": { "image/png": "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mTMHNzc3mjRpclvrvHDhAv7+/g4lf+nSJX744QcA+y78TDNnznQ4bJF5tn2LFi1ua70i4hy0RS+WVaNGDXx8fBgyZAgnTpygcOHCbN68mcWLF+Pp6UlSUtINl80szdmzZ3P27Fl7Sd+N+vXr88orrzB16lQiIiJo06YNAQEBXLp0iVWrVrFlyxb69u17W7fuBWjcuDGTJk2iR48eNGrUiDNnzjBv3jzOnj0LkOX73Lx5M126dKFp06bs2LGDBQsW8I9//IPQ0NC7/h5FxHxU9GJZxYsX58svv2T48OF8/vnnFChQgPLlyzNy5Ej++OMPpk+fztmzZylevHiWZevXr094eDirV69m06ZNtGzZ0pBMffv2pU6dOnz33Xd8//33XLhwAW9vb0JCQvjqq6+yvWverbz99tukp6ezePFiVq9eTcmSJWnQoAGdOnWidevWbNq0yWFr/ZNPPuGHH34gOjqaEiVK8O6779K5c2dDvj8RMR8X252eeiwiTmX+/Pn069eP6dOnG/qgHhExNx2jFxERsTAVvYiIiIWp6EVERCzM6Y/Rx8TE5HUEERGnpastrE9n3YuISLYSEhI4e/YsV69ezesocgNubm74+vri7++f5RHXmSxT9Pf6U2lMTIzpP/kq490zez4wf0az5wNlzBz/ZpKTkzl16hRly5alYMGCuLi43LMscmdsNhupqalcvHiR2NhYHnjggWzLXsfoRUQkizNnzlCiRAkKFSqkkjcpFxcXChQoQPHixSlatGiWB2plUtGLiEgWycnJ+Pj45HUMyaHChQtz6dKlbF9T0YuISBZpaWm4u1vm6K7leXh4ZHmuRSYVvYiIZEu77J3HzX5WKnoREREL034ZERHJsVof/8LZxLu73K64TwG2faDHIucWbdGLiEiO3W3JGzWG5JyKXkRETOeFF14gKCiIjh073nCe5557jqCgIMaOHZvjcZs1a8b7779vRESnoV33IiJiSi4uLsTExNiv6b/eyZMn+f333297zHHjxuHr62tURKegLXoRETGlatWq4e7uzvLly7O8tnTpUh588EHc3Nxua8wqVaoQEBBgVESnoKIXERFT8vHxoVGjRixdujTLa4sXLyY8PNxhWlxcHO+99x6NGjWiatWqNGjQgL59+5KQkGCf5/pd98eOHSMoKIjly5fz1ltvUaNGDerUqcOAAQO4cuXK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Ob169aJ8+fIEBgbe9fupohcREdNavny5fUu9SZMmPPnkkw6vu7u7M3jwYLy8vABYs2YNf/zxB5MnTyYsLAy4ttu/WbNmN13P1KlTuXjxInPnzrV/IGjSpAlPPfUUw4cP5/vvv7fPGx4eTmRkpP3rjz76iBIlSvDFF1/g4eEBQNGiRenZs6d9ngULFrBv3z7mzp1LcHAwAI0bN+bpp59m1KhRDlvuNWvW5NVXX729N+omtOteRERMq0qVKsycOZMBAwawffv2LLvzH3jgAXvJA2zbtg1PT097yQMUKlSIRx999Kbr2bZtG6GhoQ5b/a6urkRERLBr1y4SExPt0ytXruywbExMDGFhYfaSB2jZsiVubm72rzdu3EipUqV4+OGHSUtLIy0tjYyMDJo2bcrWrVu5evXqDce/W9qiFxER0woICCAgIIDatWvj4+NDVFQUv//+OzVq1ACgWLFiDvMnJCRQtGjRLOOUKFHiputJSEigXLlyWaYXL14cm81GUlKSfVp26/T393eY5u7u7pDjwoULnDx5kqpVq2a7/vPnz1OqVKlsx79bKnoRETGVCxcusGbNGurXr28vP7i2dQ9w6tSpGy5btGhR4uPjsdlsuLi4OIx5M4ULF+bs2bNZpp8+fdo+buZ//12RIkU4d87x3gA2m42EhAT7176+vlSsWJHo6Ogb5r5XtOteRERMJSMjg759+zJnzhyH6evXrwduvmu7fv36XL16lZUrV9qnXb161b7sjdSuXZuYmBhOnjzpkGPp0qUEBwdToECBm65z9erVJCcn26etW7eO1NRUh/FPnDhByZIlCQ4Otv9buXIlM2bMcNjtbzRt0YuIiKn4+/vz/PPP8+WXX+Ll5UVwcDAxMTFMnDiRZ555hgoVKtxw2fr169OoUSP69+/P2bNnue+++5g+fTrx8fGULFnyhsu98sorLFiwgJdeeom3334bb29vZs2axcGDB5k0adJN83br1o0VK1bQpUsXOnXqxNmzZxkzZoxDeUdGRjJz5kxeeeUVunbtSqlSpVizZg1Tp07lrbfectj7YDQVvYhILrGlJuMyMOHWM97umB5et57RyfTr14/77ruPefPmMXbsWEqXLs3bb79N586db7nsuHHjGD58OKNHjyYlJYWIiAieffZZ1qxZc8NlSpYsyezZsxk+fDgffvghGRkZVKtWjalTp1K3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", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" }, { "data": { "text/plain": [ "" ] }, "execution_count": 31, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# this plot, again, is almost the same as for 3-Shapley Values. A very close comparison of the two figures reveal, however, that they are not exactly the same\n", "k_faith_shap.plot()" ] }, { "cell_type": "code", "execution_count": 32, "id": "ecc06133", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "(False, False)" ] }, "execution_count": 32, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# again, the figure is very similar, but the interaction indices are not actually the same\n", "nshap.allclose(n_shapley_values.k_shapley_values(3), k_faith_shap), nshap.allclose(k_shapely_taylor, k_faith_shap)" ] } ], "metadata": { "kernelspec": { "display_name": "base", "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.9.12" }, "vscode": { "interpreter": { "hash": "62406f3c2942480da828869ab3f3f95d1c0177b3689d5bc770f3ddfd7b9b3df5" } } }, "nbformat": 4, "nbformat_minor": 5 }