From 39dd2977279596ad1cb21ce857f19a13e949c9a2 Mon Sep 17 00:00:00 2001
From: Amit Sharma <amit_sharma@live.com>
Date: Thu, 26 Oct 2023 16:55:51 +0530
Subject: [PATCH] Version Bump: Update to v0.11 (#413)

* version bump: updated docs

Signed-off-by: Amit Sharma <amit_sharma@live.com>

---------

Signed-off-by: Amit Sharma <amit_sharma@live.com>
---
 docs/_modules/dice_ml/constants.html          |   4 +-
 .../dice_ml/counterfactual_explanations.html  |   2 +-
 docs/_modules/dice_ml/data.html               |  12 +-
 .../private_data_interface.html               |  55 +-
 .../public_data_interface.html                |  21 +-
 docs/_modules/dice_ml/dice.html               |   2 +-
 .../dice_ml/diverse_counterfactuals.html      |  38 +-
 .../dice_ml/explainer_interfaces/dice_KD.html |  40 +-
 .../explainer_interfaces/dice_genetic.html    |  17 +-
 .../explainer_interfaces/dice_pytorch.html    |  52 +-
 .../explainer_interfaces/dice_random.html     |  18 +-
 .../dice_tensorflow1.html                     |  52 +-
 .../dice_tensorflow2.html                     |  50 +-
 .../explainer_interfaces/explainer_base.html  |  61 +-
 .../feasible_base_vae.html                    |   4 +-
 .../feasible_model_approx.html                |   2 +-
 docs/_modules/dice_ml/model.html              |   5 +-
 .../dice_ml/model_interfaces/base_model.html  |   8 +-
 .../keras_tensorflow_model.html               |   8 +-
 .../model_interfaces/pytorch_model.html       |   8 +-
 docs/_modules/dice_ml/utils/exception.html    |  14 +-
 docs/_modules/dice_ml/utils/helpers.html      |  24 +-
 .../dice_ml/utils/neuralnetworks.html         |  22 +-
 .../utils/sample_architecture/vae_model.html  |   4 +-
 docs/_modules/dice_ml/utils/serialize.html    |   4 +-
 docs/_modules/index.html                      |   2 +-
 docs/_static/documentation_options.js         |   2 +-
 docs/dice_ml.data_interfaces.html             |   7 +-
 docs/dice_ml.explainer_interfaces.html        |  18 +-
 docs/dice_ml.html                             |  13 +-
 docs/dice_ml.model_interfaces.html            |   2 +-
 docs/dice_ml.schema.html                      |   2 +-
 docs/dice_ml.utils.html                       |  35 +-
 docs/dice_ml.utils.sample_architecture.html   |   2 +-
 docs/genindex.html                            |  37 +-
 docs/index.html                               |   7 +-
 docs/modules.html                             |   2 +-
 ...king_different_CF_explanation_methods.html |  35 +-
 docs/notebooks/DiCE_feature_importances.html  | 913 +++++++++---------
 docs/notebooks/DiCE_getting_started.html      | 149 ++-
 .../DiCE_getting_started_feasible.html        |   2 +-
 docs/notebooks/DiCE_model_agnostic_CFs.html   | 277 +++---
 ...ticlass_classification_and_regression.html | 165 ++--
 .../notebooks/DiCE_with_advanced_options.html |   2 +-
 docs/notebooks/DiCE_with_private_data.html    |  90 +-
 docs/notebooks/nb_index.html                  |   2 +-
 docs/objects.inv                              | Bin 9650 -> 9778 bytes
 docs/py-modindex.html                         |   2 +-
 docs/readme.html                              |   7 +-
 docs/search.html                              |   2 +-
 docs/searchindex.js                           |   2 +-
 docs/source/conf.py                           |   2 +-
 setup.py                                      |   2 +-
 53 files changed, 1177 insertions(+), 1131 deletions(-)
diff --git a/docs/_modules/dice_ml/constants.html b/docs/_modules/dice_ml/constants.html
index 2f5c5702..16154e6c 100644
--- a/docs/_modules/dice_ml/constants.html
+++ b/docs/_modules/dice_ml/constants.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.constants &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.constants &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
diff --git a/docs/_modules/dice_ml/counterfactual_explanations.html b/docs/_modules/dice_ml/counterfactual_explanations.html
index cc056698..04da6803 100644
--- a/docs/_modules/dice_ml/counterfactual_explanations.html
+++ b/docs/_modules/dice_ml/counterfactual_explanations.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.counterfactual_explanations &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.counterfactual_explanations &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/_modules/dice_ml/data.html b/docs/_modules/dice_ml/data.html
index ef18d240..1b62d8a3 100644
--- a/docs/_modules/dice_ml/data.html
+++ b/docs/_modules/dice_ml/data.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.data &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.data &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -95,23 +93,23 @@ <h1>Source code for dice_ml.data</h1><div class="highlight"><pre>
 
 
 <div class="viewcode-block" id="Data"><a class="viewcode-back" href="../../dice_ml.html#dice_ml.data.Data">[docs]</a><span class="k">class</span> <span class="nc">Data</span><span class="p">(</span><span class="n">_BaseData</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Class containing all required information about the data for DiCE.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Class containing all required information about the data for DiCE.&quot;&quot;&quot;</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">params</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param **params: a dictionary of required parameters.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">decide_implementation_type</span><span class="p">(</span><span class="n">params</span><span class="p">)</span>
 
 <div class="viewcode-block" id="Data.decide_implementation_type"><a class="viewcode-back" href="../../dice_ml.html#dice_ml.data.Data.decide_implementation_type">[docs]</a>    <span class="k">def</span> <span class="nf">decide_implementation_type</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">params</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Decides if the Data class is for public or private data.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Decides if the Data class is for public or private data.&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span> <span class="o">=</span> <span class="n">decide</span><span class="p">(</span><span class="n">params</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="n">params</span><span class="p">)</span></div></div>
 
 
 <div class="viewcode-block" id="decide"><a class="viewcode-back" href="../../dice_ml.html#dice_ml.data.decide">[docs]</a><span class="k">def</span> <span class="nf">decide</span><span class="p">(</span><span class="n">params</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;Decides if the Data class is for public or private data.</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Decides if the Data class is for public or private data.</span>
 
 <span class="sd">    To add new implementations of Data, add the class in data_interfaces</span>
 <span class="sd">    subpackage and import-and-return the class in an elif loop as shown</span>
diff --git a/docs/_modules/dice_ml/data_interfaces/private_data_interface.html b/docs/_modules/dice_ml/data_interfaces/private_data_interface.html
index 94e25a20..4556bd56 100644
--- a/docs/_modules/dice_ml/data_interfaces/private_data_interface.html
+++ b/docs/_modules/dice_ml/data_interfaces/private_data_interface.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.data_interfaces.private_data_interface &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.data_interfaces.private_data_interface &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -98,10 +96,10 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
 
 
 <div class="viewcode-block" id="PrivateData"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData">[docs]</a><span class="k">class</span> <span class="nc">PrivateData</span><span class="p">(</span><span class="n">_BaseData</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot;A data interface for private data with meta information.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;A data interface for private data with meta information.&quot;&quot;&quot;</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">params</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param features: Dictionary or OrderedDict with feature names as keys and range in int/float</span>
 <span class="sd">                         (for continuous features) or categories in string (for categorical features)</span>
@@ -161,25 +159,25 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="bp">self</span><span class="o">.</span><span class="n">_validate_and_set_data_name</span><span class="p">(</span><span class="n">params</span><span class="o">=</span><span class="n">params</span><span class="p">)</span>
 
     <span class="k">def</span> <span class="nf">_validate_and_set_type_and_precision</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">params</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Validate and set the type and precision.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Validate and set the type and precision.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="s1">&#39;type_and_precision&#39;</span> <span class="ow">in</span> <span class="n">params</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">type_and_precision</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="s1">&#39;type_and_precision&#39;</span><span class="p">]</span>
         <span class="k">else</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">type_and_precision</span> <span class="o">=</span> <span class="p">{}</span>
 
     <span class="k">def</span> <span class="nf">_validate_and_set_mad</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">params</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Validate and set the MAD.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Validate and set the MAD.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="s1">&#39;mad&#39;</span> <span class="ow">in</span> <span class="n">params</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">mad</span> <span class="o">=</span> <span class="n">params</span><span class="p">[</span><span class="s1">&#39;mad&#39;</span><span class="p">]</span>
         <span class="k">else</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">mad</span> <span class="o">=</span> <span class="p">{}</span>
 
 <div class="viewcode-block" id="PrivateData.one_hot_encode_data"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.one_hot_encode_data">[docs]</a>    <span class="k">def</span> <span class="nf">one_hot_encode_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;One-hot-encodes the data.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;One-hot-encodes the data.&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="n">pd</span><span class="o">.</span><span class="n">get_dummies</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">drop_first</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">categorical_feature_names</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="PrivateData.normalize_data"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.normalize_data">[docs]</a>    <span class="k">def</span> <span class="nf">normalize_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">df</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Normalizes continuous features to make them fall in the range [0,1].&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Normalizes continuous features to make them fall in the range [0,1].&quot;&quot;&quot;</span>
         <span class="n">result</span> <span class="o">=</span> <span class="n">df</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">df</span><span class="p">,</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">)</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">df</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
             <span class="k">for</span> <span class="n">feature_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">continuous_feature_names</span><span class="p">:</span>
@@ -209,7 +207,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="k">return</span> <span class="n">result</span></div>
 
 <div class="viewcode-block" id="PrivateData.de_normalize_data"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.de_normalize_data">[docs]</a>    <span class="k">def</span> <span class="nf">de_normalize_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">df</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;De-normalizes continuous features from [0,1] range to original range.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;De-normalizes continuous features from [0,1] range to original range.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">df</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
             <span class="k">return</span> <span class="n">df</span>
         <span class="n">result</span> <span class="o">=</span> <span class="n">df</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
@@ -221,7 +219,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="k">return</span> <span class="n">result</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_minx_maxx"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_minx_maxx">[docs]</a>    <span class="k">def</span> <span class="nf">get_minx_maxx</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">normalized</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Gets the min/max value of features in normalized or de-normalized form.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gets the min/max value of features in normalized or de-normalized form.&quot;&quot;&quot;</span>
         <span class="n">minx</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mf">0.0</span><span class="p">]</span><span class="o">*</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">ohe_encoded_feature_names</span><span class="p">)])</span>
         <span class="n">maxx</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mf">1.0</span><span class="p">]</span><span class="o">*</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">ohe_encoded_feature_names</span><span class="p">)])</span>
 
@@ -234,7 +232,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
             <span class="k">return</span> <span class="n">minx</span><span class="p">,</span> <span class="n">maxx</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_mads"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_mads">[docs]</a>    <span class="k">def</span> <span class="nf">get_mads</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">normalized</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes Median Absolute Deviation of features.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes Median Absolute Deviation of features.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="n">normalized</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>
             <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">mad</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
         <span class="k">else</span><span class="p">:</span>
@@ -245,7 +243,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
             <span class="k">return</span> <span class="n">mads</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_valid_mads"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_valid_mads">[docs]</a>    <span class="k">def</span> <span class="nf">get_valid_mads</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">normalized</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">display_warnings</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">return_mads</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes Median Absolute Deviation of features. If they are &lt;=0, returns a practical value instead&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes Median Absolute Deviation of features. If they are &lt;=0, returns a practical value instead&quot;&quot;&quot;</span>
         <span class="n">mads</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_mads</span><span class="p">(</span><span class="n">normalized</span><span class="o">=</span><span class="n">normalized</span><span class="p">)</span>
         <span class="k">for</span> <span class="n">feature</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">continuous_feature_names</span><span class="p">:</span>
             <span class="k">if</span> <span class="n">feature</span> <span class="ow">in</span> <span class="n">mads</span><span class="p">:</span>
@@ -299,7 +297,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="bp">self</span><span class="o">.</span><span class="n">ohe_base_df</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">prepare_df_for_ohe_encoding</span><span class="p">()</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_data_params_for_gradient_dice"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_data_params_for_gradient_dice">[docs]</a>    <span class="k">def</span> <span class="nf">get_data_params_for_gradient_dice</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Gets all data related params for DiCE.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gets all data related params for DiCE.&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">create_ohe_params</span><span class="p">()</span>
         <span class="n">minx</span><span class="p">,</span> <span class="n">maxx</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_minx_maxx</span><span class="p">(</span><span class="n">normalized</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
@@ -321,7 +319,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
             <span class="n">cont_minx</span><span class="p">,</span> <span class="n">cont_maxx</span><span class="p">,</span> <span class="n">cont_precisions</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_encoded_categorical_feature_indexes"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_encoded_categorical_feature_indexes">[docs]</a>    <span class="k">def</span> <span class="nf">get_encoded_categorical_feature_indexes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Gets the column indexes categorical features after one-hot-encoding.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gets the column indexes categorical features after one-hot-encoding.&quot;&quot;&quot;</span>
         <span class="n">cols</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">col_parent</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categorical_feature_names</span><span class="p">:</span>
             <span class="n">temp</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">ohe_encoded_feature_names</span><span class="o">.</span><span class="n">index</span><span class="p">(</span>
@@ -331,7 +329,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="k">return</span> <span class="n">cols</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_indexes_of_features_to_vary"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_indexes_of_features_to_vary">[docs]</a>    <span class="k">def</span> <span class="nf">get_indexes_of_features_to_vary</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="o">=</span><span class="s1">&#39;all&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Gets indexes from feature names of one-hot-encoded data.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gets indexes from feature names of one-hot-encoded data.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="n">features_to_vary</span> <span class="o">==</span> <span class="s2">&quot;all&quot;</span><span class="p">:</span>
             <span class="k">return</span> <span class="p">[</span><span class="n">i</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">ohe_encoded_feature_names</span><span class="p">))]</span>
         <span class="k">else</span><span class="p">:</span>
@@ -353,7 +351,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="k">return</span> <span class="n">labelencoders</span></div>
 
 <div class="viewcode-block" id="PrivateData.from_label"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.from_label">[docs]</a>    <span class="k">def</span> <span class="nf">from_label</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Transforms label encoded data back to categorical values&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Transforms label encoded data back to categorical values&quot;&quot;&quot;</span>
         <span class="n">out</span> <span class="o">=</span> <span class="n">data</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">)</span> <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
             <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categorical_feature_names</span><span class="p">:</span>
@@ -365,7 +363,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
             <span class="k">return</span> <span class="n">out</span></div>
 
 <div class="viewcode-block" id="PrivateData.from_dummies"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.from_dummies">[docs]</a>    <span class="k">def</span> <span class="nf">from_dummies</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">,</span> <span class="n">prefix_sep</span><span class="o">=</span><span class="s1">&#39;_&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Gets the original data from dummy encoded data with k levels.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gets the original data from dummy encoded data with k levels.&quot;&quot;&quot;</span>
         <span class="n">out</span> <span class="o">=</span> <span class="n">data</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
         <span class="k">for</span> <span class="n">feature_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categorical_feature_names</span><span class="p">:</span>
             <span class="n">cols</span><span class="p">,</span> <span class="n">labs</span> <span class="o">=</span> <span class="p">[[</span><span class="n">c</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span>
@@ -376,7 +374,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="k">return</span> <span class="n">out</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_decimal_precisions"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_decimal_precisions">[docs]</a>    <span class="k">def</span> <span class="nf">get_decimal_precisions</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">output_type</span><span class="o">=</span><span class="s2">&quot;list&quot;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;&quot;Gets the precision of continuous features in the data.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;&quot;Gets the precision of continuous features in the data.&quot;&quot;&quot;</span>
         <span class="n">precisions_dict</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">int</span><span class="p">)</span>
         <span class="n">precisions</span> <span class="o">=</span> <span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">*</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">feature_names</span><span class="p">)</span>
         <span class="k">for</span> <span class="n">ix</span><span class="p">,</span> <span class="n">feature_name</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">continuous_feature_names</span><span class="p">):</span>
@@ -393,7 +391,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
             <span class="k">return</span> <span class="n">precisions_dict</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_decoded_data"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_decoded_data">[docs]</a>    <span class="k">def</span> <span class="nf">get_decoded_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">,</span> <span class="n">encoding</span><span class="o">=</span><span class="s1">&#39;one-hot&#39;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Gets the original data from encoded data.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gets the original data from encoded data.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
             <span class="k">return</span> <span class="n">data</span>
 
@@ -414,7 +412,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
             <span class="k">return</span> <span class="n">data</span></div>
 
 <div class="viewcode-block" id="PrivateData.prepare_df_for_ohe_encoding"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_df_for_ohe_encoding">[docs]</a>    <span class="k">def</span> <span class="nf">prepare_df_for_ohe_encoding</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Create base dataframe to do OHE for a single instance or a set of instances&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Create base dataframe to do OHE for a single instance or a set of instances&quot;&quot;&quot;</span>
         <span class="n">levels</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="n">colnames</span> <span class="o">=</span> <span class="p">[</span><span class="n">feat</span> <span class="k">for</span> <span class="n">feat</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">categorical_feature_names</span><span class="p">]</span>
         <span class="k">for</span> <span class="n">cat_feature</span> <span class="ow">in</span> <span class="n">colnames</span><span class="p">:</span>
@@ -436,8 +434,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
 
         <span class="k">return</span> <span class="n">df</span></div>
 
-<div class="viewcode-block" id="PrivateData.prepare_query_instance"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_query_instance">[docs]</a>    <span class="k">def</span> <span class="nf">prepare_query_instance</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Prepares user defined test input(s) for DiCE.&quot;&quot;&quot;</span>
+<div class="viewcode-block" id="PrivateData.query_instance_to_df"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.query_instance_to_df">[docs]</a>    <span class="k">def</span> <span class="nf">query_instance_to_df</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">):</span>
         <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
             <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query_instance</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nb">dict</span><span class="p">):</span>  <span class="c1"># prepare a list of query instances</span>
                 <span class="n">test</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">feature_names</span><span class="p">)</span>
@@ -455,23 +452,27 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
 
         <span class="k">else</span><span class="p">:</span>
             <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Query instance should be a dict, a pandas dataframe, a list, or a list of dicts&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">test</span></div>
 
+<div class="viewcode-block" id="PrivateData.prepare_query_instance"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_query_instance">[docs]</a>    <span class="k">def</span> <span class="nf">prepare_query_instance</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Prepares user defined test input(s) for DiCE.&quot;&quot;&quot;</span>
+        <span class="n">test</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">query_instance_to_df</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
         <span class="n">test</span> <span class="o">=</span> <span class="n">test</span><span class="o">.</span><span class="n">reset_index</span><span class="p">(</span><span class="n">drop</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
         <span class="k">return</span> <span class="n">test</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_ohe_min_max_normalized_data"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_ohe_min_max_normalized_data">[docs]</a>    <span class="k">def</span> <span class="nf">get_ohe_min_max_normalized_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Transforms query_instance into one-hot-encoded and min-max normalized data. query_instance should be a dict,</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Transforms query_instance into one-hot-encoded and min-max normalized data. query_instance should be a dict,</span>
 <span class="sd">           a dataframe, a list, or a list of dicts&quot;&quot;&quot;</span>
         <span class="n">query_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">prepare_query_instance</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
         <span class="n">ohe_base_df</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">prepare_df_for_ohe_encoding</span><span class="p">()</span>
-        <span class="n">temp</span> <span class="o">=</span> <span class="n">ohe_base_df</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="n">ignore_index</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">sort</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="n">temp</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">concat</span><span class="p">([</span><span class="n">ohe_base_df</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">],</span> <span class="n">ignore_index</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">sort</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
         <span class="n">temp</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">one_hot_encode_data</span><span class="p">(</span><span class="n">temp</span><span class="p">)</span>
         <span class="n">temp</span> <span class="o">=</span> <span class="n">temp</span><span class="o">.</span><span class="n">tail</span><span class="p">(</span><span class="n">query_instance</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span><span class="o">.</span><span class="n">reset_index</span><span class="p">(</span><span class="n">drop</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
         <span class="c1"># returns a pandas dataframe</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">normalize_data</span><span class="p">(</span><span class="n">temp</span><span class="p">)</span><span class="o">.</span><span class="n">apply</span><span class="p">(</span><span class="n">pd</span><span class="o">.</span><span class="n">to_numeric</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_inverse_ohe_min_max_normalized_data"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_inverse_ohe_min_max_normalized_data">[docs]</a>    <span class="k">def</span> <span class="nf">get_inverse_ohe_min_max_normalized_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">transformed_data</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Transforms one-hot-encoded and min-max normalized data into raw user-fed data format. transformed_data</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Transforms one-hot-encoded and min-max normalized data into raw user-fed data format. transformed_data</span>
 <span class="sd">           should be a dataframe or an array&quot;&quot;&quot;</span>
         <span class="n">raw_data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">from_dummies</span><span class="p">(</span><span class="n">transformed_data</span><span class="p">)</span>
         <span class="n">raw_data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">de_normalize_data</span><span class="p">(</span><span class="n">raw_data</span><span class="p">)</span>
@@ -489,7 +490,7 @@ <h1>Source code for dice_ml.data_interfaces.private_data_interface</h1><div clas
         <span class="k">return</span> <span class="n">pd</span><span class="o">.</span><span class="n">get_dummies</span><span class="p">(</span><span class="n">sample_df</span><span class="p">)</span><span class="o">.</span><span class="n">columns</span></div>
 
 <div class="viewcode-block" id="PrivateData.get_valid_feature_range"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.get_valid_feature_range">[docs]</a>    <span class="k">def</span> <span class="nf">get_valid_feature_range</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">feature_range_input</span><span class="p">,</span> <span class="n">normalized</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Gets the min/max value of features in normalized or de-normalized</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Gets the min/max value of features in normalized or de-normalized</span>
 <span class="sd">        form. Assumes that all features are already encoded to numerical form</span>
 <span class="sd">        such that the number of features remains the same.</span>
 
diff --git a/docs/_modules/dice_ml/data_interfaces/public_data_interface.html b/docs/_modules/dice_ml/data_interfaces/public_data_interface.html
index 71b22c35..bc4d9b3d 100644
--- a/docs/_modules/dice_ml/data_interfaces/public_data_interface.html
+++ b/docs/_modules/dice_ml/data_interfaces/public_data_interface.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.data_interfaces.public_data_interface &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.data_interfaces.public_data_interface &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -534,24 +534,7 @@ <h1>Source code for dice_ml.data_interfaces.public_data_interface</h1><div class
 
 <div class="viewcode-block" id="PublicData.prepare_query_instance"><a class="viewcode-back" href="../../../dice_ml.data_interfaces.html#dice_ml.data_interfaces.public_data_interface.PublicData.prepare_query_instance">[docs]</a>    <span class="k">def</span> <span class="nf">prepare_query_instance</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">):</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Prepares user defined test input(s) for DiCE.&quot;&quot;&quot;</span>
-        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query_instance</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nb">dict</span><span class="p">):</span>  <span class="c1"># prepare a list of query instances</span>
-                <span class="n">test</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">feature_names</span><span class="p">)</span>
-
-            <span class="k">else</span><span class="p">:</span>  <span class="c1"># prepare a single query instance in list</span>
-                <span class="n">query_instance</span> <span class="o">=</span> <span class="p">{</span><span class="s1">&#39;row1&#39;</span><span class="p">:</span> <span class="n">query_instance</span><span class="p">}</span>
-                <span class="n">test</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="o">.</span><span class="n">from_dict</span><span class="p">(</span>
-                    <span class="n">query_instance</span><span class="p">,</span> <span class="n">orient</span><span class="o">=</span><span class="s1">&#39;index&#39;</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">feature_names</span><span class="p">)</span>
-
-        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-            <span class="n">test</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">({</span><span class="n">k</span><span class="p">:</span> <span class="p">[</span><span class="n">v</span><span class="p">]</span> <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">query_instance</span><span class="o">.</span><span class="n">items</span><span class="p">()},</span> <span class="n">columns</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">feature_names</span><span class="p">)</span>
-
-        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">):</span>
-            <span class="n">test</span> <span class="o">=</span> <span class="n">query_instance</span><span class="o">.</span><span class="n">copy</span><span class="p">()</span>
-
-        <span class="k">else</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Query instance should be a dict, a pandas dataframe, a list, or a list of dicts&quot;</span><span class="p">)</span>
-
+        <span class="n">test</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">query_instance_to_df</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
         <span class="n">test</span> <span class="o">=</span> <span class="n">test</span><span class="o">.</span><span class="n">reset_index</span><span class="p">(</span><span class="n">drop</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
         <span class="c1"># encode categorical and numerical columns</span>
         <span class="n">test</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_set_feature_dtypes</span><span class="p">(</span><span class="n">test</span><span class="p">,</span>
diff --git a/docs/_modules/dice_ml/dice.html b/docs/_modules/dice_ml/dice.html
index fc0dff0c..f1cc3d8f 100644
--- a/docs/_modules/dice_ml/dice.html
+++ b/docs/_modules/dice_ml/dice.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.dice &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.dice &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/_modules/dice_ml/diverse_counterfactuals.html b/docs/_modules/dice_ml/diverse_counterfactuals.html
index 0ba3c7fb..80357872 100644
--- a/docs/_modules/dice_ml/diverse_counterfactuals.html
+++ b/docs/_modules/dice_ml/diverse_counterfactuals.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.diverse_counterfactuals &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.diverse_counterfactuals &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -85,7 +83,9 @@
   <h1>Source code for dice_ml.diverse_counterfactuals</h1><div class="highlight"><pre>
 <span></span><span class="kn">import</span> <span class="nn">copy</span>
 <span class="kn">import</span> <span class="nn">json</span>
+<span class="kn">import</span> <span class="nn">math</span>
 
+<span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
 <span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
 
 <span class="kn">from</span> <span class="nn">dice_ml.constants</span> <span class="kn">import</span> <span class="n">ModelTypes</span><span class="p">,</span> <span class="n">_SchemaVersions</span>
@@ -113,16 +113,18 @@ <h1>Source code for dice_ml.diverse_counterfactuals</h1><div class="highlight"><
 
 
 <div class="viewcode-block" id="json_converter"><a class="viewcode-back" href="../../dice_ml.html#dice_ml.diverse_counterfactuals.json_converter">[docs]</a><span class="k">def</span> <span class="nf">json_converter</span><span class="p">(</span><span class="n">obj</span><span class="p">):</span>
-    <span class="sd">&quot;&quot;&quot; Helper function to convert object to json.</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot; Helper function to convert object to json.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
     <span class="k">try</span><span class="p">:</span>
         <span class="k">return</span> <span class="n">obj</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
     <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">generic</span><span class="p">):</span>
+            <span class="k">return</span> <span class="n">obj</span><span class="o">.</span><span class="n">item</span><span class="p">()</span>
         <span class="k">return</span> <span class="n">obj</span><span class="o">.</span><span class="vm">__dict__</span></div>
 
 
 <div class="viewcode-block" id="CounterfactualExamples"><a class="viewcode-back" href="../../dice_ml.html#dice_ml.diverse_counterfactuals.CounterfactualExamples">[docs]</a><span class="k">class</span> <span class="nc">CounterfactualExamples</span><span class="p">:</span>
-    <span class="sd">&quot;&quot;&quot;A class to store and visualize the resulting counterfactual explanations.&quot;&quot;&quot;</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;A class to store and visualize the resulting counterfactual explanations.&quot;&quot;&quot;</span>
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data_interface</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">final_cfs_df</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">test_instance_df</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
                  <span class="n">final_cfs_df_sparse</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span>
                  <span class="n">desired_range</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">desired_class</span><span class="o">=</span><span class="s2">&quot;opposite&quot;</span><span class="p">,</span>
@@ -183,13 +185,13 @@ <h1>Source code for dice_ml.diverse_counterfactuals</h1><div class="highlight"><
             <span class="k">elif</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="p">,</span> <span class="s1">&#39;data_df&#39;</span><span class="p">)</span> <span class="ow">and</span> \
                     <span class="n">display_sparse_df</span> <span class="ow">is</span> <span class="kc">True</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
                 <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">Please specify a valid posthoc_sparsity_param to perform sparsity correction.. &#39;</span><span class="p">,</span>
-                      <span class="s1">&#39;displaying Diverse Counterfactual set without sparsity correction (new outcome : </span><span class="si">%i</span><span class="s1">)&#39;</span> <span class="o">%</span>
-                      <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_outcome</span><span class="p">))</span>
+                      <span class="s1">&#39;displaying Diverse Counterfactual set without&#39;</span><span class="p">,</span>
+                      <span class="s1">&#39;sparsity correction (new outcome : </span><span class="si">{}</span><span class="s1">)&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_outcome</span><span class="p">))</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">_dump_output</span><span class="p">(</span><span class="n">content</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span> <span class="n">show_only_changes</span><span class="o">=</span><span class="n">show_only_changes</span><span class="p">,</span>
                                   <span class="n">is_notebook_console</span><span class="o">=</span><span class="n">is_notebook_console</span><span class="p">)</span>
             <span class="k">elif</span> <span class="ow">not</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="p">,</span> <span class="s1">&#39;data_df&#39;</span><span class="p">):</span>  <span class="c1"># for private data</span>
                 <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;</span><span class="se">\n</span><span class="s1">Diverse Counterfactual set without sparsity correction since only metadata about each&#39;</span><span class="p">,</span>
-                      <span class="s1">&#39; feature is available (new outcome: </span><span class="si">%i</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_outcome</span><span class="p">))</span>
+                      <span class="s1">&#39; feature is available (new outcome: </span><span class="si">{}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_outcome</span><span class="p">))</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">_dump_output</span><span class="p">(</span><span class="n">content</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span> <span class="n">show_only_changes</span><span class="o">=</span><span class="n">show_only_changes</span><span class="p">,</span>
                                   <span class="n">is_notebook_console</span><span class="o">=</span><span class="n">is_notebook_console</span><span class="p">)</span>
             <span class="k">else</span><span class="p">:</span>
@@ -204,7 +206,7 @@ <h1>Source code for dice_ml.diverse_counterfactuals</h1><div class="highlight"><
         <span class="kn">from</span> <span class="nn">IPython.display</span> <span class="kn">import</span> <span class="n">display</span>
 
         <span class="c1"># original instance</span>
-        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Query instance (original outcome : </span><span class="si">%i</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="nb">round</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_pred</span><span class="p">))</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Query instance (original outcome : </span><span class="si">{0}</span><span class="s1">)&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_pred</span><span class="p">))</span>
         <span class="n">display</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_instance_df</span><span class="p">)</span>  <span class="c1"># works only in Jupyter notebook</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_visualize_internal</span><span class="p">(</span><span class="n">display_sparse_df</span><span class="o">=</span><span class="n">display_sparse_df</span><span class="p">,</span>
                                  <span class="n">show_only_changes</span><span class="o">=</span><span class="n">show_only_changes</span><span class="p">,</span>
@@ -219,15 +221,21 @@ <h1>Source code for dice_ml.diverse_counterfactuals</h1><div class="highlight"><
             <span class="n">org</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">test_instance_df</span><span class="o">.</span><span class="n">values</span><span class="o">.</span><span class="n">tolist</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
             <span class="k">for</span> <span class="n">ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">df</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">0</span><span class="p">]):</span>
                 <span class="k">for</span> <span class="n">jx</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">org</span><span class="p">)):</span>
-                    <span class="k">if</span> <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">==</span> <span class="n">org</span><span class="p">[</span><span class="n">jx</span><span class="p">]:</span>
-                        <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;-&#39;</span>
+                    <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">],</span> <span class="nb">str</span><span class="p">):</span>
+                        <span class="k">if</span> <span class="n">math</span><span class="o">.</span><span class="n">isclose</span><span class="p">(</span><span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">],</span> <span class="n">org</span><span class="p">[</span><span class="n">jx</span><span class="p">],</span> <span class="n">rel_tol</span><span class="o">=</span><span class="nb">abs</span><span class="p">(</span><span class="n">org</span><span class="p">[</span><span class="n">jx</span><span class="p">]</span><span class="o">/</span><span class="mi">10000</span><span class="p">)):</span>
+                            <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;-&#39;</span>
+                        <span class="k">else</span><span class="p">:</span>
+                            <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">])</span>
                     <span class="k">else</span><span class="p">:</span>
-                        <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">])</span>
+                        <span class="k">if</span> <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">==</span> <span class="n">org</span><span class="p">[</span><span class="n">jx</span><span class="p">]:</span>
+                            <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;-&#39;</span>
+                        <span class="k">else</span><span class="p">:</span>
+                            <span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">newdf</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">])</span>
             <span class="n">display</span><span class="p">(</span><span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">newdf</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="n">df</span><span class="o">.</span><span class="n">columns</span><span class="p">,</span> <span class="n">index</span><span class="o">=</span><span class="n">df</span><span class="o">.</span><span class="n">index</span><span class="p">))</span>  <span class="c1"># works only in Jupyter notebook</span></div>
 
 <div class="viewcode-block" id="CounterfactualExamples.visualize_as_list"><a class="viewcode-back" href="../../dice_ml.html#dice_ml.diverse_counterfactuals.CounterfactualExamples.visualize_as_list">[docs]</a>    <span class="k">def</span> <span class="nf">visualize_as_list</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">display_sparse_df</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">show_only_changes</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
         <span class="c1"># original instance</span>
-        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Query instance (original outcome : </span><span class="si">%i</span><span class="s1">)&#39;</span> <span class="o">%</span> <span class="nb">round</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_pred</span><span class="p">))</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Query instance (original outcome : </span><span class="si">{}</span><span class="s1">)&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_pred</span><span class="p">))</span>
         <span class="nb">print</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_instance_df</span><span class="o">.</span><span class="n">values</span><span class="o">.</span><span class="n">tolist</span><span class="p">()[</span><span class="mi">0</span><span class="p">])</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_visualize_internal</span><span class="p">(</span><span class="n">display_sparse_df</span><span class="o">=</span><span class="n">display_sparse_df</span><span class="p">,</span>
                                  <span class="n">show_only_changes</span><span class="o">=</span><span class="n">show_only_changes</span><span class="p">,</span>
@@ -242,7 +250,7 @@ <h1>Source code for dice_ml.diverse_counterfactuals</h1><div class="highlight"><
             <span class="n">org</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">test_instance_df</span><span class="o">.</span><span class="n">values</span><span class="o">.</span><span class="n">tolist</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
             <span class="k">for</span> <span class="n">ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">newli</span><span class="p">)):</span>
                 <span class="k">for</span> <span class="n">jx</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">newli</span><span class="p">[</span><span class="n">ix</span><span class="p">])):</span>
-                    <span class="k">if</span> <span class="n">newli</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">==</span> <span class="n">org</span><span class="p">[</span><span class="n">jx</span><span class="p">]:</span>
+                    <span class="k">if</span> <span class="n">math</span><span class="o">.</span><span class="n">isclose</span><span class="p">(</span><span class="n">newli</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">],</span> <span class="n">org</span><span class="p">[</span><span class="n">jx</span><span class="p">],</span> <span class="n">rel_tol</span><span class="o">=</span><span class="nb">abs</span><span class="p">(</span><span class="n">org</span><span class="p">[</span><span class="n">jx</span><span class="p">]</span><span class="o">/</span><span class="mi">10000</span><span class="p">)):</span>
                         <span class="n">newli</span><span class="p">[</span><span class="n">ix</span><span class="p">][</span><span class="n">jx</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;-&#39;</span>
                 <span class="nb">print</span><span class="p">(</span><span class="n">newli</span><span class="p">[</span><span class="n">ix</span><span class="p">])</span></div>
 
@@ -292,7 +300,7 @@ <h1>Source code for dice_ml.diverse_counterfactuals</h1><div class="highlight"><
                 <span class="n">_DiverseCFV2SchemaConstants</span><span class="o">.</span><span class="n">DESIRED_CLASS</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">desired_class</span><span class="p">,</span>
                 <span class="n">_DiverseCFV2SchemaConstants</span><span class="o">.</span><span class="n">DESIRED_RANGE</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">desired_range</span>
             <span class="p">}</span>
-            <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">alternate_obj</span><span class="p">)</span></div>
+            <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">alternate_obj</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">json_converter</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="CounterfactualExamples.from_json"><a class="viewcode-back" href="../../dice_ml.html#dice_ml.diverse_counterfactuals.CounterfactualExamples.from_json">[docs]</a>    <span class="nd">@staticmethod</span>
     <span class="k">def</span> <span class="nf">from_json</span><span class="p">(</span><span class="n">cf_example_json_str</span><span class="p">):</span>
diff --git a/docs/_modules/dice_ml/explainer_interfaces/dice_KD.html b/docs/_modules/dice_ml/explainer_interfaces/dice_KD.html
index 4730321a..1b1ceeb8 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/dice_KD.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/dice_KD.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.dice_KD &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.explainer_interfaces.dice_KD &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -101,7 +99,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_KD</h1><div class="highlig
 <div class="viewcode-block" id="DiceKD"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD">[docs]</a><span class="k">class</span> <span class="nc">DiceKD</span><span class="p">(</span><span class="n">ExplainerBase</span><span class="p">):</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data_interface</span><span class="p">,</span> <span class="n">model_interface</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param data_interface: an interface class to access data related params.</span>
 <span class="sd">        :param model_interface: an interface class to access trained ML model.</span>
@@ -136,7 +134,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_KD</h1><div class="highlig
                                   <span class="n">permitted_range</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">sparsity_weight</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
                                   <span class="n">feature_weights</span><span class="o">=</span><span class="s2">&quot;inverse_mad&quot;</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span>
                                   <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="s2">&quot;linear&quot;</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="o">=</span><span class="mi">10000</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations</span>
 
 <span class="sd">        :param query_instance: A dictionary of feature names and values. Test point of interest.</span>
 <span class="sd">        :param total_CFs: Total number of counterfactuals required.</span>
@@ -176,10 +174,9 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_KD</h1><div class="highlig
                 <span class="n">query_instance</span><span class="o">=</span><span class="n">query_instance</span><span class="p">)</span>
 
         <span class="c1"># find the predicted value of query_instance</span>
-        <span class="n">test_pred</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-
-        <span class="n">query_instance</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">test_pred</span>
-        <span class="n">desired_class</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">misc_init</span><span class="p">(</span><span class="n">stopping_threshold</span><span class="p">,</span> <span class="n">desired_class</span><span class="p">,</span> <span class="n">desired_range</span><span class="p">,</span> <span class="n">test_pred</span><span class="p">)</span>
+        <span class="n">test_pred</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">predict_fn_scores</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
+        <span class="n">query_instance</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_model_output_from_scores</span><span class="p">(</span><span class="n">test_pred</span><span class="p">)</span>
+        <span class="n">desired_class</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">misc_init</span><span class="p">(</span><span class="n">stopping_threshold</span><span class="p">,</span> <span class="n">desired_class</span><span class="p">,</span> <span class="n">desired_range</span><span class="p">,</span> <span class="n">test_pred</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
 
         <span class="k">if</span> <span class="n">desired_class</span> <span class="o">==</span> <span class="s2">&quot;opposite&quot;</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span> <span class="o">==</span> <span class="n">ModelTypes</span><span class="o">.</span><span class="n">Classifier</span><span class="p">:</span>
             <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">num_output_nodes</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
@@ -207,18 +204,33 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_KD</h1><div class="highlig
                                                               <span class="n">verbose</span><span class="p">,</span>
                                                               <span class="n">limit_steps_ls</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span> <span class="o">=</span> <span class="n">cfs_preds</span>
-
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span>
+
+        <span class="c1"># decoding to original label</span>
+        <span class="n">query_instance</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span> <span class="o">=</span> \
+            <span class="bp">self</span><span class="o">.</span><span class="n">decode_to_original_labels</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span><span class="p">)</span>
+        <span class="n">desired_class_param</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">decode_model_output</span><span class="p">(</span><span class="n">pd</span><span class="o">.</span><span class="n">Series</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span><span class="p">[</span><span class="mi">0</span><span class="p">]))[</span><span class="mi">0</span><span class="p">]</span> \
+            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;target_cf_class&#39;</span><span class="p">)</span> <span class="k">else</span> <span class="n">desired_class</span>
         <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">CounterfactualExamples</span><span class="p">(</span><span class="n">data_interface</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="p">,</span>
                                           <span class="n">final_cfs_df</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span>
                                           <span class="n">test_instance_df</span><span class="o">=</span><span class="n">query_instance</span><span class="p">,</span>
                                           <span class="n">final_cfs_df_sparse</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span><span class="p">,</span>
                                           <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="n">posthoc_sparsity_param</span><span class="p">,</span>
                                           <span class="n">desired_range</span><span class="o">=</span><span class="n">desired_range</span><span class="p">,</span>
-                                          <span class="n">desired_class</span><span class="o">=</span><span class="n">desired_class</span><span class="p">,</span>
+                                          <span class="n">desired_class</span><span class="o">=</span><span class="n">desired_class_param</span><span class="p">,</span>
                                           <span class="n">model_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span><span class="p">)</span>
 
+<div class="viewcode-block" id="DiceKD.predict_fn_scores"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn_scores">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn_scores</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns prediction scores.&quot;&quot;&quot;</span>
+        <span class="n">out</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">get_output</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span> <span class="o">==</span> <span class="n">ModelTypes</span><span class="o">.</span><span class="n">Classifier</span> <span class="ow">and</span> <span class="n">out</span><span class="o">.</span><span class="n">shape</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="c1"># DL models return only 1 for binary classification</span>
+            <span class="n">out</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">hstack</span><span class="p">((</span><span class="mi">1</span><span class="o">-</span><span class="n">out</span><span class="p">,</span> <span class="n">out</span><span class="p">))</span>
+        <span class="k">return</span> <span class="n">out</span></div>
+
 <div class="viewcode-block" id="DiceKD.predict_fn"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;returns predictions&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;returns predictions&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">get_output</span><span class="p">(</span><span class="n">input_instance</span><span class="p">,</span> <span class="n">model_score</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceKD.do_sparsity_check"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.do_sparsity_check">[docs]</a>    <span class="k">def</span> <span class="nf">do_sparsity_check</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">cfs</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">,</span> <span class="n">sparsity_weight</span><span class="p">):</span>
@@ -244,7 +256,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_KD</h1><div class="highlig
 
 <div class="viewcode-block" id="DiceKD.vary_valid"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.vary_valid">[docs]</a>    <span class="k">def</span> <span class="nf">vary_valid</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">KD_query_instance</span><span class="p">,</span> <span class="n">total_CFs</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">,</span> <span class="n">permitted_range</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">,</span>
                    <span class="n">sparsity_weight</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;This function ensures that we only vary features_to_vary when generating counterfactuals&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;This function ensures that we only vary features_to_vary when generating counterfactuals&quot;&quot;&quot;</span>
 
         <span class="c1"># TODO: this should be a user-specified parameter</span>
         <span class="n">num_queries</span> <span class="o">=</span> <span class="nb">min</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">dataset_with_predictions</span><span class="p">),</span> <span class="n">total_CFs</span> <span class="o">*</span> <span class="mi">10</span><span class="p">)</span>
@@ -307,7 +319,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_KD</h1><div class="highlig
                              <span class="n">total_CFs</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">,</span> <span class="n">permitted_range</span><span class="p">,</span>
                              <span class="n">sparsity_weight</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="p">,</span> <span class="n">posthoc_sparsity_algorithm</span><span class="p">,</span>
                              <span class="n">verbose</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Finds counterfactuals by querying a K-D tree for the nearest data points in the desired class from the dataset.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Finds counterfactuals by querying a K-D tree for the nearest data points in the desired class from the dataset.&quot;&quot;&quot;</span>
 
         <span class="n">start_time</span> <span class="o">=</span> <span class="n">timeit</span><span class="o">.</span><span class="n">default_timer</span><span class="p">()</span>
 
diff --git a/docs/_modules/dice_ml/explainer_interfaces/dice_genetic.html b/docs/_modules/dice_ml/explainer_interfaces/dice_genetic.html
index 75e694a8..a5e7e67a 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/dice_genetic.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/dice_genetic.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.dice_genetic &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.explainer_interfaces.dice_genetic &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -357,11 +357,10 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_genetic</h1><div class="hi
         <span class="bp">self</span><span class="o">.</span><span class="n">x1</span> <span class="o">=</span> <span class="n">query_instance</span>
 
         <span class="c1"># find the predicted value of query_instance</span>
-        <span class="n">test_pred</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
+        <span class="n">test_pred</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">predict_fn_scores</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">test_pred</span> <span class="o">=</span> <span class="n">test_pred</span>
-
-        <span class="n">desired_class</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">misc_init</span><span class="p">(</span><span class="n">stopping_threshold</span><span class="p">,</span> <span class="n">desired_class</span><span class="p">,</span> <span class="n">desired_range</span><span class="p">,</span> <span class="n">test_pred</span><span class="p">)</span>
+        <span class="n">desired_class</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">misc_init</span><span class="p">(</span><span class="n">stopping_threshold</span><span class="p">,</span> <span class="n">desired_class</span><span class="p">,</span> <span class="n">desired_range</span><span class="p">,</span> <span class="n">test_pred</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
 
         <span class="n">query_instance_df_dummies</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">get_dummies</span><span class="p">(</span><span class="n">query_instance_orig</span><span class="p">)</span>
         <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">get_all_dummy_colnames</span><span class="p">():</span>
@@ -376,13 +375,15 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_genetic</h1><div class="hi
         <span class="n">query_instance_df</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">find_counterfactuals</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="n">desired_range</span><span class="p">,</span> <span class="n">desired_class</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">,</span>
                                                       <span class="n">maxiterations</span><span class="p">,</span> <span class="n">thresh</span><span class="p">,</span> <span class="n">verbose</span><span class="p">)</span>
 
+        <span class="n">desired_class_param</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">decode_model_output</span><span class="p">(</span><span class="n">pd</span><span class="o">.</span><span class="n">Series</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span><span class="p">[</span><span class="mi">0</span><span class="p">]))[</span><span class="mi">0</span><span class="p">]</span> \
+            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;target_cf_class&#39;</span><span class="p">)</span> <span class="k">else</span> <span class="n">desired_class</span>
         <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">CounterfactualExamples</span><span class="p">(</span><span class="n">data_interface</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="p">,</span>
                                           <span class="n">test_instance_df</span><span class="o">=</span><span class="n">query_instance_df</span><span class="p">,</span>
                                           <span class="n">final_cfs_df</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span>
                                           <span class="n">final_cfs_df_sparse</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span><span class="p">,</span>
                                           <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="n">posthoc_sparsity_param</span><span class="p">,</span>
                                           <span class="n">desired_range</span><span class="o">=</span><span class="n">desired_range</span><span class="p">,</span>
-                                          <span class="n">desired_class</span><span class="o">=</span><span class="n">desired_class</span><span class="p">,</span>
+                                          <span class="n">desired_class</span><span class="o">=</span><span class="n">desired_class_param</span><span class="p">,</span>
                                           <span class="n">model_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span><span class="p">)</span>
 
 <div class="viewcode-block" id="DiceGenetic.predict_fn_scores"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.predict_fn_scores">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn_scores</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
@@ -590,7 +591,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_genetic</h1><div class="hi
 
         <span class="c1"># converting to dataframe</span>
         <span class="n">query_instance_df</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">label_decode</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
-        <span class="n">query_instance_df</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">test_pred</span>
+        <span class="n">query_instance_df</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_model_output_from_scores</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">test_pred</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">label_decode_cfs</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span> <span class="o">=</span> <span class="n">copy</span><span class="o">.</span><span class="n">deepcopy</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">)</span>
 
@@ -599,6 +600,10 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_genetic</h1><div class="hi
             <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">round_to_precision</span><span class="p">()</span>
 
+        <span class="c1"># decoding to original label</span>
+        <span class="n">query_instance_df</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span> <span class="o">=</span> \
+            <span class="bp">self</span><span class="o">.</span><span class="n">decode_to_original_labels</span><span class="p">(</span><span class="n">query_instance_df</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span><span class="p">)</span>
+
         <span class="bp">self</span><span class="o">.</span><span class="n">elapsed</span> <span class="o">=</span> <span class="n">timeit</span><span class="o">.</span><span class="n">default_timer</span><span class="p">()</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_time</span>
         <span class="n">m</span><span class="p">,</span> <span class="n">s</span> <span class="o">=</span> <span class="nb">divmod</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">elapsed</span><span class="p">,</span> <span class="mi">60</span><span class="p">)</span>
 
diff --git a/docs/_modules/dice_ml/explainer_interfaces/dice_pytorch.html b/docs/_modules/dice_ml/explainer_interfaces/dice_pytorch.html
index 731194c8..99c29fac 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/dice_pytorch.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/dice_pytorch.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.dice_pytorch &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.explainer_interfaces.dice_pytorch &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -100,7 +98,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
 <div class="viewcode-block" id="DicePyTorch"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch">[docs]</a><span class="k">class</span> <span class="nc">DicePyTorch</span><span class="p">(</span><span class="n">ExplainerBase</span><span class="p">):</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data_interface</span><span class="p">,</span> <span class="n">model_interface</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param data_interface: an interface class to access data related params.</span>
 <span class="sd">        :param model_interface: an interface class to access trained ML model.</span>
@@ -138,7 +136,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
                                   <span class="n">max_iter</span><span class="o">=</span><span class="mi">5000</span><span class="p">,</span> <span class="n">project_iter</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">loss_diff_thres</span><span class="o">=</span><span class="mf">1e-5</span><span class="p">,</span> <span class="n">loss_converge_maxiter</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
                                   <span class="n">init_near_query_instance</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">tie_random</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span>
                                   <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span> <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="s2">&quot;linear&quot;</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="o">=</span><span class="mi">10000</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations.</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations.</span>
 
 <span class="sd">        :param query_instance: Test point of interest. A dictionary of feature names and values or a single row dataframe</span>
 <span class="sd">        :param total_CFs: Total number of counterfactuals required.</span>
@@ -220,26 +218,26 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
 
 <div class="viewcode-block" id="DicePyTorch.get_model_output"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.get_model_output">[docs]</a>    <span class="k">def</span> <span class="nf">get_model_output</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">,</span>
                          <span class="n">transform_data</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">out_tensor</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;get output probability of ML model&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;get output probability of ML model&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">get_output</span><span class="p">(</span>
                 <span class="n">input_instance</span><span class="p">,</span>
                 <span class="n">transform_data</span><span class="o">=</span><span class="n">transform_data</span><span class="p">,</span>
                 <span class="n">out_tensor</span><span class="o">=</span><span class="n">out_tensor</span><span class="p">)[(</span><span class="bp">self</span><span class="o">.</span><span class="n">num_output_nodes</span><span class="o">-</span><span class="mi">1</span><span class="p">):]</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.predict_fn"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.predict_fn">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;prediction function&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;prediction function&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="ow">not</span> <span class="n">torch</span><span class="o">.</span><span class="n">is_tensor</span><span class="p">(</span><span class="n">input_instance</span><span class="p">):</span>
             <span class="n">input_instance</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span><span class="o">.</span><span class="n">float</span><span class="p">()</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_model_output</span><span class="p">(</span>
                 <span class="n">input_instance</span><span class="p">,</span> <span class="n">transform_data</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">out_tensor</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.predict_fn_for_sparsity"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.predict_fn_for_sparsity">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn_for_sparsity</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;prediction function for sparsity correction&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;prediction function for sparsity correction&quot;&quot;&quot;</span>
         <span class="n">input_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">transformer</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span><span class="o">.</span><span class="n">to_numpy</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span><span class="o">.</span><span class="n">float</span><span class="p">())</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.do_cf_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_cf_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_cf_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">total_CFs</span><span class="p">,</span> <span class="n">algorithm</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Intializes CFs and other related variables.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Intializes CFs and other related variables.&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">cf_init_weights</span> <span class="o">=</span> <span class="p">[</span><span class="n">total_CFs</span><span class="p">,</span> <span class="n">algorithm</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">]</span>
 
@@ -267,7 +265,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
                 <span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">[</span><span class="n">ix</span><span class="p">]</span><span class="o">.</span><span class="n">requires_grad</span> <span class="o">=</span> <span class="kc">True</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.do_loss_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_loss_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_loss_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">yloss_type</span><span class="p">,</span> <span class="n">diversity_loss_type</span><span class="p">,</span> <span class="n">feature_weights</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Intializes variables related to main loss function&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Intializes variables related to main loss function&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">loss_weights</span> <span class="o">=</span> <span class="p">[</span><span class="n">yloss_type</span><span class="p">,</span> <span class="n">diversity_loss_type</span><span class="p">,</span> <span class="n">feature_weights</span><span class="p">]</span>
 
@@ -296,7 +294,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
         <span class="bp">self</span><span class="o">.</span><span class="n">yloss_opt</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">nn</span><span class="o">.</span><span class="n">BCEWithLogitsLoss</span><span class="p">()</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.update_hyperparameters"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.update_hyperparameters">[docs]</a>    <span class="k">def</span> <span class="nf">update_hyperparameters</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">proximity_weight</span><span class="p">,</span> <span class="n">diversity_weight</span><span class="p">,</span> <span class="n">categorical_penalty</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Update hyperparameters of the loss function&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Update hyperparameters of the loss function&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">hyperparameters</span> <span class="o">=</span> <span class="p">[</span><span class="n">proximity_weight</span><span class="p">,</span> <span class="n">diversity_weight</span><span class="p">,</span> <span class="n">categorical_penalty</span><span class="p">]</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">proximity_weight</span> <span class="o">=</span> <span class="n">proximity_weight</span>
@@ -304,7 +302,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
         <span class="bp">self</span><span class="o">.</span><span class="n">categorical_penalty</span> <span class="o">=</span> <span class="n">categorical_penalty</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.do_optimizer_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_optimizer_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_optimizer_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">optimizer</span><span class="p">,</span> <span class="n">learning_rate</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Initializes gradient-based PyTorch optimizers.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initializes gradient-based PyTorch optimizers.&quot;&quot;&quot;</span>
         <span class="n">opt_method</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;:&#39;</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span>
 
         <span class="c1"># optimizater initialization</span>
@@ -314,7 +312,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
             <span class="bp">self</span><span class="o">.</span><span class="n">optimizer</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">optim</span><span class="o">.</span><span class="n">RMSprop</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">,</span> <span class="n">lr</span><span class="o">=</span><span class="n">learning_rate</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.compute_yloss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_yloss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_yloss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the first part (y-loss) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the first part (y-loss) of the loss function.&quot;&quot;&quot;</span>
         <span class="n">yloss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">yloss_type</span> <span class="o">==</span> <span class="s2">&quot;l2_loss&quot;</span><span class="p">:</span>
@@ -340,18 +338,18 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
         <span class="k">return</span> <span class="n">yloss</span><span class="o">/</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.compute_dist"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_dist">[docs]</a>    <span class="k">def</span> <span class="nf">compute_dist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">x_hat</span><span class="p">,</span> <span class="n">x1</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Compute weighted distance between two vectors.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Compute weighted distance between two vectors.&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="n">torch</span><span class="o">.</span><span class="n">sum</span><span class="p">(</span><span class="n">torch</span><span class="o">.</span><span class="n">mul</span><span class="p">((</span><span class="n">torch</span><span class="o">.</span><span class="n">abs</span><span class="p">(</span><span class="n">x_hat</span> <span class="o">-</span> <span class="n">x1</span><span class="p">)),</span> <span class="bp">self</span><span class="o">.</span><span class="n">feature_weights_list</span><span class="p">),</span> <span class="n">dim</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.compute_proximity_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_proximity_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_proximity_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Compute the second part (distance from x1) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Compute the second part (distance from x1) of the loss function.&quot;&quot;&quot;</span>
         <span class="n">proximity_loss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="n">proximity_loss</span> <span class="o">+=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_dist</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">x1</span><span class="p">)</span>
         <span class="k">return</span> <span class="n">proximity_loss</span><span class="o">/</span><span class="p">(</span><span class="n">torch</span><span class="o">.</span><span class="n">mul</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">minx</span><span class="p">[</span><span class="mi">0</span><span class="p">]),</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.dpp_style"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.dpp_style">[docs]</a>    <span class="k">def</span> <span class="nf">dpp_style</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">submethod</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the DPP of a matrix.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the DPP of a matrix.&quot;&quot;&quot;</span>
         <span class="n">det_entries</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">ones</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">))</span>
         <span class="k">if</span> <span class="n">submethod</span> <span class="o">==</span> <span class="s2">&quot;inverse_dist&quot;</span><span class="p">:</span>
             <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
@@ -371,7 +369,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
         <span class="k">return</span> <span class="n">diversity_loss</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.compute_diversity_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_diversity_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_diversity_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the third part (diversity) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the third part (diversity) of the loss function.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
             <span class="k">return</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">(</span><span class="mf">0.0</span><span class="p">)</span>
 
@@ -390,7 +388,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
             <span class="k">return</span> <span class="mf">1.0</span> <span class="o">-</span> <span class="p">(</span><span class="n">diversity_loss</span><span class="o">/</span><span class="n">count</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.compute_regularization_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_regularization_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_regularization_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Adds a linear equality constraints to the loss functions -</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Adds a linear equality constraints to the loss functions -</span>
 <span class="sd">           to ensure all levels of a categorical variable sums to one&quot;&quot;&quot;</span>
         <span class="n">regularization_loss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
@@ -400,7 +398,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
         <span class="k">return</span> <span class="n">regularization_loss</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.compute_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the overall loss&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the overall loss&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">yloss</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_yloss</span><span class="p">()</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">proximity_loss</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_proximity_loss</span><span class="p">()</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">proximity_weight</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="k">else</span> <span class="mf">0.0</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">diversity_loss</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_diversity_loss</span><span class="p">()</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">diversity_weight</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="k">else</span> <span class="mf">0.0</span>
@@ -412,7 +410,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">loss</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.initialize_CFs"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.initialize_CFs">[docs]</a>    <span class="k">def</span> <span class="nf">initialize_CFs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">,</span> <span class="n">init_near_query_instance</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Initialize counterfactuals.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initialize counterfactuals.&quot;&quot;&quot;</span>
         <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">minx</span><span class="p">[</span><span class="mi">0</span><span class="p">])):</span>
                 <span class="k">if</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">feat_to_vary_idxs</span><span class="p">:</span>
@@ -424,7 +422,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
                     <span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">[</span><span class="n">n</span><span class="p">]</span><span class="o">.</span><span class="n">data</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="o">=</span> <span class="n">query_instance</span><span class="p">[</span><span class="n">i</span><span class="p">]</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.round_off_cfs"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.round_off_cfs">[docs]</a>    <span class="k">def</span> <span class="nf">round_off_cfs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">assign</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;function for intermediate projection of CFs.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;function for intermediate projection of CFs.&quot;&quot;&quot;</span>
         <span class="n">temp_cfs</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">tcf</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">):</span>
             <span class="n">cf</span> <span class="o">=</span> <span class="n">tcf</span><span class="o">.</span><span class="n">detach</span><span class="p">()</span><span class="o">.</span><span class="n">clone</span><span class="p">()</span><span class="o">.</span><span class="n">numpy</span><span class="p">()</span>
@@ -462,7 +460,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
             <span class="k">return</span> <span class="n">temp_cfs</span></div>
 
 <div class="viewcode-block" id="DicePyTorch.stop_loop"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.stop_loop">[docs]</a>    <span class="k">def</span> <span class="nf">stop_loop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">itr</span><span class="p">,</span> <span class="n">loss_diff</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Determines the stopping condition for gradient descent.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Determines the stopping condition for gradient descent.&quot;&quot;&quot;</span>
 
         <span class="c1"># intermediate projections</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">project_iter</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">itr</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
@@ -502,7 +500,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
                              <span class="n">max_iter</span><span class="p">,</span> <span class="n">project_iter</span><span class="p">,</span> <span class="n">loss_diff_thres</span><span class="p">,</span> <span class="n">loss_converge_maxiter</span><span class="p">,</span> <span class="n">verbose</span><span class="p">,</span>
                              <span class="n">init_near_query_instance</span><span class="p">,</span> <span class="n">tie_random</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="p">,</span>
                              <span class="n">posthoc_sparsity_algorithm</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Finds counterfactuals by gradient-descent.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Finds counterfactuals by gradient-descent.&quot;&quot;&quot;</span>
         <span class="n">query_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">transformer</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span><span class="o">.</span><span class="n">to_numpy</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">x1</span> <span class="o">=</span> <span class="n">torch</span><span class="o">.</span><span class="n">tensor</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span>
 
@@ -593,7 +591,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
                 <span class="n">temp_cfs_stored</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">round_off_cfs</span><span class="p">(</span><span class="n">assign</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
                 <span class="n">test_preds_stored</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">cf</span><span class="p">)</span> <span class="k">for</span> <span class="n">cf</span> <span class="ow">in</span> <span class="n">temp_cfs_stored</span><span class="p">]</span>
 
-                <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))</span> <span class="ow">or</span>
+                <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))</span> <span class="ow">or</span>
                    <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))):</span>
                     <span class="n">avg_preds_dist</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">mean</span><span class="p">([</span><span class="nb">abs</span><span class="p">(</span><span class="n">pred</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="k">for</span> <span class="n">pred</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">])</span>
                     <span class="k">if</span> <span class="n">avg_preds_dist</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">min_dist_from_threshold</span><span class="p">[</span><span class="n">loop_ix</span><span class="p">]:</span>
@@ -618,7 +616,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
         <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">cfs</span><span class="p">)</span> <span class="k">for</span> <span class="n">cfs</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs</span><span class="p">]</span>
 
         <span class="c1"># update final_cfs from backed up CFs if valid CFs are not found</span>
-        <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
+        <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
            <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))):</span>
             <span class="k">for</span> <span class="n">loop_ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">):</span>
                 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">min_dist_from_threshold</span><span class="p">[</span><span class="n">loop_ix</span><span class="p">]</span> <span class="o">!=</span> <span class="mi">100</span><span class="p">:</span>
@@ -665,7 +663,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
             <span class="n">final_cfs_df_sparse</span> <span class="o">=</span> <span class="kc">None</span>
 
         <span class="n">m</span><span class="p">,</span> <span class="n">s</span> <span class="o">=</span> <span class="nb">divmod</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">elapsed</span><span class="p">,</span> <span class="mi">60</span><span class="p">)</span>
-        <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
+        <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
            <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))):</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">)</span>
             <span class="n">valid_ix</span> <span class="o">=</span> <span class="p">[</span><span class="n">ix</span> <span class="k">for</span> <span class="n">ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">max</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">))]</span>  <span class="c1"># indexes of valid CFs</span>
@@ -675,7 +673,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_pytorch</h1><div class="hi
             <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">=</span> <span class="mi">0</span>
             <span class="n">valid_ix</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># indexes of valid CFs</span>
             <span class="k">for</span> <span class="n">cf_ix</span><span class="p">,</span> <span class="n">pred</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">):</span>
-                <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">pred</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="ow">or</span>
+                <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">pred</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="ow">or</span>
                    <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="n">pred</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)):</span>
                     <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">+=</span> <span class="mi">1</span>
                     <span class="n">valid_ix</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cf_ix</span><span class="p">)</span>
diff --git a/docs/_modules/dice_ml/explainer_interfaces/dice_random.html b/docs/_modules/dice_ml/explainer_interfaces/dice_random.html
index 83e36586..3b278ec9 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/dice_random.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/dice_random.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.dice_random &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.explainer_interfaces.dice_random &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -102,7 +100,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_random</h1><div class="hig
 <div class="viewcode-block" id="DiceRandom"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_random.DiceRandom">[docs]</a><span class="k">class</span> <span class="nc">DiceRandom</span><span class="p">(</span><span class="n">ExplainerBase</span><span class="p">):</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data_interface</span><span class="p">,</span> <span class="n">model_interface</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param data_interface: an interface class to access data related params.</span>
 <span class="sd">        :param model_interface: an interface class to access trained ML model.</span>
@@ -125,7 +123,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_random</h1><div class="hig
                                   <span class="n">features_to_vary</span><span class="o">=</span><span class="s2">&quot;all&quot;</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span>
                                   <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="s2">&quot;linear&quot;</span><span class="p">,</span> <span class="n">sample_size</span><span class="o">=</span><span class="mi">1000</span><span class="p">,</span> <span class="n">random_seed</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
                                   <span class="n">limit_steps_ls</span><span class="o">=</span><span class="mi">10000</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Generate counterfactuals by randomly sampling features.</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Generate counterfactuals by randomly sampling features.</span>
 
 <span class="sd">        :param query_instance: Test point of interest. A dictionary of feature names and values or a single row dataframe.</span>
 <span class="sd">        :param total_CFs: Total number of counterfactuals required.</span>
@@ -265,7 +263,11 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_random</h1><div class="hig
 
         <span class="bp">self</span><span class="o">.</span><span class="n">elapsed</span> <span class="o">=</span> <span class="n">timeit</span><span class="o">.</span><span class="n">default_timer</span><span class="p">()</span> <span class="o">-</span> <span class="n">start_time</span>
         <span class="n">m</span><span class="p">,</span> <span class="n">s</span> <span class="o">=</span> <span class="nb">divmod</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">elapsed</span><span class="p">,</span> <span class="mi">60</span><span class="p">)</span>
-        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">valid_cfs_found</span><span class="p">:</span>
+
+        <span class="c1"># decoding to original label</span>
+        <span class="n">test_instance_df</span><span class="p">,</span> <span class="n">final_cfs_df</span><span class="p">,</span> <span class="n">final_cfs_df_sparse</span> <span class="o">=</span> \
+            <span class="bp">self</span><span class="o">.</span><span class="n">decode_to_original_labels</span><span class="p">(</span><span class="n">test_instance_df</span><span class="p">,</span> <span class="n">final_cfs_df</span><span class="p">,</span> <span class="n">final_cfs_df_sparse</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">final_cfs_df</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
             <span class="k">if</span> <span class="n">verbose</span><span class="p">:</span>
                 <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Diverse Counterfactuals found! total time taken: </span><span class="si">%02d</span><span class="s1">&#39;</span> <span class="o">%</span>
                       <span class="n">m</span><span class="p">,</span> <span class="s1">&#39;min </span><span class="si">%02d</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">s</span><span class="p">,</span> <span class="s1">&#39;sec&#39;</span><span class="p">)</span>
@@ -278,12 +280,14 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_random</h1><div class="hig
                       <span class="s1">&#39;Diverse Counterfactuals found for the given configuration, perhaps try with different parameters...&#39;</span><span class="p">,</span>
                       <span class="s1">&#39;; total time taken: </span><span class="si">%02d</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">m</span><span class="p">,</span> <span class="s1">&#39;min </span><span class="si">%02d</span><span class="s1">&#39;</span> <span class="o">%</span> <span class="n">s</span><span class="p">,</span> <span class="s1">&#39;sec&#39;</span><span class="p">)</span>
 
+        <span class="n">desired_class_param</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">decode_model_output</span><span class="p">(</span><span class="n">pd</span><span class="o">.</span><span class="n">Series</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span><span class="p">))[</span><span class="mi">0</span><span class="p">]</span> \
+            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="s1">&#39;target_cf_class&#39;</span><span class="p">)</span> <span class="k">else</span> <span class="n">desired_class</span>
         <span class="k">return</span> <span class="n">exp</span><span class="o">.</span><span class="n">CounterfactualExamples</span><span class="p">(</span><span class="n">data_interface</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="p">,</span>
                                           <span class="n">final_cfs_df</span><span class="o">=</span><span class="n">final_cfs_df</span><span class="p">,</span>
                                           <span class="n">test_instance_df</span><span class="o">=</span><span class="n">test_instance_df</span><span class="p">,</span>
                                           <span class="n">final_cfs_df_sparse</span><span class="o">=</span><span class="n">final_cfs_df_sparse</span><span class="p">,</span>
                                           <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="n">posthoc_sparsity_param</span><span class="p">,</span>
-                                          <span class="n">desired_class</span><span class="o">=</span><span class="n">desired_class</span><span class="p">,</span>
+                                          <span class="n">desired_class</span><span class="o">=</span><span class="n">desired_class_param</span><span class="p">,</span>
                                           <span class="n">desired_range</span><span class="o">=</span><span class="n">desired_range</span><span class="p">,</span>
                                           <span class="n">model_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span><span class="p">)</span>
 
diff --git a/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow1.html b/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow1.html
index f570e00e..42d99c08 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow1.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow1.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.dice_tensorflow1 &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.explainer_interfaces.dice_tensorflow1 &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -102,7 +100,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
 <div class="viewcode-block" id="DiceTensorFlow1"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1">[docs]</a><span class="k">class</span> <span class="nc">DiceTensorFlow1</span><span class="p">(</span><span class="n">ExplainerBase</span><span class="p">):</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data_interface</span><span class="p">,</span> <span class="n">model_interface</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param data_interface: an interface class to access data related params.</span>
 <span class="sd">        :param model_interface: an interface class to access trained ML model.</span>
@@ -154,7 +152,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
                                  <span class="n">project_iter</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">loss_diff_thres</span><span class="o">=</span><span class="mf">1e-5</span><span class="p">,</span> <span class="n">loss_converge_maxiter</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
                                  <span class="n">init_near_query_instance</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">tie_random</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span>
                                  <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span> <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="s2">&quot;linear&quot;</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="o">=</span><span class="mi">10000</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations</span>
 
 <span class="sd">        :param query_instance: Test point of interest. A dictionary of feature names and values or a single row dataframe.</span>
 <span class="sd">        :param total_CFs: Total number of counterfactuals required.</span>
@@ -224,7 +222,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
             <span class="bp">self</span><span class="o">.</span><span class="n">do_loss_initializations</span><span class="p">(</span><span class="n">yloss_type</span><span class="p">,</span> <span class="n">diversity_loss_type</span><span class="p">,</span> <span class="n">feature_weights</span><span class="p">)</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">do_optimizer_initializations</span><span class="p">(</span><span class="n">optimizer</span><span class="p">)</span>
 
-        <span class="sd">&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Future Support: We have three main components in our tensorflow graph:</span>
 <span class="sd">        (1) initialization of tf.variables</span>
 <span class="sd">        (2) defining ops for loss function initializations, and</span>
@@ -255,7 +253,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="k">return</span> <span class="n">CounterfactualExplanations</span><span class="p">(</span><span class="n">cf_examples_list</span><span class="o">=</span><span class="p">[</span><span class="n">counterfactual_explanations</span><span class="p">])</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.do_cf_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_cf_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_cf_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">total_CFs</span><span class="p">,</span> <span class="n">algorithm</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Intializes TF variables required for CF generation.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Intializes TF variables required for CF generation.&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">cf_init_weights</span> <span class="o">=</span> <span class="p">[</span><span class="n">total_CFs</span><span class="p">,</span> <span class="n">algorithm</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">]</span>
 
@@ -304,17 +302,17 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="p">}</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.predict_fn"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.predict_fn">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;prediction function&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;prediction function&quot;&quot;&quot;</span>
         <span class="n">temp_preds</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">dice_sess</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">output_tensor</span><span class="p">,</span> <span class="n">feed_dict</span><span class="o">=</span><span class="p">{</span><span class="bp">self</span><span class="o">.</span><span class="n">input_tensor</span><span class="p">:</span> <span class="n">input_instance</span><span class="p">})</span>
         <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="n">preds</span><span class="p">[(</span><span class="bp">self</span><span class="o">.</span><span class="n">num_output_nodes</span><span class="o">-</span><span class="mi">1</span><span class="p">):]</span> <span class="k">for</span> <span class="n">preds</span> <span class="ow">in</span> <span class="n">temp_preds</span><span class="p">])</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.predict_fn_for_sparsity"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.predict_fn_for_sparsity">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn_for_sparsity</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;prediction function for sparsity correction&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;prediction function for sparsity correction&quot;&quot;&quot;</span>
         <span class="n">input_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">transformer</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span><span class="o">.</span><span class="n">to_numpy</span><span class="p">()</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.compute_yloss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_yloss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_yloss</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the first part (y-loss) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the first part (y-loss) of the loss function.&quot;&quot;&quot;</span>
         <span class="n">yloss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="k">if</span> <span class="n">method</span> <span class="o">==</span> <span class="s2">&quot;l2_loss&quot;</span><span class="p">:</span>
@@ -344,11 +342,11 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="k">return</span> <span class="n">tf</span><span class="o">.</span><span class="n">divide</span><span class="p">(</span><span class="n">yloss</span><span class="p">,</span> <span class="n">tf</span><span class="o">.</span><span class="n">cast</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.compute_dist"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_dist">[docs]</a>    <span class="k">def</span> <span class="nf">compute_dist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">x_hat</span><span class="p">,</span> <span class="n">x1</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Compute weighted distance between two vectors.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Compute weighted distance between two vectors.&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="n">tf</span><span class="o">.</span><span class="n">reduce_sum</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">multiply</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">abs</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">subtract</span><span class="p">(</span><span class="n">x_hat</span><span class="p">,</span> <span class="n">x1</span><span class="p">)),</span> <span class="bp">self</span><span class="o">.</span><span class="n">feature_weights</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.compute_proximity_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_proximity_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_proximity_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Compute the second part (distance from x1) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Compute the second part (distance from x1) of the loss function.&quot;&quot;&quot;</span>
         <span class="n">proximity_loss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="n">proximity_loss</span> <span class="o">=</span> <span class="n">tf</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">proximity_loss</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_dist</span><span class="p">(</span>
@@ -356,7 +354,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="k">return</span> <span class="n">tf</span><span class="o">.</span><span class="n">divide</span><span class="p">(</span><span class="n">proximity_loss</span><span class="p">,</span> <span class="n">tf</span><span class="o">.</span><span class="n">cast</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">multiply</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">minx</span><span class="p">[</span><span class="mi">0</span><span class="p">]),</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">),</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.dpp_style"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.dpp_style">[docs]</a>    <span class="k">def</span> <span class="nf">dpp_style</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">submethod</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the DPP of a matrix.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the DPP of a matrix.&quot;&quot;&quot;</span>
         <span class="n">det_entries</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">if</span> <span class="n">submethod</span> <span class="o">==</span> <span class="s2">&quot;inverse_dist&quot;</span><span class="p">:</span>
             <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
@@ -379,7 +377,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="k">return</span> <span class="n">diversity_loss</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.compute_diversity_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_diversity_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_diversity_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the third part (diversity) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the third part (diversity) of the loss function.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
             <span class="k">return</span> <span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">(</span><span class="mf">0.0</span><span class="p">)</span>
 
@@ -401,7 +399,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
             <span class="k">return</span> <span class="n">tf</span><span class="o">.</span><span class="n">subtract</span><span class="p">(</span><span class="mf">1.0</span><span class="p">,</span> <span class="n">tf</span><span class="o">.</span><span class="n">divide</span><span class="p">(</span><span class="n">diversity_loss</span><span class="p">,</span> <span class="n">count</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.compute_regularization_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_regularization_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_regularization_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Adds a linear equality constraints to the loss functions -</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Adds a linear equality constraints to the loss functions -</span>
 <span class="sd">           to ensure all levels of a categorical variable sums to one&quot;&quot;&quot;</span>
         <span class="n">regularization_loss</span> <span class="o">=</span> <span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">(</span><span class="mf">0.0</span><span class="p">)</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
@@ -412,7 +410,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
 
 <div class="viewcode-block" id="DiceTensorFlow1.do_loss_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_loss_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_loss_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">yloss_type</span><span class="o">=</span><span class="s2">&quot;hinge_loss&quot;</span><span class="p">,</span> <span class="n">diversity_loss_type</span><span class="o">=</span><span class="s2">&quot;dpp_style:inverse_dist&quot;</span><span class="p">,</span>
                                 <span class="n">feature_weights</span><span class="o">=</span><span class="s2">&quot;inverse_mad&quot;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Defines the optimization loss&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Defines the optimization loss&quot;&quot;&quot;</span>
 
         <span class="c1"># define the loss parts</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">yloss_type</span> <span class="o">=</span> <span class="n">yloss_type</span>
@@ -463,7 +461,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
                             <span class="bp">self</span><span class="o">.</span><span class="n">weights</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">regularization_loss</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.tensorflow_optimizers"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.tensorflow_optimizers">[docs]</a>    <span class="k">def</span> <span class="nf">tensorflow_optimizers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="s2">&quot;adam&quot;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Initializes tensorflow optimizers.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initializes tensorflow optimizers.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="n">method</span> <span class="o">==</span> <span class="s2">&quot;adam&quot;</span><span class="p">:</span>
             <span class="n">opt</span> <span class="o">=</span> <span class="n">tf</span><span class="o">.</span><span class="n">train</span><span class="o">.</span><span class="n">AdamOptimizer</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">learning_rate</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="s1">&#39;myadam&#39;</span><span class="p">)</span>
             <span class="c1"># opt = tf.contrib.optimizer_v2.AdamOptimizer(self.learning_rate)</span>
@@ -481,7 +479,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="k">return</span> <span class="n">optim_step</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.initialize_CFs"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.initialize_CFs">[docs]</a>    <span class="k">def</span> <span class="nf">initialize_CFs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">,</span> <span class="n">init_near_query_instance</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Initialize counterfactuals.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initialize counterfactuals.&quot;&quot;&quot;</span>
         <span class="n">inits</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="n">one_init</span> <span class="o">=</span> <span class="p">[]</span>
@@ -497,7 +495,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="k">return</span> <span class="n">inits</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.do_optimizer_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_optimizer_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_optimizer_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">optimizer</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Initializes gradient-based TF optimizers.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initializes gradient-based TF optimizers.&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">optimizer_weights</span> <span class="o">=</span> <span class="p">[</span><span class="n">optimizer</span><span class="p">]</span>
 
@@ -512,7 +510,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="bp">self</span><span class="o">.</span><span class="n">dice_sess</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">reset_optimizer_op</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.update_hyperparameters"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.update_hyperparameters">[docs]</a>    <span class="k">def</span> <span class="nf">update_hyperparameters</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">proximity_weight</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">diversity_weight</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">categorical_penalty</span><span class="o">=</span><span class="mf">0.1</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Updates hyperparameters.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Updates hyperparameters.&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">hyperparameters</span> <span class="o">=</span> <span class="p">[</span><span class="n">proximity_weight</span><span class="p">,</span> <span class="n">diversity_weight</span><span class="p">,</span> <span class="n">categorical_penalty</span><span class="p">]</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">dice_sess</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">weights_assign</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">feed_dict</span><span class="o">=</span><span class="p">{</span><span class="bp">self</span><span class="o">.</span><span class="n">weights_inits</span><span class="p">:</span> <span class="n">proximity_weight</span><span class="p">})</span>
@@ -526,7 +524,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="bp">self</span><span class="o">.</span><span class="n">dice_sess</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">weights_assign</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span> <span class="n">feed_dict</span><span class="o">=</span><span class="p">{</span><span class="bp">self</span><span class="o">.</span><span class="n">weights_inits</span><span class="p">:</span> <span class="n">categorical_penalty</span><span class="p">})</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.round_off_cfs"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.round_off_cfs">[docs]</a>    <span class="k">def</span> <span class="nf">round_off_cfs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">assign</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;function for intermediate projection of CFs.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;function for intermediate projection of CFs.&quot;&quot;&quot;</span>
         <span class="n">temp_cfs</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">tcf</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">):</span>
             <span class="n">cf</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">dice_sess</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">tcf</span><span class="p">)</span>
@@ -562,7 +560,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
             <span class="k">return</span> <span class="n">temp_cfs</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow1.stop_loop"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.stop_loop">[docs]</a>    <span class="k">def</span> <span class="nf">stop_loop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">itr</span><span class="p">,</span> <span class="n">loss_diff</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Determines the stopping condition for gradient descent.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Determines the stopping condition for gradient descent.&quot;&quot;&quot;</span>
 
         <span class="c1"># intermediate projections</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">project_iter</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">itr</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
@@ -605,7 +603,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
                              <span class="n">max_iter</span><span class="o">=</span><span class="mi">5000</span><span class="p">,</span> <span class="n">project_iter</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">loss_diff_thres</span><span class="o">=</span><span class="mf">1e-5</span><span class="p">,</span> <span class="n">loss_converge_maxiter</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span>
                              <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">init_near_query_instance</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">tie_random</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
                              <span class="n">stopping_threshold</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span> <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="s2">&quot;linear&quot;</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Finds counterfactuals by gradient-descent.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Finds counterfactuals by gradient-descent.&quot;&quot;&quot;</span>
 
         <span class="n">query_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">transformer</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span><span class="o">.</span><span class="n">to_numpy</span><span class="p">()</span>
 
@@ -694,7 +692,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
                 <span class="n">temp_cfs_stored</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">round_off_cfs</span><span class="p">(</span><span class="n">assign</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
                 <span class="n">test_preds_stored</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">cf</span><span class="p">)</span> <span class="k">for</span> <span class="n">cf</span> <span class="ow">in</span> <span class="n">temp_cfs_stored</span><span class="p">]</span>
 
-                <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))</span> <span class="ow">or</span>
+                <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))</span> <span class="ow">or</span>
                    <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))):</span>
                     <span class="n">avg_preds_dist</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">mean</span><span class="p">([</span><span class="nb">abs</span><span class="p">(</span><span class="n">pred</span><span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="k">for</span> <span class="n">pred</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">])</span>
                     <span class="k">if</span> <span class="n">avg_preds_dist</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">min_dist_from_threshold</span><span class="p">[</span><span class="n">loop_ix</span><span class="p">]:</span>
@@ -719,7 +717,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
         <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">cfs</span><span class="p">)</span> <span class="k">for</span> <span class="n">cfs</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs</span><span class="p">]</span>
 
         <span class="c1"># update final_cfs from backed up CFs if valid CFs are not found</span>
-        <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
+        <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
            <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))):</span>
             <span class="k">for</span> <span class="n">loop_ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">):</span>
                 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">min_dist_from_threshold</span><span class="p">[</span><span class="n">loop_ix</span><span class="p">]</span> <span class="o">!=</span> <span class="mi">100</span><span class="p">:</span>
@@ -751,7 +749,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
             <span class="n">final_cfs_df_sparse</span> <span class="o">=</span> <span class="kc">None</span>
 
         <span class="n">m</span><span class="p">,</span> <span class="n">s</span> <span class="o">=</span> <span class="nb">divmod</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">elapsed</span><span class="p">,</span> <span class="mi">60</span><span class="p">)</span>
-        <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
+        <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
            <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))):</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">)</span>
             <span class="n">valid_ix</span> <span class="o">=</span> <span class="p">[</span><span class="n">ix</span> <span class="k">for</span> <span class="n">ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">max</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">))]</span>  <span class="c1"># indexes of valid CFs</span>
@@ -761,7 +759,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow1</h1><div class
             <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">=</span> <span class="mi">0</span>
             <span class="n">valid_ix</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># indexes of valid CFs</span>
             <span class="k">for</span> <span class="n">cf_ix</span><span class="p">,</span> <span class="n">pred</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">):</span>
-                <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">pred</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="ow">or</span>
+                <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">pred</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="ow">or</span>
                    <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="n">pred</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)):</span>
                     <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">+=</span> <span class="mi">1</span>
                     <span class="n">valid_ix</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cf_ix</span><span class="p">)</span>
diff --git a/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow2.html b/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow2.html
index 86e4333a..6416ff31 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow2.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/dice_tensorflow2.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.dice_tensorflow2 &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.explainer_interfaces.dice_tensorflow2 &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -101,7 +99,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
 <div class="viewcode-block" id="DiceTensorFlow2"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2">[docs]</a><span class="k">class</span> <span class="nc">DiceTensorFlow2</span><span class="p">(</span><span class="n">ExplainerBase</span><span class="p">):</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data_interface</span><span class="p">,</span> <span class="n">model_interface</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 <span class="sd">        :param data_interface: an interface class to access data related params.</span>
 <span class="sd">        :param model_interface: an interface class to access trained ML model.</span>
 
@@ -142,7 +140,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
                                  <span class="n">project_iter</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">loss_diff_thres</span><span class="o">=</span><span class="mf">1e-5</span><span class="p">,</span> <span class="n">loss_converge_maxiter</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
                                  <span class="n">init_near_query_instance</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">tie_random</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span>
                                  <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span> <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="s2">&quot;linear&quot;</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="o">=</span><span class="mi">10000</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Generates diverse counterfactual explanations</span>
 
 <span class="sd">        :param query_instance: Test point of interest. A dictionary of feature names and values or a single row dataframe</span>
 <span class="sd">        :param total_CFs: Total number of counterfactuals required.</span>
@@ -232,17 +230,17 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="k">return</span> <span class="n">CounterfactualExplanations</span><span class="p">(</span><span class="n">cf_examples_list</span><span class="o">=</span><span class="p">[</span><span class="n">counterfactual_explanations</span><span class="p">])</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.predict_fn"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.predict_fn">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;prediction function&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;prediction function&quot;&quot;&quot;</span>
         <span class="n">temp_preds</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">get_output</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span><span class="o">.</span><span class="n">numpy</span><span class="p">()</span>
         <span class="k">return</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">([</span><span class="n">preds</span><span class="p">[(</span><span class="bp">self</span><span class="o">.</span><span class="n">num_output_nodes</span><span class="o">-</span><span class="mi">1</span><span class="p">):]</span> <span class="k">for</span> <span class="n">preds</span> <span class="ow">in</span> <span class="n">temp_preds</span><span class="p">],</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">float32</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.predict_fn_for_sparsity"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.predict_fn_for_sparsity">[docs]</a>    <span class="k">def</span> <span class="nf">predict_fn_for_sparsity</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;prediction function for sparsity correction&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;prediction function for sparsity correction&quot;&quot;&quot;</span>
         <span class="n">input_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">transformer</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">input_instance</span><span class="p">)</span><span class="o">.</span><span class="n">to_numpy</span><span class="p">()</span>
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">(</span><span class="n">input_instance</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.do_cf_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_cf_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_cf_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">total_CFs</span><span class="p">,</span> <span class="n">algorithm</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Intializes CFs and other related variables.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Intializes CFs and other related variables.&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">cf_init_weights</span> <span class="o">=</span> <span class="p">[</span><span class="n">total_CFs</span><span class="p">,</span> <span class="n">algorithm</span><span class="p">,</span> <span class="n">features_to_vary</span><span class="p">]</span>
 
@@ -270,7 +268,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
                 <span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">Variable</span><span class="p">(</span><span class="n">one_init</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.do_loss_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_loss_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_loss_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">yloss_type</span><span class="p">,</span> <span class="n">diversity_loss_type</span><span class="p">,</span> <span class="n">feature_weights</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Intializes variables related to main loss function&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Intializes variables related to main loss function&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">loss_weights</span> <span class="o">=</span> <span class="p">[</span><span class="n">yloss_type</span><span class="p">,</span> <span class="n">diversity_loss_type</span><span class="p">,</span> <span class="n">feature_weights</span><span class="p">]</span>
 
@@ -296,7 +294,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
             <span class="bp">self</span><span class="o">.</span><span class="n">feature_weights_list</span> <span class="o">=</span> <span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">([</span><span class="n">feature_weights_list</span><span class="p">],</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.update_hyperparameters"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.update_hyperparameters">[docs]</a>    <span class="k">def</span> <span class="nf">update_hyperparameters</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">proximity_weight</span><span class="p">,</span> <span class="n">diversity_weight</span><span class="p">,</span> <span class="n">categorical_penalty</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Update hyperparameters of the loss function&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Update hyperparameters of the loss function&quot;&quot;&quot;</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">hyperparameters</span> <span class="o">=</span> <span class="p">[</span><span class="n">proximity_weight</span><span class="p">,</span> <span class="n">diversity_weight</span><span class="p">,</span> <span class="n">categorical_penalty</span><span class="p">]</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">proximity_weight</span> <span class="o">=</span> <span class="n">proximity_weight</span>
@@ -304,7 +302,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="bp">self</span><span class="o">.</span><span class="n">categorical_penalty</span> <span class="o">=</span> <span class="n">categorical_penalty</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.do_optimizer_initializations"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_optimizer_initializations">[docs]</a>    <span class="k">def</span> <span class="nf">do_optimizer_initializations</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">optimizer</span><span class="p">,</span> <span class="n">learning_rate</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Initializes gradient-based TensorFLow optimizers.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initializes gradient-based TensorFLow optimizers.&quot;&quot;&quot;</span>
         <span class="n">opt_method</span> <span class="o">=</span> <span class="n">optimizer</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;:&#39;</span><span class="p">)[</span><span class="mi">1</span><span class="p">]</span>
 
         <span class="c1"># optimizater initialization</span>
@@ -314,7 +312,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
             <span class="bp">self</span><span class="o">.</span><span class="n">optimizer</span> <span class="o">=</span> <span class="n">tf</span><span class="o">.</span><span class="n">compat</span><span class="o">.</span><span class="n">v1</span><span class="o">.</span><span class="n">train</span><span class="o">.</span><span class="n">RMSPropOptimizer</span><span class="p">(</span><span class="n">learning_rate</span><span class="o">=</span><span class="n">learning_rate</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.compute_yloss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_yloss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_yloss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the first part (y-loss) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the first part (y-loss) of the loss function.&quot;&quot;&quot;</span>
         <span class="n">yloss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">yloss_type</span> <span class="o">==</span> <span class="s2">&quot;l2_loss&quot;</span><span class="p">:</span>
@@ -340,18 +338,18 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="k">return</span> <span class="n">yloss</span><span class="o">/</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.compute_dist"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_dist">[docs]</a>    <span class="k">def</span> <span class="nf">compute_dist</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">x_hat</span><span class="p">,</span> <span class="n">x1</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Compute weighted distance between two vectors.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Compute weighted distance between two vectors.&quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="n">tf</span><span class="o">.</span><span class="n">reduce_sum</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">multiply</span><span class="p">((</span><span class="n">tf</span><span class="o">.</span><span class="n">abs</span><span class="p">(</span><span class="n">x_hat</span> <span class="o">-</span> <span class="n">x1</span><span class="p">)),</span> <span class="bp">self</span><span class="o">.</span><span class="n">feature_weights_list</span><span class="p">))</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.compute_proximity_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_proximity_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_proximity_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Compute the second part (distance from x1) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Compute the second part (distance from x1) of the loss function.&quot;&quot;&quot;</span>
         <span class="n">proximity_loss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="n">proximity_loss</span> <span class="o">+=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_dist</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">x1</span><span class="p">)</span>
         <span class="k">return</span> <span class="n">proximity_loss</span><span class="o">/</span><span class="n">tf</span><span class="o">.</span><span class="n">cast</span><span class="p">((</span><span class="n">tf</span><span class="o">.</span><span class="n">multiply</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">minx</span><span class="p">[</span><span class="mi">0</span><span class="p">]),</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">)),</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.dpp_style"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.dpp_style">[docs]</a>    <span class="k">def</span> <span class="nf">dpp_style</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">submethod</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the DPP of a matrix.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the DPP of a matrix.&quot;&quot;&quot;</span>
         <span class="n">det_entries</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">if</span> <span class="n">submethod</span> <span class="o">==</span> <span class="s2">&quot;inverse_dist&quot;</span><span class="p">:</span>
             <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
@@ -374,7 +372,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="k">return</span> <span class="n">diversity_loss</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.compute_diversity_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_diversity_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_diversity_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the third part (diversity) of the loss function.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the third part (diversity) of the loss function.&quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span> <span class="o">==</span> <span class="mi">1</span><span class="p">:</span>
             <span class="k">return</span> <span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">(</span><span class="mf">0.0</span><span class="p">)</span>
 
@@ -393,7 +391,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
             <span class="k">return</span> <span class="mf">1.0</span> <span class="o">-</span> <span class="p">(</span><span class="n">diversity_loss</span><span class="o">/</span><span class="n">count</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.compute_regularization_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_regularization_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_regularization_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Adds a linear equality constraints to the loss functions - to ensure all levels</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Adds a linear equality constraints to the loss functions - to ensure all levels</span>
 <span class="sd">           of a categorical variable sums to one&quot;&quot;&quot;</span>
         <span class="n">regularization_loss</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
@@ -403,7 +401,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="k">return</span> <span class="n">regularization_loss</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.compute_loss"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_loss">[docs]</a>    <span class="k">def</span> <span class="nf">compute_loss</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Computes the overall loss&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Computes the overall loss&quot;&quot;&quot;</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">yloss</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_yloss</span><span class="p">()</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">proximity_loss</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_proximity_loss</span><span class="p">()</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">proximity_weight</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="k">else</span> <span class="mf">0.0</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">diversity_loss</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">compute_diversity_loss</span><span class="p">()</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">diversity_weight</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="k">else</span> <span class="mf">0.0</span>
@@ -415,7 +413,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">loss</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.initialize_CFs"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.initialize_CFs">[docs]</a>    <span class="k">def</span> <span class="nf">initialize_CFs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">,</span> <span class="n">init_near_query_instance</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Initialize counterfactuals.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Initialize counterfactuals.&quot;&quot;&quot;</span>
         <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">):</span>
             <span class="n">one_init</span> <span class="o">=</span> <span class="p">[]</span>
             <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">minx</span><span class="p">[</span><span class="mi">0</span><span class="p">])):</span>
@@ -430,7 +428,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
             <span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">[</span><span class="n">n</span><span class="p">]</span><span class="o">.</span><span class="n">assign</span><span class="p">(</span><span class="n">one_init</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.round_off_cfs"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.round_off_cfs">[docs]</a>    <span class="k">def</span> <span class="nf">round_off_cfs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">assign</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;function for intermediate projection of CFs.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;function for intermediate projection of CFs.&quot;&quot;&quot;</span>
         <span class="n">temp_cfs</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">tcf</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs</span><span class="p">):</span>
             <span class="n">cf</span> <span class="o">=</span> <span class="n">tcf</span><span class="o">.</span><span class="n">numpy</span><span class="p">()</span>
@@ -467,7 +465,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
             <span class="k">return</span> <span class="n">temp_cfs</span></div>
 
 <div class="viewcode-block" id="DiceTensorFlow2.stop_loop"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.stop_loop">[docs]</a>    <span class="k">def</span> <span class="nf">stop_loop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">itr</span><span class="p">,</span> <span class="n">loss_diff</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Determines the stopping condition for gradient descent.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Determines the stopping condition for gradient descent.&quot;&quot;&quot;</span>
 
         <span class="c1"># intermediate projections</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">project_iter</span> <span class="o">&gt;</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">itr</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
@@ -507,7 +505,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
                              <span class="n">max_iter</span><span class="p">,</span> <span class="n">project_iter</span><span class="p">,</span> <span class="n">loss_diff_thres</span><span class="p">,</span> <span class="n">loss_converge_maxiter</span><span class="p">,</span> <span class="n">verbose</span><span class="p">,</span>
                              <span class="n">init_near_query_instance</span><span class="p">,</span> <span class="n">tie_random</span><span class="p">,</span> <span class="n">stopping_threshold</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="p">,</span>
                              <span class="n">posthoc_sparsity_algorithm</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Finds counterfactuals by gradient-descent.&quot;&quot;&quot;</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Finds counterfactuals by gradient-descent.&quot;&quot;&quot;</span>
 
         <span class="n">query_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">transformer</span><span class="o">.</span><span class="n">transform</span><span class="p">(</span><span class="n">query_instance</span><span class="p">)</span><span class="o">.</span><span class="n">to_numpy</span><span class="p">()</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">x1</span> <span class="o">=</span> <span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">(</span><span class="n">query_instance</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">)</span>
@@ -600,7 +598,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
                 <span class="n">temp_cfs_stored</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">round_off_cfs</span><span class="p">(</span><span class="n">assign</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
                 <span class="n">test_preds_stored</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">(</span><span class="n">cf</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">))</span> <span class="k">for</span> <span class="n">cf</span> <span class="ow">in</span> <span class="n">temp_cfs_stored</span><span class="p">]</span>
 
-                <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))</span> <span class="ow">or</span>
+                <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))</span> <span class="ow">or</span>
                    <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">))):</span>
                     <span class="n">avg_preds_dist</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">mean</span><span class="p">([</span><span class="nb">abs</span><span class="p">(</span><span class="n">pred</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span><span class="o">-</span><span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="k">for</span> <span class="n">pred</span> <span class="ow">in</span> <span class="n">test_preds_stored</span><span class="p">])</span>
                     <span class="k">if</span> <span class="n">avg_preds_dist</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">min_dist_from_threshold</span><span class="p">[</span><span class="n">loop_ix</span><span class="p">]:</span>
@@ -624,7 +622,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">predict_fn</span><span class="p">(</span><span class="n">tf</span><span class="o">.</span><span class="n">constant</span><span class="p">(</span><span class="n">cfs</span><span class="p">,</span> <span class="n">dtype</span><span class="o">=</span><span class="n">tf</span><span class="o">.</span><span class="n">float32</span><span class="p">))</span> <span class="k">for</span> <span class="n">cfs</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">final_cfs</span><span class="p">]</span>
 
         <span class="c1"># update final_cfs from backed up CFs if valid CFs are not found</span>
-        <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
+        <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
            <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span><span class="n">i</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))):</span>
             <span class="k">for</span> <span class="n">loop_ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">):</span>
                 <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">min_dist_from_threshold</span><span class="p">[</span><span class="n">loop_ix</span><span class="p">]</span> <span class="o">!=</span> <span class="mi">100</span><span class="p">:</span>
@@ -668,7 +666,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
         <span class="c1">#     self.cfs_preds_sparse = None</span>
 
         <span class="n">m</span><span class="p">,</span> <span class="n">s</span> <span class="o">=</span> <span class="nb">divmod</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">elapsed</span><span class="p">,</span> <span class="mi">60</span><span class="p">)</span>
-        <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
+        <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))</span> <span class="ow">or</span>
            <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="nb">all</span><span class="p">(</span><span class="n">i</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">))):</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">)</span>
             <span class="n">valid_ix</span> <span class="o">=</span> <span class="p">[</span><span class="n">ix</span> <span class="k">for</span> <span class="n">ix</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="nb">max</span><span class="p">(</span><span class="n">loop_find_CFs</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs</span><span class="p">))]</span>  <span class="c1"># indexes of valid CFs</span>
@@ -678,7 +676,7 @@ <h1>Source code for dice_ml.explainer_interfaces.dice_tensorflow2</h1><div class
             <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">=</span> <span class="mi">0</span>
             <span class="n">valid_ix</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># indexes of valid CFs</span>
             <span class="k">for</span> <span class="n">cf_ix</span><span class="p">,</span> <span class="n">pred</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cfs_preds</span><span class="p">):</span>
-                <span class="k">if</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">pred</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="ow">or</span>
+                <span class="k">if</span> <span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="n">pred</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)</span> <span class="ow">or</span>
                    <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">target_cf_class</span> <span class="o">==</span> <span class="mi">1</span> <span class="ow">and</span> <span class="n">pred</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">stopping_threshold</span><span class="p">)):</span>
                     <span class="bp">self</span><span class="o">.</span><span class="n">total_CFs_found</span> <span class="o">+=</span> <span class="mi">1</span>
                     <span class="n">valid_ix</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">cf_ix</span><span class="p">)</span>
diff --git a/docs/_modules/dice_ml/explainer_interfaces/explainer_base.html b/docs/_modules/dice_ml/explainer_interfaces/explainer_base.html
index ae503911..96d9464b 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/explainer_base.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/explainer_base.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.explainer_base &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.explainer_interfaces.explainer_base &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -88,6 +88,7 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
 <span class="kn">import</span> <span class="nn">pickle</span>
 <span class="kn">from</span> <span class="nn">abc</span> <span class="kn">import</span> <span class="n">ABC</span><span class="p">,</span> <span class="n">abstractmethod</span>
 <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Iterable</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span><span class="p">,</span> <span class="n">List</span>
 
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
 <span class="kn">import</span> <span class="nn">pandas</span> <span class="k">as</span> <span class="nn">pd</span>
@@ -130,6 +131,24 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
         <span class="c1"># self.cont_precisions = \</span>
         <span class="c1">#   [self.data_interface.get_decimal_precisions()[ix] for ix in self.encoded_continuous_feature_indexes]</span>
 
+    <span class="k">def</span> <span class="nf">_find_features_having_missing_values</span><span class="p">(</span>
+            <span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Return list of features which have missing values.</span>
+
+<span class="sd">        :param data: The dataset to check.</span>
+<span class="sd">        :type data: Any</span>
+<span class="sd">        :return: List of feature names which have missing values.</span>
+<span class="sd">        :rtype: List[str]</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">):</span>
+            <span class="k">return</span> <span class="p">[]</span>
+
+        <span class="n">list_of_feature_having_missing_values</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">for</span> <span class="n">feature</span> <span class="ow">in</span> <span class="n">data</span><span class="o">.</span><span class="n">columns</span><span class="o">.</span><span class="n">tolist</span><span class="p">():</span>
+            <span class="k">if</span> <span class="n">np</span><span class="o">.</span><span class="n">any</span><span class="p">(</span><span class="n">data</span><span class="p">[</span><span class="n">feature</span><span class="p">]</span><span class="o">.</span><span class="n">isnull</span><span class="p">()):</span>
+                <span class="n">list_of_feature_having_missing_values</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">feature</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">list_of_feature_having_missing_values</span>
+
     <span class="k">def</span> <span class="nf">_validate_counterfactual_configuration</span><span class="p">(</span>
             <span class="bp">self</span><span class="p">,</span> <span class="n">query_instances</span><span class="p">,</span> <span class="n">total_CFs</span><span class="p">,</span>
             <span class="n">desired_class</span><span class="o">=</span><span class="s2">&quot;opposite&quot;</span><span class="p">,</span> <span class="n">desired_range</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
@@ -137,6 +156,12 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
             <span class="n">stopping_threshold</span><span class="o">=</span><span class="mf">0.5</span><span class="p">,</span> <span class="n">posthoc_sparsity_param</span><span class="o">=</span><span class="mf">0.1</span><span class="p">,</span>
             <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="s2">&quot;linear&quot;</span><span class="p">,</span> <span class="n">verbose</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
 
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_find_features_having_missing_values</span><span class="p">(</span><span class="n">query_instances</span><span class="p">))</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+            <span class="k">raise</span> <span class="n">UserConfigValidationException</span><span class="p">(</span>
+                <span class="s2">&quot;The query instance(s) should not have any missing values. &quot;</span>
+                <span class="s2">&quot;Please impute the missing values and try again.&quot;</span>
+            <span class="p">)</span>
+
         <span class="k">if</span> <span class="n">total_CFs</span> <span class="o">&lt;=</span> <span class="mi">0</span><span class="p">:</span>
             <span class="k">raise</span> <span class="n">UserConfigValidationException</span><span class="p">(</span>
                 <span class="s2">&quot;The number of counterfactuals generated per query instance (total_CFs) should be a positive integer.&quot;</span><span class="p">)</span>
@@ -252,6 +277,14 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
                 <span class="n">posthoc_sparsity_algorithm</span><span class="o">=</span><span class="n">posthoc_sparsity_algorithm</span><span class="p">,</span>
                 <span class="n">verbose</span><span class="o">=</span><span class="n">verbose</span><span class="p">,</span>
                 <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+            <span class="n">res</span><span class="o">.</span><span class="n">test_instance_df</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">ensure_consistent_type</span><span class="p">(</span>
+                    <span class="n">res</span><span class="o">.</span><span class="n">test_instance_df</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">)</span>
+            <span class="k">if</span> <span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+                <span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">ensure_consistent_type</span><span class="p">(</span>
+                    <span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">)</span>
+            <span class="k">if</span> <span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+                <span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">ensure_consistent_type</span><span class="p">(</span>
+                    <span class="n">res</span><span class="o">.</span><span class="n">final_cfs_df_sparse</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">)</span>
             <span class="n">cf_examples_arr</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">res</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_check_any_counterfactuals_computed</span><span class="p">(</span><span class="n">cf_examples_arr</span><span class="o">=</span><span class="n">cf_examples_arr</span><span class="p">)</span>
 
@@ -616,7 +649,7 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
                 <span class="c1"># current_pred = self.predict_fn_for_sparsity(final_cfs_sparse.iat[[cf_ix]][self.data_interface.feature_names])</span>
                 <span class="c1"># feat_ix = self.data_interface.continuous_feature_names.index(feature)</span>
                 <span class="n">diff</span> <span class="o">=</span> <span class="n">query_instance</span><span class="p">[</span><span class="n">feature</span><span class="p">]</span><span class="o">.</span><span class="n">iat</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">-</span> <span class="n">final_cfs_sparse</span><span class="o">.</span><span class="n">at</span><span class="p">[</span><span class="n">cf_ix</span><span class="p">,</span> <span class="n">feature</span><span class="p">]</span>
-                <span class="k">if</span><span class="p">(</span><span class="nb">abs</span><span class="p">(</span><span class="n">diff</span><span class="p">)</span> <span class="o">&lt;=</span> <span class="n">quantiles</span><span class="p">[</span><span class="n">feature</span><span class="p">]):</span>
+                <span class="k">if</span> <span class="p">(</span><span class="nb">abs</span><span class="p">(</span><span class="n">diff</span><span class="p">)</span> <span class="o">&lt;=</span> <span class="n">quantiles</span><span class="p">[</span><span class="n">feature</span><span class="p">]):</span>
                     <span class="k">if</span> <span class="n">posthoc_sparsity_algorithm</span> <span class="o">==</span> <span class="s2">&quot;linear&quot;</span><span class="p">:</span>
                         <span class="n">final_cfs_sparse</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">do_linear_search</span><span class="p">(</span><span class="n">diff</span><span class="p">,</span> <span class="n">decimal_prec</span><span class="p">,</span> <span class="n">query_instance</span><span class="p">,</span> <span class="n">cf_ix</span><span class="p">,</span>
                                                                  <span class="n">feature</span><span class="p">,</span> <span class="n">final_cfs_sparse</span><span class="p">,</span> <span class="n">current_pred</span><span class="p">,</span> <span class="n">limit_steps_ls</span><span class="p">)</span>
@@ -641,8 +674,8 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
         <span class="n">current_pred</span> <span class="o">=</span> <span class="n">current_pred_orig</span>
         <span class="n">count_steps</span> <span class="o">=</span> <span class="mi">0</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span> <span class="o">==</span> <span class="n">ModelTypes</span><span class="o">.</span><span class="n">Classifier</span><span class="p">:</span>
-            <span class="k">while</span><span class="p">((</span><span class="nb">abs</span><span class="p">(</span><span class="n">diff</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mf">10e-4</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">sign</span><span class="p">(</span><span class="n">diff</span><span class="o">*</span><span class="n">old_diff</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">and</span>
-                  <span class="bp">self</span><span class="o">.</span><span class="n">is_cf_valid</span><span class="p">(</span><span class="n">current_pred</span><span class="p">))</span> <span class="ow">and</span> <span class="p">(</span><span class="n">count_steps</span> <span class="o">&lt;</span> <span class="n">limit_steps_ls</span><span class="p">):</span>
+            <span class="k">while</span> <span class="p">((</span><span class="nb">abs</span><span class="p">(</span><span class="n">diff</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mf">10e-4</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">np</span><span class="o">.</span><span class="n">sign</span><span class="p">(</span><span class="n">diff</span><span class="o">*</span><span class="n">old_diff</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">and</span>
+                    <span class="bp">self</span><span class="o">.</span><span class="n">is_cf_valid</span><span class="p">(</span><span class="n">current_pred</span><span class="p">))</span> <span class="ow">and</span> <span class="p">(</span><span class="n">count_steps</span> <span class="o">&lt;</span> <span class="n">limit_steps_ls</span><span class="p">):</span>
 
                 <span class="n">old_val</span> <span class="o">=</span> <span class="n">final_cfs_sparse</span><span class="o">.</span><span class="n">at</span><span class="p">[</span><span class="n">cf_ix</span><span class="p">,</span> <span class="n">feature</span><span class="p">]</span>
                 <span class="n">final_cfs_sparse</span><span class="o">.</span><span class="n">at</span><span class="p">[</span><span class="n">cf_ix</span><span class="p">,</span> <span class="n">feature</span><span class="p">]</span> <span class="o">+=</span> <span class="n">np</span><span class="o">.</span><span class="n">sign</span><span class="p">(</span><span class="n">diff</span><span class="p">)</span><span class="o">*</span><span class="n">change</span>
@@ -839,6 +872,13 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
         <span class="k">else</span><span class="p">:</span>
             <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">target_cf_range</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">&lt;=</span> <span class="n">model_score</span> <span class="ow">and</span> <span class="n">model_score</span> <span class="o">&lt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">target_cf_range</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span></div>
 
+<div class="viewcode-block" id="ExplainerBase.decode_model_output"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_model_output">[docs]</a>    <span class="k">def</span> <span class="nf">decode_model_output</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">encoded_labels</span><span class="p">):</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span> <span class="o">==</span> <span class="n">ModelTypes</span><span class="o">.</span><span class="n">Classifier</span><span class="p">:</span>
+            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="s2">&quot;classes_&quot;</span><span class="p">):</span>  <span class="c1"># sklearn model</span>
+                <span class="n">label_dict</span> <span class="o">=</span> <span class="p">{</span><span class="n">idx</span><span class="p">:</span> <span class="n">label</span> <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="n">label</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">classes_</span><span class="p">)}</span>
+                <span class="k">return</span> <span class="n">encoded_labels</span><span class="o">.</span><span class="n">apply</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">label_dict</span><span class="p">[</span><span class="n">x</span><span class="p">])</span>
+        <span class="k">return</span> <span class="n">encoded_labels</span>  <span class="c1"># no op</span></div>
+
 <div class="viewcode-block" id="ExplainerBase.get_model_output_from_scores"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.get_model_output_from_scores">[docs]</a>    <span class="k">def</span> <span class="nf">get_model_output_from_scores</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">model_scores</span><span class="p">):</span>
         <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">model_type</span> <span class="o">==</span> <span class="n">ModelTypes</span><span class="o">.</span><span class="n">Classifier</span><span class="p">:</span>
             <span class="n">output_type</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">int32</span>
@@ -884,7 +924,7 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
         <span class="n">dataset_instance</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">prepare_query_instance</span><span class="p">(</span>
             <span class="n">query_instance</span><span class="o">=</span><span class="n">data_df_copy</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">feature_names</span><span class="p">])</span>
 
-        <span class="n">predictions</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">get_output</span><span class="p">(</span><span class="n">dataset_instance</span><span class="p">,</span> <span class="n">model_score</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span><span class="o">.</span><span class="n">flatten</span><span class="p">()</span>
+        <span class="n">predictions</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_model_output_from_scores</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">get_output</span><span class="p">(</span><span class="n">dataset_instance</span><span class="p">,</span> <span class="n">model_score</span><span class="o">=</span><span class="kc">True</span><span class="p">))</span><span class="o">.</span><span class="n">flatten</span><span class="p">()</span>
         <span class="c1"># TODO: Is it okay to insert a column in the original dataframe with the predicted outcome? This is memory-efficient</span>
         <span class="n">data_df_copy</span><span class="p">[</span><span class="n">predicted_outcome_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">predictions</span>
 
@@ -925,6 +965,17 @@ <h1>Source code for dice_ml.explainer_interfaces.explainer_base</h1><div class="
             <span class="k">raise</span> <span class="n">UserConfigValidationException</span><span class="p">(</span>
                 <span class="s2">&quot;No counterfactuals found for any of the query points! Kindly check your configuration.&quot;</span><span class="p">)</span>
 
+<div class="viewcode-block" id="ExplainerBase.decode_to_original_labels"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_to_original_labels">[docs]</a>    <span class="k">def</span> <span class="nf">decode_to_original_labels</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">test_instance_df</span><span class="p">,</span> <span class="n">final_cfs_df</span><span class="p">,</span> <span class="n">final_cfs_df_sparse</span><span class="p">):</span>
+        <span class="n">test_instance_df</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> \
+            <span class="bp">self</span><span class="o">.</span><span class="n">decode_model_output</span><span class="p">(</span><span class="n">test_instance_df</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">])</span>
+        <span class="k">if</span> <span class="n">final_cfs_df</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+            <span class="n">final_cfs_df</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> \
+                <span class="bp">self</span><span class="o">.</span><span class="n">decode_model_output</span><span class="p">(</span><span class="n">final_cfs_df</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">])</span>
+            <span class="k">if</span> <span class="n">final_cfs_df_sparse</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                <span class="n">final_cfs_df_sparse</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">]</span> <span class="o">=</span> \
+                    <span class="bp">self</span><span class="o">.</span><span class="n">decode_model_output</span><span class="p">(</span><span class="n">final_cfs_df_sparse</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">data_interface</span><span class="o">.</span><span class="n">outcome_name</span><span class="p">])</span>
+        <span class="k">return</span> <span class="n">test_instance_df</span><span class="p">,</span> <span class="n">final_cfs_df</span><span class="p">,</span> <span class="n">final_cfs_df_sparse</span></div>
+
 <div class="viewcode-block" id="ExplainerBase.serialize_explainer"><a class="viewcode-back" href="../../../dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.serialize_explainer">[docs]</a>    <span class="k">def</span> <span class="nf">serialize_explainer</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">):</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Serialize the explainer to the file specified by path.&quot;&quot;&quot;</span>
         <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="s2">&quot;wb&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">pickle_file</span><span class="p">:</span>
diff --git a/docs/_modules/dice_ml/explainer_interfaces/feasible_base_vae.html b/docs/_modules/dice_ml/explainer_interfaces/feasible_base_vae.html
index 334bbb18..fd46f2d5 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/feasible_base_vae.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/feasible_base_vae.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.feasible_base_vae &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.explainer_interfaces.feasible_base_vae &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -272,7 +272,7 @@ <h1>Source code for dice_ml.explainer_interfaces.feasible_base_vae</h1><div clas
             <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">total_CFs</span><span class="p">):</span>
                 <span class="n">recon_err</span><span class="p">,</span> <span class="n">kl_err</span><span class="p">,</span> <span class="n">x_true</span><span class="p">,</span> <span class="n">x_pred</span><span class="p">,</span> <span class="n">cf_label</span> <span class="o">=</span> \
                     <span class="bp">self</span><span class="o">.</span><span class="n">cf_vae</span><span class="o">.</span><span class="n">compute_elbo</span><span class="p">(</span><span class="n">train_x</span><span class="p">,</span> <span class="mf">1.0</span><span class="o">-</span><span class="n">train_y</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">pred_model</span><span class="p">)</span>
-                <span class="k">while</span><span class="p">(</span><span class="n">cf_label</span> <span class="o">==</span> <span class="n">train_y</span><span class="p">):</span>
+                <span class="k">while</span> <span class="p">(</span><span class="n">cf_label</span> <span class="o">==</span> <span class="n">train_y</span><span class="p">):</span>
                     <span class="nb">print</span><span class="p">(</span><span class="n">cf_label</span><span class="p">,</span> <span class="n">train_y</span><span class="p">)</span>
                     <span class="n">recon_err</span><span class="p">,</span> <span class="n">kl_err</span><span class="p">,</span> <span class="n">x_true</span><span class="p">,</span> <span class="n">x_pred</span><span class="p">,</span> <span class="n">cf_label</span> <span class="o">=</span> \
                         <span class="bp">self</span><span class="o">.</span><span class="n">cf_vae</span><span class="o">.</span><span class="n">compute_elbo</span><span class="p">(</span><span class="n">train_x</span><span class="p">,</span> <span class="mf">1.0</span><span class="o">-</span><span class="n">train_y</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">pred_model</span><span class="p">)</span>
diff --git a/docs/_modules/dice_ml/explainer_interfaces/feasible_model_approx.html b/docs/_modules/dice_ml/explainer_interfaces/feasible_model_approx.html
index 99c9af96..5096aa7d 100644
--- a/docs/_modules/dice_ml/explainer_interfaces/feasible_model_approx.html
+++ b/docs/_modules/dice_ml/explainer_interfaces/feasible_model_approx.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces.feasible_model_approx &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.explainer_interfaces.feasible_model_approx &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/_modules/dice_ml/model.html b/docs/_modules/dice_ml/model.html
index a7ee43b3..83f854ef 100644
--- a/docs/_modules/dice_ml/model.html
+++ b/docs/_modules/dice_ml/model.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.model &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.model &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -116,8 +116,7 @@ <h1>Source code for dice_ml.model</h1><div class="highlight"><pre>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="k">if</span> <span class="n">backend</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">BackEndTypes</span><span class="o">.</span><span class="n">ALL</span><span class="p">:</span>
             <span class="n">warnings</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">{0}</span><span class="s1"> backend not in supported backends </span><span class="si">{1}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-                <span class="n">backend</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">BackEndTypes</span><span class="o">.</span><span class="n">ALL</span><span class="p">))</span>
-            <span class="p">)</span>
+                <span class="n">backend</span><span class="p">,</span> <span class="s1">&#39;,&#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">BackEndTypes</span><span class="o">.</span><span class="n">ALL</span><span class="p">)),</span> <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>
 
         <span class="k">if</span> <span class="n">model_type</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">ModelTypes</span><span class="o">.</span><span class="n">ALL</span><span class="p">:</span>
             <span class="k">raise</span> <span class="n">UserConfigValidationException</span><span class="p">(</span><span class="s1">&#39;</span><span class="si">{0}</span><span class="s1"> model type not in supported model types </span><span class="si">{1}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
diff --git a/docs/_modules/dice_ml/model_interfaces/base_model.html b/docs/_modules/dice_ml/model_interfaces/base_model.html
index 6d8be717..946724c1 100644
--- a/docs/_modules/dice_ml/model_interfaces/base_model.html
+++ b/docs/_modules/dice_ml/model_interfaces/base_model.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.model_interfaces.base_model &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.model_interfaces.base_model &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -99,7 +97,7 @@ <h1>Source code for dice_ml.model_interfaces.base_model</h1><div class="highligh
 <div class="viewcode-block" id="BaseModel"><a class="viewcode-back" href="../../../dice_ml.model_interfaces.html#dice_ml.model_interfaces.base_model.BaseModel">[docs]</a><span class="k">class</span> <span class="nc">BaseModel</span><span class="p">:</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">model</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">model_path</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">backend</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">func</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">kw_args</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param model: trained ML Model.</span>
 <span class="sd">        :param model_path: path to trained model.</span>
@@ -128,7 +126,7 @@ <h1>Source code for dice_ml.model_interfaces.base_model</h1><div class="highligh
                 <span class="bp">self</span><span class="o">.</span><span class="n">model</span> <span class="o">=</span> <span class="n">pickle</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="n">filehandle</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="BaseModel.get_output"><a class="viewcode-back" href="../../../dice_ml.model_interfaces.html#dice_ml.model_interfaces.base_model.BaseModel.get_output">[docs]</a>    <span class="k">def</span> <span class="nf">get_output</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">,</span> <span class="n">model_score</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;returns prediction probabilities for a classifier and the predicted output for a regressor.</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;returns prediction probabilities for a classifier and the predicted output for a regressor.</span>
 
 <span class="sd">        :returns: an array of output scores for a classifier, and a singleton</span>
 <span class="sd">        array of predicted value for a regressor.</span>
diff --git a/docs/_modules/dice_ml/model_interfaces/keras_tensorflow_model.html b/docs/_modules/dice_ml/model_interfaces/keras_tensorflow_model.html
index 52987a71..7eb7c80b 100644
--- a/docs/_modules/dice_ml/model_interfaces/keras_tensorflow_model.html
+++ b/docs/_modules/dice_ml/model_interfaces/keras_tensorflow_model.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.model_interfaces.keras_tensorflow_model &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.model_interfaces.keras_tensorflow_model &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -94,7 +92,7 @@ <h1>Source code for dice_ml.model_interfaces.keras_tensorflow_model</h1><div cla
 <div class="viewcode-block" id="KerasTensorFlowModel"><a class="viewcode-back" href="../../../dice_ml.model_interfaces.html#dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel">[docs]</a><span class="k">class</span> <span class="nc">KerasTensorFlowModel</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">model</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">model_path</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">backend</span><span class="o">=</span><span class="s1">&#39;TF1&#39;</span><span class="p">,</span> <span class="n">func</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">kw_args</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param model: trained Keras Sequential Model.</span>
 <span class="sd">        :param model_path: path to trained model.</span>
@@ -111,7 +109,7 @@ <h1>Source code for dice_ml.model_interfaces.keras_tensorflow_model</h1><div cla
             <span class="bp">self</span><span class="o">.</span><span class="n">model</span> <span class="o">=</span> <span class="n">keras</span><span class="o">.</span><span class="n">models</span><span class="o">.</span><span class="n">load_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model_path</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="KerasTensorFlowModel.get_output"><a class="viewcode-back" href="../../../dice_ml.model_interfaces.html#dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.get_output">[docs]</a>    <span class="k">def</span> <span class="nf">get_output</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_tensor</span><span class="p">,</span> <span class="n">training</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">transform_data</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;returns prediction probabilities</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;returns prediction probabilities</span>
 
 <span class="sd">        :param input_tensor: test input.</span>
 <span class="sd">        :param training: to determine training mode in TF2.</span>
diff --git a/docs/_modules/dice_ml/model_interfaces/pytorch_model.html b/docs/_modules/dice_ml/model_interfaces/pytorch_model.html
index 368791f4..a29eb49a 100644
--- a/docs/_modules/dice_ml/model_interfaces/pytorch_model.html
+++ b/docs/_modules/dice_ml/model_interfaces/pytorch_model.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.model_interfaces.pytorch_model &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.model_interfaces.pytorch_model &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -95,7 +93,7 @@ <h1>Source code for dice_ml.model_interfaces.pytorch_model</h1><div class="highl
 <div class="viewcode-block" id="PyTorchModel"><a class="viewcode-back" href="../../../dice_ml.model_interfaces.html#dice_ml.model_interfaces.pytorch_model.PyTorchModel">[docs]</a><span class="k">class</span> <span class="nc">PyTorchModel</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
 
     <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">model</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">model_path</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">backend</span><span class="o">=</span><span class="s1">&#39;PYT&#39;</span><span class="p">,</span> <span class="n">func</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">kw_args</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;Init method</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Init method</span>
 
 <span class="sd">        :param model: trained PyTorch Model.</span>
 <span class="sd">        :param model_path: path to trained model.</span>
@@ -113,7 +111,7 @@ <h1>Source code for dice_ml.model_interfaces.pytorch_model</h1><div class="highl
 
 <div class="viewcode-block" id="PyTorchModel.get_output"><a class="viewcode-back" href="../../../dice_ml.model_interfaces.html#dice_ml.model_interfaces.pytorch_model.PyTorchModel.get_output">[docs]</a>    <span class="k">def</span> <span class="nf">get_output</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_instance</span><span class="p">,</span> <span class="n">model_score</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
                    <span class="n">transform_data</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">out_tensor</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-        <span class="sd">&quot;&quot;&quot;returns prediction probabilities</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;returns prediction probabilities</span>
 
 <span class="sd">        :param input_tensor: test input.</span>
 <span class="sd">        :param transform_data: boolean to indicate if data transformation is required.</span>
diff --git a/docs/_modules/dice_ml/utils/exception.html b/docs/_modules/dice_ml/utils/exception.html
index c380639e..3fa1fc8f 100644
--- a/docs/_modules/dice_ml/utils/exception.html
+++ b/docs/_modules/dice_ml/utils/exception.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.utils.exception &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.utils.exception &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -82,18 +82,6 @@
              
   <h1>Source code for dice_ml.utils.exception</h1><div class="highlight"><pre>
 <span></span><span class="sd">&quot;&quot;&quot;Exceptions for the package.&quot;&quot;&quot;</span>
-<span class="kn">import</span> <span class="nn">warnings</span>
-
-
-<div class="viewcode-block" id="UserConfigValidationException"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.exception.UserConfigValidationException">[docs]</a><span class="k">class</span> <span class="nc">UserConfigValidationException</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
-<span class="w">    </span><span class="sd">&quot;&quot;&quot;An exception indicating that some user configuration is not valid.</span>
-
-<span class="sd">    :param exception_message: A message describing the error.</span>
-<span class="sd">    :type exception_message: str</span>
-<span class="sd">    &quot;&quot;&quot;</span>
-    <span class="n">_error_code</span> <span class="o">=</span> <span class="s2">&quot;Invalid Configuration&quot;</span>
-    <span class="n">warnings</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s2">&quot;UserConfigValidationException will be deprecated from dice_ml.utils. &quot;</span>
-                  <span class="s2">&quot;Please import UserConfigValidationException from raiutils.exceptions.&quot;</span><span class="p">)</span></div>
 
 
 <div class="viewcode-block" id="SystemException"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.exception.SystemException">[docs]</a><span class="k">class</span> <span class="nc">SystemException</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
diff --git a/docs/_modules/dice_ml/utils/helpers.html b/docs/_modules/dice_ml/utils/helpers.html
index c5b73605..cbecaf73 100644
--- a/docs/_modules/dice_ml/utils/helpers.html
+++ b/docs/_modules/dice_ml/utils/helpers.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.utils.helpers &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.utils.helpers &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -225,11 +225,33 @@ <h1>Source code for dice_ml.utils.helpers</h1><div class="highlight"><pre>
     <span class="k">return</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;Categorical&#39;</span><span class="p">,</span> <span class="s1">&#39;Numerical&#39;</span><span class="p">,</span> <span class="s1">&#39;Outcome&#39;</span><span class="p">])</span></div>
 
 
+<div class="viewcode-block" id="load_custom_testing_dataset_binary_str"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_binary_str">[docs]</a><span class="k">def</span> <span class="nf">load_custom_testing_dataset_binary_str</span><span class="p">():</span>
+    <span class="n">data</span> <span class="o">=</span> <span class="p">[</span>
+        <span class="p">[</span><span class="s2">&quot;a&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="s2">&quot;zero&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;b&quot;</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="s2">&quot;one&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;c&quot;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="s2">&quot;zero&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;a&quot;</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="s2">&quot;one&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;c&quot;</span><span class="p">,</span> <span class="mi">4</span><span class="p">,</span> <span class="s2">&quot;one&quot;</span><span class="p">],</span>
+    <span class="p">]</span>
+    <span class="k">return</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;Categorical&quot;</span><span class="p">,</span> <span class="s2">&quot;Numerical&quot;</span><span class="p">,</span> <span class="s2">&quot;Outcome&quot;</span><span class="p">])</span></div>
+
+
 <div class="viewcode-block" id="load_custom_testing_dataset_multiclass"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass">[docs]</a><span class="k">def</span> <span class="nf">load_custom_testing_dataset_multiclass</span><span class="p">():</span>
     <span class="n">data</span> <span class="o">=</span> <span class="p">[[</span><span class="s1">&#39;a&#39;</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span> <span class="mi">1</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;b&#39;</span><span class="p">,</span> <span class="mi">20</span><span class="p">,</span> <span class="mi">2</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;c&#39;</span><span class="p">,</span> <span class="mi">14</span><span class="p">,</span> <span class="mi">1</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;a&#39;</span><span class="p">,</span> <span class="mi">23</span><span class="p">,</span> <span class="mi">2</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;c&#39;</span><span class="p">,</span> <span class="mi">7</span><span class="p">,</span> <span class="mi">0</span><span class="p">]]</span>
     <span class="k">return</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;Categorical&#39;</span><span class="p">,</span> <span class="s1">&#39;Numerical&#39;</span><span class="p">,</span> <span class="s1">&#39;Outcome&#39;</span><span class="p">])</span></div>
 
 
+<div class="viewcode-block" id="load_custom_testing_dataset_multiclass_str"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass_str">[docs]</a><span class="k">def</span> <span class="nf">load_custom_testing_dataset_multiclass_str</span><span class="p">():</span>
+    <span class="n">data</span> <span class="o">=</span> <span class="p">[</span>
+        <span class="p">[</span><span class="s2">&quot;a&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="s2">&quot;zero&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;b&quot;</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="s2">&quot;one&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;c&quot;</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="s2">&quot;two&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;a&quot;</span><span class="p">,</span> <span class="mi">3</span><span class="p">,</span> <span class="s2">&quot;one&quot;</span><span class="p">],</span>
+        <span class="p">[</span><span class="s2">&quot;c&quot;</span><span class="p">,</span> <span class="mi">4</span><span class="p">,</span> <span class="s2">&quot;zero&quot;</span><span class="p">],</span>
+    <span class="p">]</span>
+    <span class="k">return</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;Categorical&quot;</span><span class="p">,</span> <span class="s2">&quot;Numerical&quot;</span><span class="p">,</span> <span class="s2">&quot;Outcome&quot;</span><span class="p">])</span></div>
+
+
 <div class="viewcode-block" id="load_custom_testing_dataset_regression"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_regression">[docs]</a><span class="k">def</span> <span class="nf">load_custom_testing_dataset_regression</span><span class="p">():</span>
     <span class="n">data</span> <span class="o">=</span> <span class="p">[[</span><span class="s1">&#39;a&#39;</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span> <span class="mi">1</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;b&#39;</span><span class="p">,</span> <span class="mi">21</span><span class="p">,</span> <span class="mf">2.1</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;c&#39;</span><span class="p">,</span> <span class="mi">14</span><span class="p">,</span> <span class="mf">1.4</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;a&#39;</span><span class="p">,</span> <span class="mi">23</span><span class="p">,</span> <span class="mf">2.3</span><span class="p">],</span> <span class="p">[</span><span class="s1">&#39;c&#39;</span><span class="p">,</span> <span class="mi">7</span><span class="p">,</span> <span class="mf">0.7</span><span class="p">]]</span>
     <span class="k">return</span> <span class="n">pd</span><span class="o">.</span><span class="n">DataFrame</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">columns</span><span class="o">=</span><span class="p">[</span><span class="s1">&#39;Categorical&#39;</span><span class="p">,</span> <span class="s1">&#39;Numerical&#39;</span><span class="p">,</span> <span class="s1">&#39;Outcome&#39;</span><span class="p">])</span></div>
diff --git a/docs/_modules/dice_ml/utils/neuralnetworks.html b/docs/_modules/dice_ml/utils/neuralnetworks.html
index 42b6e8a7..0e857c7f 100644
--- a/docs/_modules/dice_ml/utils/neuralnetworks.html
+++ b/docs/_modules/dice_ml/utils/neuralnetworks.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.utils.neuralnetworks &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.utils.neuralnetworks &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
@@ -104,6 +102,24 @@ <h1>Source code for dice_ml.utils.neuralnetworks</h1><div class="highlight"><pre
         <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_classifier</span><span class="p">:</span>
             <span class="n">out</span> <span class="o">=</span> <span class="mi">3</span> <span class="o">*</span> <span class="n">out</span>  <span class="c1"># output between 0 and 3</span>
         <span class="k">return</span> <span class="n">out</span></div></div>
+
+
+<div class="viewcode-block" id="MulticlassNetwork"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.neuralnetworks.MulticlassNetwork">[docs]</a><span class="k">class</span> <span class="nc">MulticlassNetwork</span><span class="p">(</span><span class="n">nn</span><span class="o">.</span><span class="n">Module</span><span class="p">):</span>
+    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">input_size</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">num_class</span><span class="p">:</span> <span class="nb">int</span><span class="p">):</span>
+        <span class="nb">super</span><span class="p">(</span><span class="n">MulticlassNetwork</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">()</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">linear_relu_stack</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Sequential</span><span class="p">(</span>
+            <span class="n">nn</span><span class="o">.</span><span class="n">Linear</span><span class="p">(</span><span class="n">input_size</span><span class="p">,</span> <span class="mi">16</span><span class="p">),</span>
+            <span class="n">nn</span><span class="o">.</span><span class="n">ReLU</span><span class="p">(),</span>
+            <span class="n">nn</span><span class="o">.</span><span class="n">Linear</span><span class="p">(</span><span class="mi">16</span><span class="p">,</span> <span class="n">num_class</span><span class="p">)</span>
+        <span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">softmax</span> <span class="o">=</span> <span class="n">nn</span><span class="o">.</span><span class="n">Softmax</span><span class="p">(</span><span class="n">dim</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+
+<div class="viewcode-block" id="MulticlassNetwork.forward"><a class="viewcode-back" href="../../../dice_ml.utils.html#dice_ml.utils.neuralnetworks.MulticlassNetwork.forward">[docs]</a>    <span class="k">def</span> <span class="nf">forward</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">x</span><span class="p">):</span>
+        <span class="n">x</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">linear_relu_stack</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
+        <span class="n">out</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">softmax</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
+
+        <span class="k">return</span> <span class="n">out</span></div></div>
 </pre></div>
 
            </div>
diff --git a/docs/_modules/dice_ml/utils/sample_architecture/vae_model.html b/docs/_modules/dice_ml/utils/sample_architecture/vae_model.html
index 5aa7be77..14509a8f 100644
--- a/docs/_modules/dice_ml/utils/sample_architecture/vae_model.html
+++ b/docs/_modules/dice_ml/utils/sample_architecture/vae_model.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.utils.sample_architecture.vae_model &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.utils.sample_architecture.vae_model &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
diff --git a/docs/_modules/dice_ml/utils/serialize.html b/docs/_modules/dice_ml/utils/serialize.html
index fd132f05..10e243f1 100644
--- a/docs/_modules/dice_ml/utils/serialize.html
+++ b/docs/_modules/dice_ml/utils/serialize.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.utils.serialize &mdash; DiCE 0.9 documentation</title>
+  <title>dice_ml.utils.serialize &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -50,8 +50,6 @@
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_model_agnostic_CFs.html">Generating counterfactual explanations with any ML model</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_private_data.html">Generating counterfactual explanations without access to training data</a></li>
 <li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_with_advanced_options.html">Advanced options to customize Counterfactual Explanations</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html">Generate feasible counterfactual explanations using a VAE</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../../../notebooks/DiCE_getting_started_feasible.html#Adding-feasibility-constraints">Adding feasibility constraints</a></li>
 </ul>
 <p class="caption" role="heading"><span class="caption-text">Package:</span></p>
 <ul>
diff --git a/docs/_modules/index.html b/docs/_modules/index.html
index f35ffb9f..21614948 100644
--- a/docs/_modules/index.html
+++ b/docs/_modules/index.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Overview: module code &mdash; DiCE 0.10 documentation</title>
+  <title>Overview: module code &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/_static/documentation_options.js b/docs/_static/documentation_options.js
index 9738300a..08605196 100644
--- a/docs/_static/documentation_options.js
+++ b/docs/_static/documentation_options.js
@@ -1,6 +1,6 @@
 var DOCUMENTATION_OPTIONS = {
     URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
-    VERSION: '0.10',
+    VERSION: '0.11',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',
diff --git a/docs/dice_ml.data_interfaces.html b/docs/dice_ml.data_interfaces.html
index 28dc654f..0b9fdcff 100644
--- a/docs/dice_ml.data_interfaces.html
+++ b/docs/dice_ml.data_interfaces.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.data_interfaces package &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.data_interfaces package &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -284,6 +284,11 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 <dd><p>Prepares user defined test input(s) for DiCE.</p>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="dice_ml.data_interfaces.private_data_interface.PrivateData.query_instance_to_df">
+<span class="sig-name descname"><span class="pre">query_instance_to_df</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">query_instance</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/data_interfaces/private_data_interface.html#PrivateData.query_instance_to_df"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.data_interfaces.private_data_interface.PrivateData.query_instance_to_df" title="Permalink to this definition"></a></dt>
+<dd></dd></dl>
+
 </dd></dl>
 
 </section>
diff --git a/docs/dice_ml.explainer_interfaces.html b/docs/dice_ml.explainer_interfaces.html
index 79f73ea3..c24e4e7f 100644
--- a/docs/dice_ml.explainer_interfaces.html
+++ b/docs/dice_ml.explainer_interfaces.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.explainer_interfaces package &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.explainer_interfaces package &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -174,6 +174,12 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 <dd><p>returns predictions</p>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn_scores">
+<span class="sig-name descname"><span class="pre">predict_fn_scores</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">input_instance</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/explainer_interfaces/dice_KD.html#DiceKD.predict_fn_scores"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn_scores" title="Permalink to this definition"></a></dt>
+<dd><p>Returns prediction scores.</p>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="dice_ml.explainer_interfaces.dice_KD.DiceKD.vary_valid">
 <span class="sig-name descname"><span class="pre">vary_valid</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">KD_query_instance</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">total_CFs</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">features_to_vary</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">permitted_range</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">query_instance</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sparsity_weight</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/explainer_interfaces/dice_KD.html#DiceKD.vary_valid"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.explainer_interfaces.dice_KD.DiceKD.vary_valid" title="Permalink to this definition"></a></dt>
@@ -808,6 +814,16 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 <span class="sig-name descname"><span class="pre">decide_cf_validity</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">model_outputs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/explainer_interfaces/explainer_base.html#ExplainerBase.decide_cf_validity"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decide_cf_validity" title="Permalink to this definition"></a></dt>
 <dd></dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_model_output">
+<span class="sig-name descname"><span class="pre">decode_model_output</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">encoded_labels</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/explainer_interfaces/explainer_base.html#ExplainerBase.decode_model_output"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_model_output" title="Permalink to this definition"></a></dt>
+<dd></dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_to_original_labels">
+<span class="sig-name descname"><span class="pre">decode_to_original_labels</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">test_instance_df</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_cfs_df</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">final_cfs_df_sparse</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/explainer_interfaces/explainer_base.html#ExplainerBase.decode_to_original_labels"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_to_original_labels" title="Permalink to this definition"></a></dt>
+<dd></dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="dice_ml.explainer_interfaces.explainer_base.ExplainerBase.deserialize_explainer">
 <em class="property"><span class="pre">static</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">deserialize_explainer</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">path</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/explainer_interfaces/explainer_base.html#ExplainerBase.deserialize_explainer"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.deserialize_explainer" title="Permalink to this definition"></a></dt>
diff --git a/docs/dice_ml.html b/docs/dice_ml.html
index c559bc8c..51f79a71 100644
--- a/docs/dice_ml.html
+++ b/docs/dice_ml.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml package &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml package &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -241,6 +241,7 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to thi
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.one_hot_encode_data"><code class="docutils literal notranslate"><span class="pre">PrivateData.one_hot_encode_data()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_df_for_ohe_encoding"><code class="docutils literal notranslate"><span class="pre">PrivateData.prepare_df_for_ohe_encoding()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_query_instance"><code class="docutils literal notranslate"><span class="pre">PrivateData.prepare_query_instance()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.query_instance_to_df"><code class="docutils literal notranslate"><span class="pre">PrivateData.query_instance_to_df()</span></code></a></li>
 </ul>
 </li>
 </ul>
@@ -286,6 +287,7 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to thi
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.duplicates"><code class="docutils literal notranslate"><span class="pre">DiceKD.duplicates()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.find_counterfactuals"><code class="docutils literal notranslate"><span class="pre">DiceKD.find_counterfactuals()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn"><code class="docutils literal notranslate"><span class="pre">DiceKD.predict_fn()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn_scores"><code class="docutils literal notranslate"><span class="pre">DiceKD.predict_fn_scores()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.vary_valid"><code class="docutils literal notranslate"><span class="pre">DiceKD.vary_valid()</span></code></a></li>
 </ul>
 </li>
@@ -402,6 +404,8 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to thi
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.check_permitted_range"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.check_permitted_range()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.check_query_instance_validity"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.check_query_instance_validity()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decide_cf_validity"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.decide_cf_validity()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_model_output"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.decode_model_output()</span></code></a></li>
+<li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_to_original_labels"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.decode_to_original_labels()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.deserialize_explainer"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.deserialize_explainer()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_binary_search"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.do_binary_search()</span></code></a></li>
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_linear_search"><code class="docutils literal notranslate"><span class="pre">ExplainerBase.do_linear_search()</span></code></a></li>
@@ -498,7 +502,6 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to thi
 <li class="toctree-l2"><a class="reference internal" href="dice_ml.utils.html#submodules">Submodules</a></li>
 <li class="toctree-l2"><a class="reference internal" href="dice_ml.utils.html#module-dice_ml.utils.exception">dice_ml.utils.exception module</a><ul>
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.exception.SystemException"><code class="docutils literal notranslate"><span class="pre">SystemException</span></code></a></li>
-<li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.exception.UserConfigValidationException"><code class="docutils literal notranslate"><span class="pre">UserConfigValidationException</span></code></a></li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="dice_ml.utils.html#module-dice_ml.utils.helpers">dice_ml.utils.helpers module</a><ul>
@@ -521,7 +524,9 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to thi
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_adult_income_dataset"><code class="docutils literal notranslate"><span class="pre">load_adult_income_dataset()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset"><code class="docutils literal notranslate"><span class="pre">load_custom_testing_dataset()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_binary"><code class="docutils literal notranslate"><span class="pre">load_custom_testing_dataset_binary()</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_binary_str"><code class="docutils literal notranslate"><span class="pre">load_custom_testing_dataset_binary_str()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass"><code class="docutils literal notranslate"><span class="pre">load_custom_testing_dataset_multiclass()</span></code></a></li>
+<li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass_str"><code class="docutils literal notranslate"><span class="pre">load_custom_testing_dataset_multiclass_str()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_regression"><code class="docutils literal notranslate"><span class="pre">load_custom_testing_dataset_regression()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_min_max_equal_dataset"><code class="docutils literal notranslate"><span class="pre">load_min_max_equal_dataset()</span></code></a></li>
 <li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.helpers.load_outcome_not_last_column_dataset"><code class="docutils literal notranslate"><span class="pre">load_outcome_not_last_column_dataset()</span></code></a></li>
@@ -534,6 +539,10 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to thi
 <li class="toctree-l4"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.neuralnetworks.FFNetwork.forward"><code class="docutils literal notranslate"><span class="pre">FFNetwork.forward()</span></code></a></li>
 </ul>
 </li>
+<li class="toctree-l3"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.neuralnetworks.MulticlassNetwork"><code class="docutils literal notranslate"><span class="pre">MulticlassNetwork</span></code></a><ul>
+<li class="toctree-l4"><a class="reference internal" href="dice_ml.utils.html#dice_ml.utils.neuralnetworks.MulticlassNetwork.forward"><code class="docutils literal notranslate"><span class="pre">MulticlassNetwork.forward()</span></code></a></li>
+</ul>
+</li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="dice_ml.utils.html#module-dice_ml.utils.serialize">dice_ml.utils.serialize module</a><ul>
diff --git a/docs/dice_ml.model_interfaces.html b/docs/dice_ml.model_interfaces.html
index 0da275e5..2f3497f9 100644
--- a/docs/dice_ml.model_interfaces.html
+++ b/docs/dice_ml.model_interfaces.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.model_interfaces package &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.model_interfaces package &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/dice_ml.schema.html b/docs/dice_ml.schema.html
index 2657f4e6..7c5be8b0 100644
--- a/docs/dice_ml.schema.html
+++ b/docs/dice_ml.schema.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.schema package &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.schema package &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/dice_ml.utils.html b/docs/dice_ml.utils.html
index e8fa6e17..6a9ab5c0 100644
--- a/docs/dice_ml.utils.html
+++ b/docs/dice_ml.utils.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.utils package &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.utils package &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -189,18 +189,6 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 </dl>
 </dd></dl>
 
-<dl class="py exception">
-<dt class="sig sig-object py" id="dice_ml.utils.exception.UserConfigValidationException">
-<em class="property"><span class="pre">exception</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">dice_ml.utils.exception.</span></span><span class="sig-name descname"><span class="pre">UserConfigValidationException</span></span><a class="reference internal" href="_modules/dice_ml/utils/exception.html#UserConfigValidationException"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.exception.UserConfigValidationException" title="Permalink to this definition"></a></dt>
-<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">Exception</span></code></p>
-<p>An exception indicating that some user configuration is not valid.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Parameters</dt>
-<dd class="field-odd"><p><strong>exception_message</strong> (<em>str</em>) – A message describing the error.</p>
-</dd>
-</dl>
-</dd></dl>
-
 </section>
 <section id="module-dice_ml.utils.helpers">
 <span id="dice-ml-utils-helpers-module"></span><h2>dice_ml.utils.helpers module<a class="headerlink" href="#module-dice_ml.utils.helpers" title="Permalink to this heading"></a></h2>
@@ -303,11 +291,21 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 <span class="sig-prename descclassname"><span class="pre">dice_ml.utils.helpers.</span></span><span class="sig-name descname"><span class="pre">load_custom_testing_dataset_binary</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/utils/helpers.html#load_custom_testing_dataset_binary"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.helpers.load_custom_testing_dataset_binary" title="Permalink to this definition"></a></dt>
 <dd></dd></dl>
 
+<dl class="py function">
+<dt class="sig sig-object py" id="dice_ml.utils.helpers.load_custom_testing_dataset_binary_str">
+<span class="sig-prename descclassname"><span class="pre">dice_ml.utils.helpers.</span></span><span class="sig-name descname"><span class="pre">load_custom_testing_dataset_binary_str</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/utils/helpers.html#load_custom_testing_dataset_binary_str"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.helpers.load_custom_testing_dataset_binary_str" title="Permalink to this definition"></a></dt>
+<dd></dd></dl>
+
 <dl class="py function">
 <dt class="sig sig-object py" id="dice_ml.utils.helpers.load_custom_testing_dataset_multiclass">
 <span class="sig-prename descclassname"><span class="pre">dice_ml.utils.helpers.</span></span><span class="sig-name descname"><span class="pre">load_custom_testing_dataset_multiclass</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/utils/helpers.html#load_custom_testing_dataset_multiclass"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass" title="Permalink to this definition"></a></dt>
 <dd></dd></dl>
 
+<dl class="py function">
+<dt class="sig sig-object py" id="dice_ml.utils.helpers.load_custom_testing_dataset_multiclass_str">
+<span class="sig-prename descclassname"><span class="pre">dice_ml.utils.helpers.</span></span><span class="sig-name descname"><span class="pre">load_custom_testing_dataset_multiclass_str</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/utils/helpers.html#load_custom_testing_dataset_multiclass_str"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass_str" title="Permalink to this definition"></a></dt>
+<dd></dd></dl>
+
 <dl class="py function">
 <dt class="sig sig-object py" id="dice_ml.utils.helpers.load_custom_testing_dataset_regression">
 <span class="sig-prename descclassname"><span class="pre">dice_ml.utils.helpers.</span></span><span class="sig-name descname"><span class="pre">load_custom_testing_dataset_regression</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/utils/helpers.html#load_custom_testing_dataset_regression"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.helpers.load_custom_testing_dataset_regression" title="Permalink to this definition"></a></dt>
@@ -348,6 +346,17 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
 </dd></dl>
 
+<dl class="py class">
+<dt class="sig sig-object py" id="dice_ml.utils.neuralnetworks.MulticlassNetwork">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">dice_ml.utils.neuralnetworks.</span></span><span class="sig-name descname"><span class="pre">MulticlassNetwork</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Any</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Any</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/utils/neuralnetworks.html#MulticlassNetwork"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.neuralnetworks.MulticlassNetwork" title="Permalink to this definition"></a></dt>
+<dd><p>Bases: <code class="xref py py-class docutils literal notranslate"><span class="pre">Module</span></code></p>
+<dl class="py method">
+<dt class="sig sig-object py" id="dice_ml.utils.neuralnetworks.MulticlassNetwork.forward">
+<span class="sig-name descname"><span class="pre">forward</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/dice_ml/utils/neuralnetworks.html#MulticlassNetwork.forward"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#dice_ml.utils.neuralnetworks.MulticlassNetwork.forward" title="Permalink to this definition"></a></dt>
+<dd></dd></dl>
+
+</dd></dl>
+
 </section>
 <section id="module-dice_ml.utils.serialize">
 <span id="dice-ml-utils-serialize-module"></span><h2>dice_ml.utils.serialize module<a class="headerlink" href="#module-dice_ml.utils.serialize" title="Permalink to this heading"></a></h2>
diff --git a/docs/dice_ml.utils.sample_architecture.html b/docs/dice_ml.utils.sample_architecture.html
index 06efef23..2cc31389 100644
--- a/docs/dice_ml.utils.sample_architecture.html
+++ b/docs/dice_ml.utils.sample_architecture.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml.utils.sample_architecture package &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml.utils.sample_architecture package &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/genindex.html b/docs/genindex.html
index a46f9e94..7fbe4f0d 100644
--- a/docs/genindex.html
+++ b/docs/genindex.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Index &mdash; DiCE 0.10 documentation</title>
+  <title>Index &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -98,6 +98,7 @@ <h1 id="index">Index</h1>
  | <a href="#N"><strong>N</strong></a>
  | <a href="#O"><strong>O</strong></a>
  | <a href="#P"><strong>P</strong></a>
+ | <a href="#Q"><strong>Q</strong></a>
  | <a href="#R"><strong>R</strong></a>
  | <a href="#S"><strong>S</strong></a>
  | <a href="#T"><strong>T</strong></a>
@@ -262,6 +263,10 @@ <h2 id="D">D</h2>
         <li><a href="dice_ml.html#dice_ml.model.Model.decide_implementation_type">(dice_ml.model.Model method)</a>
 </li>
       </ul></li>
+      <li><a href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_model_output">decode_model_output() (dice_ml.explainer_interfaces.explainer_base.ExplainerBase method)</a>
+</li>
+      <li><a href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_to_original_labels">decode_to_original_labels() (dice_ml.explainer_interfaces.explainer_base.ExplainerBase method)</a>
+</li>
       <li><a href="dice_ml.utils.sample_architecture.html#dice_ml.utils.sample_architecture.vae_model.AutoEncoder.decoder">decoder() (dice_ml.utils.sample_architecture.vae_model.AutoEncoder method)</a>
 
       <ul>
@@ -621,17 +626,19 @@ <h2 id="F">F</h2>
         <li><a href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.find_counterfactuals">(dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2 method)</a>
 </li>
       </ul></li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.fit_label_encoders">fit_label_encoders() (dice_ml.data_interfaces.private_data_interface.PrivateData method)</a>
 
       <ul>
         <li><a href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.public_data_interface.PublicData.fit_label_encoders">(dice_ml.data_interfaces.public_data_interface.PublicData method)</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="dice_ml.utils.html#dice_ml.utils.neuralnetworks.FFNetwork.forward">forward() (dice_ml.utils.neuralnetworks.FFNetwork method)</a>
 
       <ul>
+        <li><a href="dice_ml.utils.html#dice_ml.utils.neuralnetworks.MulticlassNetwork.forward">(dice_ml.utils.neuralnetworks.MulticlassNetwork method)</a>
+</li>
         <li><a href="dice_ml.utils.sample_architecture.html#dice_ml.utils.sample_architecture.vae_model.AutoEncoder.forward">(dice_ml.utils.sample_architecture.vae_model.AutoEncoder method)</a>
 </li>
         <li><a href="dice_ml.utils.sample_architecture.html#dice_ml.utils.sample_architecture.vae_model.CF_VAE.forward">(dice_ml.utils.sample_architecture.vae_model.CF_VAE method)</a>
@@ -878,11 +885,15 @@ <h2 id="L">L</h2>
       <li><a href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset">load_custom_testing_dataset() (in module dice_ml.utils.helpers)</a>
 </li>
       <li><a href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_binary">load_custom_testing_dataset_binary() (in module dice_ml.utils.helpers)</a>
+</li>
+      <li><a href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_binary_str">load_custom_testing_dataset_binary_str() (in module dice_ml.utils.helpers)</a>
 </li>
       <li><a href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass">load_custom_testing_dataset_multiclass() (in module dice_ml.utils.helpers)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_multiclass_str">load_custom_testing_dataset_multiclass_str() (in module dice_ml.utils.helpers)</a>
+</li>
       <li><a href="dice_ml.utils.html#dice_ml.utils.helpers.load_custom_testing_dataset_regression">load_custom_testing_dataset_regression() (in module dice_ml.utils.helpers)</a>
 </li>
       <li><a href="dice_ml.utils.html#dice_ml.utils.helpers.load_min_max_equal_dataset">load_min_max_equal_dataset() (in module dice_ml.utils.helpers)</a>
@@ -993,6 +1004,10 @@ <h2 id="M">M</h2>
 </li>
       </ul></li>
   </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="dice_ml.utils.html#dice_ml.utils.neuralnetworks.MulticlassNetwork">MulticlassNetwork (class in dice_ml.utils.neuralnetworks)</a>
+</li>
+  </ul></td>
 </tr></table>
 
 <h2 id="N">N</h2>
@@ -1061,7 +1076,11 @@ <h2 id="P">P</h2>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.predict_fn_scores">predict_fn_scores() (dice_ml.explainer_interfaces.dice_genetic.DiceGenetic method)</a>
+
+      <ul>
+        <li><a href="dice_ml.explainer_interfaces.html#dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn_scores">(dice_ml.explainer_interfaces.dice_KD.DiceKD method)</a>
 </li>
+      </ul></li>
       <li><a href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_df_for_ohe_encoding">prepare_df_for_ohe_encoding() (dice_ml.data_interfaces.private_data_interface.PrivateData method)</a>
 
       <ul>
@@ -1087,6 +1106,14 @@ <h2 id="P">P</h2>
   </ul></td>
 </tr></table>
 
+<h2 id="Q">Q</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="dice_ml.data_interfaces.html#dice_ml.data_interfaces.private_data_interface.PrivateData.query_instance_to_df">query_instance_to_df() (dice_ml.data_interfaces.private_data_interface.PrivateData method)</a>
+</li>
+  </ul></td>
+</tr></table>
+
 <h2 id="R">R</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
@@ -1201,10 +1228,6 @@ <h2 id="U">U</h2>
 </li>
       </ul></li>
   </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="dice_ml.utils.html#dice_ml.utils.exception.UserConfigValidationException">UserConfigValidationException</a>
-</li>
-  </ul></td>
 </tr></table>
 
 <h2 id="V">V</h2>
diff --git a/docs/index.html b/docs/index.html
index 9386acad..cb6e0a31 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Diverse Counterfactual Explanations (DiCE) for ML &mdash; DiCE 0.10 documentation</title>
+  <title>Diverse Counterfactual Explanations (DiCE) for ML &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -106,7 +106,8 @@
     text-align: unset;
 }
 </style>
-<p><a class="reference external" href="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml?query=workflow%3A%22Python+package%22"><img alt="BuildStatus" src="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml/badge.svg?branch=main" /></a> <a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PyPiVersion" src="https://img.shields.io/pypi/v/dice-ml" /></a> <a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PythonSupport" src="https://img.shields.io/pypi/pyversions/dice-ml" /></a> <a class="reference external" href="https://pepy.tech/project/dice-ml"><img alt="Downloads" src="https://static.pepy.tech/personalized-badge/dice-ml?period=total&amp;units=international_system&amp;left_color=grey&amp;right_color=orange&amp;left_text=Downloads" /></a> <a class="reference external" href="https://anaconda.org/conda-forge/dice-ml"><img alt="CondaVersion" src="https://anaconda.org/conda-forge/dice-ml/badges/version.svg" /></a></p>
+<p><a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PyPiVersion" src="https://img.shields.io/pypi/v/dice-ml" /></a> <a class="reference external" href="https://anaconda.org/conda-forge/dice-ml"><img alt="CondaVersion" src="https://anaconda.org/conda-forge/dice-ml/badges/version.svg" /></a> <img alt="MITlicense" src="https://img.shields.io/badge/License-MIT-blue.svg" /> <a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PythonSupport" src="https://img.shields.io/pypi/pyversions/dice-ml" /></a> <a class="reference external" href="https://pepy.tech/project/dice-ml"><img alt="Downloads" src="https://static.pepy.tech/personalized-badge/dice-ml?period=total&amp;units=international_system&amp;left_color=grey&amp;right_color=orange&amp;left_text=Downloads" /></a></p>
+<p><a class="reference external" href="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml?query=workflow%3A%22Python+package%22"><img alt="BuildStatusTests" src="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml/badge.svg?branch=main" /></a> <a class="reference external" href="https://github.com/interpretml/DiCE/actions/workflows/notebook-tests.yml?query=workflow%3A%22Notebook+tests%22"><img alt="BuildStatusNotebooks" src="https://github.com/interpretml/DiCE/actions/workflows/notebook-tests.yml/badge.svg?branch=main" /></a></p>
 <section id="diverse-counterfactual-explanations-dice-for-ml">
 <h1>Diverse Counterfactual Explanations (DiCE) for ML<a class="headerlink" href="#diverse-counterfactual-explanations-dice-for-ml" title="Permalink to this heading"></a></h1>
 <p><em>How to explain a machine learning model such that the explanation is truthful to the model and yet interpretable to people?</em></p>
@@ -120,7 +121,7 @@ <h1>Diverse Counterfactual Explanations (DiCE) for ML<a class="headerlink" href=
 <p>Explanations are critical for machine learning, especially as machine learning-based systems are being used to inform decisions in societally critical domains such as finance, healthcare, education, and criminal justice.
 However, most explanation methods depend on an approximation of the ML model to
 create an interpretable explanation. For example,
-consider a person who applied for a loan and was rejected by the loan distribution algorithm of a financial company. Typically, the company may provide an explanation on why the loan was rejected, for example, due to “poor credit history”. However, such an explanation does not help the person decide <em>what they do should next</em> to improve their chances of being approved in the future. Critically, the most important feature may not be enough to flip the decision of the algorithm, and in practice, may not even be changeable such as gender and race.</p>
+consider a person who applied for a loan and was rejected by the loan distribution algorithm of a financial company. Typically, the company may provide an explanation on why the loan was rejected, for example, due to “poor credit history”. However, such an explanation does not help the person decide <em>what they should do next</em> to improve their chances of being approved in the future. Critically, the most important feature may not be enough to flip the decision of the algorithm, and in practice, may not even be changeable such as gender and race.</p>
 <p>DiCE implements <a class="reference external" href="https://arxiv.org/abs/1711.00399">counterfactual (CF) explanations</a>  that provide this information by showing feature-perturbed versions of the same person who would have received the loan, e.g., <code class="docutils literal notranslate"><span class="pre">you</span> <span class="pre">would</span> <span class="pre">have</span> <span class="pre">received</span> <span class="pre">the</span> <span class="pre">loan</span> <span class="pre">if</span> <span class="pre">your</span> <span class="pre">income</span> <span class="pre">was</span> <span class="pre">higher</span> <span class="pre">by</span> <span class="pre">$10,000</span></code>. In other words, it provides “what-if” explanations for model output and can be a useful complement to other explanation methods, both for end-users and model developers.</p>
 <p>Barring simple linear models, however, it is difficult to generate CF examples that work for any machine learning model. DiCE is based on <a class="reference external" href="https://arxiv.org/abs/1905.07697">recent research</a> that generates CF explanations for any ML model. The core idea is to setup finding such explanations as an optimization problem, similar to finding adversarial examples. The critical difference is that for explanations, we need perturbations that change the output of a machine learning model, but are also diverse and feasible to change. Therefore, DiCE supports generating a set of counterfactual explanations  and has tunable parameters for diversity and proximity of the explanations to the original input. It also supports simple constraints on features to ensure feasibility of the generated counterfactual examples.</p>
 <section id="installing-dice">
diff --git a/docs/modules.html b/docs/modules.html
index 4cb5aacb..7602c80e 100644
--- a/docs/modules.html
+++ b/docs/modules.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dice_ml &mdash; DiCE 0.10 documentation</title>
+  <title>dice_ml &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/notebooks/Benchmarking_different_CF_explanation_methods.html b/docs/notebooks/Benchmarking_different_CF_explanation_methods.html
index 51cf34e4..a73cec8c 100644
--- a/docs/notebooks/Benchmarking_different_CF_explanation_methods.html
+++ b/docs/notebooks/Benchmarking_different_CF_explanation_methods.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Benchmarking different CF explanation methods &mdash; DiCE 0.10 documentation</title>
+  <title>Benchmarking different CF explanation methods &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -364,7 +364,7 @@
 <section id="Benchmarking-different-CF-explanation-methods">
 <h1>Benchmarking different CF explanation methods<a class="headerlink" href="#Benchmarking-different-CF-explanation-methods" title="Permalink to this heading"></a></h1>
 <p>In this notebook, we show runtimes of different model-agnostic explanation methods. Currently, we support three model-agnostic explanation methods: 1. Random-Sampling 2. Genetic Algorithm 3. Querying a KD tree</p>
-<div class="nbinput docutils container">
+<div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>
 </div>
@@ -384,15 +384,6 @@ <h1>Benchmarking different CF explanation methods<a class="headerlink" href="#Be
 </pre></div>
 </div>
 </div>
-<div class="nboutput nblast docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
-/mnt/c/Users/amshar/code/dice/dice_ml/utils/exception.py:12: UserWarning: UserConfigValidationException will be deprecated from dice_ml.utils. Please import UserConfigValidationException from raiutils.exceptions.
-  warnings.warn(&#34;UserConfigValidationException will be deprecated from dice_ml.utils. &#34;
-</pre></div></div>
-</div>
 <div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
 </pre></div>
@@ -757,36 +748,36 @@ <h2>Generate Counterfactuals<a class="headerlink" href="#Generate-Counterfactual
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-/tmp/ipykernel_2173/3514951616.py:11: SettingWithCopyWarning:
+/tmp/ipykernel_169/3514951616.py:11: SettingWithCopyWarning:
 A value is trying to be set on a copy of a slice from a DataFrame.
 Try using .loc[row_indexer,col_indexer] = value instead
 
 See the caveats in the documentation: https://pandas.pydata.org/pandas-docs/stable/user_guide/indexing.html#returning-a-view-versus-a-copy
   query_instances.loc[:, q] = \
-/tmp/ipykernel_2173/3514951616.py:8: SettingWithCopyWarning:
+/tmp/ipykernel_169/3514951616.py:8: SettingWithCopyWarning:
 A value is trying to be set on a copy of a slice from a DataFrame.
 Try using .loc[row_indexer,col_indexer] = value instead
 
 See the caveats in the documentation: https://pandas.pydata.org/pandas-docs/stable/user_guide/indexing.html#returning-a-view-versus-a-copy
   query_instances.loc[:, q] = \
-100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:01&lt;00:00,  1.92it/s]
-100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:02&lt;00:00,  1.17it/s]
-100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:02&lt;00:00,  1.34it/s]
-/tmp/ipykernel_2173/3514951616.py:11: SettingWithCopyWarning:
+100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:01&lt;00:00,  2.58it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:03&lt;00:00,  1.13s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:03&lt;00:00,  1.05s/it]
+/tmp/ipykernel_169/3514951616.py:11: SettingWithCopyWarning:
 A value is trying to be set on a copy of a slice from a DataFrame.
 Try using .loc[row_indexer,col_indexer] = value instead
 
 See the caveats in the documentation: https://pandas.pydata.org/pandas-docs/stable/user_guide/indexing.html#returning-a-view-versus-a-copy
   query_instances.loc[:, q] = \
-/tmp/ipykernel_2173/3514951616.py:8: SettingWithCopyWarning:
+/tmp/ipykernel_169/3514951616.py:8: SettingWithCopyWarning:
 A value is trying to be set on a copy of a slice from a DataFrame.
 Try using .loc[row_indexer,col_indexer] = value instead
 
 See the caveats in the documentation: https://pandas.pydata.org/pandas-docs/stable/user_guide/indexing.html#returning-a-view-versus-a-copy
   query_instances.loc[:, q] = \
-100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:01&lt;00:00,  2.91it/s]
-100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:02&lt;00:00,  1.12it/s]
-100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:02&lt;00:00,  1.04it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:01&lt;00:00,  2.55it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:03&lt;00:00,  1.06s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 3/3 [00:02&lt;00:00,  1.11it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -796,7 +787,7 @@ <h2>Generate Counterfactuals<a class="headerlink" href="#Generate-Counterfactual
 <div class="highlight"><pre>
 For Independent random sampling of features: Total time taken to generate 2 sets of 2 counterfactuals each: 00 min 02 sec
 For querying from a KD tree: Total time taken to generate 2 sets of 2 counterfactuals each: 00 min 05 sec
-For genetic algorithm: Total time taken to generate 2 sets of 2 counterfactuals each: 00 min 05 sec
+For genetic algorithm: Total time taken to generate 2 sets of 2 counterfactuals each: 00 min 06 sec
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
diff --git a/docs/notebooks/DiCE_feature_importances.html b/docs/notebooks/DiCE_feature_importances.html
index 62e36cdf..04340ac3 100644
--- a/docs/notebooks/DiCE_feature_importances.html
+++ b/docs/notebooks/DiCE_feature_importances.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Estimating local and global feature importance scores using DiCE &mdash; DiCE 0.10 documentation</title>
+  <title>Estimating local and global feature importance scores using DiCE &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -376,7 +376,7 @@ <h1>Estimating local and global feature importance scores using DiCE<a class="he
 <p>Summaries of counterfactual examples can be used to estimate importance of features. Intuitively, a feature that is changed more often to generate a proximal counterfactual is an important feature. We use this intuition to build a feature importance score.</p>
 <p>This score can be interpreted as a measure of the <strong>necessity</strong> of a feature to cause a particular model output. That is, if the feature’s value changes, then it is likely that the model’s output class will also change (or the model’s output will significantly change in case of regression model).</p>
 <p>Below we show how counterfactuals can be used to provide local feature importance scores for any input, and how those scores can be combined to yield a global importance score for each feature.</p>
-<div class="nbinput docutils container">
+<div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>
 </div>
@@ -392,15 +392,6 @@ <h1>Estimating local and global feature importance scores using DiCE<a class="he
 </pre></div>
 </div>
 </div>
-<div class="nboutput nblast docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
-/mnt/c/Users/amshar/code/dice/dice_ml/utils/exception.py:12: UserWarning: UserConfigValidationException will be deprecated from dice_ml.utils. Please import UserConfigValidationException from raiutils.exceptions.
-  warnings.warn(&#34;UserConfigValidationException will be deprecated from dice_ml.utils. &#34;
-</pre></div></div>
-</div>
 <div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
 </pre></div>
@@ -506,7 +497,7 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  1.86it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  2.10it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -514,7 +505,7 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 0)
+Query instance (original outcome : 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -561,15 +552,15 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
   <tbody>
     <tr>
       <th>0</th>
-      <td>32</td>
-      <td>Other/Unknown</td>
+      <td>37</td>
+      <td>Private</td>
       <td>Some-college</td>
-      <td>Divorced</td>
-      <td>Other/Unknown</td>
+      <td>Married</td>
+      <td>Sales</td>
       <td>White</td>
       <td>Male</td>
-      <td>40</td>
-      <td>0</td>
+      <td>44</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -581,7 +572,7 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 0)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -620,123 +611,123 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
   <tbody>
     <tr>
       <th>0</th>
-      <td>69.0</td>
+      <td>30</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
+      <td>Separated</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>1</th>
       <td>-</td>
       <td>-</td>
       <td>Doctorate</td>
-      <td>Married</td>
+      <td>Single</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>56.0</td>
+      <td>77</td>
       <td>-</td>
+      <td>Assoc</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>49.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
+      <td>School</td>
+      <td>Divorced</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>4</th>
-      <td>53.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
+      <td>-</td>
+      <td>Divorced</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>5</th>
-      <td>48.0</td>
+      <td>24</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>6</th>
       <td>-</td>
       <td>-</td>
-      <td>Bachelors</td>
       <td>-</td>
-      <td>Sales</td>
       <td>-</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
-      <td>1</td>
+      <td>4</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>83.0</td>
       <td>-</td>
+      <td>Self-Employed</td>
+      <td>School</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>8</th>
       <td>-</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
-      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>Female</td>
+      <td>4</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>9</th>
       <td>-</td>
-      <td>Private</td>
       <td>-</td>
       <td>-</td>
-      <td>Blue-Collar</td>
       <td>-</td>
+      <td>Service</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>65</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -757,7 +748,7 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-[{&#39;marital_status&#39;: 0.7, &#39;age&#39;: 0.6, &#39;education&#39;: 0.3, &#39;occupation&#39;: 0.3, &#39;workclass&#39;: 0.1, &#39;race&#39;: 0.0, &#39;gender&#39;: 0.0, &#39;hours_per_week&#39;: 0.0}]
+[{&#39;education&#39;: 0.4, &#39;marital_status&#39;: 0.4, &#39;age&#39;: 0.3, &#39;hours_per_week&#39;: 0.3, &#39;workclass&#39;: 0.1, &#39;occupation&#39;: 0.1, &#39;race&#39;: 0.1, &#39;gender&#39;: 0.1}]
 </pre></div></div>
 </div>
 <p>Feature importance can also be estimated directly, by leaving the <code class="docutils literal notranslate"><span class="pre">cf_examples_list</span></code> argument blank.</p>
@@ -775,7 +766,7 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  2.70it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  3.60it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -783,7 +774,7 @@ <h2>Local feature importance<a class="headerlink" href="#Local-feature-importanc
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-[{&#39;education&#39;: 0.5, &#39;marital_status&#39;: 0.5, &#39;age&#39;: 0.5, &#39;occupation&#39;: 0.4, &#39;hours_per_week&#39;: 0.3, &#39;workclass&#39;: 0.1, &#39;race&#39;: 0.0, &#39;gender&#39;: 0.0}]
+[{&#39;age&#39;: 0.5, &#39;hours_per_week&#39;: 0.5, &#39;education&#39;: 0.3, &#39;marital_status&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;occupation&#39;: 0.1, &#39;race&#39;: 0.1, &#39;gender&#39;: 0.1}]
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -812,7 +803,7 @@ <h2>Global importance<a class="headerlink" href="#Global-importance" title="Perm
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|███████████████████████████████████████████████████████████████████████████████████| 10/10 [00:02&lt;00:00,  3.55it/s]
+100%|███████████████████████████████████████████████████████████████████████████████████| 10/10 [00:03&lt;00:00,  3.01it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -820,7 +811,7 @@ <h2>Global importance<a class="headerlink" href="#Global-importance" title="Perm
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-{&#39;age&#39;: 0.65, &#39;marital_status&#39;: 0.48, &#39;education&#39;: 0.36, &#39;occupation&#39;: 0.26, &#39;hours_per_week&#39;: 0.24, &#39;workclass&#39;: 0.08, &#39;race&#39;: 0.06, &#39;gender&#39;: 0.04}
+{&#39;age&#39;: 0.53, &#39;marital_status&#39;: 0.46, &#39;hours_per_week&#39;: 0.45, &#39;occupation&#39;: 0.21, &#39;gender&#39;: 0.15, &#39;education&#39;: 0.13, &#39;workclass&#39;: 0.11, &#39;race&#39;: 0.07}
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -848,7 +839,7 @@ <h2>Convert the counterfactual output to json<a class="headerlink" href="#Conver
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-{&#34;test_data&#34;: [[[39, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 1]], [[32, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Divorced&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 0]], [[32, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0]], [[46, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 35, 1]], [[20, &#34;Other/Unknown&#34;, &#34;HS-grad&#34;, &#34;Single&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 0]], [[29, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 1]], [[39, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 1]], [[31, &#34;Private&#34;, &#34;School&#34;, &#34;Single&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 25, 0]], [[45, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 1]], [[28, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 20, 0]]], &#34;cfs_list&#34;: [[[39, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Widowed&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 54.0, 0], [26.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0], [52.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0], [90.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0], [25.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0], [39, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Widowed&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0], [34.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Separated&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0], [30.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Separated&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0], [78.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 50, 0], [78.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 0]], [[81.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [40.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [41.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [32, &#34;Other/Unknown&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [32, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Divorced&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [85.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [32, &#34;Other/Unknown&#34;, &#34;Prof-school&#34;, &#34;Divorced&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 52.0, 0], [56.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [57.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [44.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1]], [[55.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 95.0, 1], [32, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 1], [32, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Female&#34;, 50, 1], [84.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 1], [32, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 68.0, 1], [80.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 1], [55.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 1], [81.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 1], [87.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;Other&#34;, &#34;Male&#34;, 50, 1], [32, &#34;Private&#34;, &#34;Prof-school&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 50, 1]], [[46, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 35, 0], [46, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 27.0, 0], [19.0, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 35, 0], [46, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 35, 0], [46, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 4.0, 0], [46, &#34;Private&#34;, &#34;Masters&#34;, &#34;Widowed&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 35, 0], [46, &#34;Other/Unknown&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 64.0, 0], [24.0, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 47.0, 0], [46, &#34;Private&#34;, &#34;Masters&#34;, &#34;Widowed&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 35, 0], [46, &#34;Private&#34;, &#34;School&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;Other&#34;, &#34;Male&#34;, 35, 0]], [[65.0, &#34;Private&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [59.0, &#34;Other/Unknown&#34;, &#34;Prof-school&#34;, &#34;Separated&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 52.0, 1], [42.0, &#34;Self-Employed&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [55.0, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [47.0, &#34;Other/Unknown&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [58.0, &#34;Other/Unknown&#34;, &#34;Doctorate&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [67.0, &#34;Self-Employed&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [49.0, &#34;Other/Unknown&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [42.0, &#34;Other/Unknown&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1], [63.0, &#34;Government&#34;, &#34;Prof-school&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 32, 1]], [[29, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 0], [28.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 67.0, 0], [29, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Divorced&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 0], [85.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 0], [49.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Separated&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 0], [29, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 13.0, 0], [29, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Widowed&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 39.0, 0], [29, &#34;Private&#34;, &#34;Doctorate&#34;, &#34;Divorced&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 0], [29, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 18.0, 0], [28.0, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 0]], [[39, &#34;Government&#34;, &#34;Masters&#34;, &#34;Divorced&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [39, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [66.0, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Widowed&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [39, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Separated&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 38.0, 0], [27.0, &#34;Self-Employed&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [41.0, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Widowed&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [39, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Divorced&#34;, &#34;Professional&#34;, &#34;Other&#34;, &#34;Female&#34;, 40, 0], [39, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Divorced&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [20.0, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [39, &#34;Self-Employed&#34;, &#34;Masters&#34;, &#34;Widowed&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0]], [[31, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 98.0, 1], [89.0, &#34;Private&#34;, &#34;School&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 61.0, 1], [78.0, &#34;Private&#34;, &#34;School&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 69.0, 1], [65.0, &#34;Private&#34;, &#34;Doctorate&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 16.0, 1], [78.0, &#34;Private&#34;, &#34;School&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 85.0, 1], [39.0, &#34;Private&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;Other&#34;, &#34;Male&#34;, 25, 1], [62.0, &#34;Private&#34;, &#34;School&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 61.0, 1], [31, &#34;Private&#34;, &#34;Doctorate&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 25, 1], [46.0, &#34;Private&#34;, &#34;Prof-school&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 25, 1], [65.0, &#34;Private&#34;, &#34;Doctorate&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 25, 1]], [[45, &#34;Private&#34;, &#34;Masters&#34;, &#34;Separated&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 0], [35.0, &#34;Private&#34;, &#34;Masters&#34;, &#34;Separated&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 0], [62.0, &#34;Private&#34;, &#34;School&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 0], [17.0, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;Other&#34;, &#34;Male&#34;, 43, 0], [45, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Separated&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 0], [28.0, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 0], [25.0, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 0], [49.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 43, 0], [45, &#34;Private&#34;, &#34;School&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 9.0, 0], [45, &#34;Private&#34;, &#34;Masters&#34;, &#34;Separated&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 4.0, 0]], [[42.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 20, 1], [53.0, &#34;Other/Unknown&#34;, &#34;Doctorate&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 20, 0], [34.0, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 60.0, 1], [67.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 20, 1], [87.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 20, 1], [46.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 20, 1], [72.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 20, 1], [42.0, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 93.0, 1], [42.0, &#34;Private&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 20, 1], [55.0, &#34;Private&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 20, 1]]], &#34;local_importance&#34;: [[0.8, 0.0, 0.0, 0.4, 0.5, 0.1, 0.0, 0.1], [0.7, 0.1, 0.2, 0.8, 0.1, 0.0, 0.0, 0.1], [0.6, 0.0, 0.3, 0.0, 0.3, 0.1, 0.1, 0.2], [0.2, 0.1, 0.3, 0.3, 0.5, 0.1, 0.1, 0.4], [1.0, 0.4, 1.0, 0.4, 0.4, 0.0, 0.0, 0.1], [0.4, 0.0, 0.3, 0.4, 0.1, 0.0, 0.0, 0.4], [0.4, 0.1, 0.1, 0.7, 0.2, 0.1, 0.0, 0.1], [0.8, 0.0, 0.6, 0.7, 0.4, 0.1, 0.0, 0.6], [0.6, 0.0, 0.4, 0.5, 0.1, 0.1, 0.0, 0.2], [1.0, 0.1, 0.4, 0.6, 0.0, 0.0, 0.2, 0.2]], &#34;summary_importance&#34;: [0.65, 0.08, 0.36, 0.48, 0.26, 0.06, 0.04, 0.24], &#34;data_interface&#34;: {&#34;outcome_name&#34;: &#34;income&#34;, &#34;data_df&#34;: &#34;dummy_data&#34;}, &#34;feature_names&#34;: [&#34;age&#34;, &#34;workclass&#34;, &#34;education&#34;, &#34;marital_status&#34;, &#34;occupation&#34;, &#34;race&#34;, &#34;gender&#34;, &#34;hours_per_week&#34;], &#34;feature_names_including_target&#34;: [&#34;age&#34;, &#34;workclass&#34;, &#34;education&#34;, &#34;marital_status&#34;, &#34;occupation&#34;, &#34;race&#34;, &#34;gender&#34;, &#34;hours_per_week&#34;, &#34;income&#34;], &#34;model_type&#34;: &#34;classifier&#34;, &#34;desired_class&#34;: &#34;opposite&#34;, &#34;desired_range&#34;: null, &#34;metadata&#34;: {&#34;version&#34;: &#34;2.0&#34;}}
+{&#34;test_data&#34;: [[[48, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Divorced&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 60, 0]], [[37, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 44, 1]], [[36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 35, 1]], [[30, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Single&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 0]], [[32, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 1]], [[17, &#34;Private&#34;, &#34;School&#34;, &#34;Single&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 20, 0]], [[28, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 45, 1]], [[41, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 1]], [[23, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 0]], [[26, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 48, 0]]], &#34;cfs_list&#34;: [[[48, &#34;Government&#34;, &#34;Prof-school&#34;, &#34;Divorced&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 60, 1], [48, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 41, 1], [65, &#34;Government&#34;, &#34;Doctorate&#34;, &#34;Divorced&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 60, 1], [48, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 91, 1], [48, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 32, 1], [48, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 60, 1], [48, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 46, 1], [48, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 30, 1], [48, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 80, 1], [41, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 60, 1]], [[37, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Widowed&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 81, 0], [37, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Divorced&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 44, 0], [37, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 17, 0], [37, &#34;Self-Employed&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 98, 0], [83, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;Other&#34;, &#34;Male&#34;, 44, 0], [47, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 22, 0], [37, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 7, 0], [59, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 89, 0], [37, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Single&#34;, &#34;Sales&#34;, &#34;Other&#34;, &#34;Male&#34;, 44, 0], [32, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 44, 0]], [[63, &#34;Government&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 35, 0], [73, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Separated&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 35, 0], [36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 7, 0], [36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Divorced&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 5, 0], [36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Separated&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 24, 0], [36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;Other&#34;, &#34;Female&#34;, 83, 0], [36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Widowed&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 89, 0], [36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 47, 0], [36, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Single&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Female&#34;, 35, 0], [54, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 61, 0]], [[77, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 59, 1], [67, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 1], [30, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 83, 1], [30, &#34;Self-Employed&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 47, 1], [30, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [34, &#34;Private&#34;, &#34;Prof-school&#34;, &#34;Single&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [64, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [30, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 1], [30, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 94, 1], [68, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 89, 1]], [[43, &#34;Other/Unknown&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [32, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Divorced&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 21, 0], [32, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [32, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;Other&#34;, &#34;Female&#34;, 40, 0], [76, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [32, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 16, 0], [68, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;Other&#34;, &#34;Female&#34;, 40, 0], [32, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 75, 0], [49, &#34;Self-Employed&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0], [68, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 0]], [[39, &#34;Private&#34;, &#34;School&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 99, 1], [49, &#34;Private&#34;, &#34;School&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 59, 1], [42, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 76, 1], [81, &#34;Private&#34;, &#34;Doctorate&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 20, 1], [49, &#34;Private&#34;, &#34;Doctorate&#34;, &#34;Single&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 92, 1], [66, &#34;Other/Unknown&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 20, 1], [52, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 20, 1], [81, &#34;Private&#34;, &#34;Doctorate&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 38, 1], [55, &#34;Private&#34;, &#34;School&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 64, 0], [49, &#34;Self-Employed&#34;, &#34;Doctorate&#34;, &#34;Single&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 92, 1]], [[28, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Single&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Female&#34;, 45, 0], [28, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Other/Unknown&#34;, &#34;White&#34;, &#34;Male&#34;, 14, 0], [27, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 79, 0], [28, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;Other&#34;, &#34;Male&#34;, 45, 0], [28, &#34;Private&#34;, &#34;Assoc&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 45, 0], [28, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Separated&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 45, 0], [28, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Separated&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 77, 0], [46, &#34;Private&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Female&#34;, 45, 0], [28, &#34;Other/Unknown&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 45, 0], [28, &#34;Private&#34;, &#34;HS-grad&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 22, 0]], [[41, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 65, 0], [72, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 0], [41, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Separated&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 25, 0], [28, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Blue-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 0], [26, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 0], [41, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 5, 0], [81, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Divorced&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 0], [30, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Married&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 0], [41, &#34;Government&#34;, &#34;Some-college&#34;, &#34;Divorced&#34;, &#34;Sales&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 0], [41, &#34;Private&#34;, &#34;Some-college&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 65, 0]], [[23, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;Other&#34;, &#34;Male&#34;, 40, 1], [55, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [37, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [82, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 1], [88, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 1], [23, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Service&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [75, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Single&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Female&#34;, 40, 1], [73, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1], [23, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 44, 1], [88, &#34;Government&#34;, &#34;Bachelors&#34;, &#34;Married&#34;, &#34;Professional&#34;, &#34;White&#34;, &#34;Male&#34;, 40, 1]], [[76, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 71, 1], [35, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 81, 1], [42, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 48, 1], [51, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 68, 1], [58, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 48, 1], [34, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 48, 1], [88, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 48, 1], [48, &#34;Private&#34;, &#34;Masters&#34;, &#34;Married&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 48, 1], [52, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Male&#34;, 48, 1], [79, &#34;Private&#34;, &#34;Masters&#34;, &#34;Single&#34;, &#34;White-Collar&#34;, &#34;White&#34;, &#34;Female&#34;, 60, 1]]], &#34;local_importance&#34;: [[0.2, 0.1, 0.2, 0.8, 0.0, 0.0, 0.1, 0.6], [0.4, 0.2, 0.0, 0.3, 0.1, 0.2, 0.0, 0.6], [0.3, 0.1, 0.0, 0.5, 0.1, 0.1, 0.1, 0.7], [0.5, 0.1, 0.2, 0.7, 0.5, 0.0, 0.2, 0.5], [0.5, 0.2, 0.0, 0.4, 0.1, 0.2, 0.0, 0.3], [1.0, 0.2, 0.7, 0.4, 0.3, 0.0, 0.0, 0.7], [0.2, 0.1, 0.2, 0.3, 0.4, 0.1, 0.2, 0.4], [0.5, 0.1, 0.0, 0.4, 0.5, 0.0, 0.1, 0.2], [0.7, 0.0, 0.0, 0.7, 0.1, 0.1, 0.3, 0.1], [1.0, 0.0, 0.0, 0.1, 0.0, 0.0, 0.5, 0.4]], &#34;summary_importance&#34;: [0.53, 0.11, 0.13, 0.46, 0.21, 0.07, 0.15, 0.45], &#34;data_interface&#34;: {&#34;outcome_name&#34;: &#34;income&#34;, &#34;data_df&#34;: &#34;dummy_data&#34;}, &#34;feature_names&#34;: [&#34;age&#34;, &#34;workclass&#34;, &#34;education&#34;, &#34;marital_status&#34;, &#34;occupation&#34;, &#34;race&#34;, &#34;gender&#34;, &#34;hours_per_week&#34;], &#34;feature_names_including_target&#34;: [&#34;age&#34;, &#34;workclass&#34;, &#34;education&#34;, &#34;marital_status&#34;, &#34;occupation&#34;, &#34;race&#34;, &#34;gender&#34;, &#34;hours_per_week&#34;, &#34;income&#34;], &#34;model_type&#34;: &#34;classifier&#34;, &#34;desired_class&#34;: 1, &#34;desired_range&#34;: null, &#34;metadata&#34;: {&#34;version&#34;: &#34;2.0&#34;}}
 </pre></div></div>
 </div>
 </section>
@@ -870,7 +861,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 1)
+Query instance (original outcome : 0)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -909,15 +900,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>39</td>
-      <td>Private</td>
-      <td>HS-grad</td>
-      <td>Married</td>
-      <td>Blue-Collar</td>
+      <td>48</td>
+      <td>Government</td>
+      <td>Bachelors</td>
+      <td>Divorced</td>
+      <td>Professional</td>
       <td>White</td>
-      <td>Male</td>
-      <td>50</td>
-      <td>1</td>
+      <td>Female</td>
+      <td>60</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -929,7 +920,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 0.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -970,121 +961,121 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
       <th>0</th>
       <td>-</td>
       <td>-</td>
+      <td>Prof-school</td>
       <td>-</td>
-      <td>Widowed</td>
       <td>-</td>
       <td>-</td>
+      <td>Male</td>
       <td>-</td>
-      <td>54.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>26.0</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>White-Collar</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>41</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>52.0</td>
-      <td>-</td>
+      <td>65</td>
       <td>-</td>
+      <td>Doctorate</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>90.0</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Sales</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>91</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>4</th>
-      <td>25.0</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Other/Unknown</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>32</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>5</th>
       <td>-</td>
+      <td>Private</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
-      <td>Widowed</td>
-      <td>Sales</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>6</th>
-      <td>34.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Separated</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>46</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>30.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Separated</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>30</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>8</th>
-      <td>78.0</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
-      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>80</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>9</th>
-      <td>78.0</td>
+      <td>41</td>
       <td>-</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
-      <td>Service</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -1095,7 +1086,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 0)
+Query instance (original outcome : 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1134,15 +1125,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>32</td>
-      <td>Other/Unknown</td>
+      <td>37</td>
+      <td>Private</td>
       <td>Some-college</td>
-      <td>Divorced</td>
-      <td>Other/Unknown</td>
+      <td>Married</td>
+      <td>Sales</td>
       <td>White</td>
       <td>Male</td>
-      <td>40</td>
-      <td>0</td>
+      <td>44</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -1154,7 +1145,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 1.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1193,123 +1184,123 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>81.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
+      <td>Widowed</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>81</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>40.0</td>
       <td>-</td>
+      <td>Other/Unknown</td>
       <td>-</td>
-      <td>Married</td>
+      <td>Divorced</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>41.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>17</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>3</th>
       <td>-</td>
+      <td>Self-Employed</td>
       <td>-</td>
-      <td>HS-grad</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>98</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>4</th>
+      <td>83</td>
       <td>-</td>
-      <td>Private</td>
       <td>-</td>
       <td>-</td>
-      <td>Blue-Collar</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>5</th>
-      <td>85.0</td>
+      <td>47</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>22</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>6</th>
       <td>-</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>52.0</td>
       <td>-</td>
+      <td>7</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>56.0</td>
+      <td>59</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>89</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>8</th>
-      <td>57.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
+      <td>Single</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>9</th>
-      <td>44.0</td>
+      <td>32</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
+      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -1320,7 +1311,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 0)
+Query instance (original outcome : 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1359,15 +1350,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>32</td>
+      <td>36</td>
       <td>Private</td>
       <td>Some-college</td>
       <td>Married</td>
-      <td>Service</td>
+      <td>White-Collar</td>
       <td>White</td>
-      <td>Male</td>
-      <td>50</td>
-      <td>0</td>
+      <td>Female</td>
+      <td>35</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -1379,7 +1370,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 1.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1418,123 +1409,123 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>55.0</td>
+      <td>63</td>
+      <td>Government</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>95.0</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>1</th>
+      <td>73</td>
       <td>-</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Separated</td>
       <td>-</td>
-      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>2</th>
       <td>-</td>
       <td>-</td>
-      <td>Masters</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Female</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>7</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>84.0</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Divorced</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>5</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>4</th>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Separated</td>
       <td>-</td>
-      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>68.0</td>
-      <td>1</td>
+      <td>24</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>5</th>
-      <td>80.0</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
-      <td>1</td>
+      <td>83</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>6</th>
-      <td>55.0</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Widowed</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>89</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>81.0</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>Male</td>
+      <td>47</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>8</th>
-      <td>87.0</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Single</td>
+      <td>Service</td>
       <td>-</td>
-      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>9</th>
+      <td>54</td>
       <td>-</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
-      <td>Sales</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>61</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -1545,7 +1536,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 1)
+Query instance (original outcome : 0)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1584,15 +1575,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>46</td>
+      <td>30</td>
       <td>Private</td>
-      <td>Masters</td>
-      <td>Married</td>
-      <td>Professional</td>
+      <td>HS-grad</td>
+      <td>Single</td>
+      <td>Blue-Collar</td>
       <td>White</td>
       <td>Male</td>
-      <td>35</td>
-      <td>1</td>
+      <td>40</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -1604,7 +1595,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 0.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1643,123 +1634,123 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
+      <td>77</td>
       <td>-</td>
       <td>-</td>
-      <td>Bachelors</td>
-      <td>-</td>
-      <td>Other/Unknown</td>
       <td>-</td>
+      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>59</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>1</th>
+      <td>67</td>
       <td>-</td>
       <td>-</td>
-      <td>-</td>
-      <td>Single</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
-      <td>27.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>19.0</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Other/Unknown</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>83</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>3</th>
       <td>-</td>
+      <td>Self-Employed</td>
       <td>-</td>
-      <td>Some-college</td>
-      <td>-</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
-      <td>Female</td>
       <td>-</td>
-      <td>0</td>
+      <td>47</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>4</th>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Married</td>
+      <td>White-Collar</td>
       <td>-</td>
-      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
-      <td>4.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>5</th>
+      <td>34</td>
       <td>-</td>
+      <td>Prof-school</td>
       <td>-</td>
-      <td>-</td>
-      <td>Widowed</td>
-      <td>Blue-Collar</td>
+      <td>Sales</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>6</th>
-      <td>-</td>
-      <td>Other/Unknown</td>
+      <td>64</td>
       <td>-</td>
       <td>-</td>
+      <td>Married</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>64.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>24.0</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Assoc</td>
       <td>-</td>
+      <td>Professional</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
-      <td>47.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>8</th>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Widowed</td>
-      <td>Service</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>94</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>9</th>
+      <td>68</td>
       <td>-</td>
       <td>-</td>
-      <td>School</td>
-      <td>-</td>
+      <td>Married</td>
       <td>-</td>
-      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>89</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -1770,7 +1761,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 0)
+Query instance (original outcome : 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1809,15 +1800,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>20</td>
-      <td>Other/Unknown</td>
-      <td>HS-grad</td>
-      <td>Single</td>
-      <td>Other/Unknown</td>
-      <td>White</td>
-      <td>Male</td>
       <td>32</td>
-      <td>0</td>
+      <td>Private</td>
+      <td>Assoc</td>
+      <td>Married</td>
+      <td>White-Collar</td>
+      <td>White</td>
+      <td>Female</td>
+      <td>40</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -1829,7 +1820,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 1.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1868,123 +1859,123 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>65.0</td>
-      <td>Private</td>
-      <td>Prof-school</td>
+      <td>43</td>
+      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>59.0</td>
       <td>-</td>
-      <td>Prof-school</td>
-      <td>Separated</td>
       <td>-</td>
       <td>-</td>
+      <td>Divorced</td>
       <td>-</td>
-      <td>52.0</td>
-      <td>1</td>
+      <td>-</td>
+      <td>-</td>
+      <td>21</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>42.0</td>
-      <td>Self-Employed</td>
-      <td>Prof-school</td>
       <td>-</td>
-      <td>Blue-Collar</td>
       <td>-</td>
       <td>-</td>
+      <td>Single</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>-</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>55.0</td>
       <td>-</td>
-      <td>Some-college</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Other/Unknown</td>
+      <td>Other</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>4</th>
-      <td>47.0</td>
+      <td>76</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
-      <td>Professional</td>
+      <td>Single</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>5</th>
-      <td>58.0</td>
       <td>-</td>
-      <td>Doctorate</td>
-      <td>Married</td>
-      <td>Service</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>-</td>
+      <td>-</td>
+      <td>16</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>6</th>
-      <td>67.0</td>
-      <td>Self-Employed</td>
-      <td>Prof-school</td>
+      <td>68</td>
+      <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>49.0</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
-      <td>Sales</td>
       <td>-</td>
+      <td>Single</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>75</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>8</th>
-      <td>42.0</td>
+      <td>49</td>
+      <td>Self-Employed</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>9</th>
-      <td>63.0</td>
-      <td>Government</td>
-      <td>Prof-school</td>
-      <td>Married</td>
+      <td>68</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>-</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -1995,7 +1986,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 1)
+Query instance (original outcome : 0)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2034,15 +2025,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>29</td>
+      <td>17</td>
       <td>Private</td>
-      <td>Some-college</td>
-      <td>Married</td>
-      <td>Blue-Collar</td>
-      <td>Other</td>
+      <td>School</td>
+      <td>Single</td>
+      <td>Service</td>
+      <td>White</td>
       <td>Male</td>
-      <td>40</td>
-      <td>1</td>
+      <td>20</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -2054,7 +2045,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 0.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2093,123 +2084,123 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>-</td>
-      <td>-</td>
-      <td>Assoc</td>
+      <td>39</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>99</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>28.0</td>
-      <td>-</td>
+      <td>49</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>67.0</td>
-      <td>0</td>
+      <td>59</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>2</th>
+      <td>42</td>
       <td>-</td>
-      <td>-</td>
-      <td>-</td>
-      <td>Divorced</td>
+      <td>Masters</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>76</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>85.0</td>
-      <td>-</td>
-      <td>-</td>
+      <td>81</td>
       <td>-</td>
+      <td>Doctorate</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>4</th>
-      <td>49.0</td>
-      <td>-</td>
+      <td>49</td>
       <td>-</td>
-      <td>Separated</td>
+      <td>Doctorate</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>92</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>5</th>
+      <td>66</td>
+      <td>Other/Unknown</td>
+      <td>Some-college</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>-</td>
-      <td>-</td>
-      <td>-</td>
-      <td>13.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>6</th>
+      <td>52</td>
       <td>-</td>
+      <td>Masters</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
-      <td>Widowed</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>39.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>-</td>
+      <td>81</td>
       <td>-</td>
       <td>Doctorate</td>
-      <td>Divorced</td>
-      <td>-</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>38</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>8</th>
+      <td>55</td>
       <td>-</td>
       <td>-</td>
-      <td>Masters</td>
       <td>-</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
+      <td>64</td>
       <td>-</td>
-      <td>18.0</td>
-      <td>0</td>
     </tr>
     <tr>
       <th>9</th>
-      <td>28.0</td>
-      <td>-</td>
-      <td>-</td>
+      <td>49</td>
+      <td>Self-Employed</td>
+      <td>Doctorate</td>
       <td>-</td>
-      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>92</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -2259,14 +2250,14 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>39</td>
-      <td>Self-Employed</td>
-      <td>Masters</td>
+      <td>28</td>
+      <td>Private</td>
+      <td>Bachelors</td>
       <td>Married</td>
-      <td>Professional</td>
+      <td>Sales</td>
       <td>White</td>
-      <td>Female</td>
-      <td>40</td>
+      <td>Male</td>
+      <td>45</td>
       <td>1</td>
     </tr>
   </tbody>
@@ -2279,7 +2270,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 0.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2319,12 +2310,12 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>Government</td>
       <td>-</td>
-      <td>Divorced</td>
       <td>-</td>
+      <td>Single</td>
       <td>-</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
       <td>0</td>
     </tr>
@@ -2334,22 +2325,22 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Blue-Collar</td>
-      <td>-</td>
+      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
+      <td>14</td>
       <td>0</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>66.0</td>
+      <td>27</td>
       <td>-</td>
       <td>-</td>
-      <td>Widowed</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>79</td>
       <td>0</td>
     </tr>
     <tr>
@@ -2357,18 +2348,18 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Separated</td>
       <td>-</td>
+      <td>Professional</td>
+      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>38.0</td>
       <td>0</td>
     </tr>
     <tr>
       <th>4</th>
-      <td>27.0</td>
       <td>-</td>
-      <td>Some-college</td>
+      <td>-</td>
+      <td>Assoc</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2378,11 +2369,11 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
     </tr>
     <tr>
       <th>5</th>
-      <td>41.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Widowed</td>
       <td>-</td>
+      <td>Separated</td>
+      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2393,32 +2384,32 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Divorced</td>
+      <td>Separated</td>
       <td>-</td>
-      <td>Other</td>
       <td>-</td>
       <td>-</td>
+      <td>77</td>
       <td>0</td>
     </tr>
     <tr>
       <th>7</th>
+      <td>46</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Divorced</td>
-      <td>Service</td>
       <td>-</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
       <td>0</td>
     </tr>
     <tr>
       <th>8</th>
-      <td>20.0</td>
-      <td>-</td>
       <td>-</td>
+      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2428,12 +2419,12 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
       <th>9</th>
       <td>-</td>
       <td>-</td>
-      <td>-</td>
-      <td>Widowed</td>
+      <td>HS-grad</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>22</td>
       <td>0</td>
     </tr>
   </tbody>
@@ -2445,7 +2436,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 0)
+Query instance (original outcome : 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2484,15 +2475,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>31</td>
+      <td>41</td>
       <td>Private</td>
-      <td>School</td>
-      <td>Single</td>
-      <td>Blue-Collar</td>
+      <td>Some-college</td>
+      <td>Married</td>
+      <td>Sales</td>
       <td>White</td>
       <td>Male</td>
-      <td>25</td>
-      <td>0</td>
+      <td>65</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -2504,7 +2495,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 1.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2545,121 +2536,121 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Masters</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
+      <td>White-Collar</td>
       <td>-</td>
-      <td>98.0</td>
-      <td>1</td>
+      <td>Female</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>89.0</td>
+      <td>72</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
+      <td>Service</td>
       <td>-</td>
       <td>-</td>
-      <td>61.0</td>
-      <td>1</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>78.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
+      <td>Separated</td>
       <td>-</td>
       <td>-</td>
-      <td>69.0</td>
-      <td>1</td>
+      <td>-</td>
+      <td>25</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>65.0</td>
+      <td>28</td>
       <td>-</td>
-      <td>Doctorate</td>
       <td>-</td>
-      <td>White-Collar</td>
       <td>-</td>
+      <td>Blue-Collar</td>
       <td>-</td>
-      <td>16.0</td>
-      <td>1</td>
+      <td>-</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>4</th>
-      <td>78.0</td>
+      <td>26</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>85.0</td>
-      <td>1</td>
+      <td>-</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>5</th>
-      <td>39.0</td>
       <td>-</td>
-      <td>Prof-school</td>
+      <td>-</td>
+      <td>-</td>
       <td>-</td>
       <td>Professional</td>
-      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>5</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>6</th>
-      <td>62.0</td>
+      <td>81</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
+      <td>Divorced</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>61.0</td>
-      <td>1</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>7</th>
+      <td>30</td>
       <td>-</td>
       <td>-</td>
-      <td>Doctorate</td>
-      <td>Married</td>
-      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>8</th>
-      <td>46.0</td>
       <td>-</td>
-      <td>Prof-school</td>
-      <td>Married</td>
+      <td>Government</td>
       <td>-</td>
+      <td>Divorced</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>-</td>
+      <td>0</td>
     </tr>
     <tr>
       <th>9</th>
-      <td>65.0</td>
       <td>-</td>
-      <td>Doctorate</td>
       <td>-</td>
-      <td>White-Collar</td>
+      <td>-</td>
+      <td>Single</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>1</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -2670,7 +2661,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 1)
+Query instance (original outcome : 0)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2709,15 +2700,15 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>45</td>
-      <td>Private</td>
-      <td>Masters</td>
-      <td>Married</td>
-      <td>White-Collar</td>
+      <td>23</td>
+      <td>Government</td>
+      <td>Bachelors</td>
+      <td>Single</td>
+      <td>Professional</td>
       <td>White</td>
       <td>Male</td>
-      <td>43</td>
-      <td>1</td>
+      <td>40</td>
+      <td>0</td>
     </tr>
   </tbody>
 </table>
@@ -2729,7 +2720,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 0.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2771,120 +2762,120 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Separated</td>
-      <td>Sales</td>
+      <td>Married</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>35.0</td>
+      <td>55</td>
       <td>-</td>
       <td>-</td>
-      <td>Separated</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>62.0</td>
+      <td>37</td>
       <td>-</td>
-      <td>School</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>17.0</td>
+      <td>82</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Other</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>4</th>
+      <td>88</td>
       <td>-</td>
       <td>-</td>
-      <td>Assoc</td>
-      <td>Separated</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>5</th>
-      <td>28.0</td>
       <td>-</td>
       <td>-</td>
-      <td>Single</td>
       <td>-</td>
+      <td>Married</td>
+      <td>Service</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>6</th>
-      <td>25.0</td>
-      <td>-</td>
+      <td>75</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>49.0</td>
+      <td>73</td>
       <td>-</td>
-      <td>HS-grad</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>8</th>
       <td>-</td>
       <td>-</td>
-      <td>School</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>9.0</td>
-      <td>0</td>
+      <td>44</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>9</th>
+      <td>88</td>
       <td>-</td>
       <td>-</td>
+      <td>Married</td>
       <td>-</td>
-      <td>Separated</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>4.0</td>
-      <td>0</td>
+      <td>1</td>
     </tr>
   </tbody>
 </table>
@@ -2934,14 +2925,14 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>28</td>
+      <td>26</td>
       <td>Private</td>
-      <td>HS-grad</td>
+      <td>Masters</td>
       <td>Single</td>
       <td>White-Collar</td>
       <td>White</td>
       <td>Female</td>
-      <td>20</td>
+      <td>48</td>
       <td>0</td>
     </tr>
   </tbody>
@@ -2954,7 +2945,7 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Counterfactual set (new outcome: 1.0)
+Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2993,105 +2984,105 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
   <tbody>
     <tr>
       <th>0</th>
-      <td>42.0</td>
+      <td>76</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>71</td>
       <td>1</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>53.0</td>
-      <td>Other/Unknown</td>
-      <td>Doctorate</td>
+      <td>35</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>81</td>
+      <td>1</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>34.0</td>
+      <td>42</td>
       <td>-</td>
-      <td>Masters</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>60.0</td>
+      <td>Male</td>
+      <td>-</td>
       <td>1</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>67.0</td>
+      <td>51</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>68</td>
       <td>1</td>
     </tr>
     <tr>
       <th>4</th>
-      <td>87.0</td>
+      <td>58</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Male</td>
       <td>-</td>
       <td>1</td>
     </tr>
     <tr>
       <th>5</th>
-      <td>46.0</td>
+      <td>34</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Male</td>
       <td>-</td>
       <td>1</td>
     </tr>
     <tr>
       <th>6</th>
-      <td>72.0</td>
+      <td>88</td>
       <td>-</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Male</td>
       <td>-</td>
       <td>1</td>
     </tr>
     <tr>
       <th>7</th>
-      <td>42.0</td>
+      <td>48</td>
       <td>-</td>
       <td>-</td>
       <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>93.0</td>
+      <td>-</td>
       <td>1</td>
     </tr>
     <tr>
       <th>8</th>
-      <td>42.0</td>
+      <td>52</td>
+      <td>-</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -3101,14 +3092,14 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
     </tr>
     <tr>
       <th>9</th>
-      <td>55.0</td>
+      <td>79</td>
+      <td>-</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Male</td>
       <td>-</td>
+      <td>60</td>
       <td>1</td>
     </tr>
   </tbody>
@@ -3121,8 +3112,8 @@ <h2>Convert the json output to a counterfactual object<a class="headerlink" href
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 [None, None, None, None, None, None, None, None, None, None]
-[{&#39;age&#39;: 0.8, &#39;occupation&#39;: 0.5, &#39;marital_status&#39;: 0.4, &#39;race&#39;: 0.1, &#39;hours_per_week&#39;: 0.1, &#39;workclass&#39;: 0.0, &#39;education&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;marital_status&#39;: 0.8, &#39;age&#39;: 0.7, &#39;education&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;occupation&#39;: 0.1, &#39;hours_per_week&#39;: 0.1, &#39;race&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;age&#39;: 0.6, &#39;education&#39;: 0.3, &#39;occupation&#39;: 0.3, &#39;hours_per_week&#39;: 0.2, &#39;race&#39;: 0.1, &#39;gender&#39;: 0.1, &#39;workclass&#39;: 0.0, &#39;marital_status&#39;: 0.0}, {&#39;occupation&#39;: 0.5, &#39;hours_per_week&#39;: 0.4, &#39;education&#39;: 0.3, &#39;marital_status&#39;: 0.3, &#39;age&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;race&#39;: 0.1, &#39;gender&#39;: 0.1}, {&#39;age&#39;: 1.0, &#39;education&#39;: 1.0, &#39;workclass&#39;: 0.4, &#39;marital_status&#39;: 0.4, &#39;occupation&#39;: 0.4, &#39;hours_per_week&#39;: 0.1, &#39;race&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;age&#39;: 0.4, &#39;marital_status&#39;: 0.4, &#39;hours_per_week&#39;: 0.4, &#39;education&#39;: 0.3, &#39;occupation&#39;: 0.1, &#39;workclass&#39;: 0.0, &#39;race&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;marital_status&#39;: 0.7, &#39;age&#39;: 0.4, &#39;occupation&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;education&#39;: 0.1, &#39;race&#39;: 0.1, &#39;hours_per_week&#39;: 0.1, &#39;gender&#39;: 0.0}, {&#39;age&#39;: 0.8, &#39;marital_status&#39;: 0.7, &#39;education&#39;: 0.6, &#39;hours_per_week&#39;: 0.6, &#39;occupation&#39;: 0.4, &#39;race&#39;: 0.1, &#39;workclass&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;age&#39;: 0.6, &#39;marital_status&#39;: 0.5, &#39;education&#39;: 0.4, &#39;hours_per_week&#39;: 0.2, &#39;occupation&#39;: 0.1, &#39;race&#39;: 0.1, &#39;workclass&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;age&#39;: 1.0, &#39;marital_status&#39;: 0.6, &#39;education&#39;: 0.4, &#39;gender&#39;: 0.2, &#39;hours_per_week&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;occupation&#39;: 0.0, &#39;race&#39;: 0.0}]
-{&#39;age&#39;: 0.65, &#39;marital_status&#39;: 0.48, &#39;education&#39;: 0.36, &#39;occupation&#39;: 0.26, &#39;hours_per_week&#39;: 0.24, &#39;workclass&#39;: 0.08, &#39;race&#39;: 0.06, &#39;gender&#39;: 0.04}
+[{&#39;marital_status&#39;: 0.8, &#39;hours_per_week&#39;: 0.6, &#39;age&#39;: 0.2, &#39;education&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;gender&#39;: 0.1, &#39;occupation&#39;: 0.0, &#39;race&#39;: 0.0}, {&#39;hours_per_week&#39;: 0.6, &#39;age&#39;: 0.4, &#39;marital_status&#39;: 0.3, &#39;workclass&#39;: 0.2, &#39;race&#39;: 0.2, &#39;occupation&#39;: 0.1, &#39;education&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;hours_per_week&#39;: 0.7, &#39;marital_status&#39;: 0.5, &#39;age&#39;: 0.3, &#39;workclass&#39;: 0.1, &#39;occupation&#39;: 0.1, &#39;race&#39;: 0.1, &#39;gender&#39;: 0.1, &#39;education&#39;: 0.0}, {&#39;marital_status&#39;: 0.7, &#39;age&#39;: 0.5, &#39;occupation&#39;: 0.5, &#39;hours_per_week&#39;: 0.5, &#39;education&#39;: 0.2, &#39;gender&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;race&#39;: 0.0}, {&#39;age&#39;: 0.5, &#39;marital_status&#39;: 0.4, &#39;hours_per_week&#39;: 0.3, &#39;workclass&#39;: 0.2, &#39;race&#39;: 0.2, &#39;occupation&#39;: 0.1, &#39;education&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;age&#39;: 1.0, &#39;education&#39;: 0.7, &#39;hours_per_week&#39;: 0.7, &#39;marital_status&#39;: 0.4, &#39;occupation&#39;: 0.3, &#39;workclass&#39;: 0.2, &#39;race&#39;: 0.0, &#39;gender&#39;: 0.0}, {&#39;occupation&#39;: 0.4, &#39;hours_per_week&#39;: 0.4, &#39;marital_status&#39;: 0.3, &#39;age&#39;: 0.2, &#39;education&#39;: 0.2, &#39;gender&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;race&#39;: 0.1}, {&#39;age&#39;: 0.5, &#39;occupation&#39;: 0.5, &#39;marital_status&#39;: 0.4, &#39;hours_per_week&#39;: 0.2, &#39;workclass&#39;: 0.1, &#39;gender&#39;: 0.1, &#39;education&#39;: 0.0, &#39;race&#39;: 0.0}, {&#39;age&#39;: 0.7, &#39;marital_status&#39;: 0.7, &#39;gender&#39;: 0.3, &#39;occupation&#39;: 0.1, &#39;race&#39;: 0.1, &#39;hours_per_week&#39;: 0.1, &#39;workclass&#39;: 0.0, &#39;education&#39;: 0.0}, {&#39;age&#39;: 1.0, &#39;gender&#39;: 0.5, &#39;hours_per_week&#39;: 0.4, &#39;marital_status&#39;: 0.1, &#39;workclass&#39;: 0.0, &#39;education&#39;: 0.0, &#39;occupation&#39;: 0.0, &#39;race&#39;: 0.0}]
+{&#39;age&#39;: 0.53, &#39;marital_status&#39;: 0.46, &#39;hours_per_week&#39;: 0.45, &#39;occupation&#39;: 0.21, &#39;gender&#39;: 0.15, &#39;education&#39;: 0.13, &#39;workclass&#39;: 0.11, &#39;race&#39;: 0.07}
 </pre></div></div>
 </div>
 </section>
diff --git a/docs/notebooks/DiCE_getting_started.html b/docs/notebooks/DiCE_getting_started.html
index 34d8015f..2f114e32 100644
--- a/docs/notebooks/DiCE_getting_started.html
+++ b/docs/notebooks/DiCE_getting_started.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Quick introduction to generating counterfactual explanations using DiCE &mdash; DiCE 0.10 documentation</title>
+  <title>Quick introduction to generating counterfactual explanations using DiCE &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -408,7 +408,7 @@ <h1>Quick introduction to generating counterfactual explanations using DiCE<a cl
 </ul>
 <p><img alt="DiCE API" src="../_images/dice_getting_started_api.png" /></p>
 <p>DiCE requires two inputs: a training dataset and a pre-trained ML model. When the training dataset is unknown (e.g., for privacy reasons), it can also work without access to the full dataset (see this <a class="reference internal" href="DiCE_with_private_data.html"><span class="doc">notebook</span></a> for an example). Below we show a simple example.</p>
-<div class="nbinput docutils container">
+<div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>
 </div>
@@ -425,15 +425,6 @@ <h1>Quick introduction to generating counterfactual explanations using DiCE<a cl
 </pre></div>
 </div>
 </div>
-<div class="nboutput nblast docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
-/mnt/c/Users/amshar/code/dice/dice_ml/utils/exception.py:12: UserWarning: UserConfigValidationException will be deprecated from dice_ml.utils. Please import UserConfigValidationException from raiutils.exceptions.
-  warnings.warn(&#34;UserConfigValidationException will be deprecated from dice_ml.utils. &#34;
-</pre></div></div>
-</div>
 <div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
 </pre></div>
@@ -678,7 +669,7 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  2.17it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  3.99it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -753,7 +744,7 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -794,9 +785,9 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Bachelors</td>
+      <td>Prof-school</td>
       <td>-</td>
-      <td>Professional</td>
+      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -805,10 +796,10 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
     <tr>
       <th>1</th>
       <td>-</td>
+      <td>Government</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Single</td>
       <td>-</td>
-      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -891,7 +882,7 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -932,9 +923,9 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
       <th>0</th>
       <td>29</td>
       <td>Private</td>
-      <td>Bachelors</td>
+      <td>Prof-school</td>
       <td>Married</td>
-      <td>Professional</td>
+      <td>White-Collar</td>
       <td>White</td>
       <td>Female</td>
       <td>38</td>
@@ -943,10 +934,10 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
     <tr>
       <th>1</th>
       <td>29</td>
-      <td>Private</td>
-      <td>Assoc</td>
-      <td>Married</td>
-      <td>White-Collar</td>
+      <td>Government</td>
+      <td>HS-grad</td>
+      <td>Single</td>
+      <td>Blue-Collar</td>
       <td>White</td>
       <td>Female</td>
       <td>38</td>
@@ -976,7 +967,7 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  2.89it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  3.88it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1051,7 +1042,7 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -1092,9 +1083,9 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Bachelors</td>
+      <td>Prof-school</td>
       <td>-</td>
-      <td>Other/Unknown</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -1104,9 +1095,9 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
       <th>1</th>
       <td>-</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Some-college</td>
       <td>-</td>
-      <td>White-Collar</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -1134,7 +1125,7 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  2.66it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  3.68it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1209,7 +1200,7 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -1261,13 +1252,13 @@ <h2>Generating counterfactual examples using DiCE<a class="headerlink" href="#Ge
     <tr>
       <th>1</th>
       <td>-</td>
-      <td>Government</td>
       <td>-</td>
-      <td>Single</td>
+      <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>28</td>
       <td>1</td>
     </tr>
   </tbody>
@@ -1297,7 +1288,7 @@ <h3>Local feature importance scores<a class="headerlink" href="#Local-feature-im
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  1.37it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00&lt;00:00,  2.31it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1305,7 +1296,7 @@ <h3>Local feature importance scores<a class="headerlink" href="#Local-feature-im
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-[{&#39;education&#39;: 0.7, &#39;occupation&#39;: 0.7, &#39;workclass&#39;: 0.4, &#39;marital_status&#39;: 0.1, &#39;gender&#39;: 0.1, &#39;race&#39;: 0.0, &#39;age&#39;: 0.0, &#39;hours_per_week&#39;: 0.0}]
+[{&#39;education&#39;: 0.9, &#39;occupation&#39;: 0.4, &#39;workclass&#39;: 0.2, &#39;gender&#39;: 0.2, &#39;age&#39;: 0.2, &#39;marital_status&#39;: 0.0, &#39;race&#39;: 0.0, &#39;hours_per_week&#39;: 0.0}]
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -1336,7 +1327,7 @@ <h3>Global feature importance scores<a class="headerlink" href="#Global-feature-
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|███████████████████████████████████████████████████████████████████████████████████| 20/20 [00:12&lt;00:00,  1.66it/s]
+100%|███████████████████████████████████████████████████████████████████████████████████| 20/20 [00:08&lt;00:00,  2.25it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1344,7 +1335,7 @@ <h3>Global feature importance scores<a class="headerlink" href="#Global-feature-
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-{&#39;education&#39;: 0.56, &#39;marital_status&#39;: 0.32, &#39;occupation&#39;: 0.275, &#39;hours_per_week&#39;: 0.25, &#39;age&#39;: 0.23, &#39;workclass&#39;: 0.19, &#39;race&#39;: 0.12, &#39;gender&#39;: 0.095}
+{&#39;education&#39;: 0.62, &#39;occupation&#39;: 0.295, &#39;marital_status&#39;: 0.29, &#39;workclass&#39;: 0.22, &#39;age&#39;: 0.205, &#39;hours_per_week&#39;: 0.205, &#39;race&#39;: 0.115, &#39;gender&#39;: 0.09}
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -1380,9 +1371,9 @@ <h3>Explaining a Tensorflow model<a class="headerlink" href="#Explaining-a-Tenso
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-2023-06-26 19:18:40.752470: I tensorflow/core/util/util.cc:169] oneDNN custom operations are on. You may see slightly different numerical results due to floating-point round-off errors from different computation orders. To turn them off, set the environment variable `TF_ENABLE_ONEDNN_OPTS=0`.
-2023-06-26 19:18:40.756608: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcudart.so.11.0&#39;; dlerror: libcudart.so.11.0: cannot open shared object file: No such file or directory
-2023-06-26 19:18:40.756625: I tensorflow/stream_executor/cuda/cudart_stub.cc:29] Ignore above cudart dlerror if you do not have a GPU set up on your machine.
+2023-10-26 15:43:24.138021: I tensorflow/core/util/util.cc:169] oneDNN custom operations are on. You may see slightly different numerical results due to floating-point round-off errors from different computation orders. To turn them off, set the environment variable `TF_ENABLE_ONEDNN_OPTS=0`.
+2023-10-26 15:43:24.207078: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcudart.so.11.0&#39;; dlerror: libcudart.so.11.0: cannot open shared object file: No such file or directory
+2023-10-26 15:43:24.207103: I tensorflow/stream_executor/cuda/cudart_stub.cc:29] Ignore above cudart dlerror if you do not have a GPU set up on your machine.
 </pre></div></div>
 </div>
 <p>We want to note that the time required to find counterfactuals with Tensorflow 2.x’s eager style of execution is significantly greater than that with TensorFlow 1.x’s graph execution.</p>
@@ -1401,10 +1392,10 @@ <h3>Explaining a Tensorflow model<a class="headerlink" href="#Explaining-a-Tenso
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-2023-06-26 19:18:43.948236: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcuda.so.1&#39;; dlerror: libcuda.so.1: cannot open shared object file: No such file or directory
-2023-06-26 19:18:43.948388: W tensorflow/stream_executor/cuda/cuda_driver.cc:269] failed call to cuInit: UNKNOWN ERROR (303)
-2023-06-26 19:18:43.948454: I tensorflow/stream_executor/cuda/cuda_diagnostics.cc:156] kernel driver does not appear to be running on this host (AMSHAR-X1): /proc/driver/nvidia/version does not exist
-2023-06-26 19:18:43.948952: I tensorflow/core/platform/cpu_feature_guard.cc:193] This TensorFlow binary is optimized with oneAPI Deep Neural Network Library (oneDNN) to use the following CPU instructions in performance-critical operations:  AVX2 AVX512F AVX512_VNNI FMA
+2023-10-26 15:43:28.626560: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcuda.so.1&#39;; dlerror: libcuda.so.1: cannot open shared object file: No such file or directory
+2023-10-26 15:43:28.626614: W tensorflow/stream_executor/cuda/cuda_driver.cc:269] failed call to cuInit: UNKNOWN ERROR (303)
+2023-10-26 15:43:28.626637: I tensorflow/stream_executor/cuda/cuda_diagnostics.cc:156] kernel driver does not appear to be running on this host (AMSHAR-X1): /proc/driver/nvidia/version does not exist
+2023-10-26 15:43:28.627732: I tensorflow/core/platform/cpu_feature_guard.cc:193] This TensorFlow binary is optimized with oneAPI Deep Neural Network Library (oneDNN) to use the following CPU instructions in performance-critical operations:  AVX2 AVX512F AVX512_VNNI FMA
 To enable them in other operations, rebuild TensorFlow with the appropriate compiler flags.
 </pre></div></div>
 </div>
@@ -1425,8 +1416,8 @@ <h3>Explaining a Tensorflow model<a class="headerlink" href="#Explaining-a-Tenso
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Diverse Counterfactuals found! total time taken: 01 min 11 sec
-Query instance (original outcome : 1)
+Diverse Counterfactuals found! total time taken: 00 min 53 sec
+Query instance (original outcome : 0.6710000038146973)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1615,7 +1606,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
- 50%|██████████████████████████████████████████▌                                          | 1/2 [00:08&lt;00:08,  8.31s/it]
+ 50%|██████████████████████████████████████████▌                                          | 1/2 [00:04&lt;00:04,  4.54s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1623,7 +1614,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Diverse Counterfactuals found! total time taken: 00 min 07 sec
+Diverse Counterfactuals found! total time taken: 00 min 04 sec
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1631,7 +1622,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:17&lt;00:00,  8.87s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:09&lt;00:00,  4.88s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1639,8 +1630,8 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Diverse Counterfactuals found! total time taken: 00 min 09 sec
-Query instance (original outcome : 1)
+Diverse Counterfactuals found! total time taken: 00 min 04 sec
+Query instance (original outcome : 0.6179999709129333)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1687,14 +1678,14 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
   <tbody>
     <tr>
       <th>0</th>
-      <td>50.0</td>
+      <td>50</td>
       <td>Other/Unknown</td>
       <td>Some-college</td>
       <td>Married</td>
       <td>Other/Unknown</td>
       <td>White</td>
       <td>Male</td>
-      <td>40.0</td>
+      <td>40</td>
       <td>0.618</td>
     </tr>
   </tbody>
@@ -1746,14 +1737,14 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
   <tbody>
     <tr>
       <th>0</th>
-      <td>38.0</td>
+      <td>38</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>26.0</td>
+      <td>26</td>
       <td>0</td>
     </tr>
     <tr>
@@ -1782,7 +1773,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
     </tr>
     <tr>
       <th>3</th>
-      <td>70.0</td>
+      <td>70</td>
       <td>-</td>
       <td>-</td>
       <td>Divorced</td>
@@ -1801,7 +1792,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 1)
+Query instance (original outcome : 0.9679999947547913)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1840,14 +1831,14 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
   <tbody>
     <tr>
       <th>0</th>
-      <td>50.0</td>
+      <td>50</td>
       <td>Private</td>
       <td>Bachelors</td>
       <td>Married</td>
       <td>Professional</td>
       <td>White</td>
       <td>Male</td>
-      <td>40.0</td>
+      <td>40</td>
       <td>0.968</td>
     </tr>
   </tbody>
@@ -1899,14 +1890,14 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
   <tbody>
     <tr>
       <th>0</th>
-      <td>18.0</td>
+      <td>18</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>35.0</td>
+      <td>35</td>
       <td>0</td>
     </tr>
     <tr>
@@ -1923,7 +1914,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
     </tr>
     <tr>
       <th>2</th>
-      <td>69.0</td>
+      <td>69</td>
       <td>-</td>
       <td>-</td>
       <td>Single</td>
@@ -1975,7 +1966,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  2.44it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  2.32it/s]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2050,7 +2041,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 0.0)
+Diverse Counterfactual set (new outcome: 0)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2092,46 +2083,46 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Widowed</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Female</td>
-      <td>-</td>
+      <td>22</td>
       <td>0</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>68.0</td>
+      <td>28</td>
+      <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>18.0</td>
       <td>0</td>
     </tr>
     <tr>
       <th>2</th>
+      <td>29</td>
+      <td>Private</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Single</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>7.0</td>
       <td>0</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>83.0</td>
       <td>-</td>
       <td>-</td>
+      <td>School</td>
+      <td>Widowed</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Female</td>
       <td>-</td>
       <td>0</td>
     </tr>
@@ -2203,7 +2194,7 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 0.0)
+Diverse Counterfactual set (new outcome: 0)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -2246,10 +2237,10 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
       <td>-</td>
       <td>-</td>
       <td>Separated</td>
-      <td>Blue-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>32</td>
       <td>0</td>
     </tr>
     <tr>
@@ -2257,22 +2248,22 @@ <h3>Explaining a Pytorch model<a class="headerlink" href="#Explaining-a-Pytorch-
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Divorced</td>
-      <td>Blue-Collar</td>
+      <td>Separated</td>
       <td>-</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
       <td>0</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>23.0</td>
       <td>-</td>
-      <td>Some-college</td>
       <td>-</td>
+      <td>School</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Female</td>
       <td>-</td>
       <td>0</td>
     </tr>
diff --git a/docs/notebooks/DiCE_getting_started_feasible.html b/docs/notebooks/DiCE_getting_started_feasible.html
index 1df823c9..ef282f64 100644
--- a/docs/notebooks/DiCE_getting_started_feasible.html
+++ b/docs/notebooks/DiCE_getting_started_feasible.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>&lt;no title&gt; &mdash; DiCE 0.10 documentation</title>
+  <title>&lt;no title&gt; &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/notebooks/DiCE_model_agnostic_CFs.html b/docs/notebooks/DiCE_model_agnostic_CFs.html
index 2ef425e3..ee5d0419 100644
--- a/docs/notebooks/DiCE_model_agnostic_CFs.html
+++ b/docs/notebooks/DiCE_model_agnostic_CFs.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Generating counterfactual explanations with any ML model &mdash; DiCE 0.10 documentation</title>
+  <title>Generating counterfactual explanations with any ML model &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -396,7 +396,7 @@ <h1>Generating counterfactual explanations with any ML model<a class="headerlink
 <p>We use scikit-learn models for demonstration.</p>
 <section id="1.-Independent-random-sampling-of-features">
 <h2>1. Independent random sampling of features<a class="headerlink" href="#1.-Independent-random-sampling-of-features" title="Permalink to this heading"></a></h2>
-<div class="nbinput docutils container">
+<div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>
 </div>
@@ -412,15 +412,6 @@ <h2>1. Independent random sampling of features<a class="headerlink" href="#1.-In
 </pre></div>
 </div>
 </div>
-<div class="nboutput nblast docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
-/mnt/c/Users/amshar/code/dice/dice_ml/utils/exception.py:12: UserWarning: UserConfigValidationException will be deprecated from dice_ml.utils. Please import UserConfigValidationException from raiutils.exceptions.
-  warnings.warn(&#34;UserConfigValidationException will be deprecated from dice_ml.utils. &#34;
-</pre></div></div>
-</div>
 <div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
 </pre></div>
@@ -640,7 +631,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  2.79it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  2.98it/s]
 </pre></div></div>
 </div>
 <div class="nbinput docutils container">
@@ -715,7 +706,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -754,9 +745,9 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
   <tbody>
     <tr>
       <th>0</th>
-      <td>68.0</td>
+      <td>42</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -766,14 +757,14 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
     </tr>
     <tr>
       <th>1</th>
-      <td>71.0</td>
+      <td>43</td>
       <td>-</td>
       <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>71.0</td>
+      <td>-</td>
       <td>1</td>
     </tr>
   </tbody>
@@ -844,7 +835,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 0.0)
+Diverse Counterfactual set (new outcome: 0)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -883,26 +874,26 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
   <tbody>
     <tr>
       <th>0</th>
-      <td>58.0</td>
       <td>-</td>
       <td>-</td>
+      <td>Prof-school</td>
+      <td>Separated</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Female</td>
       <td>-</td>
       <td>0</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>67.0</td>
+      <td>51</td>
       <td>-</td>
+      <td>Masters</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>24.0</td>
       <td>0</td>
     </tr>
   </tbody>
@@ -929,7 +920,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  3.07it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  2.49it/s]
 </pre></div></div>
 </div>
 <div class="nbinput docutils container">
@@ -1004,7 +995,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1043,7 +1034,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
   <tbody>
     <tr>
       <th>0</th>
-      <td>87.0</td>
+      <td>87</td>
       <td>-</td>
       <td>Assoc</td>
       <td>-</td>
@@ -1055,7 +1046,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
     </tr>
     <tr>
       <th>1</th>
-      <td>67.0</td>
+      <td>67</td>
       <td>-</td>
       <td>Assoc</td>
       <td>-</td>
@@ -1067,7 +1058,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
     </tr>
     <tr>
       <th>2</th>
-      <td>61.0</td>
+      <td>61</td>
       <td>-</td>
       <td>Assoc</td>
       <td>-</td>
@@ -1079,7 +1070,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
     </tr>
     <tr>
       <th>3</th>
-      <td>72.0</td>
+      <td>72</td>
       <td>-</td>
       <td>Assoc</td>
       <td>-</td>
@@ -1157,7 +1148,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 0.0)
+Diverse Counterfactual set (new outcome: 0)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -1199,11 +1190,11 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Single</td>
+      <td>Professional</td>
       <td>-</td>
-      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
-      <td>16.0</td>
       <td>0</td>
     </tr>
     <tr>
@@ -1213,14 +1204,14 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>White</td>
       <td>-</td>
-      <td>77.0</td>
+      <td>Female</td>
+      <td>16</td>
       <td>0</td>
     </tr>
     <tr>
       <th>2</th>
-      <td>44.0</td>
+      <td>44</td>
       <td>-</td>
       <td>-</td>
       <td>Separated</td>
@@ -1232,6 +1223,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
     </tr>
     <tr>
       <th>3</th>
+      <td>19</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -1239,7 +1231,6 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>24.0</td>
       <td>0</td>
     </tr>
   </tbody>
@@ -1260,28 +1251,12 @@ <h4>Selecting the features to vary<a class="headerlink" href="#Selecting-the-fea
 </pre></div>
 </div>
 </div>
-<div class="nboutput docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
- 50%|██████████████████████████████████████████▌                                          | 1/2 [00:00&lt;00:00,  2.04it/s]
-</pre></div></div>
-</div>
-<div class="nboutput docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area docutils container">
-<div class="highlight"><pre>
-Only 3 (required 4)  Diverse Counterfactuals found for the given configuration, perhaps try with different parameters... ; total time taken: 00 min 00 sec
-</pre></div></div>
-</div>
 <div class="nboutput nblast docutils container">
 <div class="prompt empty docutils container">
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  2.45it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:01&lt;00:00,  1.64it/s]
 </pre></div></div>
 </div>
 <div class="nbinput docutils container">
@@ -1356,7 +1331,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#Selecting-the-fea
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1402,7 +1377,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#Selecting-the-fea
       <td>Sales</td>
       <td>-</td>
       <td>-</td>
-      <td>82.0</td>
+      <td>82</td>
       <td>1</td>
     </tr>
     <tr>
@@ -1414,7 +1389,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#Selecting-the-fea
       <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>85.0</td>
+      <td>85</td>
       <td>1</td>
     </tr>
     <tr>
@@ -1426,7 +1401,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#Selecting-the-fea
       <td>Sales</td>
       <td>-</td>
       <td>-</td>
-      <td>70.0</td>
+      <td>70</td>
       <td>1</td>
     </tr>
   </tbody>
@@ -1497,7 +1472,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#Selecting-the-fea
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 0.0)
+Diverse Counterfactual set (new outcome: 0)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -1537,49 +1512,49 @@ <h4>Selecting the features to vary<a class="headerlink" href="#Selecting-the-fea
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>Other/Unknown</td>
       <td>-</td>
+      <td>HS-grad</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>46.0</td>
+      <td>34</td>
       <td>0</td>
     </tr>
     <tr>
       <th>1</th>
       <td>-</td>
+      <td>Other/Unknown</td>
+      <td>Doctorate</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>25.0</td>
       <td>0</td>
     </tr>
     <tr>
       <th>2</th>
       <td>-</td>
-      <td>Private</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>34.0</td>
+      <td>-</td>
+      <td>10</td>
       <td>0</td>
     </tr>
     <tr>
       <th>3</th>
       <td>-</td>
-      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Blue-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>3.0</td>
+      <td>16</td>
       <td>0</td>
     </tr>
   </tbody>
@@ -1606,7 +1581,7 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00&lt;00:00,  2.73it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:01&lt;00:00,  1.17it/s]
 </pre></div></div>
 </div>
 <div class="nbinput docutils container">
@@ -1681,7 +1656,7 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 1.0)
+Diverse Counterfactual set (new outcome: 1)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1720,22 +1695,22 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
   <tbody>
     <tr>
       <th>0</th>
-      <td>43.0</td>
+      <td>37</td>
+      <td>-</td>
+      <td>Prof-school</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Professional</td>
       <td>-</td>
       <td>-</td>
-      <td>59.0</td>
       <td>1</td>
     </tr>
     <tr>
       <th>1</th>
-      <td>43.0</td>
-      <td>Government</td>
+      <td>42</td>
+      <td>-</td>
+      <td>Prof-school</td>
       <td>-</td>
-      <td>Widowed</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -1744,23 +1719,23 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
     </tr>
     <tr>
       <th>2</th>
-      <td>41.0</td>
-      <td>Self-Employed</td>
+      <td>38</td>
       <td>-</td>
-      <td>Married</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>-</td>
+      <td>60</td>
       <td>1</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>33.0</td>
+      <td>38</td>
+      <td>-</td>
+      <td>Prof-school</td>
       <td>-</td>
-      <td>Doctorate</td>
       <td>-</td>
-      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -1834,7 +1809,7 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set (new outcome: 0.0)
+Diverse Counterfactual set (new outcome: 0)
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -1874,10 +1849,10 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>Private</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>Divorced</td>
+      <td>Other/Unknown</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -1885,12 +1860,12 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
     </tr>
     <tr>
       <th>1</th>
+      <td>24</td>
       <td>-</td>
       <td>-</td>
-      <td>HS-grad</td>
       <td>-</td>
-      <td>Other/Unknown</td>
       <td>-</td>
+      <td>White</td>
       <td>-</td>
       <td>-</td>
       <td>0</td>
@@ -1898,22 +1873,22 @@ <h4>Choosing feature ranges<a class="headerlink" href="#Choosing-feature-ranges"
     <tr>
       <th>2</th>
       <td>-</td>
-      <td>Government</td>
-      <td>HS-grad</td>
       <td>-</td>
+      <td>School</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>52</td>
       <td>0</td>
     </tr>
     <tr>
       <th>3</th>
-      <td>24.0</td>
+      <td>-</td>
+      <td>Private</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
-      <td>Blue-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -1975,7 +1950,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
- 50%|██████████████████████████████████████████▌                                          | 1/2 [00:01&lt;00:01,  1.99s/it]
+ 50%|██████████████████████████████████████████▌                                          | 1/2 [00:03&lt;00:03,  3.78s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1983,7 +1958,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Diverse Counterfactuals found! total time taken: 00 min 01 sec
+Diverse Counterfactuals found! total time taken: 00 min 03 sec
 Initializing initial parameters to the genetic algorithm...
 Initialization complete! Generating counterfactuals...
 </pre></div></div>
@@ -1993,7 +1968,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.43s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:04&lt;00:00,  2.46s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2001,7 +1976,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Diverse Counterfactuals found! total time taken: 00 min 00 sec
+Diverse Counterfactuals found! total time taken: 00 min 01 sec
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -2127,8 +2102,8 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <td>-</td>
       <td>Some-college</td>
       <td>Married</td>
+      <td>Professional</td>
       <td>-</td>
-      <td>Other</td>
       <td>-</td>
       <td>-</td>
       <td>1</td>
@@ -2137,9 +2112,9 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Bachelors</td>
       <td>Married</td>
-      <td>White-Collar</td>
+      <td>Sales</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2149,9 +2124,9 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Bachelors</td>
+      <td>Assoc</td>
       <td>Married</td>
-      <td>Sales</td>
+      <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2159,12 +2134,12 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
     </tr>
     <tr>
       <th>0</th>
-      <td>26.0</td>
       <td>-</td>
-      <td>Bachelors</td>
-      <td>Married</td>
       <td>-</td>
+      <td>Some-college</td>
+      <td>Married</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
       <td>-</td>
       <td>1</td>
@@ -2276,12 +2251,12 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
   <tbody>
     <tr>
       <th>0</th>
-      <td>32.0</td>
-      <td>-</td>
-      <td>-</td>
       <td>-</td>
       <td>-</td>
+      <td>School</td>
       <td>-</td>
+      <td>Professional</td>
+      <td>White</td>
       <td>-</td>
       <td>-</td>
       <td>0</td>
@@ -2290,9 +2265,9 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Assoc</td>
-      <td>-</td>
+      <td>HS-grad</td>
       <td>-</td>
+      <td>Blue-Collar</td>
       <td>White</td>
       <td>-</td>
       <td>-</td>
@@ -2301,11 +2276,11 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>-</td>
-      <td>HS-grad</td>
+      <td>Private</td>
+      <td>School</td>
       <td>-</td>
       <td>Blue-Collar</td>
-      <td>White</td>
+      <td>-</td>
       <td>-</td>
       <td>-</td>
       <td>0</td>
@@ -2314,9 +2289,9 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>School</td>
+      <td>HS-grad</td>
       <td>-</td>
-      <td>Professional</td>
+      <td>White-Collar</td>
       <td>White</td>
       <td>-</td>
       <td>-</td>
@@ -2344,7 +2319,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:12&lt;00:00,  6.19s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:14&lt;00:00,  7.28s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2465,19 +2440,19 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>70.0</td>
+      <td>71</td>
       <td>1</td>
     </tr>
     <tr>
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Bachelors</td>
+      <td>Assoc</td>
       <td>-</td>
       <td>White-Collar</td>
       <td>-</td>
       <td>-</td>
-      <td>71.0</td>
+      <td>82</td>
       <td>1</td>
     </tr>
   </tbody>
@@ -2588,8 +2563,8 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>Government</td>
       <td>-</td>
+      <td>Assoc</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2600,10 +2575,10 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>-</td>
-      <td>Assoc</td>
+      <td>Government</td>
       <td>-</td>
       <td>-</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2631,7 +2606,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.04s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.25s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -2747,9 +2722,9 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Bachelors</td>
+      <td>Some-college</td>
       <td>Married</td>
-      <td>Sales</td>
+      <td>Professional</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2759,9 +2734,9 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
       <th>0</th>
       <td>-</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Bachelors</td>
       <td>Married</td>
-      <td>White-Collar</td>
+      <td>Sales</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -2875,11 +2850,11 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
     <tr>
       <th>0</th>
       <td>-</td>
+      <td>Private</td>
+      <td>Bachelors</td>
       <td>-</td>
-      <td>School</td>
+      <td>White-Collar</td>
       <td>-</td>
-      <td>Professional</td>
-      <td>White</td>
       <td>-</td>
       <td>-</td>
       <td>0</td>
@@ -2887,12 +2862,12 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id2" title="Per
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>-</td>
+      <td>Private</td>
       <td>Assoc</td>
-      <td>Divorced</td>
-      <td>Blue-Collar</td>
       <td>-</td>
       <td>-</td>
+      <td>White</td>
+      <td>-</td>
       <td>-</td>
       <td>0</td>
     </tr>
@@ -2934,7 +2909,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id4" title="Per
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.02s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:01&lt;00:00,  1.01it/s]
 </pre></div></div>
 </div>
 <div class="nbinput docutils container">
@@ -3047,10 +3022,10 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id4" title="Per
   </thead>
   <tbody>
     <tr>
-      <th>6646</th>
-      <td>28.0</td>
+      <th>11233</th>
+      <td>26</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Bachelors</td>
       <td>Married</td>
       <td>-</td>
       <td>-</td>
@@ -3059,10 +3034,10 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id4" title="Per
       <td>1</td>
     </tr>
     <tr>
-      <th>11233</th>
-      <td>26.0</td>
+      <th>3155</th>
+      <td>28</td>
       <td>-</td>
-      <td>Bachelors</td>
+      <td>Assoc</td>
       <td>Married</td>
       <td>-</td>
       <td>-</td>
@@ -3071,25 +3046,25 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id4" title="Per
       <td>1</td>
     </tr>
     <tr>
-      <th>23580</th>
+      <th>2571</th>
       <td>-</td>
       <td>-</td>
-      <td>Assoc</td>
+      <td>Some-college</td>
       <td>Married</td>
-      <td>White-Collar</td>
       <td>-</td>
+      <td>Other</td>
       <td>-</td>
       <td>-</td>
       <td>1</td>
     </tr>
     <tr>
-      <th>2571</th>
+      <th>8361</th>
       <td>-</td>
       <td>-</td>
       <td>Some-college</td>
       <td>Married</td>
+      <td>Professional</td>
       <td>-</td>
-      <td>Other</td>
       <td>-</td>
       <td>-</td>
       <td>1</td>
@@ -3201,7 +3176,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id4" title="Per
   <tbody>
     <tr>
       <th>15736</th>
-      <td>32.0</td>
+      <td>32</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -3213,7 +3188,7 @@ <h3>Generate diverse counterfactuals<a class="headerlink" href="#id4" title="Per
     </tr>
     <tr>
       <th>20071</th>
-      <td>-</td>
+      <td>29</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -3270,7 +3245,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#id5" title="Perma
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:01&lt;00:00,  1.20it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.45s/it]
 </pre></div></div>
 </div>
 <div class="nbinput docutils container">
@@ -3384,7 +3359,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#id5" title="Perma
   <tbody>
     <tr>
       <th>1267</th>
-      <td>25.0</td>
+      <td>25</td>
       <td>-</td>
       <td>Assoc</td>
       <td>-</td>
@@ -3501,7 +3476,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#id5" title="Perma
   <tbody>
     <tr>
       <th>15736</th>
-      <td>32.0</td>
+      <td>32</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -3513,7 +3488,7 @@ <h4>Selecting the features to vary<a class="headerlink" href="#id5" title="Perma
     </tr>
     <tr>
       <th>20071</th>
-      <td>-</td>
+      <td>29</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -3572,7 +3547,7 @@ <h4>Selecting the feature ranges<a class="headerlink" href="#Selecting-the-featu
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:01&lt;00:00,  1.32it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.38s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -3746,7 +3721,7 @@ <h4>Selecting the feature ranges<a class="headerlink" href="#Selecting-the-featu
   <tbody>
     <tr>
       <th>15736</th>
-      <td>32.0</td>
+      <td>32</td>
       <td>-</td>
       <td>-</td>
       <td>-</td>
@@ -3793,12 +3768,12 @@ <h4>Selecting the feature ranges<a class="headerlink" href="#Selecting-the-featu
       <td>0</td>
     </tr>
     <tr>
-      <th>5064</th>
+      <th>22686</th>
       <td>-</td>
+      <td>Private</td>
+      <td>Bachelors</td>
       <td>-</td>
-      <td>HS-grad</td>
       <td>-</td>
-      <td>Blue-Collar</td>
       <td>White</td>
       <td>-</td>
       <td>-</td>
diff --git a/docs/notebooks/DiCE_multiclass_classification_and_regression.html b/docs/notebooks/DiCE_multiclass_classification_and_regression.html
index 72c9b28e..971d653b 100644
--- a/docs/notebooks/DiCE_multiclass_classification_and_regression.html
+++ b/docs/notebooks/DiCE_multiclass_classification_and_regression.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Generating counterfactuals for multi-class classification and regression models &mdash; DiCE 0.10 documentation</title>
+  <title>Generating counterfactuals for multi-class classification and regression models &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -370,7 +370,7 @@
 <section id="Generating-counterfactuals-for-multi-class-classification-and-regression-models">
 <h1>Generating counterfactuals for multi-class classification and regression models<a class="headerlink" href="#Generating-counterfactuals-for-multi-class-classification-and-regression-models" title="Permalink to this heading"></a></h1>
 <p>This notebook will demonstrate how the DiCE library can be used for multiclass classification and regression for scikit-learn models. You can use any method (“random”, “kdtree”, “genetic”), just specific it in the method argument in the initialization step. The rest of the code is completely identical. For demonstration, we will be using the genetic algorithm for CFs.</p>
-<div class="nbinput docutils container">
+<div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>
 </div>
@@ -388,15 +388,6 @@ <h1>Generating counterfactuals for multi-class classification and regression mod
 </pre></div>
 </div>
 </div>
-<div class="nboutput nblast docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
-/mnt/c/Users/amshar/code/dice/dice_ml/utils/exception.py:12: UserWarning: UserConfigValidationException will be deprecated from dice_ml.utils. Please import UserConfigValidationException from raiutils.exceptions.
-  warnings.warn(&#34;UserConfigValidationException will be deprecated from dice_ml.utils. &#34;
-</pre></div></div>
-</div>
 <div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
 </pre></div>
@@ -603,7 +594,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:01&lt;00:00,  1.32s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:01&lt;00:00,  1.16s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -721,42 +712,34 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     </tr>
     <tr>
       <th>0</th>
-      <td>4.3</td>
-      <td>4.0</td>
-      <td>4.9</td>
-      <td>1.8</td>
-      <td>2</td>
-    </tr>
-    <tr>
-      <th>0</th>
-      <td>6.4</td>
-      <td>4.0</td>
-      <td>6.4</td>
-      <td>1.3</td>
+      <td>6.3</td>
+      <td>3.8</td>
+      <td>4.4</td>
+      <td>2.1</td>
       <td>2</td>
     </tr>
     <tr>
       <th>0</th>
       <td>6.4</td>
-      <td>3.7</td>
-      <td>5.6</td>
-      <td>1.8</td>
+      <td>3.3</td>
+      <td>6.1</td>
+      <td>0.9</td>
       <td>2</td>
     </tr>
     <tr>
       <th>0</th>
-      <td>6.4</td>
-      <td>4.0</td>
-      <td>4.9</td>
-      <td>1.8</td>
+      <td>7.2</td>
+      <td>3.6</td>
+      <td>5.2</td>
+      <td>1.3</td>
       <td>2</td>
     </tr>
     <tr>
       <th>0</th>
-      <td>5.2</td>
-      <td>4.0</td>
-      <td>5.8</td>
-      <td>2.5</td>
+      <td>4.3</td>
+      <td>3.3</td>
+      <td>4.5</td>
+      <td>1.7</td>
       <td>2</td>
     </tr>
   </tbody>
@@ -779,7 +762,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.28s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:03&lt;00:00,  1.56s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -881,8 +864,8 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
   <tbody>
     <tr>
       <th>0</th>
-      <td>6.7</td>
-      <td>3.1</td>
+      <td>-</td>
+      <td>-</td>
       <td>5.6</td>
       <td>2.4</td>
       <td>2.0</td>
@@ -890,23 +873,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>6.4</td>
-      <td>3.1</td>
-      <td>5.5</td>
-      <td>1.5</td>
-      <td>2.0</td>
-    </tr>
-    <tr>
-      <th>0</th>
-      <td>6.7</td>
-      <td>3.0</td>
-      <td>5.2</td>
-      <td>1.8</td>
-      <td>2.0</td>
-    </tr>
-    <tr>
-      <th>0</th>
-      <td>6.4</td>
-      <td>3.1</td>
+      <td>-</td>
       <td>5.5</td>
       <td>1.8</td>
       <td>2.0</td>
@@ -914,7 +881,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>6.9</td>
-      <td>3.1</td>
+      <td>-</td>
       <td>5.4</td>
       <td>2.1</td>
       <td>2.0</td>
@@ -922,19 +889,35 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>6.9</td>
-      <td>3.1</td>
+      <td>-</td>
       <td>5.1</td>
       <td>2.3</td>
       <td>2.0</td>
     </tr>
     <tr>
       <th>0</th>
-      <td>6.7</td>
+      <td>-</td>
       <td>3.0</td>
       <td>5.2</td>
       <td>2.3</td>
       <td>2.0</td>
     </tr>
+    <tr>
+      <th>0</th>
+      <td>5.7</td>
+      <td>-</td>
+      <td>5.0</td>
+      <td>2.0</td>
+      <td>2.0</td>
+    </tr>
+    <tr>
+      <th>0</th>
+      <td>-</td>
+      <td>3.3</td>
+      <td>5.7</td>
+      <td>2.1</td>
+      <td>2.0</td>
+    </tr>
   </tbody>
 </table>
 </div></div>
@@ -1031,7 +1014,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>7.2</td>
-      <td>3.2</td>
+      <td>-</td>
       <td>6.0</td>
       <td>1.8</td>
       <td>2.0</td>
@@ -1039,7 +1022,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>6.5</td>
-      <td>3.2</td>
+      <td>-</td>
       <td>5.1</td>
       <td>2.0</td>
       <td>2.0</td>
@@ -1047,7 +1030,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>6.9</td>
-      <td>3.2</td>
+      <td>-</td>
       <td>5.7</td>
       <td>2.3</td>
       <td>2.0</td>
@@ -1055,7 +1038,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>6.8</td>
-      <td>3.2</td>
+      <td>-</td>
       <td>5.9</td>
       <td>2.3</td>
       <td>2.0</td>
@@ -1063,7 +1046,7 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>6.4</td>
-      <td>3.2</td>
+      <td>-</td>
       <td>5.3</td>
       <td>2.3</td>
       <td>2.0</td>
@@ -1071,16 +1054,16 @@ <h2>Multiclass Classification<a class="headerlink" href="#Multiclass-Classificat
     <tr>
       <th>0</th>
       <td>-</td>
-      <td>2.7</td>
-      <td>5.6</td>
-      <td>2.2</td>
+      <td>2.8</td>
+      <td>1.5</td>
+      <td>2.0</td>
       <td>2.0</td>
     </tr>
     <tr>
       <th>0</th>
-      <td>-</td>
-      <td>2.4</td>
-      <td>2.2</td>
+      <td>6.9</td>
+      <td>3.1</td>
+      <td>5.4</td>
       <td>2.1</td>
       <td>2.0</td>
     </tr>
@@ -1313,7 +1296,7 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:01&lt;00:00,  1.64it/s]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:02&lt;00:00,  1.09s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1321,7 +1304,7 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 1)
+Query instance (original outcome : 1.5158300399780273)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1376,7 +1359,7 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
       <td>2.910112</td>
       <td>38.650002</td>
       <td>-121.839996</td>
-      <td>1.39714</td>
+      <td>1.51583</td>
     </tr>
   </tbody>
 </table>
@@ -1425,6 +1408,18 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
     </tr>
   </thead>
   <tbody>
+    <tr>
+      <th>0</th>
+      <td>3.6976</td>
+      <td>-</td>
+      <td>5.9</td>
+      <td>1.0</td>
+      <td>-</td>
+      <td>2.0</td>
+      <td>34.24</td>
+      <td>-124.35</td>
+      <td>3.6281412000000004</td>
+    </tr>
     <tr>
       <th>0</th>
       <td>6.5173</td>
@@ -1435,19 +1430,7 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
       <td>2.7</td>
       <td>34.45</td>
       <td>-119.81</td>
-      <td>3.4560403999999965</td>
-    </tr>
-    <tr>
-      <th>0</th>
-      <td>5.6184</td>
-      <td>-</td>
-      <td>5.9</td>
-      <td>1.0</td>
-      <td>1543.0</td>
-      <td>2.7</td>
-      <td>34.24</td>
-      <td>-118.28</td>
-      <td>3.2037501000000015</td>
+      <td>3.517150499999996</td>
     </tr>
   </tbody>
 </table>
@@ -1458,7 +1441,7 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
 </div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Query instance (original outcome : 1)
+Query instance (original outcome : 0.8763800263404846)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -1505,7 +1488,7 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
       <td>2.746479</td>
       <td>33.200001</td>
       <td>-115.599998</td>
-      <td>0.8702</td>
+      <td>0.87638</td>
     </tr>
   </tbody>
 </table>
@@ -1560,11 +1543,11 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
       <td>-</td>
       <td>8.1</td>
       <td>1.1</td>
-      <td>394.0</td>
+      <td>-</td>
       <td>2.6</td>
       <td>33.61</td>
       <td>-117.92</td>
-      <td>4.962199599999989</td>
+      <td>4.94750939999999</td>
     </tr>
     <tr>
       <th>0</th>
@@ -1572,11 +1555,11 @@ <h1>Regression<a class="headerlink" href="#Regression" title="Permalink to this
       <td>43.0</td>
       <td>4.6</td>
       <td>1.2</td>
-      <td>393.0</td>
+      <td>-</td>
       <td>1.6</td>
       <td>34.01</td>
       <td>-118.47</td>
-      <td>4.193990299999995</td>
+      <td>4.3242802999999945</td>
     </tr>
   </tbody>
 </table>
diff --git a/docs/notebooks/DiCE_with_advanced_options.html b/docs/notebooks/DiCE_with_advanced_options.html
index c05abc06..b1bcfb7c 100644
--- a/docs/notebooks/DiCE_with_advanced_options.html
+++ b/docs/notebooks/DiCE_with_advanced_options.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Advanced options to customize Counterfactual Explanations &mdash; DiCE 0.10 documentation</title>
+  <title>Advanced options to customize Counterfactual Explanations &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/notebooks/DiCE_with_private_data.html b/docs/notebooks/DiCE_with_private_data.html
index 875e42a3..02c749dd 100644
--- a/docs/notebooks/DiCE_with_private_data.html
+++ b/docs/notebooks/DiCE_with_private_data.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Generating counterfactual explanations without access to training data &mdash; DiCE 0.10 documentation</title>
+  <title>Generating counterfactual explanations without access to training data &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -378,7 +378,7 @@
 <section id="Generating-counterfactual-explanations-without-access-to-training-data">
 <h1>Generating counterfactual explanations without access to training data<a class="headerlink" href="#Generating-counterfactual-explanations-without-access-to-training-data" title="Permalink to this heading"></a></h1>
 <p>If only the trained model is available but not the training data, DiCE can still be used to generate counterfactual explanations. Below we show an example where DiCE uses only basic metadata about each feature used in the ML model.</p>
-<div class="nbinput docutils container">
+<div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[1]:
 </pre></div>
 </div>
@@ -389,15 +389,6 @@ <h1>Generating counterfactual explanations without access to training data<a cla
 </pre></div>
 </div>
 </div>
-<div class="nboutput nblast docutils container">
-<div class="prompt empty docutils container">
-</div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
-/mnt/c/Users/amshar/code/dice/dice_ml/utils/exception.py:12: UserWarning: UserConfigValidationException will be deprecated from dice_ml.utils. Please import UserConfigValidationException from raiutils.exceptions.
-  warnings.warn(&#34;UserConfigValidationException will be deprecated from dice_ml.utils. &#34;
-</pre></div></div>
-</div>
 <div class="nbinput nblast docutils container">
 <div class="prompt highlight-none notranslate"><div class="highlight"><pre><span></span>[2]:
 </pre></div>
@@ -510,7 +501,7 @@ <h2>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:02&lt;00:00,  2.36s/it]
+100%|█████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:04&lt;00:00,  4.10s/it]
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -585,7 +576,7 @@ <h2>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set without sparsity correction since only metadata about each  feature is available (new outcome: 1)
+Diverse Counterfactual set without sparsity correction since only metadata about each  feature is available (new outcome: 1
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
@@ -624,50 +615,50 @@ <h2>Generate diverse counterfactuals<a class="headerlink" href="#Generate-divers
   <tbody>
     <tr>
       <th>0</th>
-      <td>21.0</td>
       <td>-</td>
-      <td>Prof-school</td>
       <td>-</td>
-      <td>Other/Unknown</td>
+      <td>Doctorate</td>
+      <td>Widowed</td>
+      <td>White-Collar</td>
       <td>-</td>
-      <td>Male</td>
-      <td>51.0</td>
+      <td>-</td>
+      <td>39</td>
       <td>1</td>
     </tr>
     <tr>
       <th>0</th>
-      <td>30.0</td>
-      <td>Self-Employed</td>
-      <td>Doctorate</td>
-      <td>Married</td>
-      <td>Sales</td>
       <td>-</td>
       <td>-</td>
-      <td>48.0</td>
+      <td>Masters</td>
+      <td>Widowed</td>
+      <td>White-Collar</td>
+      <td>-</td>
+      <td>-</td>
+      <td>31</td>
       <td>1</td>
     </tr>
     <tr>
       <th>0</th>
-      <td>39.0</td>
+      <td>-</td>
       <td>-</td>
       <td>Doctorate</td>
-      <td>Separated</td>
-      <td>Professional</td>
-      <td>Other</td>
+      <td>Widowed</td>
+      <td>White-Collar</td>
       <td>-</td>
-      <td>43.0</td>
+      <td>-</td>
+      <td>97</td>
       <td>1</td>
     </tr>
     <tr>
       <th>0</th>
-      <td>17.0</td>
-      <td>-</td>
-      <td>Prof-school</td>
+      <td>23</td>
+      <td>Self-Employed</td>
+      <td>Bachelors</td>
+      <td>Married</td>
+      <td>Other/Unknown</td>
       <td>-</td>
-      <td>Sales</td>
       <td>-</td>
-      <td>Male</td>
-      <td>1.0</td>
+      <td>53</td>
       <td>1</td>
     </tr>
   </tbody>
@@ -695,9 +686,9 @@ <h3>Explaining pre-trained deep learning models<a class="headerlink" href="#Expl
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-2023-06-26 19:21:58.438123: I tensorflow/core/util/util.cc:169] oneDNN custom operations are on. You may see slightly different numerical results due to floating-point round-off errors from different computation orders. To turn them off, set the environment variable `TF_ENABLE_ONEDNN_OPTS=0`.
-2023-06-26 19:21:58.443679: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcudart.so.11.0&#39;; dlerror: libcudart.so.11.0: cannot open shared object file: No such file or directory
-2023-06-26 19:21:58.443700: I tensorflow/stream_executor/cuda/cudart_stub.cc:29] Ignore above cudart dlerror if you do not have a GPU set up on your machine.
+2023-10-26 15:46:28.320922: I tensorflow/core/util/util.cc:169] oneDNN custom operations are on. You may see slightly different numerical results due to floating-point round-off errors from different computation orders. To turn them off, set the environment variable `TF_ENABLE_ONEDNN_OPTS=0`.
+2023-10-26 15:46:28.325785: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcudart.so.11.0&#39;; dlerror: libcudart.so.11.0: cannot open shared object file: No such file or directory
+2023-10-26 15:46:28.325804: I tensorflow/stream_executor/cuda/cudart_stub.cc:29] Ignore above cudart dlerror if you do not have a GPU set up on your machine.
 </pre></div></div>
 </div>
 <div class="nbinput docutils container">
@@ -714,10 +705,10 @@ <h3>Explaining pre-trained deep learning models<a class="headerlink" href="#Expl
 </div>
 <div class="output_area stderr docutils container">
 <div class="highlight"><pre>
-2023-06-26 19:22:00.996181: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcuda.so.1&#39;; dlerror: libcuda.so.1: cannot open shared object file: No such file or directory
-2023-06-26 19:22:00.996275: W tensorflow/stream_executor/cuda/cuda_driver.cc:269] failed call to cuInit: UNKNOWN ERROR (303)
-2023-06-26 19:22:00.996300: I tensorflow/stream_executor/cuda/cuda_diagnostics.cc:156] kernel driver does not appear to be running on this host (AMSHAR-X1): /proc/driver/nvidia/version does not exist
-2023-06-26 19:22:00.996628: I tensorflow/core/platform/cpu_feature_guard.cc:193] This TensorFlow binary is optimized with oneAPI Deep Neural Network Library (oneDNN) to use the following CPU instructions in performance-critical operations:  AVX2 AVX512F AVX512_VNNI FMA
+2023-10-26 15:46:30.666572: W tensorflow/stream_executor/platform/default/dso_loader.cc:64] Could not load dynamic library &#39;libcuda.so.1&#39;; dlerror: libcuda.so.1: cannot open shared object file: No such file or directory
+2023-10-26 15:46:30.666630: W tensorflow/stream_executor/cuda/cuda_driver.cc:269] failed call to cuInit: UNKNOWN ERROR (303)
+2023-10-26 15:46:30.666650: I tensorflow/stream_executor/cuda/cuda_diagnostics.cc:156] kernel driver does not appear to be running on this host (AMSHAR-X1): /proc/driver/nvidia/version does not exist
+2023-10-26 15:46:30.666896: I tensorflow/core/platform/cpu_feature_guard.cc:193] This TensorFlow binary is optimized with oneAPI Deep Neural Network Library (oneDNN) to use the following CPU instructions in performance-critical operations:  AVX2 AVX512F AVX512_VNNI FMA
 To enable them in other operations, rebuild TensorFlow with the appropriate compiler flags.
 </pre></div></div>
 </div>
@@ -755,19 +746,10 @@ <h2>Generate diverse counterfactuals<a class="headerlink" href="#id1" title="Per
 <div class="nboutput docutils container">
 <div class="prompt empty docutils container">
 </div>
-<div class="output_area stderr docutils container">
-<div class="highlight"><pre>
-/mnt/c/Users/amshar/code/dice/dice_ml/data_interfaces/private_data_interface.py:382: FutureWarning: The frame.append method is deprecated and will be removed from pandas in a future version. Use pandas.concat instead.
-  temp = ohe_base_df.append(query_instance, ignore_index=True, sort=False)
-</pre></div></div>
-</div>
-<div class="nboutput docutils container">
-<div class="prompt empty docutils container">
-</div>
 <div class="output_area docutils container">
 <div class="highlight"><pre>
-Diverse Counterfactuals found! total time taken: 00 min 41 sec
-Query instance (original outcome : 0)
+Diverse Counterfactuals found! total time taken: 00 min 46 sec
+Query instance (original outcome : 0.01899999938905239)
 </pre></div></div>
 </div>
 <div class="nboutput docutils container">
@@ -826,7 +808,7 @@ <h2>Generate diverse counterfactuals<a class="headerlink" href="#id1" title="Per
 <div class="output_area docutils container">
 <div class="highlight"><pre>
 
-Diverse Counterfactual set without sparsity correction since only metadata about each  feature is available (new outcome: 1)
+Diverse Counterfactual set without sparsity correction since only metadata about each  feature is available (new outcome: 1.0
 </pre></div></div>
 </div>
 <div class="nboutput nblast docutils container">
diff --git a/docs/notebooks/nb_index.html b/docs/notebooks/nb_index.html
index 200a1ee7..08e4799d 100644
--- a/docs/notebooks/nb_index.html
+++ b/docs/notebooks/nb_index.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>&lt;no title&gt; &mdash; DiCE 0.10 documentation</title>
+  <title>&lt;no title&gt; &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/objects.inv b/docs/objects.inv
index e793dd8a862dda9a9bd2453c4b48658cca1beedc..7743dd0ad05957f2e2254351b3fc00458bb64bed 100644
GIT binary patch
delta 9620
zcmV;FC2QKUOR`Lmf`5;yJsZcwOsMOj=#b=)C563Yut;PkU3@jkEGfO3-<aQ<FBv@e
zCf>wF_C~5CfphLX1i=ej5=gTIMMWOe*S{21ddX4n??K9r9nM{mzhOtie+$At496eh
zE+!R{JZ{_I?Xvv3;2}jxmZB&t>KqlQ?BXt~%BZ{6h?1i2Tz{of5d6O$8~%Sc+ovi;
zxfUHQxtlMk%C?Kkt~I&>W39t4aq{w5rr$7Ot7SI7>fznTkED9sbxrns>5v7)=WACr
z$$2l#*Owf{O}Q858!FqXIp)>(x9*_sETCvRvAI4|Ma!!*1Gp!&*)c=SKAbP;)Swot
zVFB|s#y3e;o`1e}P28c=)liOg^}~BqqAp7uSaNvZ#A$}_UKdy&(r*nyE|9*&Wm**m
zNSCrh%`r~8OPojON1ewd?T<`57a`8!esS(`MWJyuZJ-ay5f>%upf<|0mR_d1scO`8
zR{*+WQx(xa+p5&<!mU{HD#4}kgQIHj^=HpGK&P-DaevxBxB+R}OHstl)t_Ho1%Iht
zvlbu9{)M8rjfjZHCN7Xa%Aw7x*@i2ueY2Aa`T^ZodUxEDP9UVh@lqxPK~*KndchFC
zPg|9dx;-!V9JeT19(0OdH`y!h)csQ&KC{E3OUz~4M{`ITL`qa=6xA`lQ(A75fMCWg
zvaFhd-G4aaz2JlSm~~MeKO=mHmkExS8h=jH$5o2^-3)mqr4D<eJfSX%^PIYRjgl%a
zaVOk*rKhJ^n~siE6P^0FF-rSEsy|C`*NNMCR5$pKc8u{n(&I*+`n|^pF}u6cC?O$o
z)np`wI^yo;(%^?tnW7(_TSU*@MonCv{5FB!-G8V$PFCP(=oN=wp6z(W-5u-ii>!=_
z_{Y=>-=K*Uaq71XV5ff&uYY)D{k_Qjiiy+l9`t`3Fn+HW{YEiHRifxz4Sk?rZv33V
z&plk^NFRKp@li9f^5ory-!6!ZFzLLB$H(rHmUOl0(GmIOInNT%!2yrq@R=TUH#AU?
zfPW1PRJ>5b0u?XVpg>9Nen_B2>2g4zA_N@{=#cvu3~1XSoOuD_gc^QmlDi&!=+OEb
zdgxdKGVstLh97q5S>bEYp<|81=u?Z%@qj~z^Y<b2Z<o02GLi?P&zr7^vl54(zRiFe
z^XRjCY;!jWp5R71DrWexj;;kxMmm{bEPo*!JCOHiwBNcJOYct!O(5DSp^QBRmPxkO
z&|NOZCOOCQ&zhQ;K;q(UoyS+vaB?raVLICo9S@vw$ZL?HG=n!v?;2w7N$c*R+AkK7
z1Ro?ZP{&^B(Yae_?l~(_qspT43JUKZZee=z!vicj?RFT+`j!-P7=j<tDr#|G+<#^r
z9%P<T^1{7x4*4!MehT0rMhi@I#DP4w<AkHck2QP*k6lV{L{Xbm4Y-zM@Wa9~5Teuc
zrW@4V)KgH0W-r#czOOhmhoma%ONXMoYFkM8xTJMc{m2S(bKiu1>{@QZe)Y<Vd(saN
zxMbG(q)d*KG9ypl*~^fg*onZm<bS8rleaXWq3^Kzz3SecY&>$4=>Z6SmTzEFq&FeO
zcU<e4m`xFQBQ0=r=8X(EW|C7vMo&EEOP!Jg;rUvlhIU=36D7^|($~}1Do`<1PeDEW
zeEl}ixsItgG~*LK6%93ENy(@cG^&x&--Ogd94Vu3(CL!LP5*?yjSW|?tbhJOI{~}5
z&`!W#)g5kd|DqLcWJFy@ZFkL)H%4!f9gm!5-pHqLQFZBXi}yx6USAa5Kl$?)IP#EF
z(#*>+I`+oj;HH&E)$s@x#PV3%uBvf&Qq|rVJ;qth_z@#in8g^Vf72I}u7j)%3GEJ&
zs_e4zQeE1po$^CK8m`G98GpOw*V9m!Zbn1BV_#Z74YaN=qJ$1UV%8%EkDPVP@DR-E
znBgm^)v@Jz6Lx<=uEGj$!LGs%zd^6m7|`HX#_TN!mKi~2Z^$wQH#fvXa4e$-4wCh#
z;e%zF9q>W3jJ-{=`a1OsH!uJ+dY3Uz=Wgl0$FW4WT!;rgD!p5Idw&NTm2T*KMx`=x
zk5Q@EjGK~s4T;5O_z#K2wp?$*ev6QpYsC#hVy+#x3W+(!cnXQP%r^*$w?^D3B;Fe0
zH6-5BdkcwW)ILMvtsOo?;w`(ch;+;BCl;Izl4YBKBEcoe;c@u+OHb)A3Y1YDo-bLR
zk{9Q?epNv@C0ES!ZGYzoUr8MHbSQ;+k4eLV)pz&w<tl)iT53uEZ3~V(ZbeVttb)uw
z>hO0s+Gw&<R>nE|)VuX;MT?sL!8R83Ye5w~WAAZuY*9SCJ>-!*$3NocM&xzXVzOj<
zXBm}eaz_^Z!l~YD89%yStTE}0-dCKbFk<;K0{b2o=5;-}A%A)GJpT~>HrFI8kN89v
zH#94IY$Nt~zNrcRpO;xXKB2twvZZWq+ysiOO+el=m$JeQb~I^02Rc$4*dPbT1mhwg
zUg>Wg3$&=a)P5PWQ&G9Uwefx1X3sgIl(_eR8c}U{4p03N;@#ihJvts%DfvKWmeuUO
z;s~`RbQujWT7MR%#5I{hhi+PPuF*}pf5E$vAEJq=cy~)&4EvI3uWLYS80=><E5Caw
zhhm1J`*k{#Q1NB@x{%!a%?jUQ6<q)y$o(V~oX=nkO(Xx)Y`==l)o@8vUW#FWQR0KG
zcfvbxM#*%FE1JBD(^=bdK=Xp19PMl>7NlkKNe&;#;eTn?*JXn@U<A1jO!=X14^unb
zwqX-?_f5NhUmc`HFR%~&+wd+Mu$Ta(y(;LSnx}%+ZEKW}0XM!SSxc6He2sH@&XTW9
z&ZyvT(85j$oARa01nXMSGxB;k#!OJ%4I}hj2#2rNwnN3^9C3nw%LCn_ol#y7i9s7{
z`ucP$ntyLiT(-xmV8j3QJ*;EK3I<2@{lbQ_Rf=tZXNmca9c_w;#KsO8*n&|byfb76
zh;+qXd_}uq<-21g7#tYFWhEZT_hDBZcjvvRG>F5)^X;2Pdy$h%+mWT2vH$HbgHJ4u
z>a0d2y8}+pC$Qjo3Vda<aT*?$t6|#`y1PKHaevbST_xViwd2jTyOGgH;^MC8z1R)f
zE7PI28&+I}gLTkK)#y>%HBbz0TE89xq#thXEEcHsjUD|)Ho|k&esHi!n|WE0wf0-`
zO=f;6N*DMrcW4{GBF=Nm2C_t#CeBOLeXp7q`)Fzjb9j3CEBn(po)Q5auyEhwCN&Qo
zR)2_}#y0QB#0{XmsqAyyh`gDRbtoaJP{|eHlvZ3NUX9mSHm3=~ba;2^sz<h+g;;$d
z=?=F3Eu=<rX+UUEc@tW7Lj<8^Ykfy~_JSjwb5(gapf8!n9ob7mxUd(X1;eWHqMer=
zQ{O*Dg5)O%(U|o_`E%t%+Md?q-P<#Iynk_fMvwPw&v=vDwdcOgo!XPTze$JpNvz|j
z5#jJa_9P+`D8J5k^D+ulWMI-&(O0N{5^WUFv|Z44>0j8MO`&{8fk3zkbDX@yCnTkL
zL(YXo9+Gq6bS~^G>zkoO+HI!6-f;b4x-o^B2bSA6+gFA1o3o>v4<$IXF2TUm+JEjt
z=S8h8txGU4wK%)yd6A35>l6)6u=%ckex#Z+I>LdKhe_g39LC}V1xy&hPKsVc5^y_5
z1Qk!d6QnmC<z_&F!>YU8Yto;jTW;rw(Be&dW%`tDVs(fGDwWRup57GHF$SIjRPWUe
zrrxAo@j68V6->7CsyFpyM!-P>>wl`=OV*>lYGdFjK=r0OmwFSFvN^zjm1Nw}*PkvU
zr7Iv%g?<+|C*VzatDBLxSCKb8dF1XPJ?Q7ROPg^zLjn`&7BimiraL{&b@Dd5_M#Mz
z*ex8GX0mO%y=W&h00tIZ%hiVCUS(WyJ4XZ)Z?!-b9<roIKhklT9phQb#(&-7o*i}7
zyKyN#)1&fysiGo`$1u54g)1hRQe!9}oj|grD(4Jxq{dJ{I>F>eRo<CoN6oRIq;i}Y
zRXV1X7d1hF6vkOjRLdbnMpPdIND{bgsLD0dT&Nu$plslIP#upgv!J`7p>?IJulUrE
z61stb)CMFwtmU0SZrBbFR)039d0|ZlHL}8{NPr@F$_VRtyel8<hyYM&_qkvlpLH|A
z=2(DI0cU}Ae6`8}?*s-_)Jy(XPk<fSUq=LhO1nyv=y)nmkLV&mis3TntL2Y6<7)&1
zsLk)-Rs_2RZ*%MYc8SX_%W;QFN6^FPQ(h&N+5m<OC@N6$T*qUh)PK1pAh>cqp9eZg
zb2A(udHhd)yPEm-GVKkNDp&btlqk0V15yh(Nv?9#Dn-5n6j(*~>2Y0Ob(7<EcyihL
z51vKe*6ORE0Q$r}x=yN+d{Ex*F^a9jyFBR3P%gMhSq8t$KYlXbor?l|!{RO+<+W&s
zesbZ>O6z#pUY=PolYjeVR_W{b=fuNZIbQf#zi^#-X^HKZ^CH&q+x)SB_NV^hCGfQ{
z9ojG7`jG6{&}9kz(f@7ZkRA!yTk(BQVpR*u<>j^+KKx%Y?uP(ZX0=<iSB+NOF2TTc
z8@HD8FWZvZAr`o3SN~#N9f))V6^Fk~xEGQ5)DE#AMSDrv9)D`Sl=|?%`1S%oYQo*=
z-IqXIa;IpJ($SY?Zl)cd-7OrXdQDuWRpIxBoO8MW0n_K0mFZ^dG%qS~ncYEwDQ1+h
za4niDXW;}5Ogi?KGJEaFk6sJL{SaQ1A=}>iSBJ8?fdN*DP51j$sAt>{0j5k5cb*iX
zO!ig56qs!x?0-dv8Q)$251I^nntPUJpml@;Ce)=)$-MjdTBC->r>GNt2;^EV0k=yq
zC%V0)^#7OCy(}Lds1qL^0)w({og(q}IN_9>QSt)lCWmZSZP!v<>O3QFFt?x@Oe}WQ
z9DD6&Bs4i<IsTCYIMxL6p*lHY^eE+31M?c}vB~p7|9@dAsqI(_^3FILB0_2~W3j8|
z#Or?7O8TS!+r85R32~v{7&EY{1?BRXSxB?C^Wy)KaX*9yWystAa0xcKg9~n#VBos>
zSIdD$UX+2(bjutx&UEX8f$P?w(<P6aK8tVz@puL}M+BGg>R-641F5c{;&{q^^BlCz
zeQRSuiht%O&ns}%GS6#(1}R-tcewNX7p-s`{lpfyhlEqIuA{cQ=E#$5Bi+vWV1oFW
z+Ti(SImw|51*X_(*sz-HjEf&Oe$?8qx`6>xX}qC<a+W;jW}Np=wryz%0;Uh-^cl}B
zqlq**fCo+JXGg<Cwr_!!<WAARq-${Jmqyj`=zs5STT(i}028O}su~AuRqaQZiEd|o
zFhP9fG<n`x=QQ=foan~hu%myoKi$jIQxJ!~Fba!0FwW9IfqW;Jm6z($Mr@nc)`JEj
zW_M74ig}i4uQo0P=}_5L%`vaOzoiFezun6*CnG+6qraah*{<5qQUIq=B%Yb3Qgop_
zDt`u>TG4aZFvVgH>P=7R#Db3N#t8;<P;YvANjT{EZ<lzmMD`}{^>%_@9ZGohBATZJ
zh0I~wM1?V?4>A2DE)=d?CNL~eeMsstp`lP<Ph!Is8eU<zM2FO8gM^0`4!BT$5+E{P
zEfXQ8kl;#^m(Ck99dlDPg;v18f~yLhNPm$zZJbci2Lsm)GQlEq(<srR2jo#J;KYlb
zzorQo3si7PffF(^mrWBh+F0PCwMkZAr=ZERZX0&DaPaEErMaYj8l=0laKMF{{=QjT
z<C_402`;9uT%yc#>ztxFsAE0vR(jq+3U{~i@h;d^8(Io)xsr`%_PG){lt;yU<$p?K
z4qN9+bV0r8c{>#yYUfokf7vCm!#lD|x}e_l^qgH1`@c84WQ6QZ-s|lIy*iZe>P0l~
z*`=++`?E`$m_Eexon7L(zB{|5jp{?vn`D=`3b@HGnL)!V>?6Cx@!2Z7B*6g}%6E2Y
z>+A09k{%?ulDEh%ZC!VgUDAgISAW%Cc4_PMj_i^O3|u!q*`=+Umf0m4kVmb&WtU|B
z+Gm%vQNbnkmR;JqY@c0HV1bL~B|oxt(k?$D!2uV_|CIjLTL)A6x}baYoDPz$sHUIf
zms8PJM32MIUkH(PO-T0-&zCGu$({#YgZzon(|&khw2p8<g`$f!Mz~!TS%24|6ky?S
zsiS;)$9NtDT<*HZR)BLIYiKwwG6M(~RM-?H8C|^l25NG+U4lXDMixB>TPi~3>xSGZ
znh)u^Dyo|7l$CKFQPo=S0&+|MzyubvMNL069?$p`l1J|t4_3e`dd3$Ecf2i%U9bEp
z_jS$e4hmYa9RG-$TPU_<c7F#2tyo>P-MLDp^}A7dCQtbSm7P}srG|hZgUUPXVUrbg
z)kwCMhESBl?Gg-BH!qX!Qits(+^ryim0T{o6&;(ZfLKFZ;kv{M7+6?U^XeH#QMbIk
z#U=n?f{K}yM|`4-8@g=Dv5k^EZap?m0l#ZNzZ!a;#}V+m287kH9e>B@9)+8cIza)I
zD6f(mcY8t$+(UvYS!8YEe*aIYpA)463{Y`^vfNV7bTizVAfEJr%WP}<X^_>nK?IeN
zrGYy<K5S5uwOQq{xpBB%f`RIG(|J9&vwFVg^jg$iYM){ex}Ei51<6iD<ul+K2zMjw
zl?4YJZT6faN`YfHG=Cl;2k>vFnrzvg`Xj`rzrTA7_EiU01MZtBrEdlwMVVp2i{@n_
zP3^SZY??hTys%w^D|uFtak>C;rVpEai)-?A+IW;6WXE6>TCffdej*3oF;+J)-c*8Y
zO)4jiT9qD{hHe<>lA};o&QuN^$WOFPK-OkPW!Jhfbg}g@fPd9XeEpIP+NF=?8!c-?
zYi_g*;FRUQn#TD0CEfdIx01XmymmqN4(?d>+ls@iG^D?G9{e?2u*0pt%dr@Qw<`vd
zvQ9nS1aA<|Zb=M_!?-+;EI{2}5Lr~wcE7zmv$DpK%&g|u@z05onX_c$Q*25Sc;VTg
zj+2*oo@C=O(SNWrEb@?^45yP}U){hIHI@TgxhH9Brbp?Y^e<DxRlsD#MPuW@sI*I$
z=o=EJCQdWq%UllpTe8?!b?$k2DTX&gN_?<|Rba!m9|ByFJHL|LInd<JxhS%i<XtJT
zdKccbqEnyqDo!KVE^p3ZThZ3%7u3Y<EFSGC=;7(8JAeNLd>_c+=_^3RlfVGPgD&o$
z8wUPqK2B^AeaQ#%@G*5-|CzKG*_W&iJ8M&yReiV}o)6(1_xL7`>O2VS@N9+ar`dXv
z{+By(mhk<Kk&515T*tkW?)!GJ^_pF|CIFBYARV>BCH;Qc5C}*khrO=CAyp@<RUJSD
z$6ctz4S$^;Q>!|F3N4lxy~a5`2Q9>sY&U{Jj@2yUX2!|DSrwEp4QXT8Y#8Ox#yP4^
znf0`&l_&f-z@=9L2GjCRyj`?gmrgE$HH&Gvq?*&_+pCz*7EWK!XREgpzVo?g>D2RL
zrg=57EQTe2;~SK$c+ruTp1hzk?XI=R^+hi?Re$^iS9~nfZ?vNPw22LeIM1!^IK2D#
zF;EvVvPYUl*RkpIDorjgW@KCYlB2jO?QQ$o1LzeqvQ3$|*0Jv!Co`=sYH8=43p?-h
z?YvXjNjn|$JCjBTqWf|>sn2eFPfjF)J91gTz!LhwVRp<!FXpQax}Oj<%Ndy0pi_fd
ze1Cmyt@|<p=oM4hMmMC-%2V5sw@FV|BfGx#mA?*^)kRG0IY{3w)3odGe)S5Ox~RFG
z(s>1KL)S9~8fA@5eM!Y@!|59OA^kRA=uKJD*htxnTe?PmS-zd6EGaT_{)RRCT&85p
zey`5WPia{$2EJdMdz=IBtM1arLvqALi6fS%jq<GRz?|MPImUA;3tf!ipKVpb=`m5b
z0&=PV`?6T|nUf0_8Cy~mWI-$+?SjMQ9MP#bT?O1_3<PdqocjKnwHNj=YTQPo*&WGJ
z!EjOt_&`wMgo1tIZmC=Y@|Dr-A0OtO+=H;EB51mhwCn<RJfZ*}Ryxf{Kta}4V;gFb
zF_V869s&{blb;tXf63f@j=Sm0*^ooaZa(0;gY5zBs=4q57jJPde~r?kbGPQ$yAhl?
zYcjMmv~)Y9vjuSCY29RHryFA!S~|ntjo`#t{ovcs&UMgjSKWz^)<L$R&5GdK37UIB
zU>dqOh~5iirT}R~_+W|8c3P<sO(3)4e48b20W3^fzDc-xe@Acws2`avit`StSuA6d
zPbvuAf-(zr<z=NguWPEMb|A%!Nk<U9;!B&CFONuUS``$&v&4DTWlS+>!_TU0kE~x!
z;W7#b<0dwUL3GM!*r^zU^GYv%=upT<BD~UzA6gXLe$IrI51=})VVmkk=N4c7;<2dS
zeA0Z;i4^Hye>qYBjitU$e@{?taz;fges!upzxdvl9oxR~G+~WzNwGun*Q#a|qIw3*
ztIN{YP!jX23Hz!`m*tZ0rP=9)X!Ow5@)2lsogR@ZHo*&O8Iev$(2oSwqzgK<*S5pG
z|L|MO3?9x`it{+)XqHo(dPaGT?`+zcbxmBh$EpxTe_}#A2M{v*^=$&tDP(Km;fPR5
z1Mi4#;MY1ad5daQ%i5{g=C%FNrihN0GI8Ub7=B;%9saV%$_VGm&o!)FHEX{d`(x;b
zh5h79jTraQ9c#u}d8{l==OJmAv@tj<6YMp6X}XTP^KQF0fTk79yrA#wpHN8_j34i?
z*y3rSe+g<+$;_kV(sorruWCDN2tss;>a0d&E2SNdsj+v|b?j!p(H5k)1I2y_*S;6{
z&d4MihdA<oM&ky?wGREOwfk;oBN{g_Ryw@KO$&P8s|fZ2=zBc`3)LB)%*v>Ue@ubH
zp6*)%*tVj+cl4XZ#nY|V%+e__o?&@I7y7H-f1$R^%99Hx1c=5poH(-Y38MjQThXO=
zQQI|O9#Zf<mECx{`)R2OzNfNlPl2xMieN8*8?Sdq0h-`@DjRw_JYvvqWZvCD&&mfh
ztzhUyb?NBirL4LLUveBLRQaVSUHGGdwy&!1qx0y*I4W@wjkNJA;*7N|T@axel~x;H
zf1*nh=OyaCSItX%I3D{y4Xs|mJU#ujhtVr$Z|4DDsPA!;I<j|!Gb?Uv|I~Xs(fiW~
zr=|O*_<sA{T!)Qede=i(P3_mXlhYx+6vdTvUE?|ghQ3Tt4+M%#cm6s;=@;E+v;1W&
zE891(Vd+=l`LfErv80vCT5ctEzK&b(f1sb}QdAcmUuS|9_Vk^&oi#&c{!v3qmiLvN
zK`RXDNkj9-CTC~aR9$pjY>z6DKjT)U^B0)%r2Z0Ap4#tSp>MoJag&_04kcu3QdQoX
zS7n>a<`omAngvFzve&FsI4`A>2N#)ZfDYoAywqzvELj_0x(eYCEtTi5rEcnSf4#$8
zk3E-VJzxpQ`)9tT7&&*=hnD6Btz_ifSsz*&jbPKcH2g@^xIVNrB^kKpQJ%e^JUdsF
zUy-)#&XAym>r3V_2_~aNxKJUGavXYhP|(`Z{oAtg<W;eebT0seI>}MI6OThZ?w_Lh
zCan5Z;CvppDn<Eo<w<}g=g#_of71Ahc6zUD0-a@5KrMWQH@!nPk<GFypccO3ncg9r
zP-a;bPz(P7Oz+yh*hK^asMHN2mfp*q!HN(CP%LjDO7EOibh4_eD+hnJi!-lb<GVJv
zVmfxO@smuTZp>&*%JOFpMLz4zCJKEK%rItUihgXT``BSRrT4%-kP4RHf5`@m74rW0
zkljE26yT0N`1ElG`X<S`&HXcB52x?xe~Ws!K{VO(MP7Se=zjKNj?{nO6)wN;3g=(b
z(F+`6<HPk=iZe1(oL#c9{UEbE>#kvSlyM5}HGp`UiU!p&SQZV?VlBhT#uMs@)?wSl
zO^4F(d)A%9?H7SFlf*UNf3q_|e<mPj0wT_w5dW2t4IAS!4ZHYxb0f@{I7NSDhXQ;k
zV2762m^vpbRLWggm-}`69X$NHG`FeZw1{gV)NuX_`+r`wz0_pIGb~Yox^tDbv{8|T
zS(}(DDE%68#$gQfb*K>Z6=>s}Dy$ku%eVSM?vuDhI)+VUC+_jse;mF$qp)tOBEu&w
z?+F8lZ)X(rMV0qN-<fWE(c#2AHL@r^Bp}4q#u8)ovg*)tRlT%-dd7o{a}hT$^sT4t
zcti~iijMPdg`@sL9<uscJ}-$Ts9*R{IJV$HQGe!Dg0V_)|1?);Xhu8DelxEVj&;K1
zIKOH`BX{TIn_u|6fA>#ZUayk$HzksH2D`j}KTzDSD25ZOr`v9yrtk39H|Nj=fn4QZ
zO=zdW>t10h?CKhmSLSHT<Gr)D%jJ(N<o<UszK6HZ@L@C(k}h}Hb=jf$-{$zAKKA&-
z(EuOC5mnH?&o(j9P83H*BrKjSE2`)mNg%?lMf<_Ww#y3ke{iHr+0qE(lvmIA&%RPH
zUw<{J8vL-kv@~X*A&#znZ~ApzsMD*4$~L14yDHqi$)oAXn|p2ez9iLobrbZPYIRk>
zUgoiKj#Qm-#v5~<|B1&o`@PiUnY&B<pPY<0{?jT3extGdgtYz8pp~_su&)(PwL;c@
zLfU>fv8t{Le~&v@39`>--<u^`#8}tm_Zt{?B$%%+tZfuiZ7Y?XZ68Hw^aMvx154`$
z<yk>K>&Q_1mvDHdkoHe{dwS(nU9{Z#&r61nJchB8UKSo7JmlV@>&}pNB<#EUA!O7K
z6gB$obq(5Q|Lu|`FL-3oH8|8x=o1^?%feyKBHov^e_^h9Z)k1yxQfGm_aY6sd6vI<
zoMU}nU`?lRuQcp&WFX_x&S@7OC#HT|!!4|x&Kemk9LR>ll5@KKB-erWy706^d@pG|
z{hFc1EobK7&^N?gKg~rZoc_4(yMJ=!uo>N2fT6#d*AD);eop*kA&BA$W#O|5@x9`i
zrfK=SPury*U8sV3vB~rP_1yw$-kH)fym(&INUcYL(!R0VpPOdZy$c_;*4O-_0#NkO
zHM`;kE*s+F)ul<uWAXbr?*8w8{<jTF^rQQ4bE`kClXoB;e>e}NVTI%4FtcdOg3w`2
zI5eXTp&*)whlWqPn|N$-L0>;0^@B|JzW9yA3*kIoAj1XO<7bu?*wZ8bZ9g&XoBakn
z<VAf#%_jH}szbV4Avr{^0)CRr!V7YR`>5zAbA|q)=9>0(r(FHEy*~wgRhDfaRfC}_
zYb^MYHC3eze`%<?(Shwo8lTDv4~vp0IqFO)tSa3<^)m|Z^)3rFJ1(!{?o?#eo41FM
zOpDhD|5J7$+xjaUwge+{<9+AX+BiVqf7OJ4dkAJlgJBc0z9^Y`AByUGcXtT;P3*!r
zKUEFZsj%_`1NFPph3`h7yF)PSZZ{s(x9#Uc_}c|Fe^=JYy`<rGXE;scFw);9qz?}v
z-5>7fLogi0-QI_Xfb9jRYhH4$s&*d#;R|xIYz6lMtl{|hfMv(^jT~pb`8ioTYu~Ft
z$2sr5z%~_TXuqoarac<Izx5(9g<slaW55RA3uWnBE0;*UajG{C*ysON{CAf8cMe-a
zmi}yMf5p#^RQR(c|DT<z@E?{|{73K=<tXWf!NvG!!2!-IU9d&h2F+}X)E<MpirkoX
zaEcD29CXKDWq@1>jXP$p%`J&oUpH&{?6G=+bam;+d{rE>8);vs`)vca%~5IGveR-c
z!!FAS%Z1@6X|}wHPN=C1B@aN^>mU>?WXtX>f6-`=JX^Gdh0!}56F)E6>nt;K!X+FH
z_b0f1K;TX&@x#^9vfr8TQ}LDg4ket{VF>S+9MhR#d1kL$q9u!V`SE1}{W4p4Xk{sh
zmZCU)C9_FsRMl*wKK1>}uSajzcm2_zKT0}3*0YdT6eO=7nixlhbkk&zNf#-$oM3)j
ze`AjQBpw(}lR2uMQf4_G#3g6^Ae)awzN74P?pj;JG331n5)TiDbK`TgKWAh%9^Q2g
z6Q?>J!)MfeN2nyPul>jh@=_=1L0H&Dew`}Sz(?W_=K5yLg-4owB|J($27RSqtVFw{
zu~I-Q87VLv4*SF8p+7ck{rCU$Wq2nge_Y;4;o?PJKlk9Saj(R0_d{Qq7ba1*#Awq%
zn?lu1_KN+WtBvXQx{Erd^K;du3*scfPXp2<rtdrG4ySq+zDd!M1(Rfp=y1EOi<Z%E
z9=0gMA@a6bY-ZCeRb1oFZ<v+m&A-|h`)B|^OC-<Aa_4jRy4Su?K=+QVfCVn~f2B;F
z+23t!{Q&AR#MbM~U*VfAWH%e>xyK=$?H%*p4YTLoLN%!-aF$e4U$X|qX~9_?s6TG|
zz0d^9{a|Q@zW!opUQ_tV(4xNho1q!ju8)T1bRNDMnwf3;+0fi#pznreR%(7YG&joX
z%b^*i^z)uMk@EYV87TJypE=m(e+!>k<$a&{%vn5q<HNOE@R1MSG{sjwGXmSseCE6`
z-}%h<F-)suy_4GTV_XPqzMEb&F1Fb6>aU6{*HT;8U*q?|3ThN2ymCt>F4CHg&3VeH
z)@7D78-z8*Y)iHku*PO{+eIQ*7|N~J^uCGaqB>X@58sINleJ~@9*#0Jf08o)@rS8c
zZ_BQ)cJWo=@YdIGIKhDXFSeNl^AD1H8@S)RS$^v=$MyKFn)<b8zG1-MiOAoEk(dPf
z3bdRnV&O!N^vxTqFgyRV#F22;<><fupiI6<NSwcGV>wwYGx4T58l9OJiSZy4)T*J2
z${w((n~AJ^jyB!!_Uxu9D$lxAMSuJGicKk(-7brD=9K#eU@am~qNO417(@KZ&VMG4
Kr~d~gzs~yKY%R_J

delta 9485
zcmV+oCGy&`OtMRmf`3m}dp3@VnNZh5(ILqptIF*qgGC~<=;EtMW=ZMQ{Kov=e97R!
zH}NJevNuvC37m89AqZaL5<r?IC@S)xzWk-A(sPc2e-Bc2?C{bR`8#$r{I?+d!*KjA
z?qX6Q$>X*Seq5Gc7d)gW$x;+$MV+Gpm0jFrRT*`c8c|Zzy?<1x6a@dT$A<sk&GxxU
zQLaTtOYY`Ns<Q3kvTKd5z*y_>bDX^1m+2EGY_-hhS3SJ{^odlDyRONe&mFRW_;Ts0
zCVANl^Z1&hxGDF-JfX6!nqyvl`_UcLjRh2KCpOn-s%Uw2W&pQ@Haljh*@yELof_0)
zH7sBrV|<fj<$vk1YvK-_E{1Zfs~<j~5_MVPz>>p<CQdVa_qxFPm_9WKxj_0FmuXcP
zAf3w&HODyV&T$^0?{yxRv_CTKT!c7>+r_#26@|vtw1GY(M_iPsgW4$1T6&r4rm9iX
zT>$8gO;tqyY^zeY3%6p)s|1(E500wA*PlJ(0G+~q#D8i3;0B~=&qWb87k_?r75t@o
z%UXOW`xlDhHX<S(o47#!D2Fz$W*e@s_RUTz=m&IT>D_TpI)RW1$8(tw1XYzN>jgvn
zK5bP->h`?cbKIh6dC)0--DGdLQ}<7C_`(j0E-{yFAI%|Y5Ghf;ps0@Vozilf1Ozi~
zk!95s?0?1??*$*s$E=I;_!;3lyi9Ps)cA9nKCV*S?`Fs|DRtNz<q36BoafZlOO#Z3
zi96xeD?L5U+H`cRn&{NWjZxaar24Z2cb&MMM|Fe$XvY}OBRy{9so#5y5VN~0jS><f
zS4~D@s3Y!f&JBJTl_~n}xkdEcZPdi&$!`<r-G7a$<75SnhTd@a<=Kum+}*MMzR1d`
zh`&$0@D-X!5vP9J0CxI2@%p=0*58ZVZ<sh8??L~!0ps_2(XSL^R3(aDs-X|`%Z;Bi
z__>FR9O;9PG(KuZR-U}u@Y@-YH%vNi;_R_|e$KN5G(P7s9KO(_?xJ%A30Q2d;)ROL
zRe!u-ak-M%eN?VR=`to)5rRhKI^;g$acw(<gC9VgP;UU5<gVj?9a?|Uzm7E^vA+&6
zeB`fZg|E0@#~OzLpcb9um|utU_aXFe=eX=Ll8T|vo34qo5=Vi)&47FD&}aA9=B^Sv
z!M$*(nBiYHbS-f5vXKeiC4}z|<Wm;y4}V|A()+VA6Nq+JCSy;5WuB`wbeD^<$&axV
zu%;#^khpkT=kW!%H(jBO;0-g%hUoa!8Hc<ENkTJtqYSGd_MXh@9;*Ff5lQet5(9PY
zs~VlVg{FVA5;dwsCa<9I{^1s;CqLf7qSJ1Nk*se?F^3`eA+4eo_r-12;g`%8lz+T(
zube}^bB&(@_!XlCCOYCkp4)N4QR2rMK7!v}N?;=LGQz?n5Teuc@fTF<?kT84vv18@
zw{s57A*qV`+@UD1+7?niE@|CV-?M_;Y*(QlZ}qFNU%ay7p6%luE}3;cDU&0m%*fMl
z_I;oyb|UaK`RQ=sH4SL!XPthpx_`GP4UgR9bsd7AjsLSD%d3#$JFfLi%wE~Okrp^w
z@<s+6!^kP4HmMrq?{c2&lqBq4@H>1%yDrp;l307`>uCZ9R7}-VP!GRco(4MCF%^eq
ze8Q)qS3g)%@)iji)yU|tLh2!ol+icnbk5_Zf5KnKhKpBLf1#a#-CJlU;D4{`4mY@e
z(F#{GqOPO1yX43lqqoS8M@}<gWOi6oojcs(y%CSs7e%)Z{`>`wJmi!#6EeIVd*g3#
z(@LZ2cmxY#d8}<$)wnyUYHy4l<E&<!*9R45F$U`2G>Oo4khLM9-9b{7T~?l}a~ri&
zz6MCcH8~_>x13N6b?Ig_)PFlR`S@X=b$t;fbnp?g9yxgAtYe0UU{=QrUqP*oEtjjX
z`wMavR(K0`6?XUydZosI2EQ_9Z$Yrk2r_y@X6|3z5D&qzj2<{h)}w|GmSuLp2hB3}
zHp%MC)Gu7Y0MO`N#yp+7rvDz_CA#I>H1JXB&C1&w*r;?v=QApmk$-!PO2uYemE3Dc
zEH=Y`NG!JHauxP#gv4Act`HJ)?YLG*%rVAONW5jfLP)$d;z}X$))22D@s{3ONGzlF
z84_>p@EH<s*?mQ%TV_A8;B=6zWCRomE=dme!_S|4N{3OPjOy@w&hnIeIM?+H?ZGLz
zVy0goNBBzOu%|;Q%zt-G8Wt=krLd2y0B&ljCH-6z9C=)czC}&nrH=*uT2MvLSxG)~
zZc#jZH{+2!$3NocO5}CbVzOlVS{Icsq%9WxDw^JG8K?g)798|O?<>Ml7_m&lvzeJN
zAF9a>$*br2l<ezVldL@A6J6ZUeB`l>*n{b+Cis6+WbN2Ddw=C+>zZD<2^3kIfP7&s
zWrYj#HEBUZe5nmAyzi=MISQ}z*Nz2R)SYX;jM=HE+~3;xzHPJT98pT#dqBNQY<Lb2
z{So5bukY_2zfdUoK*v<o?7rd%wIy^x2QXR|ro=TFJce#sbFR@%x|sd@ksqRosd#rw
zTnw93XwR^xHGd2?x0sdRy{JGjL(!cl%_LOJkzN;)d%s!kS*)T9-~+jzgo5)KjG<}d
zf0}Jxu(=v8iOO>^ykM00VC$Xm2Aomy8M7;zyo%FV+jBtkik}?qY!DKpW%Ef6AIafq
zywhcaH(&(04@~)?ZVyvC+_qs8cK1!Y|56*IMK7=q{eO4hE*r3z0HnPt=%AXXg4S(o
zl#l^8z9m^p79)I%b9&B_uT5T1!QZWeof0<XbC(HLSfXd-^>B=tpt>90(03sm9xrW&
ziu*a@1pgxsREG9<{2G5-mB;M#D;c(;f#yE!7nIjSy3NMZzCPXa<f)0v_E;5cXkpzy
z=$NsB!GCWI{qlXXwRmlSXX);a9c_w;#N7@V*s@3?yfb76h;&_Ad_}uqeYayJc=0fV
z%gO}X$U1~N?q2qy(f|>^`ftDA*^8W<+m0+ijQwwi>;SPis<RrA%n>+2pB#hdDe#ra
z#vy)Ku7>S@=k5Z%#Z3!zm3Zs3jyKotMn)gEi+{VK_hL6_uS|#9Zdg|o4%R^{m7%+7
zn=%GBEs_OKeIr4?k)6t1>5c<H+C0jNti;}u8G`w_C|%&gwCpy1L!AEJ2C_uwCeBOL
zeXE*R`zT}yb9i|8EBn(p4iNzzuyEhvCN+QLvKf~V`2->BP(pHk5;r-e6|VDYyv4G?
zJAV+S!~1hr-LoA8#HtHPcd#AU5<-pS(tyyS@+!3Ih6qB-mRFAQ>=i$DU#iNx0e#6l
z?#T89!nK<KEf^N^7VS6dnELi15@h*6h{p6D%AYGA()P3-@7|u#<Bi)hdc0?Q#;e?}
zJ@<9))Sle^O*(uyVI7=|2!}he4Gejk|9@q^fs#>xA_J2yM7=`&lW1-BrtN~ZOaH>Q
z$qD6)xCg?mXXE5GJ|QX1J8~{8@{pVhr*mOnS>FsL(rz;iHstCL)4c%9Jh0rf*1jr~
z-<(afd?>-8bqNNh)^_VJFKTURU4ntB#o4gTi(DLDr)Y43%{N-}Bh{SI5e}?8On(x8
z;xHB`C}6?}Hm~y{l7QPeBB*%s&G)?NC^rKV99G@!_I~~(-Euoegcfhwp3tXk6RSfk
zP^ombRP?5xjxq2Qpn9)1jr1n%iq|O`s9>_qF1@KIGXf48SXcG-ogVd78v{=PsyE#%
z(wm@^%>f3iB;zKk{&X2BT>*hA^nbg!IRS6VYu${z?P$E|$s>0U=|MlgUD}M(84{RC
z*BJ41H{9uItdqCDuotCx#BSlhG?VR&>_t170Wh%OTCVnZ_A29w+c~18c--x=*-=-w
zsbUB2z_ucc$1q7h)h^@)DL-Q<Ae}(ceJbY+l6}TdKsv!B`c&STr1{LTpns%toZ?eD
zrj_6`L4g#;S#nRyAw_CW9|K4dxU`<iHPfV?9Uh=;;0Zk)k1f-AyP=_VrR!z*)Q}Ro
zfq~QpB+aSiok5b*4i8o~rwL9?2Q|{0rbvJyc}i{Sc)TmI>4*SOY4=G@9iMemn&w!5
zQURwkb$qo-X6^(ARn$u&Q-4o@9cfHQ1b|Ar8t>QfR6fqHivTHx%jBh&KkC$_5e%R<
zzk^#5>=wMvt@qnGF1swp9V&f;9_9ggl~ig27&4%!Kv`fNkBxG`mVn^O`FtMeWPi<Y
zfaLK%`0Z-s+sm*wP|jE7n^DHs0t`qk;B2qTQL9|<4p3kf-RF6AeSg)>^4j6aW$S0|
ziYAHbtDpe-%w`Xh4d7APwR?<WE2l0GIy00DZc>)P@A8kI&Ufdc0N=2<3rBe^+M%CZ
zc(c+vUbg3FR?OsnnN@lm|D1TZYkdpnrwdmGmzLO00T;23lg!5g+H=;$i<WC)I<#ND
zO&eKbzsnN(qyO8+A%8s*vJc#cp2Vsal*`MF4t)5(WZVw{uFPs@Tdx|exLtyQ>o#r%
z=3llYwL>g$(JubQx;PN&0xAxFOJgr0@u?kRL5lX8vR$uyDfRJ=@$ChG)P%b$wJ(9V
z<WA8brK2CqTunPZyIVL&^_sX$tHSRMIp=f%0;Ugle{wG>ag!kq6B?B=`|QY%UJJ(k
z5MGp_JF|ONhqAhX0al3(lTHp6fBNc0hZ)~q01uiByHI<UW}tP1118kDPRY3Y%cVvQ
zjZaZ0oCxGvEdjSnFekdbru6^U)V(Yp@2C?W?*fCeZk;0W_Bh~_yrAS2&`l26uG+4p
zIM;bbzF=-aHJDiJsyX)B&zsQXh~@i_9Kf+AkPp?#5u-;bubN}8$%oSHf4vCO>luq(
zH78#8o9odZ{on4L9!Q7_{r-J{RV^r&$KmueYdbIgFB$hkcu<CX@(!0(k~_HIb_oWq
zn}4+&Xyip1==844LF4qUJ{Y)e4LY6kxao(^uOJ@J0OyF{GG6=(cX1%q1ymeQ316Or
zwh3QtEJ)G(BsT@FS|&FQf6ySMtLhGSp8uj1uA`sW0{4(`O4fDMc9$G^l5M2hSszRg
zKkxHA-z?wkb)mo%I}Ll^4!gyBQES8M1_n%}*{0qgi8`KhGtS!w+qSd>0n-O^%!ucf
z(ddyJz=I}quFWud>sz2Dxl=SS=^EVmrBQV}`n%hflnyY!#A&;#f5rh@Rr?WUqT5*?
zOb}m*Jf3&fi9CHUC%UoE%IM$hPxtcl6vUygjKZQ0jI%UQAd};=@?4$Uh;7o@deA_`
z><$W0G0!sX)yAbD9V*+ZIp)>3AL)VFZ})P{$%s!+^!EcL+f^G{3g8rq#52=WiY}B#
z#b8q_dJY?=Sj<7af9VOGSkQ6ZIKf~J>P=5C2?rhj?Gg``$lm0=Tu;!8LkTZlMDvuO
zkU4Cds4&L#A*P?ig~D~q1cn8w4@o^HG!zQ#No?3c!z&Dz=#ctsknqsL0T;?o0z~Gk
zWg^5B5?o30rFBDwW3H;E&<Yq>a8;obDKe*x6Ds;(;JQI3e^_L08YNovfIMmioOsdm
z*E9iRfeJ1ua6(4rvT0&Q8w*^tHp%MC6f}9(ZNu&s4qiRDG?&y*gLIb`4!BU$-&bpE
zd=mgL!Nv5IOO$zTol`Uib*$&jO3xce;ciww-UPd9LrdW;SF-WUK35`#@~D`vT#3wK
z>s*O0s5d>Yf2X2D?Yt`HFS{gmct>_g7u1`cp0i70|MzB>jF7#_d%2#V7l#sFyolyK
zyR>z9e|AX|(}$S8vrAmpcW0NhQGG~ymFyB%0XNwtGiZ2)ePow7K3ip%Bskzg`OYqF
zechd1(t`w7@*3Htt?N#*OZu?js`|?=ZJpkcT~dL8f9vKayR>!FGP@)L@~D-!?2^o1
z`|Of7D!8QHvP)Z+?Xyb?EO61h<VUtn+T}+iIN(D0AJX4?>tIM<7j&<l(?PQT()5%3
zaw^)2=zjS5Ga<6B3F-df`JCk`S?IrOkUuec+K+dP))5Y<P;`aD2)D~3>pGMItd=cx
zluz#%f6s$}%dO_v3UIDt4GqUdW&q)W3Y(%NqbpWlK}`;~OE6&FTGaHfB;y&M((&jW
z<G~78MbBAD7IJJ+?0UsTxvy(xcTmuZ<@iV3Ttl%XvpXng#p<f<UaDkTEEtt9q<1Y)
z*?AREY6uuIsJz358Cg+RjbtBN2t_&EF2O)`fAccfDRtOxpwkKxSjpvrN71pV3W#<7
z6|PIHfPsZoHLsrIJi6xXEj9rF6I9HsJmM2w+|cDJj%}3WaqF>h3iw?E`qj|$`?G-G
zH6W~p?f7owQMehY6BJO1@+!G<w<ol~JtU}-Mb;+nHyf1tIZ-;m02K!)yD0TcH?yb-
zf8t3WxQwEvp9a}P8$?hUS^BNR?}rUavNo$cHa8BpOE6H~t~##gc2v*zm|lyzbL~?s
zLbtO%tRUH`sC))o1L1Cjy|Undqs^XkL@99WhQ=f00RHV%lP%jre}wq->-+m)Uv+Rb
z;O3$zeKVMhVul4TnwNnzwbOQ^Y4*7Af5LVRuH;!o#_0mYnLcdvEw0I|pz$a@$d17%
zv|t?^{7eqMXRK~uyr~4)np932wJJR@4c#!%IY*(aoT(f-ke_LpfUJp&%C2=|=whE$
z0IQey`Xw2(OCQa5b=8K}+|?DpDa-u~jq&wMy7$p;1#eS$?Sk$d+_BoS6^B`Ae@K6C
zJosz4P=Z^3m+xW_-mVx-$~yIQ6TCq<yCpF!4&(AXvH*2^L1a-y+x_<Z%*q-^GP9bG
z<DU~FGiS-hr`VJv@WQh}9Vf5xJjupmqG4xP<RLv7PA9{@x`8QbEC;r7Ptw**kJ3Ns
zU#5nufXN#djg14N(k@-1Ur3yqe>lyAA9FeIZ^>d`)w$>8xfs3-De=J;R)G!Meh6?y
zZv0Ae<3N)e=c35=v2&%wYS%i`icWpbt2m8dySzDvZADw3Ur`gcvv{<ppogcU?)(?<
zeI$pc*;k4ufdPmIUEDu64E)o4oY*4zk`LtJW9qd2GififFIgRS)}}72fBJAcJRib2
z?(t0=)p-!u;n@n;53}_o{V#XoEaCf|`V_stxQ=@#-S_Qc>ovP_O#mP*KssuLOZxq?
zArO#84trgNL#j?zt2%%Rj=NBa8#+CvR&@XsS}ZYoi*tGoT8JgtZUluKt5L+wh?9Y{
zDkxzZ(#EjaYm`G9=cqbmf7ZjIR-W+V0GD0~7);AM@pjQ}T{^i0)-0ywl4?wwZ?9rJ
zTR40@AFbXF_|C_or9;n)k>=IFvKW^9jc-u0(m+RAdh&|Ow7b+I*B8CqRPkqA@xDx-
zXhr#H6B`b3o?F{-c>n2Bpe|x$k2H&}W7C&anp|GY$hP)1M{!fyf7|xh1LzeqvQ3$|
z*0Jx2lbKc*wY2lbg`GG0cHXG$q@9lWok=4E(S13c)Mq!oCnplY9l0!EU<sXYm>o0G
zhxuxQZYKoIat7u#=+vMVUte46zK#HT#Z<P@jli?=)OO@+($mGruE)Oe<4{>$#MGXH
z^y@NByAB^#pOC4Gf12AV9aqpcbUk9AQP$Yh*HpYFm#(27)2I0YTgsBgM#?_i(lzqy
z^6M;RNs*EBFRa;gnUXEHygD~OrDeGo_;zvbeh$2^x=SAq$q^SNTB0_}v$g|sdduV(
z&#5eQF@}G(RSBoZMBxg^sRC?fv1*#M3n4a4j`5tzQlKtQ4dX6`lVfCXgyYox_FR*Z
z7Z^g8wP!XNHEtu)?2crKRyZjHd?2WBLcu<9w^XhH`O0Yak9YG<?oQZK5j0&$T6Tdu
z9#Mb~D@<l2pdf3jv5kz#JCo}d9s=>`lM5Iue<$2b$KCYh?3F{yZa(0;gY5zBs=4q5
z7jJPde~HqgbGPQ$yAhl?Yw~JmXzBKq&KAIlr*)H+oo<X_Xz2`lH-Zyq^@DFiJJ&(C
zU3DiuS_j#NHY<W_Cur^kfobUCAbKy5nF6E{;e#bU+i9gnG=a>D^KF)V1+Xw_`6c1%
ze;dIKpnhbwD9$^mX0eP-KC2*f3(73im6w&~e6FdM+JO`^CLKZaiZ5+memo+vX;o18
z%@XHRmodel4L_^0J+l5Zh07>>88@*(45Cv;!%oFJIIr~LhYp4OO@vo^@k5J(+s~P>
z@&Q!mHEdJe=-lGVUpyAomrt4>I*}s%e<w!@pt02B^!EhSCNHRn#h*^~=NI#R*|F^x
zPZQSol@vQ9|Ey|8A*yG<yt*uX4J9$Zny{}rcUdl(FU?LbM5BkcmXAQA>-30Ru?b#K
z%ZPM3g1#rHCSA~>y|f+f{fFOLX7F$xDbD?fqgl?x)N_j(e1VSHi7s1AyU_iHfBzk$
z-cr<GM^v>N(pqY#UQk}+?uz!%T@#n>u_{F2rO<}~gbe9DO&~gjY%M$-5lZRXL_~Lk
zYn_<9MYXDB?bK{1)c$BwM8|WPxbaR5zpwfZf7!EggmdNR8rH6wwO@|?G4#X2elq<e
z#t)v3HRG&2R+gsokhDwM7@U;}fA*Sv30}wD%Wk_jfTk79yr2^iPN*cS;4k-r-{FY_
z)TWY|N6ESEs)AnCcG%^F=n~agjmZ8`I~-GE@2Kn8&3^YVNN)#<{SdBwFYuj_Np?eV
z<o}Gu4UB6Y`tODJ-OffdZeXl*c#E4B^uAXS>;=&GdI%P(7kn}+qayx3e+3SEx^E3&
z+lu<$(TSLgr(3U?rBh-&!}5kM^jEz@ZI_iN7fuKejcYh@WZx4;1K75r8}D{MLo~tn
zRCeR(?x%z%_@2s!o(^3Q`i%@WJGk@sfTk4;y{OI|?S9Iti}2;f&ygxW7o`h-RM7TS
z^?h{y^fG>Gxp-Q&@f+g2e~VeVAVM=Ltv0?y=O)fe)P1X(*Y<Ec_J0~$y@Gjo_-hZN
zSIpkd1HMq-;wE)u?+9mBTy6ijP0k@b7sZ9#BI6`)L)#~)I|4<9U49v%^o#DZS^lMq
zmF=5vT=c8(d|4$nSVll)Ew_?78N#i1&>xIfR2Lmzr`Z(t^qqyBe>Fp8{!v3qmiLpL
zK`RXDNkj9-CTC~aR9$pjY>z5SI^$O4N*9>&jOh|oo;U4Xp`Q~)WOwzfLkZdUQI!<r
zRoNyAdBsF|Jb@9b)F3Mr&P(Ye8AawApo2IjFZC7=>w(7Su0l8zNacAnshhf7?=jbX
z&t+K;SOW5Kk8dePf6krtp{2P(D;YU=)`ylxBe--f4L<@kt`99uNnVihD9>I|p1o9+
zUy-)#&XAym>r3V_2_~aNxC$JQavXYhP|(`Z&9Sob<W;eebT0seI&{-=_!e~g5Y2bE
z)UN{P^SBQr%AYGw0xUUq)(4cvSG3c6WfSNus{(4_E4=9)f3k^emQ?|@@D<PW4%vh<
z%c_7{_zz%u*Y?FOA`n2Ot`M>GUhWK5geZVwc?(f`=d7ZWRb5><_@iB%aSa>awZRp`
zv3rf5WCC?#Mq^TzKXNGYS#LB^=!;;4F)LH_eLLL84$~pMJ2v|ySWZF=7R!(Q@h-c)
z{~^E~een6ye+=|pl69N=XTly%-_rjU^>Bk|vgfnB_Po&T?8h9bpF9&TC(nfQsY>($
zhuHXVJq2t=W{R^*Hn!PbmS^21td25Hp}htW4^z>gItI(40a`2+H`#bX9nm^$ySV94
z8h*>VmvB4XYG#tS#s_vL=+6Y?OhCk$6XL%zvKwApf2Ls<KW}b?855`IFYHi&4+ZSd
z5*t(JWcfe23+r;fjK71sUzX-JRh$-aErc4*e`WvAtG4HwEGLB}Dp2=Qr7dk#{r2vJ
zTRPQj#$gQfI8+Gw3bb)f6@tyy@;s~0<UWa8q+{4rcH$n7&EdNj6xK~uWcZ}zJz)Ux
z^n!xEf2i`F=sVMGFFKr<r$!dVhXjPU+E`+&URE7?uBzAePtW)z<E4n3SNe5Lc08hn
z21UpDM9iqakcX_kl+R0|3F>D)6pk%;P}HA!m0+wA+&;|J8Jf{fv)|3@gkzmBInJ-z
z(8%36`R->v@9hJZ*Q+G`O^M{4!7lGV3>3F3e~RJ6>gl%Ir)fUW`sN(EAdsv4iwW&i
zc-<>Zg<V}^@@W=rdAx7KcDej%h1~xR#_zrM89uy?grv(IwzPF<{?i=)^QRtvI2z!i
zIHC&r@1`au+KJ-Gh=j$nH5(P3BMC&fwP-(h-*#ES9*%UKP#R&J^6DA?*;fkYi(4jD
ze}f-(=a$9{G{n)h?_IxW26cMXP}xpDVONFQFL^XQd3UP~-<PC1uWo{V$D*zZ*vC9p
z&XKA!&Uj<a^FQ&s&3-R6dFJj?|0gHojsLWYf!}CsKOt>DG-ze*C+us5Q>~D-pOCg6
zPOPe{!u<|bg6y-|_hyM!h}CuZ!v=;Oe+lM`w`v>3RNG2rXWJ(c8a=@g)WFiZL3vh?
zkLWYh{v{lqDWv_A-kx50RTnL{{>zf#6OUo+q?d)q2M@Wo=%OB^9SQsH{uMInUlcX^
z?R5>>XaDV-C9n9+plfibozN#XzL$lsIg5B-)`q#}z3cb3Cz8Zrzcq}8+&s(Qf8Ecq
zzAUh&Q@B?eHjpupacSqY#fcMBpVn{-Yp1hD1`A(g!(lxy-F}kmzz1D;+97_Bw4Q!J
zM&p(<b8zSz;;tX&A_Go;T=(5SxN_KxZY{vjU(IU=e_TH&ey|Wk@r1JQS%vsP@l4aS
zeBSNSkNZ_Yz1ZY=|N4FbHSbL6e;HmpuW6*#BSC53*zM0vGwa@kk6P<%{z(BSdgz*6
z@dB3(aq;ThB;>L9?IrI1?|=Tc4NLUB`)_lrKd<oqvBV>%gXwfIoDS$|O`8R=LOirE
zdhf?$+X(4<9!kRs$H!r2(Ut|F!<uktMjJvwG!YLCpLRF#*y4h|en9F6f0^!m@f(R3
z!g;(vUKeDKpIKI5Pmlb!{lv6y_8ah!5A_K(8{kK%4(V2K<Pg0I_(?JgFUS?{qoN<o
z75ayoYuYrMa`k(n{t)z4S+;>x4Th?$vEWD6RFyWQq3T8lw$)>NDl7b2ltjr<XGmdH
z>Gq)?QTU*DS*Y1@c@cM~e<G{i{dfq;uy~E|KV=uPeU-vtza=s@-gkbjjROS!7ftvd
z55cTxFzoQu7bQdQLs5P2ZVq9;Ls%H+r>em^6;^&=pnmJG@cjsMa|nj5!^VU9w*7Pn
ze><b*!aBLvG~8~xrD+^S`rCx`@h+sBZ~b%#hNHOK`*;_yjka{ne@kAfs-4Gw_=21)
zTfwaWYdAhWVA*kfBgc_%eoofT+7Bwwam>3fuuX*-+OO)qX^)2QZ@oxN;g>eq7_h<j
zLRtEwl}n`FIMf>lY?`?h|BWU8jl<TEr9W9(@slGJ{%pzrXQwLshou$&5j>(CCEf6H
zF+N&wfb&Kdj?lG1e>2-6wZ|Z@A~&WToT9H$4!Yw<86a0e<BpkYb4w!Dx6PU&d#s)y
zU0wPyUloV!M%vfuK5gK(IVz1?c3cu98n&=aSS}1lNwZ}%bV5yCD0u+NJ_n&-AzSEV
ziAICu+2SB9jNa*(_<6}bXPKE3F5zgnKf(1c1nz_qKU^&>fBT&YKNVk@?@+?e6UXh6
zV>%No&+K(ev^35xKfX?&UuO&4tSlwbQWU3eWHc#_s+#SBroMmq_2|v|zCRlDM@i?$
zdKU7Dg5>i<6XVD$-82|v(nX3bCzzksm}5VQUks<g992&#vmC#~B`^3vHh&ZOhO*O3
z*V-D6A#X*HfB5xqI5$2=`*TKS<JY^cVd7NBWB81^ZwQs-^R@3;K|bmvJqQcC$gfkS
zdhwC?gSnoJx$v82UkSgZAA`P9Fjk^n(pV{=m5dY^4u}0=^3Wd}w*L2j`ZBzi5-#tg
zaPc9ppL=lEd#}WA_piP(FHE9riP5HkHifF2><#-te^<5A?R6J*OvmS{a~H%(f}aMY
zNlf!Q==PC%7QRc-kp+`v|J`uAXNH#1@9wrJ!y)puT5M+1ELB|N&Tkl%=Z(MG7<+F3
zKT9Of%5ukZ_qx}<Qb6~Pt$+nC^`%Um+23t!{Q&AR#MbMKU*VfAWH%e>xyM&J+dJli
z8)nbFe}!sLP2eo4roLtkiqnF#I#7SycD~RA%bhSZLtoDrn%5Lg8CujA&l#Fw?V2<+
zr}HptXlAzUw4u4hK=X!XR%%Whnj2*`b7)2>o!&DiQqJ$0fpRDK%)vG@d}fvRP4Stt
zc$nkEwOcUBhi{r<md}j9cAC$e7iON%e3Q7ee@fQdR1H7Ig}~-pl||!Xi!HDIs>pIJ
zwRQb9ejlu$MnS?Ww`AfXt?Ag9r<`hCW=XR_SX0dQyIKKj?BumwByxqJ+}BEPPBa(Q
z!NPd>Mx;~Lmd$%O%Fsy4{QDoKV!bW9X6@pu!r`qi;c$Wh_cOMc1@j5Xy$#$sZ<cdC
zf9ALz=c=hcd*&MkJWoXaHH^e0&`+S{ToDT=a-?tGScTd7pCyijvo1&f^#^70MMC2I
zTN}&4Vws6o&C%$Lyhw}(8K73Zx~S{{8@idu%I9d)4R6nGn)0k$RrI%CF4&ZE+3m7e
fXHL2A1*}EnNwhSC9b<@(?EDw<c=~^x1GvSF132)=

diff --git a/docs/py-modindex.html b/docs/py-modindex.html
index cf2931d2..552320dd 100644
--- a/docs/py-modindex.html
+++ b/docs/py-modindex.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Python Module Index &mdash; DiCE 0.10 documentation</title>
+  <title>Python Module Index &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
diff --git a/docs/readme.html b/docs/readme.html
index 825c79cf..f7320e98 100644
--- a/docs/readme.html
+++ b/docs/readme.html
@@ -4,7 +4,7 @@
   <meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Diverse Counterfactual Explanations (DiCE) for ML &mdash; DiCE 0.10 documentation</title>
+  <title>Diverse Counterfactual Explanations (DiCE) for ML &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
   <!--[if lt IE 9]>
@@ -118,7 +118,8 @@
     text-align: unset;
 }
 </style>
-<p><a class="reference external" href="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml?query=workflow%3A%22Python+package%22"><img alt="BuildStatus" src="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml/badge.svg?branch=main" /></a> <a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PyPiVersion" src="https://img.shields.io/pypi/v/dice-ml" /></a> <a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PythonSupport" src="https://img.shields.io/pypi/pyversions/dice-ml" /></a> <a class="reference external" href="https://pepy.tech/project/dice-ml"><img alt="Downloads" src="https://static.pepy.tech/personalized-badge/dice-ml?period=total&amp;units=international_system&amp;left_color=grey&amp;right_color=orange&amp;left_text=Downloads" /></a> <a class="reference external" href="https://anaconda.org/conda-forge/dice-ml"><img alt="CondaVersion" src="https://anaconda.org/conda-forge/dice-ml/badges/version.svg" /></a></p>
+<p><a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PyPiVersion" src="https://img.shields.io/pypi/v/dice-ml" /></a> <a class="reference external" href="https://anaconda.org/conda-forge/dice-ml"><img alt="CondaVersion" src="https://anaconda.org/conda-forge/dice-ml/badges/version.svg" /></a> <img alt="MITlicense" src="https://img.shields.io/badge/License-MIT-blue.svg" /> <a class="reference external" href="https://pypi.org/project/dice-ml/"><img alt="PythonSupport" src="https://img.shields.io/pypi/pyversions/dice-ml" /></a> <a class="reference external" href="https://pepy.tech/project/dice-ml"><img alt="Downloads" src="https://static.pepy.tech/personalized-badge/dice-ml?period=total&amp;units=international_system&amp;left_color=grey&amp;right_color=orange&amp;left_text=Downloads" /></a></p>
+<p><a class="reference external" href="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml?query=workflow%3A%22Python+package%22"><img alt="BuildStatusTests" src="https://github.com/interpretml/DiCE/actions/workflows/python-package.yml/badge.svg?branch=main" /></a> <a class="reference external" href="https://github.com/interpretml/DiCE/actions/workflows/notebook-tests.yml?query=workflow%3A%22Notebook+tests%22"><img alt="BuildStatusNotebooks" src="https://github.com/interpretml/DiCE/actions/workflows/notebook-tests.yml/badge.svg?branch=main" /></a></p>
 <section id="diverse-counterfactual-explanations-dice-for-ml">
 <h1>Diverse Counterfactual Explanations (DiCE) for ML<a class="headerlink" href="#diverse-counterfactual-explanations-dice-for-ml" title="Permalink to this heading"></a></h1>
 <p><em>How to explain a machine learning model such that the explanation is truthful to the model and yet interpretable to people?</em></p>
@@ -132,7 +133,7 @@ <h1>Diverse Counterfactual Explanations (DiCE) for ML<a class="headerlink" href=
 <p>Explanations are critical for machine learning, especially as machine learning-based systems are being used to inform decisions in societally critical domains such as finance, healthcare, education, and criminal justice.
 However, most explanation methods depend on an approximation of the ML model to
 create an interpretable explanation. For example,
-consider a person who applied for a loan and was rejected by the loan distribution algorithm of a financial company. Typically, the company may provide an explanation on why the loan was rejected, for example, due to “poor credit history”. However, such an explanation does not help the person decide <em>what they do should next</em> to improve their chances of being approved in the future. Critically, the most important feature may not be enough to flip the decision of the algorithm, and in practice, may not even be changeable such as gender and race.</p>
+consider a person who applied for a loan and was rejected by the loan distribution algorithm of a financial company. Typically, the company may provide an explanation on why the loan was rejected, for example, due to “poor credit history”. However, such an explanation does not help the person decide <em>what they should do next</em> to improve their chances of being approved in the future. Critically, the most important feature may not be enough to flip the decision of the algorithm, and in practice, may not even be changeable such as gender and race.</p>
 <p>DiCE implements <a class="reference external" href="https://arxiv.org/abs/1711.00399">counterfactual (CF) explanations</a>  that provide this information by showing feature-perturbed versions of the same person who would have received the loan, e.g., <code class="docutils literal notranslate"><span class="pre">you</span> <span class="pre">would</span> <span class="pre">have</span> <span class="pre">received</span> <span class="pre">the</span> <span class="pre">loan</span> <span class="pre">if</span> <span class="pre">your</span> <span class="pre">income</span> <span class="pre">was</span> <span class="pre">higher</span> <span class="pre">by</span> <span class="pre">$10,000</span></code>. In other words, it provides “what-if” explanations for model output and can be a useful complement to other explanation methods, both for end-users and model developers.</p>
 <p>Barring simple linear models, however, it is difficult to generate CF examples that work for any machine learning model. DiCE is based on <a class="reference external" href="https://arxiv.org/abs/1905.07697">recent research</a> that generates CF explanations for any ML model. The core idea is to setup finding such explanations as an optimization problem, similar to finding adversarial examples. The critical difference is that for explanations, we need perturbations that change the output of a machine learning model, but are also diverse and feasible to change. Therefore, DiCE supports generating a set of counterfactual explanations  and has tunable parameters for diversity and proximity of the explanations to the original input. It also supports simple constraints on features to ensure feasibility of the generated counterfactual examples.</p>
 <section id="installing-dice">
diff --git a/docs/search.html b/docs/search.html
index 2f94ce44..6b8eff66 100644
--- a/docs/search.html
+++ b/docs/search.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Search &mdash; DiCE 0.10 documentation</title>
+  <title>Search &mdash; DiCE 0.11 documentation</title>
       <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
     
diff --git a/docs/searchindex.js b/docs/searchindex.js
index 3c82b3dc..f3e38d0e 100644
--- a/docs/searchindex.js
+++ b/docs/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["dice_ml", "dice_ml.data_interfaces", "dice_ml.explainer_interfaces", "dice_ml.model_interfaces", "dice_ml.schema", "dice_ml.utils", "dice_ml.utils.sample_architecture", "index", "modules", "notebooks/Benchmarking_different_CF_explanation_methods", "notebooks/DiCE_feature_importances", "notebooks/DiCE_getting_started", "notebooks/DiCE_getting_started_feasible", "notebooks/DiCE_model_agnostic_CFs", "notebooks/DiCE_multiclass_classification_and_regression", "notebooks/DiCE_with_advanced_options", "notebooks/DiCE_with_private_data", "notebooks/nb_index", "readme"], "filenames": ["dice_ml.rst", "dice_ml.data_interfaces.rst", "dice_ml.explainer_interfaces.rst", "dice_ml.model_interfaces.rst", "dice_ml.schema.rst", "dice_ml.utils.rst", "dice_ml.utils.sample_architecture.rst", "index.rst", "modules.rst", "notebooks/Benchmarking_different_CF_explanation_methods.ipynb", "notebooks/DiCE_feature_importances.ipynb", "notebooks/DiCE_getting_started.ipynb", "notebooks/DiCE_getting_started_feasible.ipynb", "notebooks/DiCE_model_agnostic_CFs.ipynb", "notebooks/DiCE_multiclass_classification_and_regression.ipynb", "notebooks/DiCE_with_advanced_options.ipynb", "notebooks/DiCE_with_private_data.ipynb", "notebooks/nb_index.rst", "readme.rst"], "titles": ["dice_ml package", "dice_ml.data_interfaces package", "dice_ml.explainer_interfaces package", "dice_ml.model_interfaces package", "dice_ml.schema package", "dice_ml.utils package", "dice_ml.utils.sample_architecture package", "Diverse Counterfactual Explanations (DiCE) for ML", "dice_ml", "Benchmarking different CF explanation methods", "Estimating local and global feature importance scores using DiCE", "Quick introduction to generating counterfactual explanations using DiCE", "&lt;no title&gt;", "Generating counterfactual explanations with any ML model", "Generating counterfactuals for multi-class classification and regression models", "Advanced options to customize Counterfactual Explanations", "Generating counterfactual explanations without access to training data", "&lt;no title&gt;", "Diverse Counterfactual Explanations (DiCE) for ML"], "terms": {"data_interfac": [0, 2, 5, 8, 10, 16], "base_data_interfac": [0, 8], "private_data_interfac": [0, 8, 16], "privatedata": [0, 1], "create_ohe_param": [0, 1], "de_normalize_data": [0, 1], "fit_label_encod": [0, 1], "from_dummi": [0, 1], "from_label": [0, 1], "get_all_dummy_colnam": [0, 1], "get_data_params_for_gradient_dic": [0, 1], "get_decimal_precis": [0, 1], "get_decoded_data": [0, 1], "get_encoded_categorical_feature_index": [0, 1], "get_features_rang": [0, 1], "get_indexes_of_features_to_vari": [0, 1], "get_inverse_ohe_min_max_normalized_data": [0, 1], "get_mad": [0, 1, 15], "get_minx_maxx": [0, 1], "get_ohe_min_max_normalized_data": [0, 1], "get_valid_feature_rang": [0, 1, 2], "get_valid_mad": [0, 1], "normalize_data": [0, 1, 7, 18], "one_hot_encode_data": [0, 1], "prepare_df_for_ohe_encod": [0, 1], "prepare_query_inst": [0, 1], "public_data_interfac": [0, 8], "publicdata": [0, 1], "get_data_typ": [0, 1], "get_quantiles_from_training_data": [0, 1], "explainer_interfac": [0, 8], "dice_kd": [0, 8, 9], "dicekd": [0, 2, 13], "do_sparsity_check": [0, 2], "duplic": [0, 2], "find_counterfactu": [0, 2], "predict_fn": [0, 2], "vary_valid": [0, 2], "dice_genet": [0, 8], "dicegenet": [0, 2, 13], "compute_loss": [0, 2], "compute_proximity_loss": [0, 2], "compute_sparsity_loss": [0, 2], "compute_yloss": [0, 2], "do_kd_init": [0, 2], "do_cf_initi": [0, 2], "do_loss_initi": [0, 2], "do_param_initi": [0, 2], "do_random_init": [0, 2], "label_decod": [0, 2], "label_decode_cf": [0, 2], "label_encod": [0, 2], "mate": [0, 2], "predict_fn_scor": [0, 2], "update_hyperparamet": [0, 2], "dice_pytorch": [0, 8], "dicepytorch": [0, 2], "compute_dist": [0, 2], "compute_diversity_loss": [0, 2], "compute_regularization_loss": [0, 2], "do_optimizer_initi": [0, 2], "dpp_style": [0, 2], "get_model_output": [0, 2], "initialize_cf": [0, 2], "predict_fn_for_spars": [0, 2], "round_off_cf": [0, 2], "stop_loop": [0, 2], "dice_random": [0, 8], "dicerandom": [0, 2], "get_continuous_sampl": [0, 2], "get_sampl": [0, 2], "dice_tensorflow1": [0, 8], "dicetensorflow1": [0, 2], "generate_counterfactu": [0, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "scipy_optim": [0, 2], "tensorflow_optim": [0, 2], "dice_tensorflow2": [0, 8], "dicetensorflow2": [0, 2], "explainer_bas": [0, 8], "explainerbas": [0, 2], "build_kd_tre": [0, 2], "check_permitted_rang": [0, 2], "check_query_instance_valid": [0, 2], "decide_cf_valid": [0, 2], "deserialize_explain": [0, 2], "do_binary_search": [0, 2], "do_linear_search": [0, 2], "do_posthoc_sparsity_enhanc": [0, 2], "feature_import": [0, 2], "get_model_output_from_scor": [0, 2], "global_feature_import": [0, 2, 10, 11], "infer_target_cfs_class": [0, 2], "infer_target_cfs_rang": [0, 2], "is_cf_valid": [0, 2], "local_feature_import": [0, 2, 10, 11], "misc_init": [0, 2], "round_to_precis": [0, 2], "serialize_explain": [0, 2], "setup": [0, 2, 7, 18], "sigmoid": [0, 2, 7, 18], "feasible_base_va": [0, 8, 12], "feasiblebaseva": [0, 2, 12], "train": [0, 1, 2, 3, 5, 6, 7, 10, 12, 14, 15, 17, 18], "feasible_model_approx": [0, 8, 12], "feasiblemodelapprox": [0, 2, 12], "model_interfac": [0, 2, 8], "base_model": [0, 8], "basemodel": [0, 3], "get_gradi": [0, 3], "get_num_output_nod": [0, 3], "get_num_output_nodes2": [0, 3], "get_output": [0, 3], "load_model": [0, 3, 12], "keras_tensorflow_model": [0, 8], "kerastensorflowmodel": [0, 3], "pytorch_model": [0, 8, 12], "pytorchmodel": [0, 3, 12], "set_eval_mod": [0, 3], "schema": [0, 8], "util": [0, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18], "sample_architectur": [0, 5], "vae_model": [0, 5], "except": [0, 8, 9, 10, 11, 13, 14, 16], "systemexcept": [0, 5], "userconfigvalidationexcept": [0, 5, 9, 10, 11, 13, 14, 16], "helper": [0, 7, 8, 9, 10, 11, 12, 13, 15, 16, 18], "datatransfom": [0, 5], "feed_data_param": [0, 5], "initialize_transform_func": [0, 5], "inverse_transform": [0, 5], "transform": [0, 1, 2, 3, 5, 9, 10, 11, 12, 13, 14, 15], "get_adult_data_info": [0, 5, 10, 11, 12], "get_adult_income_modelpath": [0, 5, 7, 11, 12, 15, 16, 18], "get_base_gen_cf_initi": [0, 5], "get_custom_dataset_modelpath_pipelin": [0, 5], "get_custom_dataset_modelpath_pipeline_binari": [0, 5], "get_custom_dataset_modelpath_pipeline_multiclass": [0, 5], "get_custom_dataset_modelpath_pipeline_regress": [0, 5], "get_custom_vars_dataset_modelpath_pipelin": [0, 5], "inverse_ohe_min_max_transform": [0, 5], "load_adult_income_dataset": [0, 5, 7, 9, 10, 11, 12, 13, 15, 18], "load_custom_testing_dataset": [0, 5], "load_custom_testing_dataset_binari": [0, 5], "load_custom_testing_dataset_multiclass": [0, 5], "load_custom_testing_dataset_regress": [0, 5], "load_min_max_equal_dataset": [0, 5], "load_outcome_not_last_column_dataset": [0, 5], "ohe_min_max_transform": [0, 5], "save_adult_income_model": [0, 5], "neuralnetwork": [0, 8], "ffnetwork": [0, 5], "forward": [0, 5, 6], "serial": [0, 2, 8], "dummydatainterfac": [0, 5], "to_json": [0, 5, 8, 10], "ml": [0, 1, 2, 3, 5, 12, 16, 17], "class": [0, 1, 2, 3, 5, 6, 7, 10, 11, 12, 13, 17, 18], "backendtyp": [0, 8], "sourc": [0, 1, 2, 3, 5, 6, 7, 12, 18], "base": [0, 1, 2, 3, 5, 6, 7, 11, 12, 15, 16, 18], "object": [0, 2, 3, 5, 7, 11, 12, 13, 15, 16, 17], "all": [0, 1, 2, 3, 6, 7, 8, 9, 10, 11, 14, 15, 16, 18], "sklearn": [0, 3, 5, 7, 8, 9, 10, 11, 13, 14, 18], "tf1": [0, 3, 5, 11, 15, 16], "tf2": [0, 3, 7, 11, 16, 18], "pyt": [0, 3, 11, 12, 16], "pytorch": [0, 2, 3, 7, 8, 9, 12, 13, 16, 17, 18], "tensorflow1": [0, 8], "tensorflow2": [0, 8, 15], "modeltyp": [0, 8], "classifi": [0, 2, 3, 7, 8, 9, 10, 11, 13, 14, 18], "regressor": [0, 3, 7, 8, 11, 14, 18], "samplingstrategi": [0, 8], "genet": [0, 2, 7, 8, 9, 11, 14, 16, 17, 18], "gradient": [0, 2, 7, 8, 11, 16, 18], "kdtree": [0, 2, 8, 9, 13, 14, 16], "random": [0, 2, 7, 8, 9, 10, 11, 14, 15, 16, 17, 18], "counterfactualexplan": [0, 2, 8], "cf_examples_list": [0, 2, 7, 8, 10, 18], "local_import": [0, 2, 8, 10, 11], "none": [0, 1, 2, 3, 5, 10], "summary_import": [0, 8, 10, 11], "version": [0, 7, 10, 11, 12, 16, 18], "A": [0, 1, 2, 5, 7, 9, 11, 12, 15, 18], "store": [0, 2], "counterfactu": [0, 2, 12, 17], "exampl": [0, 2, 7, 10, 12, 13, 16, 17, 18], "one": [0, 1, 2, 5, 6, 7, 11, 15, 18], "more": [0, 2, 7, 10, 12, 14, 15, 16, 17, 18], "input": [0, 1, 2, 3, 7, 10, 11, 12, 14, 15, 16, 18], "featur": [0, 1, 2, 7, 9, 12, 14, 16, 17, 18], "import": [0, 2, 7, 9, 12, 13, 14, 15, 16, 17, 18], "score": [0, 2, 3, 7, 17, 18], "paramet": [0, 2, 3, 5, 7, 11, 13, 14, 15, 16, 18], "list": [0, 1, 2, 7, 12, 18], "counterfactualexampl": [0, 2, 8], "instanc": [0, 1, 2, 6, 7, 10, 11, 12, 13, 14, 15, 16, 18], "estim": [0, 2, 7, 11, 16, 17, 18], "local": [0, 2, 7, 12, 17, 18], "The": [0, 2, 11, 12, 13, 14, 15, 16], "size": [0, 2], "i": [0, 1, 2, 3, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "number": [0, 1, 2, 9, 11, 15], "each": [0, 2, 7, 9, 10, 11, 12, 13, 16, 18], "contain": [0, 1, 2, 3, 14], "global": [0, 2, 7, 17, 18], "set": [0, 1, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "properti": [0, 7, 18], "static": [0, 2], "from_json": [0, 8, 10], "json_str": [0, 10], "deseri": 0, "json": [0, 7, 17], "string": [0, 2], "metadata": [0, 7, 8, 10, 12, 16, 18], "explan": [0, 2, 12, 17], "visualize_as_datafram": [0, 7, 8, 10, 11, 12, 13, 14, 15, 16, 18], "display_sparse_df": 0, "true": [0, 1, 2, 3, 5, 10, 11, 12, 13, 14, 15, 16], "show_only_chang": [0, 10, 11, 12, 13, 14, 15, 16], "fals": [0, 1, 2, 3, 7, 9, 11, 12, 13, 16, 18], "visualize_as_list": [0, 8], "point": [0, 2, 10, 11, 12, 13, 16], "differ": [0, 2, 3, 7, 10, 11, 12, 13, 14, 16, 18], "implement": [0, 2, 3, 7, 9, 11, 13, 16, 18], "requir": [0, 1, 2, 3, 7, 11, 12, 13, 16, 18], "onli": [0, 2, 7, 11, 12, 13, 16, 18], "few": [0, 15], "about": [0, 1, 12, 16], "rang": [0, 1, 2, 7, 9, 11, 14, 15, 16, 18], "continu": [0, 1, 2, 7, 11, 12, 13, 15, 16, 18], "level": [0, 1, 2, 7, 10, 11, 15, 18], "categor": [0, 1, 2, 7, 9, 10, 11, 13, 14, 15, 16, 18], "henc": [0, 15, 16], "can": [0, 2, 7, 9, 10, 11, 12, 13, 14, 16, 18], "us": [0, 2, 9, 12, 13, 14, 15, 16, 17], "privat": [0, 1, 7, 9, 10, 11, 12, 13, 15, 16, 18], "whose": [0, 11, 12], "meta": [0, 1, 5, 7, 17], "ar": [0, 1, 2, 3, 7, 11, 12, 13, 15, 16, 18], "avail": [0, 7, 16, 18], "name": [0, 1, 2, 11, 12, 15, 16], "specifi": [0, 2, 7, 11, 12, 15, 16, 18], "appropri": [0, 7, 11, 16, 18], "param": [0, 1], "_basedata": [0, 1], "inform": [0, 1, 7, 14, 16, 18], "decide_implementation_typ": [0, 8], "decid": [0, 2, 7, 8, 15, 18], "public": [0, 1], "To": [0, 7, 11, 16, 18], "add": [0, 2, 7, 11, 18], "new": [0, 2, 7, 10, 11, 13, 14, 16, 18], "return": [0, 1, 2, 3, 5, 9, 11, 12], "an": [0, 1, 2, 3, 5, 7, 10, 11, 12, 13, 15, 16, 18], "elif": 0, "loop": [0, 2, 9], "shown": [0, 11, 13, 16], "below": [0, 10, 11, 12, 13, 14, 15, 16], "method": [0, 1, 2, 3, 10, 11, 12, 13, 14, 16], "framework": [0, 2, 3, 12, 13, 15], "tensorflow": [0, 2, 3, 7, 9, 12, 13, 15, 16, 17, 18], "randomsampl": 0, "kwarg": [0, 2, 5], "interfac": [0, 1, 2, 3, 11, 16], "type": [0, 1, 10, 11, 14, 16], "final_cfs_df": [0, 7, 18], "test_instance_df": 0, "final_cfs_df_spars": 0, "posthoc_sparsity_param": [0, 2, 10], "0": [0, 1, 2, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "desired_rang": [0, 2, 10, 14], "desired_class": [0, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "opposit": [0, 2, 7, 10, 11, 12, 13, 15, 16, 18], "model_typ": [0, 2, 10, 14], "visual": [0, 2, 7, 11, 12, 15, 16, 18], "result": [0, 2, 11, 12, 16], "display_df": [0, 8], "df": [0, 1], "cf_example_json_str": 0, "print_list": [0, 8], "li": 0, "serialization_vers": 0, "json_convert": [0, 8], "obj": 0, "function": [0, 2, 5, 6, 7, 9, 10, 11, 12, 13, 15, 16, 18], "convert": [0, 7, 11, 17], "access": [0, 7, 11, 12, 17, 18], "output": [0, 2, 3, 7, 11, 12, 13, 17, 18], "model_path": [0, 3, 7, 11, 12, 15, 16, 18], "backend": [0, 3, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "func": [0, 3, 5, 7, 11, 16, 18], "kw_arg": [0, 3, 5], "data": [1, 2, 3, 5, 7, 8, 9, 11, 12, 13, 14, 15, 17, 18], "dice": [1, 8, 9, 12, 13, 14, 15, 16, 17], "one_hot_encoded_data": [1, 7, 18], "de": 1, "normal": [1, 2, 5, 15, 16], "from": [1, 2, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "1": [1, 2, 6, 7, 9, 10, 11, 12, 14, 16, 17, 18], "origin": [1, 2, 7, 10, 11, 12, 13, 14, 15, 16, 18], "prefix_sep": 1, "_": [1, 7, 9, 18], "get": [1, 2, 5, 15], "dummi": 1, "encod": [1, 2, 5, 6, 11, 12, 15], "k": [1, 2, 7, 9, 13, 18], "label": [1, 2, 7, 18], "back": [1, 2], "valu": [1, 2, 3, 7, 9, 10, 11, 12, 14, 15, 16, 18], "relat": [1, 2, 11], "output_typ": 1, "precis": [1, 2], "hot": [1, 2, 5, 11, 15], "column": [1, 7, 9, 10, 11, 13, 14, 18], "index": [1, 7, 9, 16, 18], "after": 1, "permitted_range_input": 1, "features_dict": 1, "features_to_vari": [1, 2, 7, 10, 11, 13, 18], "transformed_data": 1, "min": [1, 2, 5, 7, 9, 11, 13, 16, 18], "max": [1, 2, 5, 7, 9, 11, 16, 18], "raw": 1, "user": [1, 2, 5, 7, 9, 10, 11, 13, 14, 15, 16, 18], "fed": [1, 2, 5], "format": [1, 2, 11], "should": [1, 2, 6, 7, 11, 16, 18], "datafram": [1, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "arrai": [1, 3], "comput": [1, 2, 6, 7, 11, 15, 16, 18], "median": [1, 2, 7, 15, 16, 18], "absolut": [1, 2, 7, 15, 16, 18], "deviat": [1, 7, 15, 16, 18], "form": [1, 11, 12, 15, 16], "query_inst": [1, 2, 7, 9, 10, 11, 12, 13, 15, 16, 18], "dict": 1, "feature_range_input": 1, "assum": 1, "alreadi": 1, "numer": [1, 9, 10, 11, 13, 14, 16], "remain": 1, "same": [1, 2, 7, 11, 12, 13, 16, 18], "todo": [1, 2], "need": [1, 6, 7, 10, 11, 12, 16, 18], "work": [1, 7, 9, 10, 12, 13, 15, 17, 18], "adher": 1, "support": [1, 2, 9, 11, 13, 16], "permitted_rang": [1, 2, 7, 10, 11, 13, 18], "both": [1, 7, 9, 10, 12, 13, 14, 15, 18], "discret": [1, 11, 12], "when": [1, 2, 7, 11, 15, 16, 18], "provid": [1, 2, 7, 10, 11, 12, 13, 14, 15, 16, 18], "_generate_counterfactu": 1, "display_warn": 1, "return_mad": 1, "If": [1, 2, 7, 11, 13, 16, 18], "thei": [1, 7, 11, 13, 18], "practic": [1, 7, 11, 18], "instead": [1, 6, 9, 16], "make": [1, 7, 13, 18], "them": [1, 6, 11, 15, 16], "fall": [1, 15], "One": 1, "creat": [1, 7, 9, 10, 11, 13, 14, 15, 18], "do": [1, 7, 11, 13, 16, 18], "oh": [1, 7, 11, 16, 18], "singl": [1, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "prepar": [1, 5], "defin": [1, 2, 5, 6, 7, 11, 15, 17], "test": [1, 2, 3, 7, 9, 10, 11, 13, 14, 16, 18], "": [1, 2, 7, 9, 10, 12, 13, 14, 15, 16, 17, 18], "between": [1, 2, 7, 11, 16, 17, 18], "explain": [1, 2, 7, 12, 18], "thi": [1, 2, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "vice": [1, 12], "versa": [1, 12], "col": [1, 12], "infer": [1, 2, 12], "quantil": 1, "05": [1, 2, 9], "gener": [2, 5, 10, 12, 17], "kd": [2, 7, 9, 11, 17, 18], "tree": [2, 7, 9, 11, 17, 18], "code": [2, 7, 9, 10, 11, 12, 13, 14, 16, 18], "similar": [2, 7, 12, 18], "interpret": [2, 7, 10, 18], "guid": 2, "prototyp": 2, "http": [2, 5, 7, 9, 11, 12, 13, 14, 15, 16, 18], "arxiv": [2, 12], "org": [2, 5, 9, 12, 14, 16], "pdf": [2, 12], "1907": 2, "02584": 2, "cf": [2, 7, 11, 12, 13, 14, 18], "sparsity_weight": 2, "final_indic": 2, "data_df_copi": 2, "query_instance_orig": 2, "total_cf": [2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "stopping_threshold": 2, "posthoc_sparsity_algorithm": 2, "verbos": [2, 7, 9, 13, 18], "limit_steps_l": 2, "find": [2, 7, 11, 13, 16, 18], "queri": [2, 7, 9, 10, 11, 12, 14, 15, 16, 17], "d": [2, 6, 7, 9, 10, 11, 12, 13, 15, 16, 18], "nearest": 2, "desir": [2, 7, 11, 13, 14, 18], "dataset": [2, 5, 7, 10, 12, 14, 16, 17, 18], "input_inst": [2, 3], "predict": [2, 3, 5, 7, 9, 10, 11, 12, 13, 14, 18], "kd_query_inst": 2, "ensur": [2, 7, 13, 18], "we": [2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "vari": [2, 7, 11, 15, 18], "divers": [2, 9, 10, 11, 14, 17], "algorithm": [2, 7, 9, 11, 14, 16, 17, 18], "geco": 2, "qualiti": 2, "real": 2, "time": [2, 9, 10, 11, 12, 13, 15, 16], "2101": 2, "01292": 2, "overal": 2, "loss": [2, 7, 11, 18], "x_hat_unnorm": 2, "query_instance_norm": 2, "weight": [2, 7, 12, 16, 17, 18], "distanc": [2, 7, 11, 15, 16, 18], "two": [2, 7, 11, 12, 16, 18], "vector": 2, "first": [2, 10, 11, 12, 16], "part": 2, "y": [2, 7, 11, 18], "initi": [2, 11, 12, 13, 14, 15, 16], "query_instance_df_dummi": 2, "intial": 2, "other": [2, 7, 9, 10, 11, 12, 13, 15, 16, 18], "variabl": [2, 7, 11, 12, 15, 16, 18], "yloss_typ": [2, 9], "diversity_loss_typ": 2, "feature_weight": [2, 7, 15, 16, 18], "main": 2, "proximity_weight": [2, 7, 15, 18], "diversity_weight": [2, 7, 15, 18], "categorical_penalti": 2, "num_init": 2, "maxiter": 2, "thresh": 2, "through": [2, 7, 11, 15, 16, 18], "labelled_input": 2, "cfs_arr": 2, "k1": 2, "k2": 2, "perform": [2, 6, 11, 16], "produc": [2, 11, 12, 13, 16], "offspr": 2, "actual": [2, 7, 18], "updat": 2, "hyperparamet": 2, "x_hat": 2, "x1": [2, 11, 16], "third": [2, 12], "second": [2, 12], "linear": [2, 7, 18], "equal": [2, 15, 16], "constraint": [2, 7, 11, 12, 18], "sum": 2, "optim": [2, 7, 11, 12, 15, 16, 18], "learning_r": [2, 5], "submethod": 2, "dpp": 2, "matrix": 2, "min_it": 2, "max_it": 2, "project_it": 2, "loss_diff_thr": 2, "loss_converge_maxit": [2, 11], "init_near_query_inst": 2, "tie_random": 2, "descent": 2, "transform_data": [2, 3], "out_tensor": [2, 3], "probabl": [2, 3], "model": [2, 3, 5, 7, 8, 12, 17, 18], "sparsiti": [2, 11, 13, 16], "correct": [2, 16], "assign": [2, 7, 15, 18], "intermedi": 2, "project": [2, 7, 18], "itr": 2, "loss_diff": 2, "determin": [2, 3, 7, 12, 18], "stop": 2, "condit": [2, 11], "sampl": [2, 7, 9, 10, 11, 12, 16, 17, 18], "simpl": [2, 7, 11, 12, 18], "low": [2, 7, 11, 12, 18], "high": [2, 7, 11, 12, 16, 18], "1000": 2, "seed": [2, 13, 15], "fixed_features_valu": 2, "feature_rang": 2, "sampling_random_se": 2, "sampling_s": 2, "x": [2, 5, 6, 7, 11, 12, 16, 18], "tf": [2, 7, 15, 16, 18], "hinge_loss": [2, 9], "inverse_dist": 2, "inverse_mad": 2, "500": 2, "5000": [2, 10], "1e": [2, 12], "5": [2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "diversecf": 2, "adam": [2, 7, 18], "10000": 2, "interest": [2, 7, 11, 18], "dictionari": [2, 12, 15, 16], "row": [2, 11], "total": [2, 9, 10, 11, 13, 14, 15, 16], "take": [2, 6, 15], "default": [2, 7, 11, 12, 13, 15, 16, 18], "outcom": [2, 5, 7, 10, 11, 12, 13, 14, 16, 18], "binari": [2, 7, 11, 12, 16, 18], "classif": [2, 7, 11, 17], "posit": 2, "float": [2, 11, 16], "larger": [2, 11], "close": [2, 11, 13], "either": [2, 11], "randominitcf": 2, "kei": [2, 12, 15, 16], "permit": [2, 11, 13], "metric": [2, 7, 11, 18], "l2_loss": 2, "log_loss": 2, "avg_dist": 2, "correspond": 2, "option": [2, 7, 11, 17, 18], "where": [2, 11, 12, 15, 16], "invers": [2, 15, 16], "devid": 2, "mad": [2, 7, 15, 16, 18], "current": [2, 9, 11, 13], "learn": [2, 5, 7, 9, 12, 13, 14, 15, 17, 18], "rate": 2, "iter": 2, "run": [2, 6, 7, 11, 12, 15, 16, 18], "interv": 2, "mani": [2, 11], "minimum": 2, "success": 2, "check": [2, 7, 9, 11, 18], "converg": [2, 11, 13], "maximum": 2, "hold": 2, "declar": [2, 7, 18], "conserv": [2, 11], "2": [2, 5, 7, 9, 10, 11, 12, 14, 16, 17, 18], "paper": [2, 7, 11, 12, 15, 16, 18], "print": [2, 9, 10, 11, 12, 15], "boolean": [2, 3], "indic": [2, 3, 5, 11, 16], "round": [2, 11, 15, 16], "off": [2, 7, 11, 16, 17], "threshold": 2, "target": [2, 7, 9, 10, 11, 13, 14, 18], "post": [2, 7, 18], "hoc": 2, "oper": [2, 11, 16], "enhanc": 2, "search": [2, 7, 11], "prefer": 2, "larg": 2, "incom": [2, 5, 7, 9, 10, 11, 12, 13, 15, 16, 18], "10k": 2, "1000k": 2, "share": [2, 11, 16], "monoton": [2, 12], "relationship": 2, "upper": 2, "limit": [2, 11, 16], "step": [2, 7, 9, 10, 11, 13, 14, 15, 16, 18], "posthoc_sparsity_enhanc": 2, "see": [2, 7, 9, 11, 12, 14, 15, 16, 18], "diverse_counterfactu": [2, 7, 8], "py": [2, 9, 10, 11, 12, 13, 14, 16], "nelder": 2, "mead": 2, "templat": [2, 3], "subclass": [2, 3, 6], "abc": 2, "predicted_outcome_nam": 2, "comment": [2, 7, 18], "necessari": [2, 11], "els": [2, 9, 12], "remov": [2, 16], "feature_ranges_orig": 2, "model_output": 2, "path": 2, "reload": 2, "memori": [2, 14], "read": 2, "file": [2, 11, 16], "diff": 2, "decimal_prec": 2, "cf_ix": 2, "final_cfs_spars": 2, "current_pr": 2, "until": 2, "chang": [2, 7, 10, 11, 12, 17, 18], "current_pred_orig": 2, "greedi": 2, "move": 2, "toward": [2, 7, 11, 12, 18], "greedili": 2, "reach": [2, 15], "encourag": 2, "final": [2, 7, 11, 18], "panda": [2, 9, 14, 16], "done": [2, 7, 16, 18], "avoid": [2, 12], "infinit": 2, "10": [2, 7, 9, 10, 11, 12, 13, 14, 16, 18], "global_import": 2, "given": [2, 7, 10, 11, 12, 13, 14, 18], "which": [2, 7, 11, 12, 16, 18], "These": [2, 10, 11], "precomput": 2, "everi": [2, 6, 11], "follow": [2, 7, 11, 16, 18], "ignor": [2, 6, 9, 10, 11, 13, 14, 16], "per": [2, 7, 10, 11, 12, 15, 18], "other_paramet": 2, "includ": [2, 11, 12], "summar": [2, 11], "over": [2, 7, 15, 17], "For": [2, 7, 9, 10, 11, 12, 14, 15, 16, 18], "regress": [2, 7, 10, 11, 17], "problem": [2, 7, 18], "ascend": 2, "order": [2, 11, 15, 16], "gradientdesc": 2, "less": [2, 11, 13, 15], "whether": [2, 7, 11, 12, 18], "detail": [2, 7, 11, 12, 15, 18], "messag": [2, 5], "sample_s": 2, "random_se": [2, 13], "reproduc": [2, 15], "accept": 2, "specif": [2, 7, 14, 18], "its": [2, 7, 12, 18], "attribut": [2, 7, 17, 18], "model_scor": [2, 3], "flag": [2, 11, 16], "also": [2, 7, 10, 11, 12, 13, 15, 16, 18], "desired_class_input": 2, "original_pr": 2, "num_output_nod": 2, "call": [2, 5, 6, 11, 12, 16], "multiclass": [2, 7, 17], "downstream": 2, "allow": [2, 7, 11, 12, 15, 18], "desired_range_input": 2, "belong": 2, "test_pr": 2, "z": [2, 6], "vae": [2, 7, 11, 12, 18], "model_out": 2, "target_label": 2, "pre_train": [2, 12], "bool": [2, 6], "pre": [2, 7, 11, 12, 18], "exist": [2, 11, 16], "again": [2, 12, 13], "constraint_typ": 2, "constraint_vari": 2, "constraint_direct": 2, "constraint_reg": 2, "unari": [2, 12], "effect": [2, 12], "cause1": 2, "cause2": 2, "neg": 2, "By": [2, 7, 15, 18], "ha": [2, 7, 11, 12, 16, 18], "tunabl": [2, 7, 15, 18], "hyperparamt": 2, "OR": 3, "inp_siz": 3, "singleton": 3, "kera": [3, 7, 18], "input_tensor": 3, "mode": 3, "autoencod": [5, 6, 7, 18], "decod": [5, 6, 12], "normal_likelihood": [5, 6], "sample_latent_cod": [5, 6], "cf_vae": [5, 6], "compute_elbo": [5, 6], "some": [5, 7, 9, 10, 11, 12, 13, 15, 16, 18], "system": [5, 7, 18], "happen": 5, "dure": [5, 13], "execut": [5, 11, 12, 16], "exception_messag": 5, "str": 5, "describ": [5, 7, 9, 11, 12, 13, 18], "error": [5, 11, 15, 16], "configur": [5, 11, 13], "valid": [5, 7, 11, 18], "containt": 5, "load": [5, 7, 12, 16, 17], "deta": 5, "functiontransform": 5, "scikit": [5, 9, 13, 14, 16], "intern": [5, 7, 14, 15, 18], "stabl": [5, 7, 9, 14, 16, 18], "preprocess": [5, 9, 10, 11, 13, 14], "html": [5, 9, 14, 16], "encoded_s": [5, 6, 12], "cont_minx": 5, "cont_maxx": 5, "margin": [5, 12], "validity_reg": [5, 12], "epoch": [5, 7, 12, 18], "wm1": [5, 12], "wm2": [5, 12], "wm3": [5, 12], "only_train": 5, "adult": [5, 9, 12, 13, 15, 16], "archiv": [5, 9, 11, 12, 13, 15, 16], "ic": [5, 9, 11, 12, 13, 15, 16], "uci": [5, 9, 11, 12, 13, 15, 16], "edu": [5, 9, 11, 12, 13, 15, 16], "analysi": 5, "rpub": 5, "com": [5, 7, 18], "h_zhu": 5, "235617": 5, "adult_data": 5, "modelpath": 5, "test_fract": 5, "random_st": [5, 7, 9, 10, 11, 13, 14, 18], "arg": 5, "ani": [5, 7, 10, 11, 14, 17, 18], "outcome_nam": [5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "data_df": [5, 10], "overridden": 6, "although": 6, "recip": 6, "pass": [6, 13], "within": [6, 7, 11, 13, 18], "afterward": 6, "sinc": [6, 11, 12, 13, 15, 16], "former": 6, "care": 6, "regist": 6, "hook": 6, "while": [6, 11, 12], "latter": 6, "silent": 6, "mean": [6, 7, 11, 12, 15, 18], "logvar": 6, "raxi": 6, "c": [6, 7, 9, 10, 11, 13, 14, 16, 18], "pred_model": 6, "how": [7, 10, 11, 12, 13, 14, 15, 18], "machin": [7, 9, 11, 12, 13, 15, 16, 18], "truth": [7, 18], "yet": [7, 18], "peopl": [7, 18], "ramaravind": [7, 18], "mothil": [7, 18], "amit": [7, 18], "sharma": [7, 18], "chenhao": [7, 18], "tan": [7, 18], "fat": [7, 18], "20": [7, 9, 10, 11, 13, 18], "doc": [7, 9, 18], "live": [7, 18], "jupyt": [7, 18], "blog": [7, 18], "studi": [7, 18], "scienc": [7, 18], "hotel": [7, 18], "book": [7, 18], "analyt": [7, 18], "vidhya": [7, 18], "titan": [7, 18], "critic": [7, 11, 16, 18], "especi": [7, 18], "being": [7, 11, 18], "decis": [7, 11, 18], "societ": [7, 18], "domain": [7, 18], "financ": [7, 18], "healthcar": [7, 18], "educ": [7, 9, 10, 11, 12, 13, 15, 16, 18], "crimin": [7, 18], "justic": [7, 18], "howev": [7, 11, 12, 15, 16, 18], "most": [7, 15, 18], "depend": [7, 18], "approxim": [7, 15, 18], "consid": [7, 18], "person": [7, 11, 15, 18], "who": [7, 18], "appli": [7, 11, 18], "loan": [7, 18], "wa": [7, 11, 16, 18], "reject": [7, 18], "distribut": [7, 18], "financi": [7, 18], "compani": [7, 18], "typic": [7, 18], "mai": [7, 11, 15, 16, 18], "why": [7, 15, 18], "due": [7, 11, 16, 18], "poor": [7, 18], "credit": [7, 18], "histori": [7, 18], "doe": [7, 11, 16, 18], "help": [7, 11, 15, 18], "what": [7, 15, 17, 18], "next": [7, 16, 17, 18], "improv": [7, 18], "chanc": [7, 18], "approv": [7, 18], "futur": [7, 11, 16, 18], "enough": [7, 18], "flip": [7, 18], "even": [7, 11, 12, 18], "changeabl": [7, 18], "gender": [7, 9, 10, 11, 12, 13, 15, 16, 18], "race": [7, 9, 10, 11, 12, 13, 15, 16, 18], "show": [7, 9, 10, 11, 12, 13, 15, 16, 18], "perturb": [7, 11, 12, 15, 18], "would": [7, 11, 12, 15, 18], "have": [7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "receiv": [7, 11, 18], "e": [7, 11, 15, 18], "g": [7, 11, 15, 18], "you": [7, 9, 11, 12, 13, 14, 16, 18], "your": [7, 11, 16, 18], "higher": [7, 11, 15, 18], "000": [7, 18], "In": [7, 9, 11, 12, 13, 15, 18], "word": [7, 18], "complement": [7, 18], "end": [7, 11, 18], "develop": [7, 18], "bar": [7, 18], "difficult": [7, 15, 18], "recent": [7, 18], "research": [7, 18], "core": [7, 11, 14, 16, 18], "idea": [7, 13, 18], "adversari": [7, 18], "therefor": [7, 11, 18], "proxim": [7, 10, 11, 17, 18], "It": [7, 11, 12, 13, 15, 18], "python": [7, 12, 16, 18], "3": [7, 9, 10, 11, 12, 14, 16, 17, 18], "pypi": [7, 18], "pip": [7, 18], "conda": [7, 18], "forg": [7, 18], "latest": [7, 12, 18], "dev": [7, 18], "clone": [7, 18], "repo": [7, 18], "top": [7, 18], "folder": [7, 18], "face": [7, 18], "try": [7, 9, 11, 12, 13, 15, 16, 18], "manual": [7, 16, 18], "r": [7, 12, 18], "txt": [7, 18], "addit": [7, 11, 12, 18], "dependendi": [7, 18], "deep": [7, 17, 18], "deeplearn": [7, 18], "unit": [7, 15, 18], "jsonschema": [], "numpi": [9, 15], "h5py": [], "tqdm": [], "13": [9, 10, 11, 13, 14], "With": [7, 18], "three": [7, 9, 11, 13, 15, 18], "process": [7, 18], "invok": [7, 18], "dice_ml": [7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "continuous_featur": [7, 9, 10, 11, 12, 13, 14, 15, 18], "ag": [7, 9, 10, 11, 12, 13, 15, 16, 18], "hours_per_week": [7, 9, 10, 11, 12, 13, 15, 16, 18], "m": [7, 9, 10, 11, 12, 13, 15, 16, 18], "exp": [7, 10, 11, 12, 15, 16, 18], "now": [7, 9, 10, 11, 12, 13, 14, 15, 18], "lead": [7, 11, 16, 18], "22": [11, 13, 14, 15, 16], "workclass": [7, 9, 10, 11, 12, 13, 15, 16, 18], "h": [7, 9, 10, 11, 12, 13, 15, 16, 18], "grad": [7, 9, 10, 11, 12, 13, 15, 16, 18], "marital_statu": [7, 9, 10, 11, 12, 13, 15, 16, 18], "occup": [7, 9, 10, 11, 12, 13, 15, 16, 18], "servic": [7, 9, 10, 11, 12, 13, 15, 16, 18], "white": [7, 9, 10, 11, 12, 13, 15, 16, 18], "femal": [7, 9, 10, 11, 12, 13, 15, 16, 18], "45": [10, 12, 14, 15, 16], "been": [15, 16], "dice_exp": [7, 9, 11, 12, 15, 16, 18], "4": [7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "save": [7, 18], "wai": [7, 11, 12, 15, 18], "disk": [7, 18], "to_csv": [7, 18], "path_or_buf": [7, 18], "csv": [7, 18], "out": [7, 11, 18], "here": [7, 12, 13, 15, 18], "multi": [7, 11, 17, 18], "permiss": [7, 18], "agnost": [7, 9, 11, 18], "explicit": [7, 11, 18], "et": [7, 18], "al": [7, 18], "2020": [7, 18], "variat": [7, 12, 18], "mahajan": [7, 18], "2019": [7, 18], "baseva": [7, 12, 18], "last": [7, 11, 18], "differenti": [7, 11, 18], "neural": [7, 11, 15, 16, 18], "network": [7, 11, 15, 16, 18], "rais": [7, 18], "issu": [7, 13, 18], "full": [7, 9, 10, 11, 12, 13, 14, 18], "thu": [7, 15, 18], "sensit": [7, 11, 18], "17": [7, 10, 11, 13, 14, 15, 16, 18], "90": [7, 10, 15, 16, 18], "govern": [7, 10, 11, 13, 16, 18], "unknown": [7, 10, 11, 13, 16, 18], "self": [7, 9, 10, 11, 13, 16, 18], "emploi": [7, 9, 10, 11, 13, 16, 18], "assoc": [7, 9, 10, 11, 13, 16, 18], "bachelor": [7, 9, 10, 11, 13, 16, 18], "doctor": [7, 10, 11, 13, 16, 18], "master": [7, 10, 11, 16, 18], "prof": [7, 10, 11, 13, 16, 18], "school": [7, 9, 10, 11, 13, 16, 18], "colleg": [7, 9, 10, 11, 13, 16, 18], "divorc": [7, 10, 11, 13, 16, 18], "marri": [7, 9, 10, 11, 13, 16, 18], "separ": [7, 10, 11, 13, 16, 18], "widow": [7, 10, 11, 13, 16, 18], "blue": [7, 9, 10, 11, 13, 16, 18], "collar": [7, 9, 10, 11, 13, 16, 18], "profession": [7, 9, 10, 11, 13, 16, 18], "sale": [7, 9, 10, 11, 13, 16, 18], "male": [7, 9, 10, 11, 13, 16, 18], "99": [7, 13, 15, 16, 18], "well": [7, 18], "sess": [7, 18], "interactivesess": [7, 18], "split_data": [7, 18], "x_train": [7, 9, 10, 11, 13, 14, 18], "loc": [7, 9, 18], "y_train": [7, 9, 10, 11, 13, 14, 18], "fit": [7, 9, 10, 11, 12, 13, 14, 18], "dens": [7, 18], "ann_model": [7, 18], "sequenti": [7, 18], "layer": [7, 18], "input_shap": [7, 18], "shape": [7, 18], "kernel_regular": [7, 18], "regular": [7, 18], "l1": [7, 18], "001": [7, 18], "activ": [7, 18], "nn": [7, 18], "relu": [7, 18], "compil": [7, 11, 16, 18], "binary_crossentropi": [7, 18], "01": [7, 9, 11, 13, 14, 18], "accuraci": [7, 11, 12, 16, 18], "validation_split": [7, 18], "100": [7, 9, 10, 11, 13, 14, 16, 18], "class_weight": [7, 18], "highlight": [7, 11, 18], "plan": [7, 18], "english": [7, 18], "languag": [7, 12, 18], "too": [7, 12, 18], "acknowledg": [7, 15, 18], "closer": [7, 15, 18], "individu": [7, 11, 15, 18], "profil": [7, 15, 18], "choos": [7, 15, 18], "multipl": [7, 11, 14, 15, 18], "possibl": [7, 11, 15, 18], "kind": [7, 11, 18], "addition": [7, 11, 18], "harder": [7, 15, 18], "than": [7, 11, 13, 15, 16, 18], "hour": [7, 10, 11, 15, 18], "week": [7, 10, 11, 15, 18], "rel": [7, 11, 15, 16, 18], "difficulti": [7, 15, 18], "measur": [7, 10, 15, 18], "divid": [7, 15, 18], "imposs": [7, 11, 18], "reflect": [7, 15, 18], "50": [7, 9, 10, 11, 13, 18], "Being": [7, 18], "stakehold": [7, 18], "made": [7, 11, 18], "subject": [7, 18], "explor": [7, 11, 18], "action": [7, 18], "recours": [7, 18], "altern": [7, 18], "understand": [7, 11, 18], "could": [7, 11, 16, 18], "debug": [7, 18], "potenti": [7, 18], "select": [7, 15, 18], "uncov": [7, 18], "problemat": [7, 18], "95": [7, 10, 18], "aim": [7, 18], "aggreg": [7, 11, 18], "maker": [7, 18], "judg": [7, 18], "particular": [7, 10, 11, 15, 16, 18], "probe": [7, 18], "enabl": [7, 11, 16, 18], "assess": [7, 18], "trust": [7, 18], "evalu": [7, 18], "fair": [7, 18], "ideal": [7, 11, 18], "balanc": [7, 18], "wide": [7, 18], "suggest": [7, 18], "eas": [7, 15, 18], "adopt": [7, 18], "those": [7, 10, 11, 16, 18], "causal": [7, 18], "law": [7, 18], "world": [7, 18], "hardli": [7, 18], "lower": [7, 18], "degre": [7, 18], "ad": [7, 12, 18], "construct": [7, 11, 12, 18], "phrase": [7, 18], "like": [7, 10, 11, 12, 18], "lime": [7, 11, 18], "shap": [7, 11, 18], "necess": [7, 10, 11, 18], "suffici": [7, 11, 18], "bayesian": [7, 18], "better": [7, 11, 18], "pleas": [7, 9, 10, 11, 13, 14, 16, 18], "proceed": [7, 18], "confer": [7, 18], "account": [7, 18], "transpar": [7, 18], "bibtex": [7, 18], "inproceed": [7, 18], "mothilal2020dic": [7, 18], "titl": [7, 18], "author": [7, 18], "booktitl": [7, 18], "page": [7, 18], "607": [7, 18], "617": [7, 18], "year": [7, 11, 18], "welcom": [7, 18], "agre": [7, 18], "contributor": [7, 18], "licens": [7, 18], "agreement": [7, 18], "cla": [7, 18], "right": [7, 18], "grant": [7, 18], "u": [7, 15, 18], "visit": [7, 18], "microsoft": [7, 18], "submit": [7, 18], "pull": [7, 18], "request": [7, 18], "bot": [7, 18], "automat": [7, 18], "decor": [7, 18], "pr": [7, 18], "simpli": [7, 11, 18], "instruct": [7, 11, 16, 18], "onc": [7, 14, 18], "across": [7, 13, 18], "our": [7, 11, 12, 13, 15, 16, 18], "open": [7, 11, 16, 18], "conduct": [7, 18], "faq": [7, 18], "contact": [7, 18], "opencod": [7, 18], "question": [7, 11, 18], "quick": [7, 17], "introduct": [7, 17], "preliminari": [7, 17], "resourc": [7, 17], "independ": [7, 9, 17], "without": [7, 11, 12, 17, 18], "advanc": [7, 12, 16, 17], "custom": [7, 11, 16, 17], "trade": [7, 17], "goal": [7, 13, 17], "modelapprox": 12, "initil": 12, "subpackag": [7, 8], "submodul": [7, 8], "constant": [7, 8, 11, 16], "modul": [7, 8, 9, 11, 12, 13, 14, 15, 16], "counterfactual_explan": [7, 8], "content": [7, 8, 12], "packag": [8, 11, 12, 16], "notebook": [9, 11, 12, 13, 14, 16, 18], "runtim": 9, "np": 9, "timeit": 9, "compos": [9, 10, 11, 13, 14], "columntransform": [9, 10, 11, 13, 14, 16], "model_select": [7, 9, 10, 11, 13, 14, 18], "train_test_split": [7, 9, 10, 11, 13, 14, 18], "pipelin": [9, 10, 11, 13, 14, 16], "standardscal": [9, 10, 13, 14], "onehotencod": [9, 10, 11, 13, 14, 16], "ensembl": [9, 10, 11, 13, 14], "randomforestclassifi": [9, 10, 11, 13, 14, 16], "load_ext": [9, 10, 11, 12, 13, 14, 15, 16], "autoreload": [9, 10, 11, 12, 13, 14, 15, 16], "repositori": [9, 11, 12, 13, 15, 16], "demonstr": [9, 11, 12, 13, 14, 15], "purpos": [9, 11, 12, 15], "filenotfounderror": [], "traceback": [], "lt": [9, 10, 11, 13, 14, 16], "cell": 12, "line": [], "gt": [10, 11, 14], "mnt": [9, 10, 11, 13, 14, 16], "amshar": [9, 10, 11, 13, 14, 16], "25": [10, 11, 12, 13, 14], "19": [10, 11, 13, 14, 16], "def": [], "34": [9, 10, 11, 13, 14, 16], "21": [11, 13, 14, 16], "23": [11, 13, 14], "24": [10, 13, 14], "raw_data": [], "genfromtxt": [], "39": [10, 11, 14, 16], "databas": [], "26": [9, 10, 11, 13, 16], "delimit": [], "dtype": 14, "invalid_rais": [], "28": [9, 10, 11, 13, 14], "29": [10, 11, 14, 16], "column_nam": [], "fnlwgt": [], "num": [9, 10, 13, 14], "marit": [10, 11], "statu": [10, 11], "30": [9, 10, 11, 13, 16], "capit": [], "gain": [], "nativ": [], "countri": [], "31": [9, 10, 11, 13], "env": 16, "v3": 16, "8dowhi": 16, "lib": 16, "python3": [12, 16], "8": [9, 10, 11, 12, 13, 14, 16], "site": 16, "npyio": [], "1934": [], "fname": [], "skip_head": [], "skip_foot": [], "missing_valu": [], "filling_valu": [], "usecol": [], "excludelist": [], "deletechar": [], "replace_spac": [], "autostrip": [], "case_sensit": [], "defaultfmt": [], "unpack": [], "usemask": [], "loos": [], "max_row": [], "ndmin": [], "1932": [], "os_fspath": [], "1933": [], "isinst": [], "fid": [], "_datasourc": [], "rt": [], "1935": [], "fid_ctx": [], "contextlib": [], "1936": [], "193": [11, 16], "destpath": [], "newlin": [], "156": [11, 16], "157": [], "158": [], "189": [], "190": [], "192": [], "datasourc": [], "533": [], "530": [], "_file_open": [], "ext": [], "found": [11, 12, 13, 16], "531": [], "532": [], "f": [], "head": [9, 11, 12, 13, 14, 15], "nameerror": [], "soon": [9, 12, 13], "6": [9, 10, 11, 12, 13, 14, 16], "split": [9, 10, 11, 13, 14], "datasetx": [9, 10, 13, 14], "drop": [7, 9, 10, 11, 13, 14, 18], "axi": [9, 10, 11, 13, 14], "x_test": [9, 10, 11, 13, 14], "y_test": [9, 10, 11, 13, 14], "test_siz": [7, 9, 10, 11, 12, 13, 14, 18], "stratifi": [7, 9, 10, 11, 13, 14, 18], "numeric_transform": [9, 10, 13, 14], "scaler": [9, 10, 13, 14], "categorical_transform": [9, 10, 11, 13, 14], "onehot": [9, 10, 11, 13, 14], "handle_unknown": [9, 10, 11, 13, 14], "cat": [9, 10, 11, 12, 13, 14], "append": [9, 10, 11, 13, 14, 16], "clf": [9, 10, 11, 13], "preprocessor": [9, 10, 11, 13, 14], "7": [9, 10, 11, 13, 14, 16], "exp_random": [9, 13], "9": [9, 10, 11, 13, 14, 16], "exp_genet": [9, 13], "exp_kd": [9, 13], "11": [9, 10, 11, 13, 14, 16], "12": [9, 10, 11, 12, 13, 14, 16], "modifi": 9, "num_loop": 9, "14": [9, 11, 13, 14], "elapsed_random": 9, "elapsed_kd": 9, "elapsed_genet": 9, "q": 9, "categorical_feature_nam": 9, "uniqu": 9, "choic": 9, "uniform": 9, "start_tim": 9, "default_tim": 9, "dice_exp_random": [9, 13], "m_random": 9, "s_random": 9, "divmod": 9, "60": [9, 10, 11, 13, 16], "taken": [9, 11, 13, 16], "02d": 9, "sec": [9, 11, 13, 16], "m_kd": 9, "s_kd": 9, "m_genet": 9, "s_genet": 9, "summari": [10, 11], "intuit": [10, 11], "often": [10, 11], "build": [10, 13], "caus": [10, 11, 12], "That": [10, 11, 12], "significantli": [10, 11, 16], "case": [10, 11, 12, 15, 16], "combin": [10, 15], "yield": 10, "downsampl": 10, "reduc": 10, "industri": [10, 11], "50k": [10, 11, 12], "v": [10, 11], "e1": [10, 11], "00": [9, 10, 11, 13, 14, 16], "12it": 9, "43": [10, 11, 13, 14, 16], "94": [], "63": 10, "33": [13, 14], "15": [11, 13, 14], "77": 13, "64": [10, 11, 16], "calcul": 10, "imp": [10, 11], "directli": [10, 16], "leav": 10, "argument": [10, 11, 12, 14], "blank": 10, "18it": [], "repres": 10, "cobj": 10, "57it": [], "46": [10, 13], "test_data": 10, "37": 14, "40": [9, 10, 11, 12, 13], "44": [10, 13], "41": [9, 10, 11, 12, 13, 14, 16], "53": 10, "38": [10, 11, 14, 16], "cfs_list": 10, "73": 16, "88": 14, "42": [10, 12], "83": [10, 11], "59": [10, 13], "55": [10, 16], "27": [9, 10, 13], "80": 10, "81": [10, 14], "36": [10, 16], "47": [10, 14], "67": [10, 13], "52": [10, 14], "84": 10, "93": 10, "57": 10, "78": 10, "82": 13, "51": 16, "98": 10, "72": [10, 13], "91": [], "56": [10, 11], "66": 10, "69": [10, 11], "75": [], "97": [], "70": [11, 13, 16], "65": [9, 10, 11, 13], "68": [10, 11, 13], "54": 10, "48": [10, 16], "79": [], "74": 16, "89": 10, "71": 13, "62": [10, 11], "dummy_data": 10, "feature_nam": [10, 14], "feature_names_including_target": 10, "null": [10, 12, 14], "imp_r": 10, "o": 10, "scenario": 11, "inspect": 11, "librari": [11, 12, 14, 15, 16], "formal": 11, "known": 11, "answer": 11, "abov": [11, 12, 15, 16], "obtain": 11, "revers": 11, "know": [7, 11, 16, 18], "bring": 11, "logic": 11, "spars": [11, 13], "achiev": 11, "easi": 11, "minim": [7, 11, 18], "anoth": [11, 12], "feasibl": [11, 12, 13, 15], "outsid": 11, "simplest": 11, "complex": [11, 12], "concept": 11, "just": [11, 14], "certain": 11, "releas": 11, "x_i": 11, "keep": 11, "similarli": 11, "absenc": 11, "neither": 11, "nor": 11, "definit": 11, "translat": 11, "easili": 11, "deriv": 11, "rank": 11, "frequenc": 11, "among": 11, "parameter": 11, "refin": 11, "space": 11, "consequ": 11, "compar": [11, 12, 15, 16], "tend": 11, "give": [11, 13], "black": 11, "box": 11, "nearbi": 11, "privaci": 11, "reason": [11, 15], "binar": [11, 12], "32": [9, 10, 11, 13, 14], "35": [9, 10, 11, 13], "descript": [11, 12], "adult_info": [11, 12], "train_dataset": [7, 11, 18], "test_dataset": [7, 11, 18], "want": [11, 13, 16], "four": 11, "snippet": 11, "38it": [], "restrict": 11, "e2": 11, "58it": [], "e3": 11, "72it": [], "operation": 11, "criterion": 11, "refer": [11, 12, 16], "unifi": 11, "around": 11, "denot": 11, "04": [10, 13], "83it": [], "275": 11, "235": [], "175": [], "155": [], "09": 11, "rather": 11, "slower": 11, "compon": 11, "formul": 11, "baselin": [11, 12, 16], "conveni": [11, 12], "16": [10, 11, 12, 13, 14], "instal": 11, "ml_modelpath": [11, 12, 15, 16], "2022": [], "694158": [], "cc": [11, 16], "169": [11, 16], "onednn": [11, 16], "slightli": [11, 16], "turn": [11, 16], "environ": [11, 16], "tf_enable_onednn_opt": [11, 16], "698027": [], "w": [11, 16], "stream_executor": [11, 16], "platform": [11, 16], "dso_load": [11, 16], "dynam": [11, 16], "libcudart": [11, 16], "so": [11, 16], "dlerror": [11, 16], "cannot": [11, 15, 16], "No": [11, 13, 16], "directori": [11, 16], "698044": [], "cuda": [11, 16], "cudart_stub": [11, 16], "cudart": [11, 16], "gpu": [11, 16], "up": [7, 11, 16, 18], "note": [11, 12, 13, 15, 16], "eager": [11, 16], "style": [11, 16], "greater": [11, 16], "graph": [11, 16], "instanti": [11, 12], "49": 10, "357741": [], "libcuda": [11, 16], "357797": [], "cuda_driv": [11, 16], "269": [11, 16], "fail": [11, 16], "cuinit": [11, 16], "303": [11, 16], "357820": [], "cuda_diagnost": [11, 16], "kernel": [11, 16], "driver": [11, 16], "appear": [11, 16], "host": [11, 16], "proc": [11, 16], "nvidia": [11, 16], "358100": [], "cpu_feature_guard": [11, 16], "oneapi": [11, 16], "cpu": [11, 16], "avx2": [11, 16], "avx512f": [11, 16], "avx512_vnni": [11, 16], "fma": [11, 16], "rebuild": [11, 16], "18": [10, 11, 13], "671": 11, "rigor": 11, "experiment": 11, "replic": 11, "info": [11, 14, 16], "dice_interfac": 11, "dice_tensorflow": 11, "03": [], "07": 11, "618": 11, "968": 11, "35it": [], "constrain": [11, 12, 13], "weigh": [11, 16], "consider": 11, "likelihood": 11, "term": 11, "present": 12, "approach": 12, "ab": 12, "1912": 12, "03277": 12, "remotedisconnect": [], "525": 16, "522": [], "valueerror": [], "url": [], "writeabl": [], "524": [], "_findfil": [], "write": [], "526": 14, "527": [], "_fname": [], "_splitzipext": [], "369": [], "366": [], "filelist": [], "_possible_nam": [], "368": [], "370": [], "_isurl": [], "371": [], "_cach": [], "479": [], "477": [], "478": [], "netfil": [], "urlopen": [], "480": [], "481": [], "del": 12, "usr": [], "urllib": [], "222": [], "timeout": [], "cafil": [], "capath": [], "cadefault": [], "context": [], "220": [], "221": [], "_open": [], "openerdirector": [], "fullurl": [], "req": [], "meth": [], "sy": [], "audit": [], "full_url": [], "header": [], "get_method": [], "respons": [], "528": [], "meth_nam": [], "protocol": [], "_respons": [], "542": [], "539": [], "541": [], "_call_chain": [], "handle_open": [], "543": [], "544": [], "545": [], "502": [], "chain": [], "handler": [], "501": [], "getattr": [], "503": [], "504": [], "1397": [], "httpshandler": [], "https_open": [], "1396": [], "do_open": [], "client": [], "httpsconnect": [], "1398": [], "_context": [], "check_hostnam": [], "_check_hostnam": [], "1358": [], "abstracthttphandl": [], "http_class": [], "http_conn_arg": [], "1356": [], "oserror": [], "err": [], "1357": [], "urlerror": [], "getrespons": [], "1359": [], "1360": [], "1348": [], "httpconnect": [], "1346": [], "1347": [], "begin": [], "1349": [], "connectionerror": [], "1350": [], "316": [], "httprespons": [], "314": [], "non": [14, 15], "315": [], "_read_statu": [], "317": [], "318": [], "break": 16, "285": [], "281": [], "repli": [], "repr": [], "282": [], "283": [], "presum": [], "server": [], "connect": [], "befor": 15, "284": [], "send": [], "remot": [], "286": [], "287": [], "288": [], "data_nam": 12, "becaus": 12, "_2node": 12, "pth": 12, "userwarn": [9, 10, 11, 13, 14, 16], "warn": [9, 10, 11, 13, 14, 15, 16], "in_featur": [], "out_featur": [], "bia": [], "softmax": [], "dim": [], "home": 16, "torch": [], "786": [], "sourcechangewarn": [], "retriev": [], "dump_patch": [], "patch": [], "tool": [], "revert": [], "msg": [], "arug": 12, "re": 12, "repeat": 12, "lr": 12, "batch_siz": 12, "2048": 12, "165": 12, "super": 12, "fast": 12, "might": [12, 16], "notic": 12, "still": [12, 16], "infeas": 12, "adpat": 12, "prodcu": 12, "adapt": 12, "under": 12, "assumpt": 12, "section": 12, "preserv": 12, "ed": 12, "never": 12, "decreas": 12, "increas": [12, 13, 15], "impli": [12, 15], "cause_1": 12, "cause_n": 12, "intend": 12, "direct": 12, "fourth": 12, "penalti": 12, "76": 12, "344": 12, "87": [10, 11, 12, 13], "unlik": 12, "experi": 12, "scmgencf": 12, "oraclegencf": 12, "method_nam": 13, "observ": [13, 15, 16], "contrast": 13, "worsen": 13, "further": 13, "sens": 13, "randomli": 13, "freeli": 13, "control": 13, "best": 13, "quickli": 13, "promot": 13, "previous": 13, "dice_exp_genet": 13, "wish": 13, "closest": 13, "effici": 13, "behind": 13, "itself": 13, "displai": 13, "dice_exp_kd": 13, "rest": 14, "complet": [13, 14], "ident": 14, "load_iri": 14, "fetch_california_h": 14, "randomforestregressor": 14, "pd": [14, 16], "iri": 14, "consist": 14, "iris": 14, "setosa": 14, "versicolour": 14, "virginica": 14, "petal": 14, "sepal": 14, "length": 14, "toy_dataset": 14, "plant": 14, "df_iri": 14, "as_fram": 14, "frame": [14, 16], "cm": 14, "width": 14, "rangeindex": 14, "150": 14, "entri": 14, "149": 14, "count": 14, "float64": 14, "int64": 14, "usag": 14, "kb": 14, "continuous_features_iri": 14, "tolist": 14, "categorical_featur": 14, "clf_iri": 14, "model_iri": 14, "d_iri": 14, "m_iri": 14, "exp_genetic_iri": 14, "As": [14, 15, 16], "lie": 14, "query_instances_iri": 14, "genetic_iri": 14, "39it": [], "california": 14, "hous": 14, "price": 14, "housing_data": 14, "df_hous": 14, "seri": 14, "medinc": 14, "houseag": 14, "averoom": 14, "avebedrm": 14, "popul": 14, "aveoccup": 14, "latitud": 14, "longitud": 14, "3252": 14, "984127": 14, "023810": 14, "322": 14, "555556": 14, "122": 14, "3014": 14, "238137": 14, "971880": 14, "2401": 14, "109842": 14, "86": 14, "585": 14, "2574": 14, "288136": 14, "073446": 14, "496": 14, "802260": 14, "85": [10, 13, 14], "521": 14, "6431": 14, "817352": 14, "073059": 14, "558": 14, "547945": 14, "413": 14, "8462": 14, "281853": 14, "081081": 14, "565": 14, "181467": 14, "422": 14, "20640": 14, "20639": 14, "mb": 14, "continuous_features_h": 14, "regr_hous": 14, "model_h": 14, "d_hous": 14, "m_hous": 14, "exp_genetic_h": 14, "query_instances_h": 14, "genetic_h": 14, "49it": [], "3487": 14, "930712": 14, "026217": 14, "1554": 14, "910112": 14, "650002": 14, "121": 14, "839996": 14, "49846": [], "5173": 14, "119": 14, "4537603999999984": [], "6184": 14, "1543": 14, "118": 14, "126689999999999": [], "4511": 14, "992958": 14, "316901": 14, "390": 14, "746479": 14, "200001": 14, "115": 14, "599998": 14, "91159": [], "3682": 14, "394": 14, "61": [10, 13, 14], "117": 14, "92": 14, "98180959999999": [], "9167": 14, "393": 14, "890800399999997": [], "discuss": [15, 16], "behavior": 15, "supress": 15, "deprec": [9, 10, 11, 13, 14, 15, 16], "compat": 15, "v1": 15, "log": 15, "set_verbos": 15, "631881": [], "635417": [], "635428": [], "artifici": 15, "set_random_se": 15, "set_se": 15, "__version__": [15, 16], "394561": [], "394614": [], "394632": [], "394838": [], "attributeerror": [], "160": [], "query_instances_list": [], "159": [], "set_continuous_feature_index": [], "161": [], "162": [], "163": [], "170": [], "171": [], "172": [], "cf_examples_arr": [], "remap": [], "continuous_feature_index": [], "get_loc": [], "continuous_feature_nam": [], "listcomp": [], "resutl": 15, "convei": 15, "robust": 15, "standard": 15, "affect": 15, "outlier": 15, "let": 15, "seven": 15, "Of": 15, "cours": 15, "sound": 15, "odd": 15, "ride": 15, "handl": 15, "scale": [15, 16], "veri": 15, "categori": [15, 16], "tabl": [12, 15, 18], "extrem": 15, "factor": 15, "captur": [15, 16], "preval": [15, 16], "respect": [15, 16], "basic": 16, "simul": 16, "ordereddict": 16, "randomforest": 16, "sk_modelpath": 16, "pretrain": 16, "329": 16, "unpickl": 16, "invalid": 16, "own": 16, "risk": 16, "model_persist": 16, "secur": 16, "maintain": 16, "decisiontreeclassifi": 16, "02": [9, 10, 13, 14, 16], "popular": 16, "come": 16, "built": 16, "noqa": 16, "988801": [], "992079": [], "992092": [], "820933": [], "820983": [], "821002": [], "821194": [], "382": 16, "futurewarn": 16, "concat": 16, "temp": 16, "ohe_base_df": 16, "ignore_index": 16, "sort": 16, "019": 16, "911": 16, "755": 16, "dice_getting_start": 16, "nonetheless": 16, "raiutil": [9, 10, 11, 13, 14, 16], "9608": 9, "22027": 9, "14296": 9, "tmp": 9, "ipykernel_2173": 9, "3514951616": 9, "settingwithcopywarn": 9, "copi": 9, "slice": 9, "row_index": 9, "col_index": 9, "caveat": 9, "document": 9, "pydata": 9, "user_guid": 9, "view": 9, "versu": 9, "92it": 9, "17it": [9, 11], "34it": 9, "91it": 9, "04it": [9, 13], "86it": 10, "70it": 10, "55it": 10, "08": [10, 11], "06": [10, 11, 16], "58": [10, 13, 16], "89it": 11, "66it": 11, "37it": 11, "095": 11, "2023": [11, 16], "752470": 11, "756608": 11, "756625": 11, "948236": 11, "948388": 11, "948454": 11, "948952": 11, "44it": 11, "cell_typ": 12, "markdown": 12, "execution_count": 12, "dicen": 12, "dice_mln": 12, "functionsn": 12, "n": 12, "autoreloadn": 12, "dice_with_private_data": 12, "ipynb": 12, "scroll": 12, "featuresn": 12, "valuen": 12, "counterfactualsn": 12, "resultsn": 12, "constraintsn": 12, "monotonicn": 12, "nbsphinx": 12, "kernelspec": 12, "display_nam": 12, "language_info": 12, "codemirror_mod": 12, "ipython": 12, "file_extens": 12, "mimetyp": 12, "text": 12, "nbconvert_export": 12, "pygments_lex": 12, "ipython3": 12, "toc": 12, "base_numb": 12, "nav_menu": 12, "number_sect": 12, "sidebar": 12, "skip_h1_titl": 12, "title_cel": 12, "title_sidebar": 12, "toc_cel": 12, "toc_posit": 12, "toc_section_displai": 12, "toc_window_displai": 12, "varinspector": 12, "lennam": 12, "lentyp": 12, "lenvar": 12, "kernels_config": 12, "delete_cmd_postfix": 12, "delete_cmd_prefix": 12, "var_list": 12, "varrefreshcmd": 12, "var_dic_list": 12, "rm": 12, "types_to_exclud": 12, "builtin_function_or_method": 12, "_featur": 12, "window_displai": 12, "nbformat": 12, "nbformat_minor": 12, "79it": 13, "07it": 13, "perhap": 13, "45it": 13, "73it": 13, "6646": 13, "11233": 13, "23580": 13, "2571": 13, "15736": 13, "20071": 13, "17010": 13, "15712": 13, "20it": 13, "1267": 13, "554": 13, "32it": 13, "12896": 13, "5064": 13, "64it": 14, "39714": 14, "4560403999999965": 14, "2037501000000015": 14, "8702": 14, "962199599999989": 14, "193990299999995": 14, "438123": 16, "443679": 16, "443700": 16, "996181": 16, "996275": 16, "996300": 16, "996628": 16}, "objects": {"": [[0, 0, 0, "-", "dice_ml"]], "dice_ml": [[0, 1, 1, "", "Data"], [0, 1, 1, "", "Dice"], [0, 1, 1, "", "Model"], [0, 0, 0, "-", "constants"], [0, 0, 0, "-", "counterfactual_explanations"], [0, 0, 0, "-", "data"], [1, 0, 0, "-", "data_interfaces"], [0, 0, 0, "-", "dice"], [0, 0, 0, "-", "diverse_counterfactuals"], [2, 0, 0, "-", "explainer_interfaces"], [0, 0, 0, "-", "model"], [3, 0, 0, "-", "model_interfaces"], [4, 0, 0, "-", "schema"], [5, 0, 0, "-", "utils"]], "dice_ml.Data": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.Dice": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.Model": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.constants": [[0, 1, 1, "", "BackEndTypes"], [0, 1, 1, "", "ModelTypes"], [0, 1, 1, "", "SamplingStrategy"]], "dice_ml.constants.BackEndTypes": [[0, 3, 1, "", "ALL"], [0, 3, 1, "", "Pytorch"], [0, 3, 1, "", "Sklearn"], [0, 3, 1, "", "Tensorflow1"], [0, 3, 1, "", "Tensorflow2"]], "dice_ml.constants.ModelTypes": [[0, 3, 1, "", "ALL"], [0, 3, 1, "", "Classifier"], [0, 3, 1, "", "Regressor"]], "dice_ml.constants.SamplingStrategy": [[0, 3, 1, "", "Genetic"], [0, 3, 1, "", "Gradient"], [0, 3, 1, "", "KdTree"], [0, 3, 1, "", "Random"]], "dice_ml.counterfactual_explanations": [[0, 1, 1, "", "CounterfactualExplanations"]], "dice_ml.counterfactual_explanations.CounterfactualExplanations": [[0, 4, 1, "", "cf_examples_list"], [0, 2, 1, "", "from_json"], [0, 4, 1, "", "local_importance"], [0, 4, 1, "", "metadata"], [0, 4, 1, "", "summary_importance"], [0, 2, 1, "", "to_json"], [0, 2, 1, "", "visualize_as_dataframe"], [0, 2, 1, "", "visualize_as_list"]], "dice_ml.data": [[0, 1, 1, "", "Data"], [0, 5, 1, "", "decide"]], "dice_ml.data.Data": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.data_interfaces": [[1, 0, 0, "-", "base_data_interface"], [1, 0, 0, "-", "private_data_interface"], [1, 0, 0, "-", "public_data_interface"]], "dice_ml.data_interfaces.private_data_interface": [[1, 1, 1, "", "PrivateData"]], "dice_ml.data_interfaces.private_data_interface.PrivateData": [[1, 2, 1, "", "create_ohe_params"], [1, 2, 1, "", "de_normalize_data"], [1, 2, 1, "", "fit_label_encoders"], [1, 2, 1, "", "from_dummies"], [1, 2, 1, "", "from_label"], [1, 2, 1, "", "get_all_dummy_colnames"], [1, 2, 1, "", "get_data_params_for_gradient_dice"], [1, 2, 1, "", "get_decimal_precisions"], [1, 2, 1, "", "get_decoded_data"], [1, 2, 1, "", "get_encoded_categorical_feature_indexes"], [1, 2, 1, "", "get_features_range"], [1, 2, 1, "", "get_indexes_of_features_to_vary"], [1, 2, 1, "", "get_inverse_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_mads"], [1, 2, 1, "", "get_minx_maxx"], [1, 2, 1, "", "get_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_valid_feature_range"], [1, 2, 1, "", "get_valid_mads"], [1, 2, 1, "", "normalize_data"], [1, 2, 1, "", "one_hot_encode_data"], [1, 2, 1, "", "prepare_df_for_ohe_encoding"], [1, 2, 1, "", "prepare_query_instance"]], "dice_ml.data_interfaces.public_data_interface": [[1, 1, 1, "", "PublicData"]], "dice_ml.data_interfaces.public_data_interface.PublicData": [[1, 2, 1, "", "create_ohe_params"], [1, 2, 1, "", "de_normalize_data"], [1, 2, 1, "", "fit_label_encoders"], [1, 2, 1, "", "from_dummies"], [1, 2, 1, "", "from_label"], [1, 2, 1, "", "get_all_dummy_colnames"], [1, 2, 1, "", "get_data_params_for_gradient_dice"], [1, 2, 1, "", "get_data_type"], [1, 2, 1, "", "get_decimal_precisions"], [1, 2, 1, "", "get_decoded_data"], [1, 2, 1, "", "get_encoded_categorical_feature_indexes"], [1, 2, 1, "", "get_features_range"], [1, 2, 1, "", "get_indexes_of_features_to_vary"], [1, 2, 1, "", "get_inverse_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_mads"], [1, 2, 1, "", "get_minx_maxx"], [1, 2, 1, "", "get_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_quantiles_from_training_data"], [1, 2, 1, "", "get_valid_feature_range"], [1, 2, 1, "", "get_valid_mads"], [1, 2, 1, "", "normalize_data"], [1, 2, 1, "", "one_hot_encode_data"], [1, 2, 1, "", "prepare_df_for_ohe_encoding"], [1, 2, 1, "", "prepare_query_instance"]], "dice_ml.dice": [[0, 1, 1, "", "Dice"], [0, 5, 1, "", "decide"]], "dice_ml.dice.Dice": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.diverse_counterfactuals": [[0, 1, 1, "", "CounterfactualExamples"], [0, 5, 1, "", "json_converter"]], "dice_ml.diverse_counterfactuals.CounterfactualExamples": [[0, 2, 1, "", "display_df"], [0, 2, 1, "", "from_json"], [0, 2, 1, "", "print_list"], [0, 2, 1, "", "to_json"], [0, 2, 1, "", "visualize_as_dataframe"], [0, 2, 1, "", "visualize_as_list"]], "dice_ml.explainer_interfaces": [[2, 0, 0, "-", "dice_KD"], [2, 0, 0, "-", "dice_genetic"], [2, 0, 0, "-", "dice_pytorch"], [2, 0, 0, "-", "dice_random"], [2, 0, 0, "-", "dice_tensorflow1"], [2, 0, 0, "-", "dice_tensorflow2"], [2, 0, 0, "-", "explainer_base"], [2, 0, 0, "-", "feasible_base_vae"], [2, 0, 0, "-", "feasible_model_approx"]], "dice_ml.explainer_interfaces.dice_KD": [[2, 1, 1, "", "DiceKD"]], "dice_ml.explainer_interfaces.dice_KD.DiceKD": [[2, 2, 1, "", "do_sparsity_check"], [2, 2, 1, "", "duplicates"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "vary_valid"]], "dice_ml.explainer_interfaces.dice_genetic": [[2, 1, 1, "", "DiceGenetic"]], "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic": [[2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_sparsity_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_KD_init"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_param_initializations"], [2, 2, 1, "", "do_random_init"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "get_valid_feature_range"], [2, 2, 1, "", "label_decode"], [2, 2, 1, "", "label_decode_cfs"], [2, 2, 1, "", "label_encode"], [2, 2, 1, "", "mate"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_scores"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.dice_pytorch": [[2, 1, 1, "", "DicePyTorch"]], "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch": [[2, 2, 1, "", "compute_dist"], [2, 2, 1, "", "compute_diversity_loss"], [2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_regularization_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_optimizer_initializations"], [2, 2, 1, "", "dpp_style"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "get_model_output"], [2, 2, 1, "", "initialize_CFs"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_off_cfs"], [2, 2, 1, "", "stop_loop"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.dice_random": [[2, 1, 1, "", "DiceRandom"]], "dice_ml.explainer_interfaces.dice_random.DiceRandom": [[2, 2, 1, "", "get_continuous_samples"], [2, 2, 1, "", "get_samples"]], "dice_ml.explainer_interfaces.dice_tensorflow1": [[2, 1, 1, "", "DiceTensorFlow1"]], "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1": [[2, 2, 1, "", "compute_dist"], [2, 2, 1, "", "compute_diversity_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_regularization_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_optimizer_initializations"], [2, 2, 1, "", "dpp_style"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "initialize_CFs"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_off_cfs"], [2, 2, 1, "", "scipy_optimizers"], [2, 2, 1, "", "stop_loop"], [2, 2, 1, "", "tensorflow_optimizers"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.dice_tensorflow2": [[2, 1, 1, "", "DiceTensorFlow2"]], "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2": [[2, 2, 1, "", "compute_dist"], [2, 2, 1, "", "compute_diversity_loss"], [2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_regularization_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_optimizer_initializations"], [2, 2, 1, "", "dpp_style"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "initialize_CFs"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_off_cfs"], [2, 2, 1, "", "stop_loop"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.explainer_base": [[2, 1, 1, "", "ExplainerBase"]], "dice_ml.explainer_interfaces.explainer_base.ExplainerBase": [[2, 2, 1, "", "build_KD_tree"], [2, 2, 1, "", "check_permitted_range"], [2, 2, 1, "", "check_query_instance_validity"], [2, 2, 1, "", "decide_cf_validity"], [2, 2, 1, "", "deserialize_explainer"], [2, 2, 1, "", "do_binary_search"], [2, 2, 1, "", "do_linear_search"], [2, 2, 1, "", "do_posthoc_sparsity_enhancement"], [2, 2, 1, "", "feature_importance"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "get_model_output_from_scores"], [2, 2, 1, "", "global_feature_importance"], [2, 2, 1, "", "infer_target_cfs_class"], [2, 2, 1, "", "infer_target_cfs_range"], [2, 2, 1, "", "is_cf_valid"], [2, 2, 1, "", "local_feature_importance"], [2, 2, 1, "", "misc_init"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_to_precision"], [2, 2, 1, "", "serialize_explainer"], [2, 2, 1, "", "setup"], [2, 2, 1, "", "sigmoid"]], "dice_ml.explainer_interfaces.feasible_base_vae": [[2, 1, 1, "", "FeasibleBaseVAE"]], "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE": [[2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "train"]], "dice_ml.explainer_interfaces.feasible_model_approx": [[2, 1, 1, "", "FeasibleModelApprox"]], "dice_ml.explainer_interfaces.feasible_model_approx.FeasibleModelApprox": [[2, 2, 1, "", "train"]], "dice_ml.model": [[0, 1, 1, "", "Model"], [0, 5, 1, "", "decide"]], "dice_ml.model.Model": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.model_interfaces": [[3, 0, 0, "-", "base_model"], [3, 0, 0, "-", "keras_tensorflow_model"], [3, 0, 0, "-", "pytorch_model"]], "dice_ml.model_interfaces.base_model": [[3, 1, 1, "", "BaseModel"]], "dice_ml.model_interfaces.base_model.BaseModel": [[3, 2, 1, "", "get_gradient"], [3, 2, 1, "", "get_num_output_nodes"], [3, 2, 1, "", "get_num_output_nodes2"], [3, 2, 1, "", "get_output"], [3, 2, 1, "", "load_model"]], "dice_ml.model_interfaces.keras_tensorflow_model": [[3, 1, 1, "", "KerasTensorFlowModel"]], "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel": [[3, 2, 1, "", "get_gradient"], [3, 2, 1, "", "get_num_output_nodes"], [3, 2, 1, "", "get_output"], [3, 2, 1, "", "load_model"]], "dice_ml.model_interfaces.pytorch_model": [[3, 1, 1, "", "PyTorchModel"]], "dice_ml.model_interfaces.pytorch_model.PyTorchModel": [[3, 2, 1, "", "get_gradient"], [3, 2, 1, "", "get_num_output_nodes"], [3, 2, 1, "", "get_output"], [3, 2, 1, "", "load_model"], [3, 2, 1, "", "set_eval_mode"]], "dice_ml.utils": [[5, 0, 0, "-", "exception"], [5, 0, 0, "-", "helpers"], [5, 0, 0, "-", "neuralnetworks"], [6, 0, 0, "-", "sample_architecture"], [5, 0, 0, "-", "serialize"]], "dice_ml.utils.exception": [[5, 6, 1, "", "SystemException"], [5, 6, 1, "", "UserConfigValidationException"]], "dice_ml.utils.helpers": [[5, 1, 1, "", "DataTransfomer"], [5, 5, 1, "", "get_adult_data_info"], [5, 5, 1, "", "get_adult_income_modelpath"], [5, 5, 1, "", "get_base_gen_cf_initialization"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline_binary"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline_multiclass"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline_regression"], [5, 5, 1, "", "get_custom_vars_dataset_modelpath_pipeline"], [5, 5, 1, "", "inverse_ohe_min_max_transformation"], [5, 5, 1, "", "load_adult_income_dataset"], [5, 5, 1, "", "load_custom_testing_dataset"], [5, 5, 1, "", "load_custom_testing_dataset_binary"], [5, 5, 1, "", "load_custom_testing_dataset_multiclass"], [5, 5, 1, "", "load_custom_testing_dataset_regression"], [5, 5, 1, "", "load_min_max_equal_dataset"], [5, 5, 1, "", "load_outcome_not_last_column_dataset"], [5, 5, 1, "", "ohe_min_max_transformation"], [5, 5, 1, "", "save_adult_income_model"]], "dice_ml.utils.helpers.DataTransfomer": [[5, 2, 1, "", "feed_data_params"], [5, 2, 1, "", "initialize_transform_func"], [5, 2, 1, "", "inverse_transform"], [5, 2, 1, "", "transform"]], "dice_ml.utils.neuralnetworks": [[5, 1, 1, "", "FFNetwork"]], "dice_ml.utils.neuralnetworks.FFNetwork": [[5, 2, 1, "", "forward"]], "dice_ml.utils.sample_architecture": [[6, 0, 0, "-", "vae_model"]], "dice_ml.utils.sample_architecture.vae_model": [[6, 1, 1, "", "AutoEncoder"], [6, 1, 1, "", "CF_VAE"]], "dice_ml.utils.sample_architecture.vae_model.AutoEncoder": [[6, 2, 1, "", "decoder"], [6, 2, 1, "", "encoder"], [6, 2, 1, "", "forward"], [6, 2, 1, "", "normal_likelihood"], [6, 2, 1, "", "sample_latent_code"], [6, 3, 1, "", "training"]], "dice_ml.utils.sample_architecture.vae_model.CF_VAE": [[6, 2, 1, "", "compute_elbo"], [6, 2, 1, "", "decoder"], [6, 2, 1, "", "encoder"], [6, 2, 1, "", "forward"], [6, 2, 1, "", "normal_likelihood"], [6, 2, 1, "", "sample_latent_code"], [6, 3, 1, "", "training"]], "dice_ml.utils.serialize": [[5, 1, 1, "", "DummyDataInterface"]], "dice_ml.utils.serialize.DummyDataInterface": [[5, 2, 1, "", "to_json"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:attribute", "4": "py:property", "5": "py:function", "6": "py:exception"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "attribute", "Python attribute"], "4": ["py", "property", "Python property"], "5": ["py", "function", "Python function"], "6": ["py", "exception", "Python exception"]}, "titleterms": {"dice_ml": [0, 1, 2, 3, 4, 5, 6, 8], "packag": [0, 1, 2, 3, 4, 5, 6, 7], "subpackag": [0, 5], "submodul": [0, 1, 2, 3, 5, 6], "constant": 0, "modul": [0, 1, 2, 3, 4, 5, 6], "counterfactual_explan": 0, "data": [0, 10, 16], "dice": [0, 7, 10, 11, 18], "diverse_counterfactu": 0, "model": [0, 9, 10, 11, 13, 14, 15, 16], "content": [0, 1, 2, 3, 4, 5, 6], "data_interfac": 1, "base_data_interfac": 1, "private_data_interfac": 1, "public_data_interfac": 1, "explainer_interfac": 2, "dice_kd": 2, "dice_genet": 2, "dice_pytorch": 2, "dice_random": 2, "dice_tensorflow1": 2, "dice_tensorflow2": 2, "explainer_bas": 2, "feasible_base_va": 2, "feasible_model_approx": 2, "model_interfac": 3, "base_model": 3, "keras_tensorflow_model": 3, "pytorch_model": 3, "schema": 4, "util": [5, 6], "except": 5, "helper": 5, "neuralnetwork": 5, "serial": 5, "sample_architectur": 6, "vae_model": 6, "divers": [7, 13, 15, 16, 18], "counterfactu": [7, 9, 10, 11, 13, 14, 15, 16, 18], "explan": [7, 9, 11, 13, 15, 16, 18], "ml": [7, 9, 10, 11, 13, 15, 18], "instal": [7, 18], "get": [7, 18], "start": [7, 18], "support": [7, 18], "method": [7, 9, 18], "gener": [7, 9, 11, 13, 14, 15, 16, 18], "us": [7, 10, 11, 18], "case": [7, 18], "feasibl": [7, 18], "The": [7, 18], "promis": [7, 18], "roadmap": [7, 18], "cite": [7, 18], "contribut": [7, 18], "notebook": [7, 17], "indic": 7, "tabl": 7, "benchmark": 9, "differ": 9, "cf": 9, "load": [9, 10, 11, 13, 15], "dataset": [9, 11, 13, 15], "train": [9, 11, 13, 16], "initi": 9, "estim": 10, "local": [10, 11], "global": [10, 11], "featur": [10, 11, 13, 15], "import": [10, 11], "score": [10, 11], "preliminari": [10, 11], "convert": 10, "output": 10, "json": 10, "object": 10, "quick": 11, "introduct": 11, "over": 11, "adult": 11, "exampl": 11, "attribut": 11, "work": 11, "deep": [11, 16], "learn": [11, 16], "tensorflow": 11, "pytorch": 11, "explain": [11, 16], "more": 11, "resourc": 11, "what": 11, "": 11, "next": 11, "vae": [], "ad": [], "constraint": [], "modelapprox": [], "initil": [], "feasiblemodelapprox": [], "ani": 13, "1": [13, 15], "independ": 13, "random": 13, "sampl": 13, "custom": [13, 15], "select": 13, "vari": 13, "choos": 13, "rang": 13, "2": [13, 15], "genet": 13, "algorithm": 13, "3": [13, 15], "queri": 13, "kd": 13, "tree": 13, "multi": 14, "class": 14, "classif": 14, "regress": 14, "multiclass": 14, "advanc": 15, "option": 15, "chang": 15, "weight": 15, "trade": 15, "off": 15, "between": 15, "proxim": 15, "goal": 15, "without": 16, "access": 16, "defin": 16, "meta": 16, "pre": 16, "sklearn": 16}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.todo": 2, "nbsphinx": 4, "sphinx": 57}, "alltitles": {"dice_ml package": [[0, "dice-ml-package"]], "Subpackages": [[0, "subpackages"], [5, "subpackages"]], "Submodules": [[0, "submodules"], [1, "submodules"], [2, "submodules"], [3, "submodules"], [5, "submodules"], [6, "submodules"]], "dice_ml.constants module": [[0, "module-dice_ml.constants"]], "dice_ml.counterfactual_explanations module": [[0, "module-dice_ml.counterfactual_explanations"]], "dice_ml.data module": [[0, "module-dice_ml.data"]], "dice_ml.dice module": [[0, "module-dice_ml.dice"]], "dice_ml.diverse_counterfactuals module": [[0, "module-dice_ml.diverse_counterfactuals"]], "dice_ml.model module": [[0, "module-dice_ml.model"]], "Module contents": [[0, "module-dice_ml"], [1, "module-dice_ml.data_interfaces"], [2, "module-dice_ml.explainer_interfaces"], [3, "module-dice_ml.model_interfaces"], [4, "module-dice_ml.schema"], [5, "module-dice_ml.utils"], [6, "module-dice_ml.utils.sample_architecture"]], "dice_ml.data_interfaces package": [[1, "dice-ml-data-interfaces-package"]], "dice_ml.data_interfaces.base_data_interface module": [[1, "module-dice_ml.data_interfaces.base_data_interface"]], "dice_ml.data_interfaces.private_data_interface module": [[1, "module-dice_ml.data_interfaces.private_data_interface"]], "dice_ml.data_interfaces.public_data_interface module": [[1, "module-dice_ml.data_interfaces.public_data_interface"]], "dice_ml.explainer_interfaces package": [[2, "dice-ml-explainer-interfaces-package"]], "dice_ml.explainer_interfaces.dice_KD module": [[2, "module-dice_ml.explainer_interfaces.dice_KD"]], "dice_ml.explainer_interfaces.dice_genetic module": [[2, "module-dice_ml.explainer_interfaces.dice_genetic"]], "dice_ml.explainer_interfaces.dice_pytorch module": [[2, "module-dice_ml.explainer_interfaces.dice_pytorch"]], "dice_ml.explainer_interfaces.dice_random module": [[2, "module-dice_ml.explainer_interfaces.dice_random"]], "dice_ml.explainer_interfaces.dice_tensorflow1 module": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow1"]], "dice_ml.explainer_interfaces.dice_tensorflow2 module": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow2"]], "dice_ml.explainer_interfaces.explainer_base module": [[2, "module-dice_ml.explainer_interfaces.explainer_base"]], "dice_ml.explainer_interfaces.feasible_base_vae module": [[2, "module-dice_ml.explainer_interfaces.feasible_base_vae"]], "dice_ml.explainer_interfaces.feasible_model_approx module": [[2, "module-dice_ml.explainer_interfaces.feasible_model_approx"]], "dice_ml.model_interfaces package": [[3, "dice-ml-model-interfaces-package"]], "dice_ml.model_interfaces.base_model module": [[3, "module-dice_ml.model_interfaces.base_model"]], "dice_ml.model_interfaces.keras_tensorflow_model module": [[3, "module-dice_ml.model_interfaces.keras_tensorflow_model"]], "dice_ml.model_interfaces.pytorch_model module": [[3, "module-dice_ml.model_interfaces.pytorch_model"]], "dice_ml.schema package": [[4, "dice-ml-schema-package"]], "dice_ml.utils package": [[5, "dice-ml-utils-package"]], "dice_ml.utils.exception module": [[5, "module-dice_ml.utils.exception"]], "dice_ml.utils.helpers module": [[5, "module-dice_ml.utils.helpers"]], "dice_ml.utils.neuralnetworks module": [[5, "module-dice_ml.utils.neuralnetworks"]], "dice_ml.utils.serialize module": [[5, "module-dice_ml.utils.serialize"]], "dice_ml.utils.sample_architecture package": [[6, "dice-ml-utils-sample-architecture-package"]], "dice_ml.utils.sample_architecture.vae_model module": [[6, "module-dice_ml.utils.sample_architecture.vae_model"]], "Diverse Counterfactual Explanations (DiCE) for ML": [[7, "diverse-counterfactual-explanations-dice-for-ml"], [18, "diverse-counterfactual-explanations-dice-for-ml"]], "Installing DICE": [[7, "installing-dice"], [18, "installing-dice"]], "Getting started with DiCE": [[7, "getting-started-with-dice"], [18, "getting-started-with-dice"]], "Supported methods for generating counterfactuals": [[7, "supported-methods-for-generating-counterfactuals"], [18, "supported-methods-for-generating-counterfactuals"]], "Supported use-cases": [[7, "supported-use-cases"], [18, "supported-use-cases"]], "Feasibility of counterfactual explanations": [[7, "feasibility-of-counterfactual-explanations"], [18, "feasibility-of-counterfactual-explanations"]], "The promise of counterfactual explanations": [[7, "the-promise-of-counterfactual-explanations"], [18, "the-promise-of-counterfactual-explanations"]], "Roadmap": [[7, "roadmap"], [18, "roadmap"]], "Citing": [[7, "citing"], [18, "citing"]], "Contributing": [[7, "contributing"], [18, "contributing"]], "Getting Started:": [[7, null]], "Notebooks:": [[7, null], [17, null]], "Package:": [[7, null]], "Indices and tables": [[7, "indices-and-tables"]], "dice_ml": [[8, "dice-ml"]], "Benchmarking different CF explanation methods": [[9, "Benchmarking-different-CF-explanation-methods"]], "Loading dataset": [[9, "Loading-dataset"], [13, "Loading-dataset"], [15, "Loading-dataset"]], "Training the ML model": [[9, "Training-the-ML-model"]], "Initialize counterfactual generation methods": [[9, "Initialize-counterfactual-generation-methods"]], "Generate Counterfactuals": [[9, "Generate-Counterfactuals"]], "Estimating local and global feature importance scores using DiCE": [[10, "Estimating-local-and-global-feature-importance-scores-using-DiCE"]], "Preliminaries: Loading the data and ML model": [[10, "Preliminaries:-Loading-the-data-and-ML-model"]], "Local feature importance": [[10, "Local-feature-importance"]], "Global importance": [[10, "Global-importance"]], "Convert the counterfactual output to json": [[10, "Convert-the-counterfactual-output-to-json"]], "Convert the json output to a counterfactual object": [[10, "Convert-the-json-output-to-a-counterfactual-object"]], "Quick introduction to generating counterfactual explanations using DiCE": [[11, "Quick-introduction-to-generating-counterfactual-explanations-using-DiCE"]], "Preliminaries: Loading a dataset and a ML model trained over it": [[11, "Preliminaries:-Loading-a-dataset-and-a-ML-model-trained-over-it"]], "Loading the Adult dataset": [[11, "Loading-the-Adult-dataset"]], "Loading the ML model": [[11, "Loading-the-ML-model"]], "Generating counterfactual examples using DiCE": [[11, "Generating-counterfactual-examples-using-DiCE"]], "Generating feature attributions (local and global) using DiCE": [[11, "Generating-feature-attributions-(local-and-global)-using-DiCE"]], "Local feature importance scores": [[11, "Local-feature-importance-scores"]], "Global feature importance scores": [[11, "Global-feature-importance-scores"]], "Working with deep learning models (TensorFlow and PyTorch)": [[11, "Working-with-deep-learning-models-(TensorFlow-and-PyTorch)"]], "Explaining a Tensorflow model": [[11, "Explaining-a-Tensorflow-model"]], "Explaining a Pytorch model": [[11, "Explaining-a-Pytorch-model"]], "More resources: What\u2019s next?": [[11, "More-resources:-What\u2019s-next?"]], "Generating counterfactual explanations with any ML model": [[13, "Generating-counterfactual-explanations-with-any-ML-model"]], "1. Independent random sampling of features": [[13, "1.-Independent-random-sampling-of-features"]], "Training a custom ML model": [[13, "Training-a-custom-ML-model"], [13, "id1"], [13, "id3"]], "Generate diverse counterfactuals": [[13, "Generate-diverse-counterfactuals"], [13, "id2"], [13, "id4"], [15, "Generate-diverse-counterfactuals"], [16, "Generate-diverse-counterfactuals"], [16, "id1"]], "Selecting the features to vary": [[13, "Selecting-the-features-to-vary"], [13, "id5"]], "Choosing feature ranges": [[13, "Choosing-feature-ranges"]], "2. Genetic Algorithm": [[13, "2.-Genetic-Algorithm"]], "3. Querying a KD Tree": [[13, "3.-Querying-a-KD-Tree"]], "Selecting the feature ranges": [[13, "Selecting-the-feature-ranges"]], "Generating counterfactuals for multi-class classification and regression models": [[14, "Generating-counterfactuals-for-multi-class-classification-and-regression-models"]], "Multiclass Classification": [[14, "Multiclass-Classification"]], "Regression": [[14, "Regression"]], "Advanced options to customize Counterfactual Explanations": [[15, "Advanced-options-to-customize-Counterfactual-Explanations"]], "1. Loading a custom ML model": [[15, "1.-Loading-a-custom-ML-model"]], "2. Changing feature weights": [[15, "2.-Changing-feature-weights"]], "3. Trading off between proximity and diversity goals": [[15, "3.-Trading-off-between-proximity-and-diversity-goals"]], "Generating counterfactual explanations without access to training data": [[16, "Generating-counterfactual-explanations-without-access-to-training-data"]], "Defining meta data": [[16, "Defining-meta-data"]], "Explaining pre-trained sklearn models": [[16, "Explaining-pre-trained-sklearn-models"]], "Explaining pre-trained deep learning models": [[16, "Explaining-pre-trained-deep-learning-models"]]}, "indexentries": {"all (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.ALL"]], "all (dice_ml.constants.modeltypes attribute)": [[0, "dice_ml.constants.ModelTypes.ALL"]], "backendtypes (class in dice_ml.constants)": [[0, "dice_ml.constants.BackEndTypes"]], "classifier (dice_ml.constants.modeltypes attribute)": [[0, "dice_ml.constants.ModelTypes.Classifier"]], "counterfactualexamples (class in dice_ml.diverse_counterfactuals)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples"]], "counterfactualexplanations (class in dice_ml.counterfactual_explanations)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations"]], "data (class in dice_ml)": [[0, "dice_ml.Data"]], "data (class in dice_ml.data)": [[0, "dice_ml.data.Data"]], "dice (class in dice_ml)": [[0, "dice_ml.Dice"]], "dice (class in dice_ml.dice)": [[0, "dice_ml.dice.Dice"]], "genetic (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.Genetic"]], "gradient (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.Gradient"]], "kdtree (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.KdTree"]], "model (class in dice_ml)": [[0, "dice_ml.Model"]], "model (class in dice_ml.model)": [[0, "dice_ml.model.Model"]], "modeltypes (class in dice_ml.constants)": [[0, "dice_ml.constants.ModelTypes"]], "pytorch (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Pytorch"]], "random (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.Random"]], "regressor (dice_ml.constants.modeltypes attribute)": [[0, "dice_ml.constants.ModelTypes.Regressor"]], "samplingstrategy (class in dice_ml.constants)": [[0, "dice_ml.constants.SamplingStrategy"]], "sklearn (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Sklearn"]], "tensorflow1 (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Tensorflow1"]], "tensorflow2 (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Tensorflow2"]], "cf_examples_list (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.cf_examples_list"]], "decide() (in module dice_ml.data)": [[0, "dice_ml.data.decide"]], "decide() (in module dice_ml.dice)": [[0, "dice_ml.dice.decide"]], "decide() (in module dice_ml.model)": [[0, "dice_ml.model.decide"]], "decide_implementation_type() (dice_ml.data method)": [[0, "dice_ml.Data.decide_implementation_type"]], "decide_implementation_type() (dice_ml.dice method)": [[0, "dice_ml.Dice.decide_implementation_type"]], "decide_implementation_type() (dice_ml.model method)": [[0, "dice_ml.Model.decide_implementation_type"]], "decide_implementation_type() (dice_ml.data.data method)": [[0, "dice_ml.data.Data.decide_implementation_type"]], "decide_implementation_type() (dice_ml.dice.dice method)": [[0, "dice_ml.dice.Dice.decide_implementation_type"]], "decide_implementation_type() (dice_ml.model.model method)": [[0, "dice_ml.model.Model.decide_implementation_type"]], "dice_ml": [[0, "module-dice_ml"]], "dice_ml.constants": [[0, "module-dice_ml.constants"]], "dice_ml.counterfactual_explanations": [[0, "module-dice_ml.counterfactual_explanations"]], "dice_ml.data": [[0, "module-dice_ml.data"]], "dice_ml.dice": [[0, "module-dice_ml.dice"]], "dice_ml.diverse_counterfactuals": [[0, "module-dice_ml.diverse_counterfactuals"]], "dice_ml.model": [[0, "module-dice_ml.model"]], "display_df() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.display_df"]], "from_json() (dice_ml.counterfactual_explanations.counterfactualexplanations static method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.from_json"]], "from_json() (dice_ml.diverse_counterfactuals.counterfactualexamples static method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.from_json"]], "json_converter() (in module dice_ml.diverse_counterfactuals)": [[0, "dice_ml.diverse_counterfactuals.json_converter"]], "local_importance (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.local_importance"]], "metadata (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.metadata"]], "module": [[0, "module-dice_ml"], [0, "module-dice_ml.constants"], [0, "module-dice_ml.counterfactual_explanations"], [0, "module-dice_ml.data"], [0, "module-dice_ml.dice"], [0, "module-dice_ml.diverse_counterfactuals"], [0, "module-dice_ml.model"], [1, "module-dice_ml.data_interfaces"], [1, "module-dice_ml.data_interfaces.base_data_interface"], [1, "module-dice_ml.data_interfaces.private_data_interface"], [1, "module-dice_ml.data_interfaces.public_data_interface"], [2, "module-dice_ml.explainer_interfaces"], [2, "module-dice_ml.explainer_interfaces.dice_KD"], [2, "module-dice_ml.explainer_interfaces.dice_genetic"], [2, "module-dice_ml.explainer_interfaces.dice_pytorch"], [2, "module-dice_ml.explainer_interfaces.dice_random"], [2, "module-dice_ml.explainer_interfaces.dice_tensorflow1"], [2, "module-dice_ml.explainer_interfaces.dice_tensorflow2"], [2, "module-dice_ml.explainer_interfaces.explainer_base"], [2, "module-dice_ml.explainer_interfaces.feasible_base_vae"], [2, "module-dice_ml.explainer_interfaces.feasible_model_approx"], [3, "module-dice_ml.model_interfaces"], [3, "module-dice_ml.model_interfaces.base_model"], [3, "module-dice_ml.model_interfaces.keras_tensorflow_model"], [3, "module-dice_ml.model_interfaces.pytorch_model"], [4, "module-dice_ml.schema"], [5, "module-dice_ml.utils"], [5, "module-dice_ml.utils.exception"], [5, "module-dice_ml.utils.helpers"], [5, "module-dice_ml.utils.neuralnetworks"], [5, "module-dice_ml.utils.serialize"], [6, "module-dice_ml.utils.sample_architecture"], [6, "module-dice_ml.utils.sample_architecture.vae_model"]], "print_list() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.print_list"]], "summary_importance (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.summary_importance"]], "to_json() (dice_ml.counterfactual_explanations.counterfactualexplanations method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.to_json"]], "to_json() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.to_json"]], "visualize_as_dataframe() (dice_ml.counterfactual_explanations.counterfactualexplanations method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.visualize_as_dataframe"]], "visualize_as_dataframe() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.visualize_as_dataframe"]], "visualize_as_list() (dice_ml.counterfactual_explanations.counterfactualexplanations method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.visualize_as_list"]], "visualize_as_list() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.visualize_as_list"]], "privatedata (class in dice_ml.data_interfaces.private_data_interface)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData"]], "publicdata (class in dice_ml.data_interfaces.public_data_interface)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData"]], "create_ohe_params() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.create_ohe_params"]], "create_ohe_params() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.create_ohe_params"]], "de_normalize_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.de_normalize_data"]], "de_normalize_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.de_normalize_data"]], "dice_ml.data_interfaces": [[1, "module-dice_ml.data_interfaces"]], "dice_ml.data_interfaces.base_data_interface": [[1, "module-dice_ml.data_interfaces.base_data_interface"]], "dice_ml.data_interfaces.private_data_interface": [[1, "module-dice_ml.data_interfaces.private_data_interface"]], "dice_ml.data_interfaces.public_data_interface": [[1, "module-dice_ml.data_interfaces.public_data_interface"]], "fit_label_encoders() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.fit_label_encoders"]], "fit_label_encoders() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.fit_label_encoders"]], "from_dummies() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.from_dummies"]], "from_dummies() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.from_dummies"]], "from_label() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.from_label"]], "from_label() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.from_label"]], "get_all_dummy_colnames() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_all_dummy_colnames"]], "get_all_dummy_colnames() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_all_dummy_colnames"]], "get_data_params_for_gradient_dice() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_data_params_for_gradient_dice"]], "get_data_params_for_gradient_dice() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_data_params_for_gradient_dice"]], "get_data_type() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_data_type"]], "get_decimal_precisions() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_decimal_precisions"]], "get_decimal_precisions() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_decimal_precisions"]], "get_decoded_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_decoded_data"]], "get_decoded_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_decoded_data"]], "get_encoded_categorical_feature_indexes() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_encoded_categorical_feature_indexes"]], "get_encoded_categorical_feature_indexes() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_encoded_categorical_feature_indexes"]], "get_features_range() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_features_range"]], "get_features_range() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_features_range"]], "get_indexes_of_features_to_vary() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_indexes_of_features_to_vary"]], "get_indexes_of_features_to_vary() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_indexes_of_features_to_vary"]], "get_inverse_ohe_min_max_normalized_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_inverse_ohe_min_max_normalized_data"]], "get_inverse_ohe_min_max_normalized_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_inverse_ohe_min_max_normalized_data"]], "get_mads() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_mads"]], "get_mads() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_mads"]], "get_minx_maxx() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_minx_maxx"]], "get_minx_maxx() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_minx_maxx"]], "get_ohe_min_max_normalized_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_ohe_min_max_normalized_data"]], "get_ohe_min_max_normalized_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_ohe_min_max_normalized_data"]], "get_quantiles_from_training_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_quantiles_from_training_data"]], "get_valid_feature_range() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_valid_feature_range"]], "get_valid_feature_range() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_valid_feature_range"]], "get_valid_mads() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_valid_mads"]], "get_valid_mads() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_valid_mads"]], "normalize_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.normalize_data"]], "normalize_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.normalize_data"]], "one_hot_encode_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.one_hot_encode_data"]], "one_hot_encode_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.one_hot_encode_data"]], "prepare_df_for_ohe_encoding() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_df_for_ohe_encoding"]], "prepare_df_for_ohe_encoding() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.prepare_df_for_ohe_encoding"]], "prepare_query_instance() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_query_instance"]], "prepare_query_instance() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.prepare_query_instance"]], "dicegenetic (class in dice_ml.explainer_interfaces.dice_genetic)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic"]], "dicekd (class in dice_ml.explainer_interfaces.dice_kd)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD"]], "dicepytorch (class in dice_ml.explainer_interfaces.dice_pytorch)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch"]], "dicerandom (class in dice_ml.explainer_interfaces.dice_random)": [[2, "dice_ml.explainer_interfaces.dice_random.DiceRandom"]], "dicetensorflow1 (class in dice_ml.explainer_interfaces.dice_tensorflow1)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1"]], "dicetensorflow2 (class in dice_ml.explainer_interfaces.dice_tensorflow2)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2"]], "explainerbase (class in dice_ml.explainer_interfaces.explainer_base)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase"]], "feasiblebasevae (class in dice_ml.explainer_interfaces.feasible_base_vae)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE"]], "feasiblemodelapprox (class in dice_ml.explainer_interfaces.feasible_model_approx)": [[2, "dice_ml.explainer_interfaces.feasible_model_approx.FeasibleModelApprox"]], "build_kd_tree() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.build_KD_tree"]], "check_permitted_range() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.check_permitted_range"]], "check_query_instance_validity() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.check_query_instance_validity"]], "compute_dist() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_dist"]], "compute_dist() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_dist"]], "compute_dist() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_dist"]], "compute_diversity_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_diversity_loss"]], "compute_diversity_loss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_diversity_loss"]], "compute_diversity_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_diversity_loss"]], "compute_loss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_loss"]], "compute_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_loss"]], "compute_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_loss"]], "compute_loss() (dice_ml.explainer_interfaces.feasible_base_vae.feasiblebasevae method)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE.compute_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_proximity_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_proximity_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_proximity_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_proximity_loss"]], "compute_regularization_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_regularization_loss"]], "compute_regularization_loss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_regularization_loss"]], "compute_regularization_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_regularization_loss"]], "compute_sparsity_loss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_sparsity_loss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_yloss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_yloss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_yloss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_yloss"]], "decide_cf_validity() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decide_cf_validity"]], "deserialize_explainer() (dice_ml.explainer_interfaces.explainer_base.explainerbase static method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.deserialize_explainer"]], "dice_ml.explainer_interfaces": [[2, "module-dice_ml.explainer_interfaces"]], "dice_ml.explainer_interfaces.dice_kd": [[2, "module-dice_ml.explainer_interfaces.dice_KD"]], "dice_ml.explainer_interfaces.dice_genetic": [[2, "module-dice_ml.explainer_interfaces.dice_genetic"]], "dice_ml.explainer_interfaces.dice_pytorch": [[2, "module-dice_ml.explainer_interfaces.dice_pytorch"]], "dice_ml.explainer_interfaces.dice_random": [[2, "module-dice_ml.explainer_interfaces.dice_random"]], "dice_ml.explainer_interfaces.dice_tensorflow1": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow1"]], "dice_ml.explainer_interfaces.dice_tensorflow2": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow2"]], "dice_ml.explainer_interfaces.explainer_base": [[2, "module-dice_ml.explainer_interfaces.explainer_base"]], "dice_ml.explainer_interfaces.feasible_base_vae": [[2, "module-dice_ml.explainer_interfaces.feasible_base_vae"]], "dice_ml.explainer_interfaces.feasible_model_approx": [[2, "module-dice_ml.explainer_interfaces.feasible_model_approx"]], "do_kd_init() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_KD_init"]], "do_binary_search() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_binary_search"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_cf_initializations"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_cf_initializations"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_cf_initializations"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_cf_initializations"]], "do_linear_search() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_linear_search"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_loss_initializations"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_loss_initializations"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_loss_initializations"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_loss_initializations"]], "do_optimizer_initializations() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_optimizer_initializations"]], "do_optimizer_initializations() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_optimizer_initializations"]], "do_optimizer_initializations() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_optimizer_initializations"]], "do_param_initializations() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_param_initializations"]], "do_posthoc_sparsity_enhancement() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_posthoc_sparsity_enhancement"]], "do_random_init() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_random_init"]], "do_sparsity_check() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.do_sparsity_check"]], "dpp_style() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.dpp_style"]], "dpp_style() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.dpp_style"]], "dpp_style() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.dpp_style"]], "duplicates() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.duplicates"]], "feature_importance() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.feature_importance"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.find_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.generate_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.generate_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.generate_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.feasible_base_vae.feasiblebasevae method)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE.generate_counterfactuals"]], "get_continuous_samples() (dice_ml.explainer_interfaces.dice_random.dicerandom method)": [[2, "dice_ml.explainer_interfaces.dice_random.DiceRandom.get_continuous_samples"]], "get_model_output() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.get_model_output"]], "get_model_output_from_scores() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.get_model_output_from_scores"]], "get_samples() (dice_ml.explainer_interfaces.dice_random.dicerandom method)": [[2, "dice_ml.explainer_interfaces.dice_random.DiceRandom.get_samples"]], "get_valid_feature_range() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.get_valid_feature_range"]], "global_feature_importance() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.global_feature_importance"]], "infer_target_cfs_class() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.infer_target_cfs_class"]], "infer_target_cfs_range() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.infer_target_cfs_range"]], "initialize_cfs() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.initialize_CFs"]], "initialize_cfs() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.initialize_CFs"]], "initialize_cfs() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.initialize_CFs"]], "is_cf_valid() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.is_cf_valid"]], "label_decode() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.label_decode"]], "label_decode_cfs() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.label_decode_cfs"]], "label_encode() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.label_encode"]], "local_feature_importance() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.local_feature_importance"]], "mate() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.mate"]], "misc_init() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.misc_init"]], "predict_fn() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.predict_fn"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.predict_fn_for_sparsity"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.predict_fn_for_sparsity"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.predict_fn_for_sparsity"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.predict_fn_for_sparsity"]], "predict_fn_scores() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.predict_fn_scores"]], "round_off_cfs() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.round_off_cfs"]], "round_off_cfs() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.round_off_cfs"]], "round_off_cfs() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.round_off_cfs"]], "round_to_precision() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.round_to_precision"]], "scipy_optimizers() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.scipy_optimizers"]], "serialize_explainer() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.serialize_explainer"]], "setup() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.setup"]], "sigmoid() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.sigmoid"]], "stop_loop() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.stop_loop"]], "stop_loop() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.stop_loop"]], "stop_loop() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.stop_loop"]], "tensorflow_optimizers() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.tensorflow_optimizers"]], "train() (dice_ml.explainer_interfaces.feasible_base_vae.feasiblebasevae method)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE.train"]], "train() (dice_ml.explainer_interfaces.feasible_model_approx.feasiblemodelapprox method)": [[2, "dice_ml.explainer_interfaces.feasible_model_approx.FeasibleModelApprox.train"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.update_hyperparameters"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.update_hyperparameters"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.update_hyperparameters"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.update_hyperparameters"]], "vary_valid() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.vary_valid"]], "basemodel (class in dice_ml.model_interfaces.base_model)": [[3, "dice_ml.model_interfaces.base_model.BaseModel"]], "kerastensorflowmodel (class in dice_ml.model_interfaces.keras_tensorflow_model)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel"]], "pytorchmodel (class in dice_ml.model_interfaces.pytorch_model)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel"]], "dice_ml.model_interfaces": [[3, "module-dice_ml.model_interfaces"]], "dice_ml.model_interfaces.base_model": [[3, "module-dice_ml.model_interfaces.base_model"]], "dice_ml.model_interfaces.keras_tensorflow_model": [[3, "module-dice_ml.model_interfaces.keras_tensorflow_model"]], "dice_ml.model_interfaces.pytorch_model": [[3, "module-dice_ml.model_interfaces.pytorch_model"]], "get_gradient() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_gradient"]], "get_gradient() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.get_gradient"]], "get_gradient() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.get_gradient"]], "get_num_output_nodes() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_num_output_nodes"]], "get_num_output_nodes() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.get_num_output_nodes"]], "get_num_output_nodes() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.get_num_output_nodes"]], "get_num_output_nodes2() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_num_output_nodes2"]], "get_output() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_output"]], "get_output() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.get_output"]], "get_output() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.get_output"]], "load_model() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.load_model"]], "load_model() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.load_model"]], "load_model() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.load_model"]], "set_eval_mode() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.set_eval_mode"]], "dice_ml.schema": [[4, "module-dice_ml.schema"]], "datatransfomer (class in dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.DataTransfomer"]], "dummydatainterface (class in dice_ml.utils.serialize)": [[5, "dice_ml.utils.serialize.DummyDataInterface"]], "ffnetwork (class in dice_ml.utils.neuralnetworks)": [[5, "dice_ml.utils.neuralnetworks.FFNetwork"]], "systemexception": [[5, "dice_ml.utils.exception.SystemException"]], "userconfigvalidationexception": [[5, "dice_ml.utils.exception.UserConfigValidationException"]], "dice_ml.utils": [[5, "module-dice_ml.utils"]], "dice_ml.utils.exception": [[5, "module-dice_ml.utils.exception"]], "dice_ml.utils.helpers": [[5, "module-dice_ml.utils.helpers"]], "dice_ml.utils.neuralnetworks": [[5, "module-dice_ml.utils.neuralnetworks"]], "dice_ml.utils.serialize": [[5, "module-dice_ml.utils.serialize"]], "feed_data_params() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.feed_data_params"]], "forward() (dice_ml.utils.neuralnetworks.ffnetwork method)": [[5, "dice_ml.utils.neuralnetworks.FFNetwork.forward"]], "get_adult_data_info() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_adult_data_info"]], "get_adult_income_modelpath() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_adult_income_modelpath"]], "get_base_gen_cf_initialization() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_base_gen_cf_initialization"]], "get_custom_dataset_modelpath_pipeline() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline"]], "get_custom_dataset_modelpath_pipeline_binary() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline_binary"]], "get_custom_dataset_modelpath_pipeline_multiclass() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline_multiclass"]], "get_custom_dataset_modelpath_pipeline_regression() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline_regression"]], "get_custom_vars_dataset_modelpath_pipeline() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_vars_dataset_modelpath_pipeline"]], "initialize_transform_func() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.initialize_transform_func"]], "inverse_ohe_min_max_transformation() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.inverse_ohe_min_max_transformation"]], "inverse_transform() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.inverse_transform"]], "load_adult_income_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_adult_income_dataset"]], "load_custom_testing_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset"]], "load_custom_testing_dataset_binary() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_binary"]], "load_custom_testing_dataset_multiclass() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_multiclass"]], "load_custom_testing_dataset_regression() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_regression"]], "load_min_max_equal_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_min_max_equal_dataset"]], "load_outcome_not_last_column_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_outcome_not_last_column_dataset"]], "ohe_min_max_transformation() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.ohe_min_max_transformation"]], "save_adult_income_model() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.save_adult_income_model"]], "to_json() (dice_ml.utils.serialize.dummydatainterface method)": [[5, "dice_ml.utils.serialize.DummyDataInterface.to_json"]], "transform() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.transform"]], "autoencoder (class in dice_ml.utils.sample_architecture.vae_model)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder"]], "cf_vae (class in dice_ml.utils.sample_architecture.vae_model)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE"]], "compute_elbo() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.compute_elbo"]], "decoder() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.decoder"]], "decoder() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.decoder"]], "dice_ml.utils.sample_architecture": [[6, "module-dice_ml.utils.sample_architecture"]], "dice_ml.utils.sample_architecture.vae_model": [[6, "module-dice_ml.utils.sample_architecture.vae_model"]], "encoder() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.encoder"]], "encoder() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.encoder"]], "forward() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.forward"]], "forward() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.forward"]], "normal_likelihood() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.normal_likelihood"]], "normal_likelihood() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.normal_likelihood"]], "sample_latent_code() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.sample_latent_code"]], "sample_latent_code() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.sample_latent_code"]], "training (dice_ml.utils.sample_architecture.vae_model.autoencoder attribute)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.training"]], "training (dice_ml.utils.sample_architecture.vae_model.cf_vae attribute)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.training"]]}})
\ No newline at end of file
+Search.setIndex({"docnames": ["dice_ml", "dice_ml.data_interfaces", "dice_ml.explainer_interfaces", "dice_ml.model_interfaces", "dice_ml.schema", "dice_ml.utils", "dice_ml.utils.sample_architecture", "index", "modules", "notebooks/Benchmarking_different_CF_explanation_methods", "notebooks/DiCE_feature_importances", "notebooks/DiCE_getting_started", "notebooks/DiCE_getting_started_feasible", "notebooks/DiCE_model_agnostic_CFs", "notebooks/DiCE_multiclass_classification_and_regression", "notebooks/DiCE_with_advanced_options", "notebooks/DiCE_with_private_data", "notebooks/nb_index", "readme"], "filenames": ["dice_ml.rst", "dice_ml.data_interfaces.rst", "dice_ml.explainer_interfaces.rst", "dice_ml.model_interfaces.rst", "dice_ml.schema.rst", "dice_ml.utils.rst", "dice_ml.utils.sample_architecture.rst", "index.rst", "modules.rst", "notebooks/Benchmarking_different_CF_explanation_methods.ipynb", "notebooks/DiCE_feature_importances.ipynb", "notebooks/DiCE_getting_started.ipynb", "notebooks/DiCE_getting_started_feasible.ipynb", "notebooks/DiCE_model_agnostic_CFs.ipynb", "notebooks/DiCE_multiclass_classification_and_regression.ipynb", "notebooks/DiCE_with_advanced_options.ipynb", "notebooks/DiCE_with_private_data.ipynb", "notebooks/nb_index.rst", "readme.rst"], "titles": ["dice_ml package", "dice_ml.data_interfaces package", "dice_ml.explainer_interfaces package", "dice_ml.model_interfaces package", "dice_ml.schema package", "dice_ml.utils package", "dice_ml.utils.sample_architecture package", "Diverse Counterfactual Explanations (DiCE) for ML", "dice_ml", "Benchmarking different CF explanation methods", "Estimating local and global feature importance scores using DiCE", "Quick introduction to generating counterfactual explanations using DiCE", "&lt;no title&gt;", "Generating counterfactual explanations with any ML model", "Generating counterfactuals for multi-class classification and regression models", "Advanced options to customize Counterfactual Explanations", "Generating counterfactual explanations without access to training data", "&lt;no title&gt;", "Diverse Counterfactual Explanations (DiCE) for ML"], "terms": {"data_interfac": [0, 2, 5, 8, 10], "base_data_interfac": [0, 8], "private_data_interfac": [0, 8], "privatedata": [0, 1], "create_ohe_param": [0, 1], "de_normalize_data": [0, 1], "fit_label_encod": [0, 1], "from_dummi": [0, 1], "from_label": [0, 1], "get_all_dummy_colnam": [0, 1], "get_data_params_for_gradient_dic": [0, 1], "get_decimal_precis": [0, 1], "get_decoded_data": [0, 1], "get_encoded_categorical_feature_index": [0, 1], "get_features_rang": [0, 1], "get_indexes_of_features_to_vari": [0, 1], "get_inverse_ohe_min_max_normalized_data": [0, 1], "get_mad": [0, 1, 15], "get_minx_maxx": [0, 1], "get_ohe_min_max_normalized_data": [0, 1], "get_valid_feature_rang": [0, 1, 2], "get_valid_mad": [0, 1], "normalize_data": [0, 1, 7, 18], "one_hot_encode_data": [0, 1], "prepare_df_for_ohe_encod": [0, 1], "prepare_query_inst": [0, 1], "public_data_interfac": [0, 8], "publicdata": [0, 1], "get_data_typ": [0, 1], "get_quantiles_from_training_data": [0, 1], "explainer_interfac": [0, 8], "dice_kd": [0, 8, 9], "dicekd": [0, 2, 13], "do_sparsity_check": [0, 2], "duplic": [0, 2], "find_counterfactu": [0, 2], "predict_fn": [0, 2], "vary_valid": [0, 2], "dice_genet": [0, 8], "dicegenet": [0, 2, 13], "compute_loss": [0, 2], "compute_proximity_loss": [0, 2], "compute_sparsity_loss": [0, 2], "compute_yloss": [0, 2], "do_kd_init": [0, 2], "do_cf_initi": [0, 2], "do_loss_initi": [0, 2], "do_param_initi": [0, 2], "do_random_init": [0, 2], "label_decod": [0, 2], "label_decode_cf": [0, 2], "label_encod": [0, 2], "mate": [0, 2], "predict_fn_scor": [0, 2], "update_hyperparamet": [0, 2], "dice_pytorch": [0, 8], "dicepytorch": [0, 2], "compute_dist": [0, 2], "compute_diversity_loss": [0, 2], "compute_regularization_loss": [0, 2], "do_optimizer_initi": [0, 2], "dpp_style": [0, 2], "get_model_output": [0, 2], "initialize_cf": [0, 2], "predict_fn_for_spars": [0, 2], "round_off_cf": [0, 2], "stop_loop": [0, 2], "dice_random": [0, 8], "dicerandom": [0, 2], "get_continuous_sampl": [0, 2], "get_sampl": [0, 2], "dice_tensorflow1": [0, 8], "dicetensorflow1": [0, 2], "generate_counterfactu": [0, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "scipy_optim": [0, 2], "tensorflow_optim": [0, 2], "dice_tensorflow2": [0, 8], "dicetensorflow2": [0, 2], "explainer_bas": [0, 8], "explainerbas": [0, 2], "build_kd_tre": [0, 2], "check_permitted_rang": [0, 2], "check_query_instance_valid": [0, 2], "decide_cf_valid": [0, 2], "deserialize_explain": [0, 2], "do_binary_search": [0, 2], "do_linear_search": [0, 2], "do_posthoc_sparsity_enhanc": [0, 2], "feature_import": [0, 2], "get_model_output_from_scor": [0, 2], "global_feature_import": [0, 2, 10, 11], "infer_target_cfs_class": [0, 2], "infer_target_cfs_rang": [0, 2], "is_cf_valid": [0, 2], "local_feature_import": [0, 2, 10, 11], "misc_init": [0, 2], "round_to_precis": [0, 2], "serialize_explain": [0, 2], "setup": [0, 2, 7, 18], "sigmoid": [0, 2, 7, 18], "feasible_base_va": [0, 8, 12], "feasiblebaseva": [0, 2, 12], "train": [0, 1, 2, 3, 5, 6, 7, 10, 12, 14, 15, 17, 18], "feasible_model_approx": [0, 8, 12], "feasiblemodelapprox": [0, 2, 12], "model_interfac": [0, 2, 8], "base_model": [0, 8], "basemodel": [0, 3], "get_gradi": [0, 3], "get_num_output_nod": [0, 3], "get_num_output_nodes2": [0, 3], "get_output": [0, 3], "load_model": [0, 3, 12], "keras_tensorflow_model": [0, 8], "kerastensorflowmodel": [0, 3], "pytorch_model": [0, 8, 12], "pytorchmodel": [0, 3, 12], "set_eval_mod": [0, 3], "schema": [0, 8], "util": [0, 7, 8, 9, 10, 11, 12, 13, 15, 16, 18], "sample_architectur": [0, 5], "vae_model": [0, 5], "except": [0, 8, 11], "systemexcept": [0, 5], "userconfigvalidationexcept": [], "helper": [0, 7, 8, 9, 10, 11, 12, 13, 15, 16, 18], "datatransfom": [0, 5], "feed_data_param": [0, 5], "initialize_transform_func": [0, 5], "inverse_transform": [0, 5], "transform": [0, 1, 2, 3, 5, 9, 10, 11, 12, 13, 14, 15], "get_adult_data_info": [0, 5, 10, 11, 12], "get_adult_income_modelpath": [0, 5, 7, 11, 12, 15, 16, 18], "get_base_gen_cf_initi": [0, 5], "get_custom_dataset_modelpath_pipelin": [0, 5], "get_custom_dataset_modelpath_pipeline_binari": [0, 5], "get_custom_dataset_modelpath_pipeline_multiclass": [0, 5], "get_custom_dataset_modelpath_pipeline_regress": [0, 5], "get_custom_vars_dataset_modelpath_pipelin": [0, 5], "inverse_ohe_min_max_transform": [0, 5], "load_adult_income_dataset": [0, 5, 7, 9, 10, 11, 12, 13, 15, 18], "load_custom_testing_dataset": [0, 5], "load_custom_testing_dataset_binari": [0, 5], "load_custom_testing_dataset_multiclass": [0, 5], "load_custom_testing_dataset_regress": [0, 5], "load_min_max_equal_dataset": [0, 5], "load_outcome_not_last_column_dataset": [0, 5], "ohe_min_max_transform": [0, 5], "save_adult_income_model": [0, 5], "neuralnetwork": [0, 8], "ffnetwork": [0, 5], "forward": [0, 5, 6], "serial": [0, 2, 8], "dummydatainterfac": [0, 5], "to_json": [0, 5, 8, 10], "ml": [0, 1, 2, 3, 5, 12, 16, 17], "class": [0, 1, 2, 3, 5, 6, 7, 10, 11, 12, 13, 17, 18], "backendtyp": [0, 8], "sourc": [0, 1, 2, 3, 5, 6, 7, 12, 18], "base": [0, 1, 2, 3, 5, 6, 7, 11, 12, 15, 16, 18], "object": [0, 2, 3, 5, 7, 11, 12, 13, 15, 16, 17], "all": [0, 1, 2, 3, 6, 7, 8, 9, 10, 11, 14, 15, 16, 18], "sklearn": [0, 3, 5, 7, 8, 9, 10, 11, 13, 14, 18], "tf1": [0, 3, 5, 11, 15, 16], "tf2": [0, 3, 7, 11, 16, 18], "pyt": [0, 3, 11, 12, 16], "pytorch": [0, 2, 3, 7, 8, 9, 12, 13, 16, 17, 18], "tensorflow1": [0, 8], "tensorflow2": [0, 8, 15], "modeltyp": [0, 8], "classifi": [0, 2, 3, 7, 8, 9, 10, 11, 13, 14, 18], "regressor": [0, 3, 7, 8, 11, 14, 18], "samplingstrategi": [0, 8], "genet": [0, 2, 7, 8, 9, 11, 14, 16, 17, 18], "gradient": [0, 2, 7, 8, 11, 16, 18], "kdtree": [0, 2, 8, 9, 13, 14, 16], "random": [0, 2, 7, 8, 9, 10, 11, 14, 15, 16, 17, 18], "counterfactualexplan": [0, 2, 8], "cf_examples_list": [0, 2, 7, 8, 10, 18], "local_import": [0, 2, 8, 10, 11], "none": [0, 1, 2, 3, 5, 10], "summary_import": [0, 8, 10, 11], "version": [0, 7, 10, 11, 12, 16, 18], "A": [0, 1, 2, 5, 7, 9, 11, 12, 15, 18], "store": [0, 2], "counterfactu": [0, 2, 12, 17], "exampl": [0, 2, 7, 10, 12, 13, 16, 17, 18], "one": [0, 1, 2, 5, 6, 7, 11, 15, 18], "more": [0, 2, 7, 10, 12, 14, 15, 16, 17, 18], "input": [0, 1, 2, 3, 7, 10, 11, 12, 14, 15, 16, 18], "featur": [0, 1, 2, 7, 9, 12, 14, 16, 17, 18], "import": [0, 2, 7, 9, 12, 13, 14, 15, 16, 17, 18], "score": [0, 2, 3, 7, 17, 18], "paramet": [0, 2, 3, 5, 7, 11, 13, 14, 15, 16, 18], "list": [0, 1, 2, 7, 12, 18], "counterfactualexampl": [0, 2, 8], "instanc": [0, 1, 2, 6, 7, 10, 11, 12, 13, 14, 15, 16, 18], "estim": [0, 2, 7, 11, 16, 17, 18], "local": [0, 2, 7, 12, 17, 18], "The": [0, 2, 11, 12, 13, 14, 15, 16], "size": [0, 2], "i": [0, 1, 2, 3, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "number": [0, 1, 2, 9, 11, 15], "each": [0, 2, 7, 9, 10, 11, 12, 13, 16, 18], "contain": [0, 1, 2, 3, 14], "global": [0, 2, 7, 17, 18], "set": [0, 1, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "properti": [0, 7, 18], "static": [0, 2], "from_json": [0, 8, 10], "json_str": [0, 10], "deseri": 0, "json": [0, 7, 17], "string": [0, 2], "metadata": [0, 7, 8, 10, 12, 16, 18], "explan": [0, 2, 12, 17], "visualize_as_datafram": [0, 7, 8, 10, 11, 12, 13, 14, 15, 16, 18], "display_sparse_df": 0, "true": [0, 1, 2, 3, 5, 10, 11, 12, 13, 14, 15, 16], "show_only_chang": [0, 10, 11, 12, 13, 14, 15, 16], "fals": [0, 1, 2, 3, 7, 9, 11, 12, 13, 18], "visualize_as_list": [0, 8], "point": [0, 2, 10, 11, 12, 13, 16], "differ": [0, 2, 3, 7, 10, 11, 12, 13, 14, 16, 18], "implement": [0, 2, 3, 7, 9, 11, 13, 16, 18], "requir": [0, 1, 2, 3, 7, 11, 12, 16, 18], "onli": [0, 2, 7, 11, 12, 13, 16, 18], "few": [0, 15], "about": [0, 1, 12, 16], "rang": [0, 1, 2, 7, 9, 11, 14, 15, 16, 18], "continu": [0, 1, 2, 7, 11, 12, 13, 15, 16, 18], "level": [0, 1, 2, 7, 10, 11, 15, 18], "categor": [0, 1, 2, 7, 9, 10, 11, 13, 14, 15, 16, 18], "henc": [0, 15, 16], "can": [0, 2, 7, 9, 10, 11, 12, 13, 14, 16, 18], "us": [0, 2, 9, 12, 13, 14, 15, 16, 17], "privat": [0, 1, 7, 9, 10, 11, 12, 13, 15, 16, 18], "whose": [0, 11, 12], "meta": [0, 1, 5, 7, 17], "ar": [0, 1, 2, 3, 7, 11, 12, 13, 15, 16, 18], "avail": [0, 7, 16, 18], "name": [0, 1, 2, 11, 12, 15, 16], "specifi": [0, 2, 7, 11, 12, 15, 16, 18], "appropri": [0, 7, 11, 16, 18], "param": [0, 1], "_basedata": [0, 1], "inform": [0, 1, 7, 14, 16, 18], "decide_implementation_typ": [0, 8], "decid": [0, 2, 7, 8, 15, 18], "public": [0, 1], "To": [0, 7, 11, 16, 18], "add": [0, 2, 7, 11, 18], "new": [0, 2, 7, 10, 11, 13, 14, 16, 18], "return": [0, 1, 2, 3, 5, 9, 11, 12], "an": [0, 1, 2, 3, 5, 7, 10, 11, 12, 13, 15, 16, 18], "elif": 0, "loop": [0, 2, 9], "shown": [0, 11, 13, 16], "below": [0, 10, 11, 12, 13, 14, 15, 16], "method": [0, 1, 2, 3, 10, 11, 12, 13, 14, 16], "framework": [0, 2, 3, 12, 13, 15], "tensorflow": [0, 2, 3, 7, 9, 12, 13, 15, 16, 17, 18], "randomsampl": 0, "kwarg": [0, 2, 5], "interfac": [0, 1, 2, 3, 11, 16], "type": [0, 1, 10, 11, 14, 16], "final_cfs_df": [0, 2, 7, 18], "test_instance_df": [0, 2], "final_cfs_df_spars": [0, 2], "posthoc_sparsity_param": [0, 2, 10], "0": [0, 1, 2, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "desired_rang": [0, 2, 10, 14], "desired_class": [0, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "opposit": [0, 2, 7, 10, 11, 12, 13, 15, 16, 18], "model_typ": [0, 2, 10, 14], "visual": [0, 2, 7, 11, 12, 15, 16, 18], "result": [0, 2, 11, 12, 16], "display_df": [0, 8], "df": [0, 1], "cf_example_json_str": 0, "print_list": [0, 8], "li": 0, "serialization_vers": 0, "json_convert": [0, 8], "obj": 0, "function": [0, 2, 5, 6, 7, 9, 10, 11, 12, 13, 15, 16, 18], "convert": [0, 7, 11, 17], "access": [0, 7, 11, 12, 17, 18], "output": [0, 2, 3, 7, 11, 12, 13, 17, 18], "model_path": [0, 3, 7, 11, 12, 15, 16, 18], "backend": [0, 3, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "func": [0, 3, 5, 7, 11, 16, 18], "kw_arg": [0, 3, 5], "data": [1, 2, 3, 5, 7, 8, 9, 11, 12, 13, 14, 15, 17, 18], "dice": [1, 8, 9, 12, 13, 14, 15, 16, 17], "one_hot_encoded_data": [1, 7, 18], "de": 1, "normal": [1, 2, 5, 15, 16], "from": [1, 2, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "1": [1, 2, 6, 7, 9, 10, 11, 12, 14, 16, 17, 18], "origin": [1, 2, 7, 10, 11, 12, 13, 14, 15, 16, 18], "prefix_sep": 1, "_": [1, 7, 9, 18], "get": [1, 2, 5, 15], "dummi": 1, "encod": [1, 2, 5, 6, 11, 12, 15], "k": [1, 2, 7, 9, 13, 18], "label": [1, 2, 7, 18], "back": [1, 2], "valu": [1, 2, 3, 7, 9, 10, 11, 12, 14, 15, 16, 18], "relat": [1, 2, 11], "output_typ": 1, "precis": [1, 2], "hot": [1, 2, 5, 11, 15], "column": [1, 7, 9, 10, 11, 13, 14, 18], "index": [1, 7, 9, 16, 18], "after": 1, "permitted_range_input": 1, "features_dict": 1, "features_to_vari": [1, 2, 7, 10, 11, 13, 18], "transformed_data": 1, "min": [1, 2, 5, 7, 9, 11, 13, 16, 18], "max": [1, 2, 5, 7, 9, 11, 16, 18], "raw": 1, "user": [1, 2, 5, 7, 15, 18], "fed": [1, 2, 5], "format": [1, 2, 11], "should": [1, 2, 6, 7, 11, 16, 18], "datafram": [1, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "arrai": [1, 3], "comput": [1, 2, 6, 7, 11, 15, 16, 18], "median": [1, 2, 7, 15, 16, 18], "absolut": [1, 2, 7, 15, 16, 18], "deviat": [1, 7, 15, 16, 18], "form": [1, 11, 12, 15, 16], "query_inst": [1, 2, 7, 9, 10, 11, 12, 13, 15, 16, 18], "dict": 1, "feature_range_input": 1, "assum": 1, "alreadi": 1, "numer": [1, 9, 10, 11, 13, 14, 16], "remain": 1, "same": [1, 2, 7, 11, 12, 13, 16, 18], "todo": [1, 2], "need": [1, 6, 7, 10, 11, 12, 16, 18], "work": [1, 7, 9, 10, 12, 13, 15, 17, 18], "adher": 1, "support": [1, 2, 9, 11, 13, 16], "permitted_rang": [1, 2, 7, 10, 11, 13, 18], "both": [1, 7, 9, 10, 12, 13, 14, 15, 18], "discret": [1, 11, 12], "when": [1, 2, 7, 11, 15, 16, 18], "provid": [1, 2, 7, 10, 11, 12, 13, 14, 15, 16, 18], "_generate_counterfactu": 1, "display_warn": 1, "return_mad": 1, "If": [1, 2, 7, 11, 13, 16, 18], "thei": [1, 7, 11, 13, 18], "practic": [1, 7, 11, 18], "instead": [1, 6, 9], "make": [1, 7, 13, 18], "them": [1, 6, 11, 15, 16], "fall": [1, 15], "One": 1, "creat": [1, 7, 9, 10, 11, 13, 14, 15, 18], "do": [1, 7, 11, 13, 16, 18], "oh": [1, 7, 11, 16, 18], "singl": [1, 2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "prepar": [1, 5], "defin": [1, 2, 5, 6, 7, 11, 15, 17], "test": [1, 2, 3, 7, 9, 10, 11, 13, 14, 16, 18], "": [1, 2, 7, 9, 10, 12, 13, 14, 15, 16, 17, 18], "between": [1, 2, 7, 11, 16, 17, 18], "explain": [1, 2, 7, 12, 18], "thi": [1, 2, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "vice": [1, 12], "versa": [1, 12], "col": [1, 12], "infer": [1, 2, 12], "quantil": 1, "05": [1, 2, 9], "gener": [2, 5, 10, 12, 17], "kd": [2, 7, 9, 11, 17, 18], "tree": [2, 7, 9, 11, 17, 18], "code": [2, 7, 11, 12, 14, 16, 18], "similar": [2, 7, 12, 18], "interpret": [2, 7, 10, 18], "guid": 2, "prototyp": 2, "http": [2, 5, 7, 9, 11, 12, 13, 14, 15, 16, 18], "arxiv": [2, 12], "org": [2, 5, 9, 12, 14, 16], "pdf": [2, 12], "1907": 2, "02584": 2, "cf": [2, 7, 11, 12, 13, 14, 18], "sparsity_weight": 2, "final_indic": 2, "data_df_copi": 2, "query_instance_orig": 2, "total_cf": [2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "stopping_threshold": 2, "posthoc_sparsity_algorithm": 2, "verbos": [2, 7, 9, 13, 18], "limit_steps_l": 2, "find": [2, 7, 11, 13, 16, 18], "queri": [2, 7, 9, 10, 11, 12, 14, 15, 16, 17], "d": [2, 6, 7, 9, 10, 11, 12, 13, 15, 16, 18], "nearest": 2, "desir": [2, 7, 11, 13, 14, 18], "dataset": [2, 5, 7, 10, 12, 14, 16, 17, 18], "input_inst": [2, 3], "predict": [2, 3, 5, 7, 9, 10, 11, 12, 13, 14, 18], "kd_query_inst": 2, "ensur": [2, 7, 13, 18], "we": [2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "vari": [2, 7, 11, 15, 18], "divers": [2, 9, 10, 11, 14, 17], "algorithm": [2, 7, 9, 11, 14, 16, 17, 18], "geco": 2, "qualiti": 2, "real": 2, "time": [2, 9, 10, 11, 12, 13, 15, 16], "2101": 2, "01292": 2, "overal": 2, "loss": [2, 7, 11, 18], "x_hat_unnorm": 2, "query_instance_norm": 2, "weight": [2, 7, 12, 16, 17, 18], "distanc": [2, 7, 11, 15, 16, 18], "two": [2, 7, 11, 12, 16, 18], "vector": 2, "first": [2, 10, 11, 12, 16], "part": 2, "y": [2, 7, 11, 18], "initi": [2, 11, 12, 13, 14, 15, 16], "query_instance_df_dummi": 2, "intial": 2, "other": [2, 7, 9, 10, 11, 12, 13, 15, 16, 18], "variabl": [2, 7, 11, 12, 15, 16, 18], "yloss_typ": [2, 9], "diversity_loss_typ": 2, "feature_weight": [2, 7, 15, 16, 18], "main": 2, "proximity_weight": [2, 7, 15, 18], "diversity_weight": [2, 7, 15, 18], "categorical_penalti": 2, "num_init": 2, "maxiter": 2, "thresh": 2, "through": [2, 7, 11, 15, 16, 18], "labelled_input": 2, "cfs_arr": 2, "k1": 2, "k2": 2, "perform": [2, 6, 11, 16], "produc": [2, 11, 12, 13, 16], "offspr": 2, "actual": [2, 7, 18], "updat": 2, "hyperparamet": 2, "x_hat": 2, "x1": [2, 11, 16], "third": [2, 12], "second": [2, 12], "linear": [2, 7, 18], "equal": [2, 15, 16], "constraint": [2, 7, 11, 12, 18], "sum": 2, "optim": [2, 7, 11, 12, 15, 16, 18], "learning_r": [2, 5], "submethod": 2, "dpp": 2, "matrix": 2, "min_it": 2, "max_it": 2, "project_it": 2, "loss_diff_thr": 2, "loss_converge_maxit": [2, 11], "init_near_query_inst": 2, "tie_random": 2, "descent": 2, "transform_data": [2, 3], "out_tensor": [2, 3], "probabl": [2, 3], "model": [2, 3, 5, 7, 8, 12, 17, 18], "sparsiti": [2, 11, 13, 16], "correct": [2, 16], "assign": [2, 7, 15, 18], "intermedi": 2, "project": [2, 7, 18], "itr": 2, "loss_diff": 2, "determin": [2, 3, 7, 12, 18], "stop": 2, "condit": [2, 11], "sampl": [2, 7, 9, 10, 11, 12, 16, 17, 18], "simpl": [2, 7, 11, 12, 18], "low": [2, 7, 11, 12, 18], "high": [2, 7, 11, 12, 16, 18], "1000": 2, "seed": [2, 13, 15], "fixed_features_valu": 2, "feature_rang": 2, "sampling_random_se": 2, "sampling_s": 2, "x": [2, 5, 6, 7, 11, 12, 16, 18], "tf": [2, 7, 15, 16, 18], "hinge_loss": [2, 9], "inverse_dist": 2, "inverse_mad": 2, "500": 2, "5000": [2, 10], "1e": [2, 12], "5": [2, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "diversecf": 2, "adam": [2, 7, 18], "10000": 2, "interest": [2, 7, 11, 18], "dictionari": [2, 12, 15, 16], "row": [2, 11], "total": [2, 9, 10, 11, 13, 14, 15, 16], "take": [2, 6, 15], "default": [2, 7, 11, 12, 13, 15, 16, 18], "outcom": [2, 5, 7, 10, 11, 12, 13, 14, 16, 18], "binari": [2, 7, 11, 12, 16, 18], "classif": [2, 7, 11, 17], "posit": 2, "float": [2, 11, 16], "larger": [2, 11], "close": [2, 11, 13], "either": [2, 11], "randominitcf": 2, "kei": [2, 12, 15, 16], "permit": [2, 11, 13], "metric": [2, 7, 11, 18], "l2_loss": 2, "log_loss": 2, "avg_dist": 2, "correspond": 2, "option": [2, 7, 11, 17, 18], "where": [2, 11, 12, 15, 16], "invers": [2, 15, 16], "devid": 2, "mad": [2, 7, 15, 16, 18], "current": [2, 9, 11, 13], "learn": [2, 5, 7, 9, 12, 13, 14, 15, 17, 18], "rate": 2, "iter": 2, "run": [2, 6, 7, 11, 12, 15, 16, 18], "interv": 2, "mani": [2, 11], "minimum": 2, "success": 2, "check": [2, 7, 9, 11, 18], "converg": [2, 11, 13], "maximum": 2, "hold": 2, "declar": [2, 7, 18], "conserv": [2, 11], "2": [2, 5, 7, 9, 10, 11, 12, 14, 16, 17, 18], "paper": [2, 7, 11, 12, 15, 16, 18], "print": [2, 9, 10, 11, 12, 15], "boolean": [2, 3], "indic": [2, 3, 5, 11, 16], "round": [2, 11, 15, 16], "off": [2, 7, 11, 16, 17], "threshold": 2, "target": [2, 7, 9, 10, 11, 13, 14, 18], "post": [2, 7, 18], "hoc": 2, "oper": [2, 11, 16], "enhanc": 2, "search": [2, 7, 11], "prefer": 2, "larg": 2, "incom": [2, 5, 7, 9, 10, 11, 12, 13, 15, 16, 18], "10k": 2, "1000k": 2, "share": [2, 11, 16], "monoton": [2, 12], "relationship": 2, "upper": 2, "limit": [2, 11, 16], "step": [2, 7, 9, 10, 11, 13, 14, 15, 16, 18], "posthoc_sparsity_enhanc": 2, "see": [2, 7, 9, 11, 12, 14, 15, 16, 18], "diverse_counterfactu": [2, 7, 8], "py": [2, 9, 11, 12, 16], "nelder": 2, "mead": 2, "templat": [2, 3], "subclass": [2, 3, 6], "abc": 2, "predicted_outcome_nam": 2, "comment": [2, 7, 18], "necessari": [2, 11], "els": [2, 9, 12], "remov": 2, "feature_ranges_orig": 2, "model_output": 2, "path": 2, "reload": 2, "memori": [2, 14], "read": 2, "file": [2, 11, 16], "diff": 2, "decimal_prec": 2, "cf_ix": 2, "final_cfs_spars": 2, "current_pr": 2, "until": 2, "chang": [2, 7, 10, 11, 12, 17, 18], "current_pred_orig": 2, "greedi": 2, "move": 2, "toward": [2, 7, 11, 12, 18], "greedili": 2, "reach": [2, 15], "encourag": 2, "final": [2, 7, 11, 18], "panda": [2, 9, 14, 16], "done": [2, 7, 16, 18], "avoid": [2, 12], "infinit": 2, "10": [2, 7, 9, 10, 11, 12, 13, 14, 16, 18], "global_import": 2, "given": [2, 7, 10, 11, 12, 14, 18], "which": [2, 7, 11, 12, 16, 18], "These": [2, 10, 11], "precomput": 2, "everi": [2, 6, 11], "follow": [2, 7, 11, 16, 18], "ignor": [2, 6, 9, 10, 11, 13, 14, 16], "per": [2, 7, 10, 11, 12, 15, 18], "other_paramet": 2, "includ": [2, 11, 12], "summar": [2, 11], "over": [2, 7, 15, 17], "For": [2, 7, 9, 10, 11, 12, 14, 15, 16, 18], "regress": [2, 7, 10, 11, 17], "problem": [2, 7, 18], "ascend": 2, "order": [2, 11, 15, 16], "gradientdesc": 2, "less": [2, 11, 13, 15], "whether": [2, 7, 11, 12, 18], "detail": [2, 7, 11, 12, 15, 18], "messag": [2, 5], "sample_s": 2, "random_se": [2, 13], "reproduc": [2, 15], "accept": 2, "specif": [2, 7, 14, 18], "its": [2, 7, 12, 18], "attribut": [2, 7, 17, 18], "model_scor": [2, 3], "flag": [2, 11, 16], "also": [2, 7, 10, 11, 12, 13, 15, 16, 18], "desired_class_input": 2, "original_pr": 2, "num_output_nod": 2, "call": [2, 5, 6, 11, 12, 16], "multiclass": [2, 7, 17], "downstream": 2, "allow": [2, 7, 11, 12, 15, 18], "desired_range_input": 2, "belong": 2, "test_pr": 2, "z": [2, 6], "vae": [2, 7, 11, 12, 18], "model_out": 2, "target_label": 2, "pre_train": [2, 12], "bool": [2, 6], "pre": [2, 7, 11, 12, 18], "exist": [2, 11, 16], "again": [2, 12, 13], "constraint_typ": 2, "constraint_vari": 2, "constraint_direct": 2, "constraint_reg": 2, "unari": [2, 12], "effect": [2, 12], "cause1": 2, "cause2": 2, "neg": 2, "By": [2, 7, 15, 18], "ha": [2, 7, 11, 12, 16, 18], "tunabl": [2, 7, 15, 18], "hyperparamt": 2, "OR": 3, "inp_siz": 3, "singleton": 3, "kera": [3, 7, 18], "input_tensor": 3, "mode": 3, "autoencod": [5, 6, 7, 18], "decod": [5, 6, 12], "normal_likelihood": [5, 6], "sample_latent_cod": [5, 6], "cf_vae": [5, 6], "compute_elbo": [5, 6], "some": [5, 7, 9, 10, 11, 12, 13, 15, 16, 18], "system": [5, 7, 18], "happen": 5, "dure": [5, 13], "execut": [5, 11, 12, 16], "exception_messag": 5, "str": 5, "describ": [5, 7, 9, 11, 12, 13, 18], "error": [5, 11, 15, 16], "configur": 11, "valid": [7, 11, 18], "containt": 5, "load": [5, 7, 12, 16, 17], "deta": 5, "functiontransform": 5, "scikit": [5, 9, 13, 14, 16], "intern": [5, 7, 14, 15, 18], "stabl": [5, 7, 9, 14, 16, 18], "preprocess": [5, 9, 10, 11, 13, 14], "html": [5, 9, 14, 16], "encoded_s": [5, 6, 12], "cont_minx": 5, "cont_maxx": 5, "margin": [5, 12], "validity_reg": [5, 12], "epoch": [5, 7, 12, 18], "wm1": [5, 12], "wm2": [5, 12], "wm3": [5, 12], "only_train": 5, "adult": [5, 9, 12, 13, 15, 16], "archiv": [5, 9, 11, 12, 13, 15, 16], "ic": [5, 9, 11, 12, 13, 15, 16], "uci": [5, 9, 11, 12, 13, 15, 16], "edu": [5, 9, 11, 12, 13, 15, 16], "analysi": 5, "rpub": 5, "com": [5, 7, 18], "h_zhu": 5, "235617": 5, "adult_data": 5, "modelpath": 5, "test_fract": 5, "random_st": [5, 7, 9, 10, 11, 13, 14, 18], "arg": 5, "ani": [5, 7, 10, 11, 14, 17, 18], "outcome_nam": [5, 7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "data_df": [5, 10], "overridden": 6, "although": 6, "recip": 6, "pass": [6, 13], "within": [6, 7, 11, 13, 18], "afterward": 6, "sinc": [6, 11, 12, 13, 15, 16], "former": 6, "care": 6, "regist": 6, "hook": 6, "while": [6, 11, 12], "latter": 6, "silent": 6, "mean": [6, 7, 11, 12, 15, 18], "logvar": 6, "raxi": 6, "c": [6, 7, 18], "pred_model": 6, "how": [7, 10, 11, 12, 13, 14, 15, 18], "machin": [7, 9, 11, 12, 13, 15, 16, 18], "truth": [7, 18], "yet": [7, 18], "peopl": [7, 18], "ramaravind": [7, 18], "mothil": [7, 18], "amit": [7, 18], "sharma": [7, 18], "chenhao": [7, 18], "tan": [7, 18], "fat": [7, 18], "20": [7, 9, 10, 11, 13, 18], "doc": [7, 9, 18], "live": [7, 18], "jupyt": [7, 18], "blog": [7, 18], "studi": [7, 18], "scienc": [7, 18], "hotel": [7, 18], "book": [7, 18], "analyt": [7, 18], "vidhya": [7, 18], "titan": [7, 18], "critic": [7, 11, 16, 18], "especi": [7, 18], "being": [7, 11, 18], "decis": [7, 11, 18], "societ": [7, 18], "domain": [7, 18], "financ": [7, 18], "healthcar": [7, 18], "educ": [7, 9, 10, 11, 12, 13, 15, 16, 18], "crimin": [7, 18], "justic": [7, 18], "howev": [7, 11, 12, 15, 16, 18], "most": [7, 15, 18], "depend": [7, 18], "approxim": [7, 15, 18], "consid": [7, 18], "person": [7, 11, 15, 18], "who": [7, 18], "appli": [7, 11, 18], "loan": [7, 18], "wa": [7, 11, 16, 18], "reject": [7, 18], "distribut": [7, 18], "financi": [7, 18], "compani": [7, 18], "typic": [7, 18], "mai": [7, 11, 15, 16, 18], "why": [7, 15, 18], "due": [7, 11, 16, 18], "poor": [7, 18], "credit": [7, 18], "histori": [7, 18], "doe": [7, 11, 16, 18], "help": [7, 11, 15, 18], "what": [7, 15, 17, 18], "next": [7, 16, 17, 18], "improv": [7, 18], "chanc": [7, 18], "approv": [7, 18], "futur": [7, 11, 18], "enough": [7, 18], "flip": [7, 18], "even": [7, 11, 12, 18], "changeabl": [7, 18], "gender": [7, 9, 10, 11, 12, 13, 15, 16, 18], "race": [7, 9, 10, 11, 12, 13, 15, 16, 18], "show": [7, 9, 10, 11, 12, 13, 15, 16, 18], "perturb": [7, 11, 12, 15, 18], "would": [7, 11, 12, 15, 18], "have": [7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "receiv": [7, 11, 18], "e": [7, 11, 15, 18], "g": [7, 11, 15, 18], "you": [7, 9, 11, 12, 13, 14, 16, 18], "your": [7, 11, 16, 18], "higher": [7, 11, 15, 18], "000": [7, 18], "In": [7, 9, 11, 12, 13, 15, 18], "word": [7, 18], "complement": [7, 18], "end": [7, 11, 18], "develop": [7, 18], "bar": [7, 18], "difficult": [7, 15, 18], "recent": [7, 18], "research": [7, 18], "core": [7, 11, 14, 16, 18], "idea": [7, 13, 18], "adversari": [7, 18], "therefor": [7, 11, 18], "proxim": [7, 10, 11, 17, 18], "It": [7, 11, 12, 13, 15, 18], "python": [7, 12, 16, 18], "3": [7, 9, 10, 11, 12, 14, 16, 17, 18], "pypi": [7, 18], "pip": [7, 18], "conda": [7, 18], "forg": [7, 18], "latest": [7, 12, 18], "dev": [7, 18], "clone": [7, 18], "repo": [7, 18], "top": [7, 18], "folder": [7, 18], "face": [7, 18], "try": [7, 9, 11, 12, 15, 16, 18], "manual": [7, 16, 18], "r": [7, 12, 18], "txt": [7, 18], "addit": [7, 11, 12, 18], "dependendi": [7, 18], "deep": [7, 17, 18], "deeplearn": [7, 18], "unit": [7, 15, 18], "jsonschema": [], "numpi": [9, 15], "h5py": [], "tqdm": [], "13": [9, 10, 11, 13, 14], "With": [7, 18], "three": [7, 9, 11, 13, 15, 18], "process": [7, 18], "invok": [7, 18], "dice_ml": [7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "continuous_featur": [7, 9, 10, 11, 12, 13, 14, 15, 18], "ag": [7, 9, 10, 11, 12, 13, 15, 16, 18], "hours_per_week": [7, 9, 10, 11, 12, 13, 15, 16, 18], "m": [7, 9, 10, 11, 12, 13, 15, 16, 18], "exp": [7, 10, 11, 12, 15, 16, 18], "now": [7, 9, 10, 11, 12, 13, 14, 15, 18], "lead": [7, 11, 16, 18], "22": [10, 11, 13, 14, 15, 16], "workclass": [7, 9, 10, 11, 12, 13, 15, 16, 18], "h": [7, 9, 10, 11, 12, 13, 15, 16, 18], "grad": [7, 9, 10, 11, 12, 13, 15, 16, 18], "marital_statu": [7, 9, 10, 11, 12, 13, 15, 16, 18], "occup": [7, 9, 10, 11, 12, 13, 15, 16, 18], "servic": [7, 9, 10, 11, 12, 13, 15, 16, 18], "white": [7, 9, 10, 11, 12, 13, 15, 16, 18], "femal": [7, 9, 10, 11, 12, 13, 15, 16, 18], "45": [10, 12, 13, 14, 15, 16], "been": [15, 16], "dice_exp": [7, 9, 11, 12, 15, 16, 18], "4": [7, 9, 10, 11, 12, 13, 14, 15, 16, 18], "save": [7, 18], "wai": [7, 11, 12, 15, 18], "disk": [7, 18], "to_csv": [7, 18], "path_or_buf": [7, 18], "csv": [7, 18], "out": [7, 11, 18], "here": [7, 12, 13, 15, 18], "multi": [7, 11, 17, 18], "permiss": [7, 18], "agnost": [7, 9, 11, 18], "explicit": [7, 11, 18], "et": [7, 18], "al": [7, 18], "2020": [7, 18], "variat": [7, 12, 18], "mahajan": [7, 18], "2019": [7, 18], "baseva": [7, 12, 18], "last": [7, 11, 18], "differenti": [7, 11, 18], "neural": [7, 11, 15, 16, 18], "network": [7, 11, 15, 16, 18], "rais": [7, 18], "issu": [7, 13, 18], "full": [7, 9, 10, 11, 12, 13, 14, 18], "thu": [7, 15, 18], "sensit": [7, 11, 18], "17": [7, 10, 11, 13, 14, 15, 16, 18], "90": [7, 15, 16, 18], "govern": [7, 10, 11, 13, 16, 18], "unknown": [7, 10, 11, 13, 16, 18], "self": [7, 9, 10, 11, 13, 16, 18], "emploi": [7, 9, 10, 11, 13, 16, 18], "assoc": [7, 9, 10, 11, 13, 16, 18], "bachelor": [7, 9, 10, 11, 13, 16, 18], "doctor": [7, 10, 11, 13, 16, 18], "master": [7, 10, 11, 13, 16, 18], "prof": [7, 10, 11, 13, 16, 18], "school": [7, 9, 10, 11, 13, 16, 18], "colleg": [7, 9, 10, 11, 13, 16, 18], "divorc": [7, 10, 11, 13, 16, 18], "marri": [7, 9, 10, 11, 13, 16, 18], "separ": [7, 10, 11, 13, 16, 18], "widow": [7, 10, 11, 16, 18], "blue": [7, 9, 10, 11, 13, 16, 18], "collar": [7, 9, 10, 11, 13, 16, 18], "profession": [7, 9, 10, 11, 13, 16, 18], "sale": [7, 9, 10, 11, 13, 16, 18], "male": [7, 9, 10, 11, 13, 16, 18], "99": [7, 10, 15, 16, 18], "well": [7, 18], "sess": [7, 18], "interactivesess": [7, 18], "split_data": [7, 18], "x_train": [7, 9, 10, 11, 13, 14, 18], "loc": [7, 9, 18], "y_train": [7, 9, 10, 11, 13, 14, 18], "fit": [7, 9, 10, 11, 12, 13, 14, 18], "dens": [7, 18], "ann_model": [7, 18], "sequenti": [7, 18], "layer": [7, 18], "input_shap": [7, 18], "shape": [7, 18], "kernel_regular": [7, 18], "regular": [7, 18], "l1": [7, 18], "001": [7, 18], "activ": [7, 18], "nn": [7, 18], "relu": [7, 18], "compil": [7, 11, 16, 18], "binary_crossentropi": [7, 18], "01": [7, 9, 13, 14, 18], "accuraci": [7, 11, 12, 16, 18], "validation_split": [7, 18], "100": [7, 9, 10, 11, 13, 14, 16, 18], "class_weight": [7, 18], "highlight": [7, 11, 18], "plan": [7, 18], "english": [7, 18], "languag": [7, 12, 18], "too": [7, 12, 18], "acknowledg": [7, 15, 18], "closer": [7, 15, 18], "individu": [7, 11, 15, 18], "profil": [7, 15, 18], "choos": [7, 15, 18], "multipl": [7, 11, 14, 15, 18], "possibl": [7, 11, 15, 18], "kind": [7, 11, 18], "addition": [7, 11, 18], "harder": [7, 15, 18], "than": [7, 11, 13, 15, 16, 18], "hour": [7, 10, 11, 15, 18], "week": [7, 10, 11, 15, 18], "rel": [7, 11, 15, 16, 18], "difficulti": [7, 15, 18], "measur": [7, 10, 15, 18], "divid": [7, 15, 18], "imposs": [7, 11, 18], "reflect": [7, 15, 18], "50": [7, 9, 11, 13, 18], "Being": [7, 18], "stakehold": [7, 18], "made": [7, 11, 18], "subject": [7, 18], "explor": [7, 11, 18], "action": [7, 18], "recours": [7, 18], "altern": [7, 18], "understand": [7, 11, 18], "could": [7, 11, 16, 18], "debug": [7, 18], "potenti": [7, 18], "select": [7, 15, 18], "uncov": [7, 18], "problemat": [7, 18], "95": [7, 18], "aim": [7, 18], "aggreg": [7, 11, 18], "maker": [7, 18], "judg": [7, 18], "particular": [7, 10, 11, 15, 16, 18], "probe": [7, 18], "enabl": [7, 11, 16, 18], "assess": [7, 18], "trust": [7, 18], "evalu": [7, 18], "fair": [7, 18], "ideal": [7, 11, 18], "balanc": [7, 18], "wide": [7, 18], "suggest": [7, 18], "eas": [7, 15, 18], "adopt": [7, 18], "those": [7, 10, 11, 16, 18], "causal": [7, 18], "law": [7, 18], "world": [7, 18], "hardli": [7, 18], "lower": [7, 18], "degre": [7, 18], "ad": [7, 12, 18], "construct": [7, 11, 12, 18], "phrase": [7, 18], "like": [7, 10, 11, 12, 18], "lime": [7, 11, 18], "shap": [7, 11, 18], "necess": [7, 10, 11, 18], "suffici": [7, 11, 18], "bayesian": [7, 18], "better": [7, 11, 18], "pleas": [7, 13, 16, 18], "proceed": [7, 18], "confer": [7, 18], "account": [7, 18], "transpar": [7, 18], "bibtex": [7, 18], "inproceed": [7, 18], "mothilal2020dic": [7, 18], "titl": [7, 18], "author": [7, 18], "booktitl": [7, 18], "page": [7, 18], "607": [7, 18], "617": [7, 18], "year": [7, 11, 18], "welcom": [7, 18], "agre": [7, 18], "contributor": [7, 18], "licens": [7, 18], "agreement": [7, 18], "cla": [7, 18], "right": [7, 18], "grant": [7, 18], "u": [7, 15, 18], "visit": [7, 18], "microsoft": [7, 18], "submit": [7, 18], "pull": [7, 18], "request": [7, 18], "bot": [7, 18], "automat": [7, 18], "decor": [7, 18], "pr": [7, 18], "simpli": [7, 11, 18], "instruct": [7, 11, 16, 18], "onc": [7, 14, 18], "across": [7, 13, 18], "our": [7, 11, 12, 13, 15, 16, 18], "open": [7, 11, 16, 18], "conduct": [7, 18], "faq": [7, 18], "contact": [7, 18], "opencod": [7, 18], "question": [7, 11, 18], "quick": [7, 17], "introduct": [7, 17], "preliminari": [7, 17], "resourc": [7, 17], "independ": [7, 9, 17], "without": [7, 11, 12, 17, 18], "advanc": [7, 12, 16, 17], "custom": [7, 11, 16, 17], "trade": [7, 17], "goal": [7, 13, 17], "modelapprox": 12, "initil": 12, "subpackag": [7, 8], "submodul": [7, 8], "constant": [7, 8, 11, 16], "modul": [7, 8, 9, 11, 12, 13, 14, 15, 16], "counterfactual_explan": [7, 8], "content": [7, 8, 12], "packag": [8, 11, 12, 16], "notebook": [9, 11, 12, 13, 14, 16, 18], "runtim": 9, "np": 9, "timeit": 9, "compos": [9, 10, 11, 13, 14], "columntransform": [9, 10, 11, 13, 14, 16], "model_select": [7, 9, 10, 11, 13, 14, 18], "train_test_split": [7, 9, 10, 11, 13, 14, 18], "pipelin": [9, 10, 11, 13, 14, 16], "standardscal": [9, 10, 13, 14], "onehotencod": [9, 10, 11, 13, 14, 16], "ensembl": [9, 10, 11, 13, 14], "randomforestclassifi": [9, 10, 11, 13, 14, 16], "load_ext": [9, 10, 11, 12, 13, 14, 15, 16], "autoreload": [9, 10, 11, 12, 13, 14, 15, 16], "repositori": [9, 11, 12, 13, 15, 16], "demonstr": [9, 11, 12, 13, 14, 15], "purpos": [9, 11, 12, 15], "filenotfounderror": [], "traceback": [], "lt": [9, 10, 11, 13, 14, 16], "cell": 12, "line": [], "gt": [10, 11, 14], "mnt": [], "amshar": [11, 16], "25": [10, 12, 13, 14], "19": [11, 13, 14], "def": [], "34": [10, 13, 14], "21": [10, 11, 13, 14], "23": [10, 11, 13, 14, 16], "24": [10, 11, 13, 14], "raw_data": [], "genfromtxt": [], "39": [10, 11, 14, 16], "databas": [], "26": [9, 10, 11, 13, 16], "delimit": [], "dtype": 14, "invalid_rais": [], "28": [9, 10, 11, 13, 16], "29": [11, 13, 14, 16], "column_nam": [], "fnlwgt": [], "num": [9, 10, 13, 14], "marit": [10, 11], "statu": [10, 11], "30": [9, 10, 11, 13, 16], "capit": [], "gain": [], "nativ": [], "countri": [], "31": [9, 13, 16], "env": 16, "v3": 16, "8dowhi": 16, "lib": 16, "python3": [12, 16], "8": [9, 10, 11, 12, 13, 14, 16], "site": 16, "npyio": [], "1934": [], "fname": [], "skip_head": [], "skip_foot": [], "missing_valu": [], "filling_valu": [], "usecol": [], "excludelist": [], "deletechar": [], "replace_spac": [], "autostrip": [], "case_sensit": [], "defaultfmt": [], "unpack": [], "usemask": [], "loos": [], "max_row": [], "ndmin": [], "1932": [], "os_fspath": [], "1933": [], "isinst": [], "fid": [], "_datasourc": [], "rt": [], "1935": [], "fid_ctx": [], "contextlib": [], "1936": [], "193": [11, 16], "destpath": [], "newlin": [], "156": [11, 16], "157": [], "158": [], "189": [], "190": [], "192": [], "datasourc": [], "533": [], "530": [], "_file_open": [], "ext": [], "found": [11, 12, 13, 16], "531": [], "532": [], "f": [], "head": [9, 11, 12, 13, 14, 15], "nameerror": [], "soon": [9, 12, 13], "6": [9, 10, 11, 12, 13, 14, 16], "split": [9, 10, 11, 13, 14], "datasetx": [9, 10, 13, 14], "drop": [7, 9, 10, 11, 13, 14, 18], "axi": [9, 10, 11, 13, 14], "x_test": [9, 10, 11, 13, 14], "y_test": [9, 10, 11, 13, 14], "test_siz": [7, 9, 10, 11, 12, 13, 14, 18], "stratifi": [7, 9, 10, 11, 13, 14, 18], "numeric_transform": [9, 10, 13, 14], "scaler": [9, 10, 13, 14], "categorical_transform": [9, 10, 11, 13, 14], "onehot": [9, 10, 11, 13, 14], "handle_unknown": [9, 10, 11, 13, 14], "cat": [9, 10, 11, 12, 13, 14], "append": [9, 10, 11, 13, 14], "clf": [9, 10, 11, 13], "preprocessor": [9, 10, 11, 13, 14], "7": [9, 10, 11, 13, 14, 16], "exp_random": [9, 13], "9": [9, 10, 11, 13, 14, 16], "exp_genet": [9, 13], "exp_kd": [9, 13], "11": [9, 10, 11, 13, 14, 16], "12": [9, 11, 12, 13, 14], "modifi": 9, "num_loop": 9, "14": [9, 10, 11, 13, 14], "elapsed_random": 9, "elapsed_kd": 9, "elapsed_genet": 9, "q": 9, "categorical_feature_nam": 9, "uniqu": 9, "choic": 9, "uniform": 9, "start_tim": 9, "default_tim": 9, "dice_exp_random": [9, 13], "m_random": 9, "s_random": 9, "divmod": 9, "60": [9, 10, 11, 13, 16], "taken": [9, 11, 13, 16], "02d": 9, "sec": [9, 11, 13, 16], "m_kd": 9, "s_kd": 9, "m_genet": 9, "s_genet": 9, "summari": [10, 11], "intuit": [10, 11], "often": [10, 11], "build": [10, 13], "caus": [10, 11, 12], "That": [10, 11, 12], "significantli": [10, 11, 16], "case": [10, 11, 12, 15, 16], "combin": [10, 15], "yield": 10, "downsampl": 10, "reduc": 10, "industri": [10, 11], "50k": [10, 11, 12], "v": [10, 11], "e1": [10, 11], "00": [9, 10, 11, 13, 14, 16], "12it": [], "43": [10, 11, 13, 14, 16], "94": 10, "63": 10, "33": 14, "15": [10, 11, 13, 14, 16], "77": 10, "64": [10, 11, 16], "calcul": 10, "imp": [10, 11], "directli": [10, 16], "leav": 10, "argument": [10, 11, 12, 14], "blank": 10, "18it": [], "repres": 10, "cobj": 10, "57it": [], "46": [10, 13, 16], "test_data": 10, "37": [10, 13, 14], "40": [9, 10, 11, 12, 13], "44": [10, 13], "41": [9, 10, 11, 12, 13, 14], "53": [10, 11, 16], "38": [10, 11, 13, 14, 16], "cfs_list": 10, "73": [10, 16], "88": [10, 11, 14], "42": [10, 12, 13], "83": 10, "59": 10, "55": [10, 16], "27": [9, 10, 13], "80": 10, "81": [10, 14], "36": 10, "47": [10, 14], "67": [10, 13], "52": [10, 13, 14], "84": [], "93": [], "57": [], "78": 13, "82": [10, 13], "51": [10, 13], "98": 10, "72": [10, 13], "91": 10, "56": 14, "66": 10, "69": 11, "75": 10, "97": 16, "70": [11, 13, 16], "65": [9, 10, 11, 13], "68": 10, "54": [10, 11], "48": 10, "79": 10, "74": 16, "89": 10, "71": [10, 13], "62": 11, "dummy_data": 10, "feature_nam": [10, 14], "feature_names_including_target": 10, "null": [10, 12, 14], "imp_r": 10, "o": 10, "scenario": 11, "inspect": 11, "librari": [11, 12, 14, 15, 16], "formal": 11, "known": 11, "answer": 11, "abov": [11, 12, 15, 16], "obtain": 11, "revers": 11, "know": [7, 11, 16, 18], "bring": 11, "logic": 11, "spars": [11, 13], "achiev": 11, "easi": 11, "minim": [7, 11, 18], "anoth": [11, 12], "feasibl": [11, 12, 13, 15], "outsid": 11, "simplest": 11, "complex": [11, 12], "concept": 11, "just": [11, 14], "certain": 11, "releas": 11, "x_i": 11, "keep": 11, "similarli": 11, "absenc": 11, "neither": 11, "nor": 11, "definit": 11, "translat": 11, "easili": 11, "deriv": 11, "rank": 11, "frequenc": 11, "among": 11, "parameter": 11, "refin": 11, "space": 11, "consequ": 11, "compar": [11, 12, 15, 16], "tend": 11, "give": [11, 13], "black": 11, "box": 11, "nearbi": 11, "privaci": 11, "reason": [11, 15], "binar": [11, 12], "32": [9, 10, 11, 13], "35": [9, 10, 11, 13, 14], "descript": [11, 12], "adult_info": [11, 12], "train_dataset": [7, 11, 18], "test_dataset": [7, 11, 18], "want": [11, 13, 16], "four": 11, "snippet": 11, "38it": [], "restrict": 11, "e2": 11, "58it": 9, "e3": 11, "72it": [], "operation": 11, "criterion": 11, "refer": [11, 12, 16], "unifi": 11, "around": 11, "denot": 11, "04": [11, 13, 16], "83it": [], "275": [], "235": [], "175": [], "155": [], "09": [11, 14], "rather": 11, "slower": 11, "compon": 11, "formul": 11, "baselin": [11, 12, 16], "conveni": [11, 12], "16": [10, 11, 12, 13, 14], "instal": 11, "ml_modelpath": [11, 12, 15, 16], "2022": [], "694158": [], "cc": [11, 16], "169": [11, 16], "onednn": [11, 16], "slightli": [11, 16], "turn": [11, 16], "environ": [11, 16], "tf_enable_onednn_opt": [11, 16], "698027": [], "w": [11, 16], "stream_executor": [11, 16], "platform": [11, 16], "dso_load": [11, 16], "dynam": [11, 16], "libcudart": [11, 16], "so": [11, 16], "dlerror": [11, 16], "cannot": [11, 15, 16], "No": [11, 13, 16], "directori": [11, 16], "698044": [], "cuda": [11, 16], "cudart_stub": [11, 16], "cudart": [11, 16], "gpu": [11, 16], "up": [7, 11, 16, 18], "note": [11, 12, 13, 15, 16], "eager": [11, 16], "style": [11, 16], "greater": [11, 16], "graph": [11, 16], "instanti": [11, 12], "49": 10, "357741": [], "libcuda": [11, 16], "357797": [], "cuda_driv": [11, 16], "269": [11, 16], "fail": [11, 16], "cuinit": [11, 16], "303": [11, 16], "357820": [], "cuda_diagnost": [11, 16], "kernel": [11, 16], "driver": [11, 16], "appear": [11, 16], "host": [11, 16], "proc": [11, 16], "nvidia": [11, 16], "358100": [], "cpu_feature_guard": [11, 16], "oneapi": [11, 16], "cpu": [11, 16], "avx2": [11, 16], "avx512f": [11, 16], "avx512_vnni": [11, 16], "fma": [11, 16], "rebuild": [11, 16], "18": [11, 13], "671": 11, "rigor": 11, "experiment": 11, "replic": 11, "info": [11, 14, 16], "dice_interfac": 11, "dice_tensorflow": 11, "03": [9, 10, 13, 14], "07": 10, "618": 11, "968": 11, "35it": [], "constrain": [11, 12, 13], "weigh": [11, 16], "consider": 11, "likelihood": 11, "term": 11, "present": 12, "approach": 12, "ab": 12, "1912": 12, "03277": 12, "remotedisconnect": [], "525": 16, "522": [], "valueerror": [], "url": [], "writeabl": [], "524": [], "_findfil": [], "write": [], "526": 14, "527": [], "_fname": [], "_splitzipext": [], "369": [], "366": [], "filelist": [], "_possible_nam": [], "368": [], "370": [], "_isurl": [], "371": [], "_cach": [], "479": [], "477": [], "478": [], "netfil": [], "urlopen": [], "480": [], "481": [], "del": 12, "usr": [], "urllib": [], "222": [], "timeout": [], "cafil": [], "capath": [], "cadefault": [], "context": [], "220": [], "221": [], "_open": [], "openerdirector": [], "fullurl": [], "req": [], "meth": [], "sy": [], "audit": [], "full_url": [], "header": [], "get_method": [], "respons": [], "528": [], "meth_nam": [], "protocol": [], "_respons": [], "542": [], "539": [], "541": [], "_call_chain": [], "handle_open": [], "543": [], "544": [], "545": [], "502": [], "chain": [], "handler": [], "501": [], "getattr": [], "503": [], "504": [], "1397": [], "httpshandler": [], "https_open": [], "1396": [], "do_open": [], "client": [], "httpsconnect": [], "1398": [], "_context": [], "check_hostnam": [], "_check_hostnam": [], "1358": [], "abstracthttphandl": [], "http_class": [], "http_conn_arg": [], "1356": [], "oserror": [], "err": [], "1357": [], "urlerror": [], "getrespons": [], "1359": [], "1360": [], "1348": [], "httpconnect": [], "1346": [], "1347": [], "begin": [], "1349": [], "connectionerror": [], "1350": [], "316": [], "httprespons": [], "314": [], "non": [14, 15], "315": [], "_read_statu": [], "317": [], "318": [], "break": 16, "285": [], "281": [], "repli": [], "repr": [], "282": [], "283": [], "presum": [], "server": [], "connect": [], "befor": 15, "284": [], "send": [], "remot": [], "286": [], "287": [], "288": [], "data_nam": 12, "becaus": 12, "_2node": 12, "pth": 12, "userwarn": 16, "warn": [15, 16], "in_featur": [], "out_featur": [], "bia": [], "softmax": [], "dim": [], "home": 16, "torch": [], "786": [], "sourcechangewarn": [], "retriev": [], "dump_patch": [], "patch": [], "tool": [], "revert": [], "msg": [], "arug": 12, "re": 12, "repeat": 12, "lr": 12, "batch_siz": 12, "2048": 12, "165": 12, "super": 12, "fast": 12, "might": [12, 16], "notic": 12, "still": [12, 16], "infeas": 12, "adpat": 12, "prodcu": 12, "adapt": 12, "under": 12, "assumpt": 12, "section": 12, "preserv": 12, "ed": 12, "never": 12, "decreas": 12, "increas": [12, 13, 15], "impli": [12, 15], "cause_1": 12, "cause_n": 12, "intend": 12, "direct": 12, "fourth": 12, "penalti": 12, "76": [10, 12], "344": 12, "87": [12, 13], "unlik": 12, "experi": 12, "scmgencf": 12, "oraclegencf": 12, "method_nam": 13, "observ": [13, 15, 16], "contrast": 13, "worsen": 13, "further": 13, "sens": 13, "randomli": 13, "freeli": 13, "control": 13, "best": 13, "quickli": 13, "promot": 13, "previous": 13, "dice_exp_genet": 13, "wish": 13, "closest": 13, "effici": 13, "behind": 13, "itself": 13, "displai": 13, "dice_exp_kd": 13, "rest": 14, "complet": [13, 14], "ident": 14, "load_iri": 14, "fetch_california_h": 14, "randomforestregressor": 14, "pd": [14, 16], "iri": 14, "consist": 14, "iris": 14, "setosa": 14, "versicolour": 14, "virginica": 14, "petal": 14, "sepal": 14, "length": 14, "toy_dataset": 14, "plant": 14, "df_iri": 14, "as_fram": 14, "frame": 14, "cm": 14, "width": 14, "rangeindex": 14, "150": 14, "entri": 14, "149": 14, "count": 14, "float64": 14, "int64": 14, "usag": 14, "kb": 14, "continuous_features_iri": 14, "tolist": 14, "categorical_featur": 14, "clf_iri": 14, "model_iri": 14, "d_iri": 14, "m_iri": 14, "exp_genetic_iri": 14, "As": [14, 15, 16], "lie": 14, "query_instances_iri": 14, "genetic_iri": 14, "39it": [], "california": 14, "hous": 14, "price": 14, "housing_data": 14, "df_hous": 14, "seri": 14, "medinc": 14, "houseag": 14, "averoom": 14, "avebedrm": 14, "popul": 14, "aveoccup": 14, "latitud": 14, "longitud": 14, "3252": 14, "984127": 14, "023810": 14, "322": 14, "555556": 14, "122": 14, "3014": 14, "238137": 14, "971880": 14, "2401": 14, "109842": 14, "86": 14, "585": 14, "2574": 14, "288136": 14, "073446": 14, "496": 14, "802260": 14, "85": [13, 14], "521": 14, "6431": 14, "817352": 14, "073059": 14, "558": 14, "547945": 14, "413": 14, "8462": 14, "281853": 14, "081081": 14, "565": 14, "181467": 14, "422": 14, "20640": 14, "20639": 14, "mb": 14, "continuous_features_h": 14, "regr_hous": 14, "model_h": 14, "d_hous": 14, "m_hous": 14, "exp_genetic_h": 14, "query_instances_h": 14, "genetic_h": 14, "49it": 13, "3487": 14, "930712": 14, "026217": 14, "1554": 14, "910112": 14, "650002": 14, "121": 14, "839996": 14, "49846": [], "5173": 14, "119": 14, "4537603999999984": [], "6184": [], "1543": [], "118": 14, "126689999999999": [], "4511": 14, "992958": 14, "316901": 14, "390": 14, "746479": 14, "200001": 14, "115": [11, 14], "599998": 14, "91159": [], "3682": 14, "394": [], "61": [10, 13, 14], "117": 14, "92": [10, 14], "98180959999999": [], "9167": 14, "393": [], "890800399999997": [], "discuss": [15, 16], "behavior": 15, "supress": 15, "deprec": 15, "compat": 15, "v1": 15, "log": 15, "set_verbos": 15, "631881": [], "635417": [], "635428": [], "artifici": 15, "set_random_se": 15, "set_se": 15, "__version__": [15, 16], "394561": [], "394614": [], "394632": [], "394838": [], "attributeerror": [], "160": [], "query_instances_list": [], "159": [], "set_continuous_feature_index": [], "161": [], "162": [], "163": [], "170": [], "171": [], "172": [], "cf_examples_arr": [], "remap": [], "continuous_feature_index": [], "get_loc": [], "continuous_feature_nam": [], "listcomp": [], "resutl": 15, "convei": 15, "robust": 15, "standard": 15, "affect": 15, "outlier": 15, "let": 15, "seven": 15, "Of": 15, "cours": 15, "sound": 15, "odd": 15, "ride": 15, "handl": 15, "scale": [15, 16], "veri": 15, "categori": [15, 16], "tabl": [12, 15, 18], "extrem": 15, "factor": 15, "captur": [15, 16], "preval": [15, 16], "respect": [15, 16], "basic": 16, "simul": 16, "ordereddict": 16, "randomforest": 16, "sk_modelpath": 16, "pretrain": 16, "329": 16, "unpickl": 16, "invalid": 16, "own": 16, "risk": 16, "model_persist": 16, "secur": 16, "maintain": 16, "decisiontreeclassifi": 16, "02": [9, 13, 14], "popular": 16, "come": 16, "built": 16, "noqa": 16, "988801": [], "992079": [], "992092": [], "820933": [], "820983": [], "821002": [], "821194": [], "382": [], "futurewarn": [], "concat": [], "temp": [], "ohe_base_df": [], "ignore_index": [], "sort": [], "019": 16, "911": 16, "755": 16, "dice_getting_start": 16, "nonetheless": 16, "raiutil": [], "9608": 9, "22027": 9, "14296": 9, "tmp": 9, "ipykernel_2173": [], "3514951616": 9, "settingwithcopywarn": 9, "copi": 9, "slice": 9, "row_index": 9, "col_index": 9, "caveat": 9, "document": 9, "pydata": 9, "user_guid": 9, "view": 9, "versu": 9, "92it": [], "17it": 13, "34it": [], "91it": [], "04it": [], "86it": [], "70it": [], "55it": 9, "08": 11, "06": 9, "58": 10, "89it": [], "66it": [], "37it": [], "095": [], "2023": [11, 16], "752470": [], "756608": [], "756625": [], "948236": [], "948388": [], "948454": [], "948952": [], "44it": [], "cell_typ": 12, "markdown": 12, "execution_count": 12, "dicen": 12, "dice_mln": 12, "functionsn": 12, "n": 12, "autoreloadn": 12, "dice_with_private_data": 12, "ipynb": 12, "scroll": 12, "featuresn": 12, "valuen": 12, "counterfactualsn": 12, "resultsn": 12, "constraintsn": 12, "monotonicn": 12, "nbsphinx": 12, "kernelspec": 12, "display_nam": 12, "language_info": 12, "codemirror_mod": 12, "ipython": 12, "file_extens": 12, "mimetyp": 12, "text": 12, "nbconvert_export": 12, "pygments_lex": 12, "ipython3": 12, "toc": 12, "base_numb": 12, "nav_menu": 12, "number_sect": 12, "sidebar": 12, "skip_h1_titl": 12, "title_cel": 12, "title_sidebar": 12, "toc_cel": 12, "toc_posit": 12, "toc_section_displai": 12, "toc_window_displai": 12, "varinspector": 12, "lennam": 12, "lentyp": 12, "lenvar": 12, "kernels_config": 12, "delete_cmd_postfix": 12, "delete_cmd_prefix": 12, "var_list": 12, "varrefreshcmd": 12, "var_dic_list": 12, "rm": 12, "types_to_exclud": 12, "builtin_function_or_method": 12, "_featur": 12, "window_displai": 12, "nbformat": 12, "nbformat_minor": 12, "79it": [], "07it": [], "perhap": [], "45it": [], "73it": [], "6646": [], "11233": 13, "23580": [], "2571": 13, "15736": 13, "20071": 13, "17010": 13, "15712": 13, "20it": [], "1267": 13, "554": 13, "32it": 11, "12896": 13, "5064": [], "64it": 13, "39714": [], "4560403999999965": [], "2037501000000015": [], "8702": [], "962199599999989": [], "193990299999995": [], "438123": [], "443679": [], "443700": [], "996181": [], "996275": [], "996300": [], "996628": [], "query_instance_to_df": [0, 1], "decode_model_output": [0, 2], "decode_to_original_label": [0, 2], "load_custom_testing_dataset_binary_str": [0, 5], "load_custom_testing_dataset_multiclass_str": [0, 5], "multiclassnetwork": [0, 5], "encoded_label": 2, "ipykernel_169": 9, "11it": 9, "10it": 10, "60it": 10, "01it": [10, 13], "99it": 11, "88it": 11, "68it": 11, "31it": 11, "25it": 11, "295": 11, "205": 11, "138021": 11, "207078": 11, "207103": 11, "626560": 11, "626614": 11, "626637": 11, "627732": 11, "6710000038146973": 11, "6179999709129333": 11, "9679999947547913": 11, "98it": 13, "3155": 13, "8361": 13, "22686": 13, "5158300399780273": 14, "51583": 14, "6976": 14, "124": 14, "6281412000000004": 14, "517150499999996": 14, "8763800263404846": 14, "87638": 14, "94750939999999": 14, "3242802999999945": 14, "320922": 16, "325785": 16, "325804": 16, "666572": 16, "666630": 16, "666650": 16, "666896": 16, "01899999938905239": 16}, "objects": {"": [[0, 0, 0, "-", "dice_ml"]], "dice_ml": [[0, 1, 1, "", "Data"], [0, 1, 1, "", "Dice"], [0, 1, 1, "", "Model"], [0, 0, 0, "-", "constants"], [0, 0, 0, "-", "counterfactual_explanations"], [0, 0, 0, "-", "data"], [1, 0, 0, "-", "data_interfaces"], [0, 0, 0, "-", "dice"], [0, 0, 0, "-", "diverse_counterfactuals"], [2, 0, 0, "-", "explainer_interfaces"], [0, 0, 0, "-", "model"], [3, 0, 0, "-", "model_interfaces"], [4, 0, 0, "-", "schema"], [5, 0, 0, "-", "utils"]], "dice_ml.Data": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.Dice": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.Model": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.constants": [[0, 1, 1, "", "BackEndTypes"], [0, 1, 1, "", "ModelTypes"], [0, 1, 1, "", "SamplingStrategy"]], "dice_ml.constants.BackEndTypes": [[0, 3, 1, "", "ALL"], [0, 3, 1, "", "Pytorch"], [0, 3, 1, "", "Sklearn"], [0, 3, 1, "", "Tensorflow1"], [0, 3, 1, "", "Tensorflow2"]], "dice_ml.constants.ModelTypes": [[0, 3, 1, "", "ALL"], [0, 3, 1, "", "Classifier"], [0, 3, 1, "", "Regressor"]], "dice_ml.constants.SamplingStrategy": [[0, 3, 1, "", "Genetic"], [0, 3, 1, "", "Gradient"], [0, 3, 1, "", "KdTree"], [0, 3, 1, "", "Random"]], "dice_ml.counterfactual_explanations": [[0, 1, 1, "", "CounterfactualExplanations"]], "dice_ml.counterfactual_explanations.CounterfactualExplanations": [[0, 4, 1, "", "cf_examples_list"], [0, 2, 1, "", "from_json"], [0, 4, 1, "", "local_importance"], [0, 4, 1, "", "metadata"], [0, 4, 1, "", "summary_importance"], [0, 2, 1, "", "to_json"], [0, 2, 1, "", "visualize_as_dataframe"], [0, 2, 1, "", "visualize_as_list"]], "dice_ml.data": [[0, 1, 1, "", "Data"], [0, 5, 1, "", "decide"]], "dice_ml.data.Data": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.data_interfaces": [[1, 0, 0, "-", "base_data_interface"], [1, 0, 0, "-", "private_data_interface"], [1, 0, 0, "-", "public_data_interface"]], "dice_ml.data_interfaces.private_data_interface": [[1, 1, 1, "", "PrivateData"]], "dice_ml.data_interfaces.private_data_interface.PrivateData": [[1, 2, 1, "", "create_ohe_params"], [1, 2, 1, "", "de_normalize_data"], [1, 2, 1, "", "fit_label_encoders"], [1, 2, 1, "", "from_dummies"], [1, 2, 1, "", "from_label"], [1, 2, 1, "", "get_all_dummy_colnames"], [1, 2, 1, "", "get_data_params_for_gradient_dice"], [1, 2, 1, "", "get_decimal_precisions"], [1, 2, 1, "", "get_decoded_data"], [1, 2, 1, "", "get_encoded_categorical_feature_indexes"], [1, 2, 1, "", "get_features_range"], [1, 2, 1, "", "get_indexes_of_features_to_vary"], [1, 2, 1, "", "get_inverse_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_mads"], [1, 2, 1, "", "get_minx_maxx"], [1, 2, 1, "", "get_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_valid_feature_range"], [1, 2, 1, "", "get_valid_mads"], [1, 2, 1, "", "normalize_data"], [1, 2, 1, "", "one_hot_encode_data"], [1, 2, 1, "", "prepare_df_for_ohe_encoding"], [1, 2, 1, "", "prepare_query_instance"], [1, 2, 1, "", "query_instance_to_df"]], "dice_ml.data_interfaces.public_data_interface": [[1, 1, 1, "", "PublicData"]], "dice_ml.data_interfaces.public_data_interface.PublicData": [[1, 2, 1, "", "create_ohe_params"], [1, 2, 1, "", "de_normalize_data"], [1, 2, 1, "", "fit_label_encoders"], [1, 2, 1, "", "from_dummies"], [1, 2, 1, "", "from_label"], [1, 2, 1, "", "get_all_dummy_colnames"], [1, 2, 1, "", "get_data_params_for_gradient_dice"], [1, 2, 1, "", "get_data_type"], [1, 2, 1, "", "get_decimal_precisions"], [1, 2, 1, "", "get_decoded_data"], [1, 2, 1, "", "get_encoded_categorical_feature_indexes"], [1, 2, 1, "", "get_features_range"], [1, 2, 1, "", "get_indexes_of_features_to_vary"], [1, 2, 1, "", "get_inverse_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_mads"], [1, 2, 1, "", "get_minx_maxx"], [1, 2, 1, "", "get_ohe_min_max_normalized_data"], [1, 2, 1, "", "get_quantiles_from_training_data"], [1, 2, 1, "", "get_valid_feature_range"], [1, 2, 1, "", "get_valid_mads"], [1, 2, 1, "", "normalize_data"], [1, 2, 1, "", "one_hot_encode_data"], [1, 2, 1, "", "prepare_df_for_ohe_encoding"], [1, 2, 1, "", "prepare_query_instance"]], "dice_ml.dice": [[0, 1, 1, "", "Dice"], [0, 5, 1, "", "decide"]], "dice_ml.dice.Dice": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.diverse_counterfactuals": [[0, 1, 1, "", "CounterfactualExamples"], [0, 5, 1, "", "json_converter"]], "dice_ml.diverse_counterfactuals.CounterfactualExamples": [[0, 2, 1, "", "display_df"], [0, 2, 1, "", "from_json"], [0, 2, 1, "", "print_list"], [0, 2, 1, "", "to_json"], [0, 2, 1, "", "visualize_as_dataframe"], [0, 2, 1, "", "visualize_as_list"]], "dice_ml.explainer_interfaces": [[2, 0, 0, "-", "dice_KD"], [2, 0, 0, "-", "dice_genetic"], [2, 0, 0, "-", "dice_pytorch"], [2, 0, 0, "-", "dice_random"], [2, 0, 0, "-", "dice_tensorflow1"], [2, 0, 0, "-", "dice_tensorflow2"], [2, 0, 0, "-", "explainer_base"], [2, 0, 0, "-", "feasible_base_vae"], [2, 0, 0, "-", "feasible_model_approx"]], "dice_ml.explainer_interfaces.dice_KD": [[2, 1, 1, "", "DiceKD"]], "dice_ml.explainer_interfaces.dice_KD.DiceKD": [[2, 2, 1, "", "do_sparsity_check"], [2, 2, 1, "", "duplicates"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_scores"], [2, 2, 1, "", "vary_valid"]], "dice_ml.explainer_interfaces.dice_genetic": [[2, 1, 1, "", "DiceGenetic"]], "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic": [[2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_sparsity_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_KD_init"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_param_initializations"], [2, 2, 1, "", "do_random_init"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "get_valid_feature_range"], [2, 2, 1, "", "label_decode"], [2, 2, 1, "", "label_decode_cfs"], [2, 2, 1, "", "label_encode"], [2, 2, 1, "", "mate"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_scores"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.dice_pytorch": [[2, 1, 1, "", "DicePyTorch"]], "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch": [[2, 2, 1, "", "compute_dist"], [2, 2, 1, "", "compute_diversity_loss"], [2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_regularization_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_optimizer_initializations"], [2, 2, 1, "", "dpp_style"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "get_model_output"], [2, 2, 1, "", "initialize_CFs"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_off_cfs"], [2, 2, 1, "", "stop_loop"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.dice_random": [[2, 1, 1, "", "DiceRandom"]], "dice_ml.explainer_interfaces.dice_random.DiceRandom": [[2, 2, 1, "", "get_continuous_samples"], [2, 2, 1, "", "get_samples"]], "dice_ml.explainer_interfaces.dice_tensorflow1": [[2, 1, 1, "", "DiceTensorFlow1"]], "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1": [[2, 2, 1, "", "compute_dist"], [2, 2, 1, "", "compute_diversity_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_regularization_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_optimizer_initializations"], [2, 2, 1, "", "dpp_style"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "initialize_CFs"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_off_cfs"], [2, 2, 1, "", "scipy_optimizers"], [2, 2, 1, "", "stop_loop"], [2, 2, 1, "", "tensorflow_optimizers"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.dice_tensorflow2": [[2, 1, 1, "", "DiceTensorFlow2"]], "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2": [[2, 2, 1, "", "compute_dist"], [2, 2, 1, "", "compute_diversity_loss"], [2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "compute_proximity_loss"], [2, 2, 1, "", "compute_regularization_loss"], [2, 2, 1, "", "compute_yloss"], [2, 2, 1, "", "do_cf_initializations"], [2, 2, 1, "", "do_loss_initializations"], [2, 2, 1, "", "do_optimizer_initializations"], [2, 2, 1, "", "dpp_style"], [2, 2, 1, "", "find_counterfactuals"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "initialize_CFs"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_off_cfs"], [2, 2, 1, "", "stop_loop"], [2, 2, 1, "", "update_hyperparameters"]], "dice_ml.explainer_interfaces.explainer_base": [[2, 1, 1, "", "ExplainerBase"]], "dice_ml.explainer_interfaces.explainer_base.ExplainerBase": [[2, 2, 1, "", "build_KD_tree"], [2, 2, 1, "", "check_permitted_range"], [2, 2, 1, "", "check_query_instance_validity"], [2, 2, 1, "", "decide_cf_validity"], [2, 2, 1, "", "decode_model_output"], [2, 2, 1, "", "decode_to_original_labels"], [2, 2, 1, "", "deserialize_explainer"], [2, 2, 1, "", "do_binary_search"], [2, 2, 1, "", "do_linear_search"], [2, 2, 1, "", "do_posthoc_sparsity_enhancement"], [2, 2, 1, "", "feature_importance"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "get_model_output_from_scores"], [2, 2, 1, "", "global_feature_importance"], [2, 2, 1, "", "infer_target_cfs_class"], [2, 2, 1, "", "infer_target_cfs_range"], [2, 2, 1, "", "is_cf_valid"], [2, 2, 1, "", "local_feature_importance"], [2, 2, 1, "", "misc_init"], [2, 2, 1, "", "predict_fn"], [2, 2, 1, "", "predict_fn_for_sparsity"], [2, 2, 1, "", "round_to_precision"], [2, 2, 1, "", "serialize_explainer"], [2, 2, 1, "", "setup"], [2, 2, 1, "", "sigmoid"]], "dice_ml.explainer_interfaces.feasible_base_vae": [[2, 1, 1, "", "FeasibleBaseVAE"]], "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE": [[2, 2, 1, "", "compute_loss"], [2, 2, 1, "", "generate_counterfactuals"], [2, 2, 1, "", "train"]], "dice_ml.explainer_interfaces.feasible_model_approx": [[2, 1, 1, "", "FeasibleModelApprox"]], "dice_ml.explainer_interfaces.feasible_model_approx.FeasibleModelApprox": [[2, 2, 1, "", "train"]], "dice_ml.model": [[0, 1, 1, "", "Model"], [0, 5, 1, "", "decide"]], "dice_ml.model.Model": [[0, 2, 1, "", "decide_implementation_type"]], "dice_ml.model_interfaces": [[3, 0, 0, "-", "base_model"], [3, 0, 0, "-", "keras_tensorflow_model"], [3, 0, 0, "-", "pytorch_model"]], "dice_ml.model_interfaces.base_model": [[3, 1, 1, "", "BaseModel"]], "dice_ml.model_interfaces.base_model.BaseModel": [[3, 2, 1, "", "get_gradient"], [3, 2, 1, "", "get_num_output_nodes"], [3, 2, 1, "", "get_num_output_nodes2"], [3, 2, 1, "", "get_output"], [3, 2, 1, "", "load_model"]], "dice_ml.model_interfaces.keras_tensorflow_model": [[3, 1, 1, "", "KerasTensorFlowModel"]], "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel": [[3, 2, 1, "", "get_gradient"], [3, 2, 1, "", "get_num_output_nodes"], [3, 2, 1, "", "get_output"], [3, 2, 1, "", "load_model"]], "dice_ml.model_interfaces.pytorch_model": [[3, 1, 1, "", "PyTorchModel"]], "dice_ml.model_interfaces.pytorch_model.PyTorchModel": [[3, 2, 1, "", "get_gradient"], [3, 2, 1, "", "get_num_output_nodes"], [3, 2, 1, "", "get_output"], [3, 2, 1, "", "load_model"], [3, 2, 1, "", "set_eval_mode"]], "dice_ml.utils": [[5, 0, 0, "-", "exception"], [5, 0, 0, "-", "helpers"], [5, 0, 0, "-", "neuralnetworks"], [6, 0, 0, "-", "sample_architecture"], [5, 0, 0, "-", "serialize"]], "dice_ml.utils.exception": [[5, 6, 1, "", "SystemException"]], "dice_ml.utils.helpers": [[5, 1, 1, "", "DataTransfomer"], [5, 5, 1, "", "get_adult_data_info"], [5, 5, 1, "", "get_adult_income_modelpath"], [5, 5, 1, "", "get_base_gen_cf_initialization"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline_binary"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline_multiclass"], [5, 5, 1, "", "get_custom_dataset_modelpath_pipeline_regression"], [5, 5, 1, "", "get_custom_vars_dataset_modelpath_pipeline"], [5, 5, 1, "", "inverse_ohe_min_max_transformation"], [5, 5, 1, "", "load_adult_income_dataset"], [5, 5, 1, "", "load_custom_testing_dataset"], [5, 5, 1, "", "load_custom_testing_dataset_binary"], [5, 5, 1, "", "load_custom_testing_dataset_binary_str"], [5, 5, 1, "", "load_custom_testing_dataset_multiclass"], [5, 5, 1, "", "load_custom_testing_dataset_multiclass_str"], [5, 5, 1, "", "load_custom_testing_dataset_regression"], [5, 5, 1, "", "load_min_max_equal_dataset"], [5, 5, 1, "", "load_outcome_not_last_column_dataset"], [5, 5, 1, "", "ohe_min_max_transformation"], [5, 5, 1, "", "save_adult_income_model"]], "dice_ml.utils.helpers.DataTransfomer": [[5, 2, 1, "", "feed_data_params"], [5, 2, 1, "", "initialize_transform_func"], [5, 2, 1, "", "inverse_transform"], [5, 2, 1, "", "transform"]], "dice_ml.utils.neuralnetworks": [[5, 1, 1, "", "FFNetwork"], [5, 1, 1, "", "MulticlassNetwork"]], "dice_ml.utils.neuralnetworks.FFNetwork": [[5, 2, 1, "", "forward"]], "dice_ml.utils.neuralnetworks.MulticlassNetwork": [[5, 2, 1, "", "forward"]], "dice_ml.utils.sample_architecture": [[6, 0, 0, "-", "vae_model"]], "dice_ml.utils.sample_architecture.vae_model": [[6, 1, 1, "", "AutoEncoder"], [6, 1, 1, "", "CF_VAE"]], "dice_ml.utils.sample_architecture.vae_model.AutoEncoder": [[6, 2, 1, "", "decoder"], [6, 2, 1, "", "encoder"], [6, 2, 1, "", "forward"], [6, 2, 1, "", "normal_likelihood"], [6, 2, 1, "", "sample_latent_code"], [6, 3, 1, "", "training"]], "dice_ml.utils.sample_architecture.vae_model.CF_VAE": [[6, 2, 1, "", "compute_elbo"], [6, 2, 1, "", "decoder"], [6, 2, 1, "", "encoder"], [6, 2, 1, "", "forward"], [6, 2, 1, "", "normal_likelihood"], [6, 2, 1, "", "sample_latent_code"], [6, 3, 1, "", "training"]], "dice_ml.utils.serialize": [[5, 1, 1, "", "DummyDataInterface"]], "dice_ml.utils.serialize.DummyDataInterface": [[5, 2, 1, "", "to_json"]]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:method", "3": "py:attribute", "4": "py:property", "5": "py:function", "6": "py:exception"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "method", "Python method"], "3": ["py", "attribute", "Python attribute"], "4": ["py", "property", "Python property"], "5": ["py", "function", "Python function"], "6": ["py", "exception", "Python exception"]}, "titleterms": {"dice_ml": [0, 1, 2, 3, 4, 5, 6, 8], "packag": [0, 1, 2, 3, 4, 5, 6, 7], "subpackag": [0, 5], "submodul": [0, 1, 2, 3, 5, 6], "constant": 0, "modul": [0, 1, 2, 3, 4, 5, 6], "counterfactual_explan": 0, "data": [0, 10, 16], "dice": [0, 7, 10, 11, 18], "diverse_counterfactu": 0, "model": [0, 9, 10, 11, 13, 14, 15, 16], "content": [0, 1, 2, 3, 4, 5, 6], "data_interfac": 1, "base_data_interfac": 1, "private_data_interfac": 1, "public_data_interfac": 1, "explainer_interfac": 2, "dice_kd": 2, "dice_genet": 2, "dice_pytorch": 2, "dice_random": 2, "dice_tensorflow1": 2, "dice_tensorflow2": 2, "explainer_bas": 2, "feasible_base_va": 2, "feasible_model_approx": 2, "model_interfac": 3, "base_model": 3, "keras_tensorflow_model": 3, "pytorch_model": 3, "schema": 4, "util": [5, 6], "except": 5, "helper": 5, "neuralnetwork": 5, "serial": 5, "sample_architectur": 6, "vae_model": 6, "divers": [7, 13, 15, 16, 18], "counterfactu": [7, 9, 10, 11, 13, 14, 15, 16, 18], "explan": [7, 9, 11, 13, 15, 16, 18], "ml": [7, 9, 10, 11, 13, 15, 18], "instal": [7, 18], "get": [7, 18], "start": [7, 18], "support": [7, 18], "method": [7, 9, 18], "gener": [7, 9, 11, 13, 14, 15, 16, 18], "us": [7, 10, 11, 18], "case": [7, 18], "feasibl": [7, 18], "The": [7, 18], "promis": [7, 18], "roadmap": [7, 18], "cite": [7, 18], "contribut": [7, 18], "notebook": [7, 17], "indic": 7, "tabl": 7, "benchmark": 9, "differ": 9, "cf": 9, "load": [9, 10, 11, 13, 15], "dataset": [9, 11, 13, 15], "train": [9, 11, 13, 16], "initi": 9, "estim": 10, "local": [10, 11], "global": [10, 11], "featur": [10, 11, 13, 15], "import": [10, 11], "score": [10, 11], "preliminari": [10, 11], "convert": 10, "output": 10, "json": 10, "object": 10, "quick": 11, "introduct": 11, "over": 11, "adult": 11, "exampl": 11, "attribut": 11, "work": 11, "deep": [11, 16], "learn": [11, 16], "tensorflow": 11, "pytorch": 11, "explain": [11, 16], "more": 11, "resourc": 11, "what": 11, "": 11, "next": 11, "vae": [], "ad": [], "constraint": [], "modelapprox": [], "initil": [], "feasiblemodelapprox": [], "ani": 13, "1": [13, 15], "independ": 13, "random": 13, "sampl": 13, "custom": [13, 15], "select": 13, "vari": 13, "choos": 13, "rang": 13, "2": [13, 15], "genet": 13, "algorithm": 13, "3": [13, 15], "queri": 13, "kd": 13, "tree": 13, "multi": 14, "class": 14, "classif": 14, "regress": 14, "multiclass": 14, "advanc": 15, "option": 15, "chang": 15, "weight": 15, "trade": 15, "off": 15, "between": 15, "proxim": 15, "goal": 15, "without": 16, "access": 16, "defin": 16, "meta": 16, "pre": 16, "sklearn": 16}, "envversion": {"sphinx.domains.c": 2, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 8, "sphinx.domains.index": 1, "sphinx.domains.javascript": 2, "sphinx.domains.math": 2, "sphinx.domains.python": 3, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.todo": 2, "nbsphinx": 4, "sphinx": 57}, "alltitles": {"dice_ml package": [[0, "dice-ml-package"]], "Subpackages": [[0, "subpackages"], [5, "subpackages"]], "Submodules": [[0, "submodules"], [1, "submodules"], [2, "submodules"], [3, "submodules"], [5, "submodules"], [6, "submodules"]], "dice_ml.constants module": [[0, "module-dice_ml.constants"]], "dice_ml.counterfactual_explanations module": [[0, "module-dice_ml.counterfactual_explanations"]], "dice_ml.data module": [[0, "module-dice_ml.data"]], "dice_ml.dice module": [[0, "module-dice_ml.dice"]], "dice_ml.diverse_counterfactuals module": [[0, "module-dice_ml.diverse_counterfactuals"]], "dice_ml.model module": [[0, "module-dice_ml.model"]], "Module contents": [[0, "module-dice_ml"], [1, "module-dice_ml.data_interfaces"], [2, "module-dice_ml.explainer_interfaces"], [3, "module-dice_ml.model_interfaces"], [4, "module-dice_ml.schema"], [5, "module-dice_ml.utils"], [6, "module-dice_ml.utils.sample_architecture"]], "dice_ml.data_interfaces package": [[1, "dice-ml-data-interfaces-package"]], "dice_ml.data_interfaces.base_data_interface module": [[1, "module-dice_ml.data_interfaces.base_data_interface"]], "dice_ml.data_interfaces.private_data_interface module": [[1, "module-dice_ml.data_interfaces.private_data_interface"]], "dice_ml.data_interfaces.public_data_interface module": [[1, "module-dice_ml.data_interfaces.public_data_interface"]], "dice_ml.explainer_interfaces package": [[2, "dice-ml-explainer-interfaces-package"]], "dice_ml.explainer_interfaces.dice_KD module": [[2, "module-dice_ml.explainer_interfaces.dice_KD"]], "dice_ml.explainer_interfaces.dice_genetic module": [[2, "module-dice_ml.explainer_interfaces.dice_genetic"]], "dice_ml.explainer_interfaces.dice_pytorch module": [[2, "module-dice_ml.explainer_interfaces.dice_pytorch"]], "dice_ml.explainer_interfaces.dice_random module": [[2, "module-dice_ml.explainer_interfaces.dice_random"]], "dice_ml.explainer_interfaces.dice_tensorflow1 module": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow1"]], "dice_ml.explainer_interfaces.dice_tensorflow2 module": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow2"]], "dice_ml.explainer_interfaces.explainer_base module": [[2, "module-dice_ml.explainer_interfaces.explainer_base"]], "dice_ml.explainer_interfaces.feasible_base_vae module": [[2, "module-dice_ml.explainer_interfaces.feasible_base_vae"]], "dice_ml.explainer_interfaces.feasible_model_approx module": [[2, "module-dice_ml.explainer_interfaces.feasible_model_approx"]], "dice_ml.model_interfaces package": [[3, "dice-ml-model-interfaces-package"]], "dice_ml.model_interfaces.base_model module": [[3, "module-dice_ml.model_interfaces.base_model"]], "dice_ml.model_interfaces.keras_tensorflow_model module": [[3, "module-dice_ml.model_interfaces.keras_tensorflow_model"]], "dice_ml.model_interfaces.pytorch_model module": [[3, "module-dice_ml.model_interfaces.pytorch_model"]], "dice_ml.schema package": [[4, "dice-ml-schema-package"]], "dice_ml.utils package": [[5, "dice-ml-utils-package"]], "dice_ml.utils.exception module": [[5, "module-dice_ml.utils.exception"]], "dice_ml.utils.helpers module": [[5, "module-dice_ml.utils.helpers"]], "dice_ml.utils.neuralnetworks module": [[5, "module-dice_ml.utils.neuralnetworks"]], "dice_ml.utils.serialize module": [[5, "module-dice_ml.utils.serialize"]], "dice_ml.utils.sample_architecture package": [[6, "dice-ml-utils-sample-architecture-package"]], "dice_ml.utils.sample_architecture.vae_model module": [[6, "module-dice_ml.utils.sample_architecture.vae_model"]], "Diverse Counterfactual Explanations (DiCE) for ML": [[7, "diverse-counterfactual-explanations-dice-for-ml"], [18, "diverse-counterfactual-explanations-dice-for-ml"]], "Installing DICE": [[7, "installing-dice"], [18, "installing-dice"]], "Getting started with DiCE": [[7, "getting-started-with-dice"], [18, "getting-started-with-dice"]], "Supported methods for generating counterfactuals": [[7, "supported-methods-for-generating-counterfactuals"], [18, "supported-methods-for-generating-counterfactuals"]], "Supported use-cases": [[7, "supported-use-cases"], [18, "supported-use-cases"]], "Feasibility of counterfactual explanations": [[7, "feasibility-of-counterfactual-explanations"], [18, "feasibility-of-counterfactual-explanations"]], "The promise of counterfactual explanations": [[7, "the-promise-of-counterfactual-explanations"], [18, "the-promise-of-counterfactual-explanations"]], "Roadmap": [[7, "roadmap"], [18, "roadmap"]], "Citing": [[7, "citing"], [18, "citing"]], "Contributing": [[7, "contributing"], [18, "contributing"]], "Getting Started:": [[7, null]], "Notebooks:": [[7, null], [17, null]], "Package:": [[7, null]], "Indices and tables": [[7, "indices-and-tables"]], "dice_ml": [[8, "dice-ml"]], "Benchmarking different CF explanation methods": [[9, "Benchmarking-different-CF-explanation-methods"]], "Loading dataset": [[9, "Loading-dataset"], [13, "Loading-dataset"], [15, "Loading-dataset"]], "Training the ML model": [[9, "Training-the-ML-model"]], "Initialize counterfactual generation methods": [[9, "Initialize-counterfactual-generation-methods"]], "Generate Counterfactuals": [[9, "Generate-Counterfactuals"]], "Estimating local and global feature importance scores using DiCE": [[10, "Estimating-local-and-global-feature-importance-scores-using-DiCE"]], "Preliminaries: Loading the data and ML model": [[10, "Preliminaries:-Loading-the-data-and-ML-model"]], "Local feature importance": [[10, "Local-feature-importance"]], "Global importance": [[10, "Global-importance"]], "Convert the counterfactual output to json": [[10, "Convert-the-counterfactual-output-to-json"]], "Convert the json output to a counterfactual object": [[10, "Convert-the-json-output-to-a-counterfactual-object"]], "Quick introduction to generating counterfactual explanations using DiCE": [[11, "Quick-introduction-to-generating-counterfactual-explanations-using-DiCE"]], "Preliminaries: Loading a dataset and a ML model trained over it": [[11, "Preliminaries:-Loading-a-dataset-and-a-ML-model-trained-over-it"]], "Loading the Adult dataset": [[11, "Loading-the-Adult-dataset"]], "Loading the ML model": [[11, "Loading-the-ML-model"]], "Generating counterfactual examples using DiCE": [[11, "Generating-counterfactual-examples-using-DiCE"]], "Generating feature attributions (local and global) using DiCE": [[11, "Generating-feature-attributions-(local-and-global)-using-DiCE"]], "Local feature importance scores": [[11, "Local-feature-importance-scores"]], "Global feature importance scores": [[11, "Global-feature-importance-scores"]], "Working with deep learning models (TensorFlow and PyTorch)": [[11, "Working-with-deep-learning-models-(TensorFlow-and-PyTorch)"]], "Explaining a Tensorflow model": [[11, "Explaining-a-Tensorflow-model"]], "Explaining a Pytorch model": [[11, "Explaining-a-Pytorch-model"]], "More resources: What\u2019s next?": [[11, "More-resources:-What\u2019s-next?"]], "Generating counterfactual explanations with any ML model": [[13, "Generating-counterfactual-explanations-with-any-ML-model"]], "1. Independent random sampling of features": [[13, "1.-Independent-random-sampling-of-features"]], "Training a custom ML model": [[13, "Training-a-custom-ML-model"], [13, "id1"], [13, "id3"]], "Generate diverse counterfactuals": [[13, "Generate-diverse-counterfactuals"], [13, "id2"], [13, "id4"], [15, "Generate-diverse-counterfactuals"], [16, "Generate-diverse-counterfactuals"], [16, "id1"]], "Selecting the features to vary": [[13, "Selecting-the-features-to-vary"], [13, "id5"]], "Choosing feature ranges": [[13, "Choosing-feature-ranges"]], "2. Genetic Algorithm": [[13, "2.-Genetic-Algorithm"]], "3. Querying a KD Tree": [[13, "3.-Querying-a-KD-Tree"]], "Selecting the feature ranges": [[13, "Selecting-the-feature-ranges"]], "Generating counterfactuals for multi-class classification and regression models": [[14, "Generating-counterfactuals-for-multi-class-classification-and-regression-models"]], "Multiclass Classification": [[14, "Multiclass-Classification"]], "Regression": [[14, "Regression"]], "Advanced options to customize Counterfactual Explanations": [[15, "Advanced-options-to-customize-Counterfactual-Explanations"]], "1. Loading a custom ML model": [[15, "1.-Loading-a-custom-ML-model"]], "2. Changing feature weights": [[15, "2.-Changing-feature-weights"]], "3. Trading off between proximity and diversity goals": [[15, "3.-Trading-off-between-proximity-and-diversity-goals"]], "Generating counterfactual explanations without access to training data": [[16, "Generating-counterfactual-explanations-without-access-to-training-data"]], "Defining meta data": [[16, "Defining-meta-data"]], "Explaining pre-trained sklearn models": [[16, "Explaining-pre-trained-sklearn-models"]], "Explaining pre-trained deep learning models": [[16, "Explaining-pre-trained-deep-learning-models"]]}, "indexentries": {"all (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.ALL"]], "all (dice_ml.constants.modeltypes attribute)": [[0, "dice_ml.constants.ModelTypes.ALL"]], "backendtypes (class in dice_ml.constants)": [[0, "dice_ml.constants.BackEndTypes"]], "classifier (dice_ml.constants.modeltypes attribute)": [[0, "dice_ml.constants.ModelTypes.Classifier"]], "counterfactualexamples (class in dice_ml.diverse_counterfactuals)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples"]], "counterfactualexplanations (class in dice_ml.counterfactual_explanations)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations"]], "data (class in dice_ml)": [[0, "dice_ml.Data"]], "data (class in dice_ml.data)": [[0, "dice_ml.data.Data"]], "dice (class in dice_ml)": [[0, "dice_ml.Dice"]], "dice (class in dice_ml.dice)": [[0, "dice_ml.dice.Dice"]], "genetic (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.Genetic"]], "gradient (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.Gradient"]], "kdtree (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.KdTree"]], "model (class in dice_ml)": [[0, "dice_ml.Model"]], "model (class in dice_ml.model)": [[0, "dice_ml.model.Model"]], "modeltypes (class in dice_ml.constants)": [[0, "dice_ml.constants.ModelTypes"]], "pytorch (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Pytorch"]], "random (dice_ml.constants.samplingstrategy attribute)": [[0, "dice_ml.constants.SamplingStrategy.Random"]], "regressor (dice_ml.constants.modeltypes attribute)": [[0, "dice_ml.constants.ModelTypes.Regressor"]], "samplingstrategy (class in dice_ml.constants)": [[0, "dice_ml.constants.SamplingStrategy"]], "sklearn (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Sklearn"]], "tensorflow1 (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Tensorflow1"]], "tensorflow2 (dice_ml.constants.backendtypes attribute)": [[0, "dice_ml.constants.BackEndTypes.Tensorflow2"]], "cf_examples_list (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.cf_examples_list"]], "decide() (in module dice_ml.data)": [[0, "dice_ml.data.decide"]], "decide() (in module dice_ml.dice)": [[0, "dice_ml.dice.decide"]], "decide() (in module dice_ml.model)": [[0, "dice_ml.model.decide"]], "decide_implementation_type() (dice_ml.data method)": [[0, "dice_ml.Data.decide_implementation_type"]], "decide_implementation_type() (dice_ml.dice method)": [[0, "dice_ml.Dice.decide_implementation_type"]], "decide_implementation_type() (dice_ml.model method)": [[0, "dice_ml.Model.decide_implementation_type"]], "decide_implementation_type() (dice_ml.data.data method)": [[0, "dice_ml.data.Data.decide_implementation_type"]], "decide_implementation_type() (dice_ml.dice.dice method)": [[0, "dice_ml.dice.Dice.decide_implementation_type"]], "decide_implementation_type() (dice_ml.model.model method)": [[0, "dice_ml.model.Model.decide_implementation_type"]], "dice_ml": [[0, "module-dice_ml"]], "dice_ml.constants": [[0, "module-dice_ml.constants"]], "dice_ml.counterfactual_explanations": [[0, "module-dice_ml.counterfactual_explanations"]], "dice_ml.data": [[0, "module-dice_ml.data"]], "dice_ml.dice": [[0, "module-dice_ml.dice"]], "dice_ml.diverse_counterfactuals": [[0, "module-dice_ml.diverse_counterfactuals"]], "dice_ml.model": [[0, "module-dice_ml.model"]], "display_df() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.display_df"]], "from_json() (dice_ml.counterfactual_explanations.counterfactualexplanations static method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.from_json"]], "from_json() (dice_ml.diverse_counterfactuals.counterfactualexamples static method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.from_json"]], "json_converter() (in module dice_ml.diverse_counterfactuals)": [[0, "dice_ml.diverse_counterfactuals.json_converter"]], "local_importance (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.local_importance"]], "metadata (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.metadata"]], "module": [[0, "module-dice_ml"], [0, "module-dice_ml.constants"], [0, "module-dice_ml.counterfactual_explanations"], [0, "module-dice_ml.data"], [0, "module-dice_ml.dice"], [0, "module-dice_ml.diverse_counterfactuals"], [0, "module-dice_ml.model"], [1, "module-dice_ml.data_interfaces"], [1, "module-dice_ml.data_interfaces.base_data_interface"], [1, "module-dice_ml.data_interfaces.private_data_interface"], [1, "module-dice_ml.data_interfaces.public_data_interface"], [2, "module-dice_ml.explainer_interfaces"], [2, "module-dice_ml.explainer_interfaces.dice_KD"], [2, "module-dice_ml.explainer_interfaces.dice_genetic"], [2, "module-dice_ml.explainer_interfaces.dice_pytorch"], [2, "module-dice_ml.explainer_interfaces.dice_random"], [2, "module-dice_ml.explainer_interfaces.dice_tensorflow1"], [2, "module-dice_ml.explainer_interfaces.dice_tensorflow2"], [2, "module-dice_ml.explainer_interfaces.explainer_base"], [2, "module-dice_ml.explainer_interfaces.feasible_base_vae"], [2, "module-dice_ml.explainer_interfaces.feasible_model_approx"], [3, "module-dice_ml.model_interfaces"], [3, "module-dice_ml.model_interfaces.base_model"], [3, "module-dice_ml.model_interfaces.keras_tensorflow_model"], [3, "module-dice_ml.model_interfaces.pytorch_model"], [4, "module-dice_ml.schema"], [5, "module-dice_ml.utils"], [5, "module-dice_ml.utils.exception"], [5, "module-dice_ml.utils.helpers"], [5, "module-dice_ml.utils.neuralnetworks"], [5, "module-dice_ml.utils.serialize"], [6, "module-dice_ml.utils.sample_architecture"], [6, "module-dice_ml.utils.sample_architecture.vae_model"]], "print_list() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.print_list"]], "summary_importance (dice_ml.counterfactual_explanations.counterfactualexplanations property)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.summary_importance"]], "to_json() (dice_ml.counterfactual_explanations.counterfactualexplanations method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.to_json"]], "to_json() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.to_json"]], "visualize_as_dataframe() (dice_ml.counterfactual_explanations.counterfactualexplanations method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.visualize_as_dataframe"]], "visualize_as_dataframe() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.visualize_as_dataframe"]], "visualize_as_list() (dice_ml.counterfactual_explanations.counterfactualexplanations method)": [[0, "dice_ml.counterfactual_explanations.CounterfactualExplanations.visualize_as_list"]], "visualize_as_list() (dice_ml.diverse_counterfactuals.counterfactualexamples method)": [[0, "dice_ml.diverse_counterfactuals.CounterfactualExamples.visualize_as_list"]], "privatedata (class in dice_ml.data_interfaces.private_data_interface)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData"]], "publicdata (class in dice_ml.data_interfaces.public_data_interface)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData"]], "create_ohe_params() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.create_ohe_params"]], "create_ohe_params() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.create_ohe_params"]], "de_normalize_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.de_normalize_data"]], "de_normalize_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.de_normalize_data"]], "dice_ml.data_interfaces": [[1, "module-dice_ml.data_interfaces"]], "dice_ml.data_interfaces.base_data_interface": [[1, "module-dice_ml.data_interfaces.base_data_interface"]], "dice_ml.data_interfaces.private_data_interface": [[1, "module-dice_ml.data_interfaces.private_data_interface"]], "dice_ml.data_interfaces.public_data_interface": [[1, "module-dice_ml.data_interfaces.public_data_interface"]], "fit_label_encoders() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.fit_label_encoders"]], "fit_label_encoders() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.fit_label_encoders"]], "from_dummies() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.from_dummies"]], "from_dummies() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.from_dummies"]], "from_label() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.from_label"]], "from_label() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.from_label"]], "get_all_dummy_colnames() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_all_dummy_colnames"]], "get_all_dummy_colnames() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_all_dummy_colnames"]], "get_data_params_for_gradient_dice() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_data_params_for_gradient_dice"]], "get_data_params_for_gradient_dice() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_data_params_for_gradient_dice"]], "get_data_type() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_data_type"]], "get_decimal_precisions() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_decimal_precisions"]], "get_decimal_precisions() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_decimal_precisions"]], "get_decoded_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_decoded_data"]], "get_decoded_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_decoded_data"]], "get_encoded_categorical_feature_indexes() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_encoded_categorical_feature_indexes"]], "get_encoded_categorical_feature_indexes() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_encoded_categorical_feature_indexes"]], "get_features_range() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_features_range"]], "get_features_range() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_features_range"]], "get_indexes_of_features_to_vary() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_indexes_of_features_to_vary"]], "get_indexes_of_features_to_vary() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_indexes_of_features_to_vary"]], "get_inverse_ohe_min_max_normalized_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_inverse_ohe_min_max_normalized_data"]], "get_inverse_ohe_min_max_normalized_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_inverse_ohe_min_max_normalized_data"]], "get_mads() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_mads"]], "get_mads() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_mads"]], "get_minx_maxx() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_minx_maxx"]], "get_minx_maxx() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_minx_maxx"]], "get_ohe_min_max_normalized_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_ohe_min_max_normalized_data"]], "get_ohe_min_max_normalized_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_ohe_min_max_normalized_data"]], "get_quantiles_from_training_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_quantiles_from_training_data"]], "get_valid_feature_range() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_valid_feature_range"]], "get_valid_feature_range() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_valid_feature_range"]], "get_valid_mads() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.get_valid_mads"]], "get_valid_mads() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.get_valid_mads"]], "normalize_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.normalize_data"]], "normalize_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.normalize_data"]], "one_hot_encode_data() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.one_hot_encode_data"]], "one_hot_encode_data() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.one_hot_encode_data"]], "prepare_df_for_ohe_encoding() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_df_for_ohe_encoding"]], "prepare_df_for_ohe_encoding() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.prepare_df_for_ohe_encoding"]], "prepare_query_instance() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.prepare_query_instance"]], "prepare_query_instance() (dice_ml.data_interfaces.public_data_interface.publicdata method)": [[1, "dice_ml.data_interfaces.public_data_interface.PublicData.prepare_query_instance"]], "query_instance_to_df() (dice_ml.data_interfaces.private_data_interface.privatedata method)": [[1, "dice_ml.data_interfaces.private_data_interface.PrivateData.query_instance_to_df"]], "dicegenetic (class in dice_ml.explainer_interfaces.dice_genetic)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic"]], "dicekd (class in dice_ml.explainer_interfaces.dice_kd)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD"]], "dicepytorch (class in dice_ml.explainer_interfaces.dice_pytorch)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch"]], "dicerandom (class in dice_ml.explainer_interfaces.dice_random)": [[2, "dice_ml.explainer_interfaces.dice_random.DiceRandom"]], "dicetensorflow1 (class in dice_ml.explainer_interfaces.dice_tensorflow1)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1"]], "dicetensorflow2 (class in dice_ml.explainer_interfaces.dice_tensorflow2)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2"]], "explainerbase (class in dice_ml.explainer_interfaces.explainer_base)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase"]], "feasiblebasevae (class in dice_ml.explainer_interfaces.feasible_base_vae)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE"]], "feasiblemodelapprox (class in dice_ml.explainer_interfaces.feasible_model_approx)": [[2, "dice_ml.explainer_interfaces.feasible_model_approx.FeasibleModelApprox"]], "build_kd_tree() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.build_KD_tree"]], "check_permitted_range() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.check_permitted_range"]], "check_query_instance_validity() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.check_query_instance_validity"]], "compute_dist() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_dist"]], "compute_dist() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_dist"]], "compute_dist() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_dist"]], "compute_diversity_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_diversity_loss"]], "compute_diversity_loss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_diversity_loss"]], "compute_diversity_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_diversity_loss"]], "compute_loss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_loss"]], "compute_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_loss"]], "compute_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_loss"]], "compute_loss() (dice_ml.explainer_interfaces.feasible_base_vae.feasiblebasevae method)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE.compute_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_proximity_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_proximity_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_proximity_loss"]], "compute_proximity_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_proximity_loss"]], "compute_regularization_loss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_regularization_loss"]], "compute_regularization_loss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_regularization_loss"]], "compute_regularization_loss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_regularization_loss"]], "compute_sparsity_loss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_sparsity_loss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.compute_yloss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.compute_yloss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.compute_yloss"]], "compute_yloss() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.compute_yloss"]], "decide_cf_validity() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decide_cf_validity"]], "decode_model_output() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_model_output"]], "decode_to_original_labels() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.decode_to_original_labels"]], "deserialize_explainer() (dice_ml.explainer_interfaces.explainer_base.explainerbase static method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.deserialize_explainer"]], "dice_ml.explainer_interfaces": [[2, "module-dice_ml.explainer_interfaces"]], "dice_ml.explainer_interfaces.dice_kd": [[2, "module-dice_ml.explainer_interfaces.dice_KD"]], "dice_ml.explainer_interfaces.dice_genetic": [[2, "module-dice_ml.explainer_interfaces.dice_genetic"]], "dice_ml.explainer_interfaces.dice_pytorch": [[2, "module-dice_ml.explainer_interfaces.dice_pytorch"]], "dice_ml.explainer_interfaces.dice_random": [[2, "module-dice_ml.explainer_interfaces.dice_random"]], "dice_ml.explainer_interfaces.dice_tensorflow1": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow1"]], "dice_ml.explainer_interfaces.dice_tensorflow2": [[2, "module-dice_ml.explainer_interfaces.dice_tensorflow2"]], "dice_ml.explainer_interfaces.explainer_base": [[2, "module-dice_ml.explainer_interfaces.explainer_base"]], "dice_ml.explainer_interfaces.feasible_base_vae": [[2, "module-dice_ml.explainer_interfaces.feasible_base_vae"]], "dice_ml.explainer_interfaces.feasible_model_approx": [[2, "module-dice_ml.explainer_interfaces.feasible_model_approx"]], "do_kd_init() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_KD_init"]], "do_binary_search() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_binary_search"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_cf_initializations"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_cf_initializations"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_cf_initializations"]], "do_cf_initializations() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_cf_initializations"]], "do_linear_search() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_linear_search"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_loss_initializations"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_loss_initializations"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_loss_initializations"]], "do_loss_initializations() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_loss_initializations"]], "do_optimizer_initializations() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.do_optimizer_initializations"]], "do_optimizer_initializations() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.do_optimizer_initializations"]], "do_optimizer_initializations() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.do_optimizer_initializations"]], "do_param_initializations() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_param_initializations"]], "do_posthoc_sparsity_enhancement() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.do_posthoc_sparsity_enhancement"]], "do_random_init() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.do_random_init"]], "do_sparsity_check() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.do_sparsity_check"]], "dpp_style() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.dpp_style"]], "dpp_style() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.dpp_style"]], "dpp_style() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.dpp_style"]], "duplicates() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.duplicates"]], "feature_importance() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.feature_importance"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.find_counterfactuals"]], "find_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.find_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.generate_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.generate_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.generate_counterfactuals"]], "generate_counterfactuals() (dice_ml.explainer_interfaces.feasible_base_vae.feasiblebasevae method)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE.generate_counterfactuals"]], "get_continuous_samples() (dice_ml.explainer_interfaces.dice_random.dicerandom method)": [[2, "dice_ml.explainer_interfaces.dice_random.DiceRandom.get_continuous_samples"]], "get_model_output() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.get_model_output"]], "get_model_output_from_scores() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.get_model_output_from_scores"]], "get_samples() (dice_ml.explainer_interfaces.dice_random.dicerandom method)": [[2, "dice_ml.explainer_interfaces.dice_random.DiceRandom.get_samples"]], "get_valid_feature_range() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.get_valid_feature_range"]], "global_feature_importance() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.global_feature_importance"]], "infer_target_cfs_class() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.infer_target_cfs_class"]], "infer_target_cfs_range() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.infer_target_cfs_range"]], "initialize_cfs() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.initialize_CFs"]], "initialize_cfs() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.initialize_CFs"]], "initialize_cfs() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.initialize_CFs"]], "is_cf_valid() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.is_cf_valid"]], "label_decode() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.label_decode"]], "label_decode_cfs() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.label_decode_cfs"]], "label_encode() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.label_encode"]], "local_feature_importance() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.local_feature_importance"]], "mate() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.mate"]], "misc_init() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.misc_init"]], "predict_fn() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.predict_fn"]], "predict_fn() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.predict_fn"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.predict_fn_for_sparsity"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.predict_fn_for_sparsity"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.predict_fn_for_sparsity"]], "predict_fn_for_sparsity() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.predict_fn_for_sparsity"]], "predict_fn_scores() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.predict_fn_scores"]], "predict_fn_scores() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.predict_fn_scores"]], "round_off_cfs() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.round_off_cfs"]], "round_off_cfs() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.round_off_cfs"]], "round_off_cfs() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.round_off_cfs"]], "round_to_precision() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.round_to_precision"]], "scipy_optimizers() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.scipy_optimizers"]], "serialize_explainer() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.serialize_explainer"]], "setup() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.setup"]], "sigmoid() (dice_ml.explainer_interfaces.explainer_base.explainerbase method)": [[2, "dice_ml.explainer_interfaces.explainer_base.ExplainerBase.sigmoid"]], "stop_loop() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.stop_loop"]], "stop_loop() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.stop_loop"]], "stop_loop() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.stop_loop"]], "tensorflow_optimizers() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.tensorflow_optimizers"]], "train() (dice_ml.explainer_interfaces.feasible_base_vae.feasiblebasevae method)": [[2, "dice_ml.explainer_interfaces.feasible_base_vae.FeasibleBaseVAE.train"]], "train() (dice_ml.explainer_interfaces.feasible_model_approx.feasiblemodelapprox method)": [[2, "dice_ml.explainer_interfaces.feasible_model_approx.FeasibleModelApprox.train"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_genetic.dicegenetic method)": [[2, "dice_ml.explainer_interfaces.dice_genetic.DiceGenetic.update_hyperparameters"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_pytorch.dicepytorch method)": [[2, "dice_ml.explainer_interfaces.dice_pytorch.DicePyTorch.update_hyperparameters"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_tensorflow1.dicetensorflow1 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow1.DiceTensorFlow1.update_hyperparameters"]], "update_hyperparameters() (dice_ml.explainer_interfaces.dice_tensorflow2.dicetensorflow2 method)": [[2, "dice_ml.explainer_interfaces.dice_tensorflow2.DiceTensorFlow2.update_hyperparameters"]], "vary_valid() (dice_ml.explainer_interfaces.dice_kd.dicekd method)": [[2, "dice_ml.explainer_interfaces.dice_KD.DiceKD.vary_valid"]], "basemodel (class in dice_ml.model_interfaces.base_model)": [[3, "dice_ml.model_interfaces.base_model.BaseModel"]], "kerastensorflowmodel (class in dice_ml.model_interfaces.keras_tensorflow_model)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel"]], "pytorchmodel (class in dice_ml.model_interfaces.pytorch_model)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel"]], "dice_ml.model_interfaces": [[3, "module-dice_ml.model_interfaces"]], "dice_ml.model_interfaces.base_model": [[3, "module-dice_ml.model_interfaces.base_model"]], "dice_ml.model_interfaces.keras_tensorflow_model": [[3, "module-dice_ml.model_interfaces.keras_tensorflow_model"]], "dice_ml.model_interfaces.pytorch_model": [[3, "module-dice_ml.model_interfaces.pytorch_model"]], "get_gradient() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_gradient"]], "get_gradient() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.get_gradient"]], "get_gradient() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.get_gradient"]], "get_num_output_nodes() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_num_output_nodes"]], "get_num_output_nodes() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.get_num_output_nodes"]], "get_num_output_nodes() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.get_num_output_nodes"]], "get_num_output_nodes2() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_num_output_nodes2"]], "get_output() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.get_output"]], "get_output() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.get_output"]], "get_output() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.get_output"]], "load_model() (dice_ml.model_interfaces.base_model.basemodel method)": [[3, "dice_ml.model_interfaces.base_model.BaseModel.load_model"]], "load_model() (dice_ml.model_interfaces.keras_tensorflow_model.kerastensorflowmodel method)": [[3, "dice_ml.model_interfaces.keras_tensorflow_model.KerasTensorFlowModel.load_model"]], "load_model() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.load_model"]], "set_eval_mode() (dice_ml.model_interfaces.pytorch_model.pytorchmodel method)": [[3, "dice_ml.model_interfaces.pytorch_model.PyTorchModel.set_eval_mode"]], "dice_ml.schema": [[4, "module-dice_ml.schema"]], "datatransfomer (class in dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.DataTransfomer"]], "dummydatainterface (class in dice_ml.utils.serialize)": [[5, "dice_ml.utils.serialize.DummyDataInterface"]], "ffnetwork (class in dice_ml.utils.neuralnetworks)": [[5, "dice_ml.utils.neuralnetworks.FFNetwork"]], "multiclassnetwork (class in dice_ml.utils.neuralnetworks)": [[5, "dice_ml.utils.neuralnetworks.MulticlassNetwork"]], "systemexception": [[5, "dice_ml.utils.exception.SystemException"]], "dice_ml.utils": [[5, "module-dice_ml.utils"]], "dice_ml.utils.exception": [[5, "module-dice_ml.utils.exception"]], "dice_ml.utils.helpers": [[5, "module-dice_ml.utils.helpers"]], "dice_ml.utils.neuralnetworks": [[5, "module-dice_ml.utils.neuralnetworks"]], "dice_ml.utils.serialize": [[5, "module-dice_ml.utils.serialize"]], "feed_data_params() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.feed_data_params"]], "forward() (dice_ml.utils.neuralnetworks.ffnetwork method)": [[5, "dice_ml.utils.neuralnetworks.FFNetwork.forward"]], "forward() (dice_ml.utils.neuralnetworks.multiclassnetwork method)": [[5, "dice_ml.utils.neuralnetworks.MulticlassNetwork.forward"]], "get_adult_data_info() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_adult_data_info"]], "get_adult_income_modelpath() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_adult_income_modelpath"]], "get_base_gen_cf_initialization() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_base_gen_cf_initialization"]], "get_custom_dataset_modelpath_pipeline() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline"]], "get_custom_dataset_modelpath_pipeline_binary() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline_binary"]], "get_custom_dataset_modelpath_pipeline_multiclass() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline_multiclass"]], "get_custom_dataset_modelpath_pipeline_regression() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_dataset_modelpath_pipeline_regression"]], "get_custom_vars_dataset_modelpath_pipeline() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.get_custom_vars_dataset_modelpath_pipeline"]], "initialize_transform_func() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.initialize_transform_func"]], "inverse_ohe_min_max_transformation() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.inverse_ohe_min_max_transformation"]], "inverse_transform() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.inverse_transform"]], "load_adult_income_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_adult_income_dataset"]], "load_custom_testing_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset"]], "load_custom_testing_dataset_binary() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_binary"]], "load_custom_testing_dataset_binary_str() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_binary_str"]], "load_custom_testing_dataset_multiclass() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_multiclass"]], "load_custom_testing_dataset_multiclass_str() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_multiclass_str"]], "load_custom_testing_dataset_regression() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_custom_testing_dataset_regression"]], "load_min_max_equal_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_min_max_equal_dataset"]], "load_outcome_not_last_column_dataset() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.load_outcome_not_last_column_dataset"]], "ohe_min_max_transformation() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.ohe_min_max_transformation"]], "save_adult_income_model() (in module dice_ml.utils.helpers)": [[5, "dice_ml.utils.helpers.save_adult_income_model"]], "to_json() (dice_ml.utils.serialize.dummydatainterface method)": [[5, "dice_ml.utils.serialize.DummyDataInterface.to_json"]], "transform() (dice_ml.utils.helpers.datatransfomer method)": [[5, "dice_ml.utils.helpers.DataTransfomer.transform"]], "autoencoder (class in dice_ml.utils.sample_architecture.vae_model)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder"]], "cf_vae (class in dice_ml.utils.sample_architecture.vae_model)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE"]], "compute_elbo() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.compute_elbo"]], "decoder() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.decoder"]], "decoder() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.decoder"]], "dice_ml.utils.sample_architecture": [[6, "module-dice_ml.utils.sample_architecture"]], "dice_ml.utils.sample_architecture.vae_model": [[6, "module-dice_ml.utils.sample_architecture.vae_model"]], "encoder() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.encoder"]], "encoder() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.encoder"]], "forward() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.forward"]], "forward() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.forward"]], "normal_likelihood() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.normal_likelihood"]], "normal_likelihood() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.normal_likelihood"]], "sample_latent_code() (dice_ml.utils.sample_architecture.vae_model.autoencoder method)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.sample_latent_code"]], "sample_latent_code() (dice_ml.utils.sample_architecture.vae_model.cf_vae method)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.sample_latent_code"]], "training (dice_ml.utils.sample_architecture.vae_model.autoencoder attribute)": [[6, "dice_ml.utils.sample_architecture.vae_model.AutoEncoder.training"]], "training (dice_ml.utils.sample_architecture.vae_model.cf_vae attribute)": [[6, "dice_ml.utils.sample_architecture.vae_model.CF_VAE.training"]]}})
\ No newline at end of file
diff --git a/docs/source/conf.py b/docs/source/conf.py
index df40af1f..7f5adb7f 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -22,7 +22,7 @@
 author = 'Ramaravind, Amit, Chenhao'
 
 # The full version, including alpha/beta/rc tags
-release = '0.10'
+release = '0.11'
 
 
 # -- General configuration ---------------------------------------------------
diff --git a/setup.py b/setup.py
index 94698ef4..73690036 100644
--- a/setup.py
+++ b/setup.py
@@ -1,6 +1,6 @@
 import setuptools
 
-VERSION_STR = "0.10"
+VERSION_STR = "0.11"
 
 with open("README.rst", "r") as fh:
     long_description = fh.read()
