[ci skip] MTN Made the distinction between predictor and transformer clearer (INRIA#856) aa0fdfb

Author: pull[bot]

_images/57883c9f1bec4123cdacffad11f1a824299d6ac64190d3b82e33e8167636fbc7.png

@@ -101,11 +101,18 @@
 # ![Predictor fit diagram](../figures/api_diagram-predictor.fit.svg)
 #
 # In scikit-learn an object that has a `fit` method is called an **estimator**.
+# If the estimator additionally has :
+# - a  `predict` method, it is called a **predictor**. Examples of predictors
+#   are classifiers or regressors.
+# - a `transform` method, it is called a **transformer**. Examples of
+#   transformers are scalers or encoders. We will see more about transformers in
+#   the next notebook.
+#
 # The method `fit` is composed of two elements: (i) a **learning algorithm** and
 # (ii) some **model states**. The learning algorithm takes the training data and
 # training target as input and sets the model states. These model states are
-# later used to either predict (for classifiers and regressors) or transform
-# data (for transformers).
+# later used to either predict or transform data as explained above. See the
+# glossary for more detailed definitions.
 #
 # Both the learning algorithm and the type of model states are specific to each
 # type of model.
@@ -124,8 +131,7 @@
 target_predicted = model.predict(data)
 
 # %% [markdown]
-# An estimator (an object with a `fit` method) with a `predict` method is called
-# a **predictor**. We can illustrate the prediction mechanism as follows:
+# We can illustrate the prediction mechanism as follows:
 #
 # ![Predictor predict diagram](../figures/api_diagram-predictor.predict.svg)
 #

_sources/python_scripts/02_numerical_pipeline_introduction.py

@@ -88,6 +88,7 @@
 # We show how to apply such normalization using a scikit-learn transformer
 # called `StandardScaler`. This transformer shifts and scales each feature
 # individually so that they all have a 0-mean and a unit standard deviation.
+# We recall that transformers are estimators that have a `transform` method.
 #
 # We now investigate different steps used in scikit-learn to achieve such a
 # transformation of the data.

_sources/python_scripts/02_numerical_pipeline_scaling.py

@@ -136,6 +136,7 @@
 # that, here we only explore the combination learning-rate and the maximum
 # number of nodes for a total of 4 x 3 = 12 combinations.
 
+# %%
 # %%time
 from sklearn.model_selection import GridSearchCV
 

_sources/python_scripts/parameter_tuning_grid_search.py

@@ -61,8 +61,8 @@
     <script>const THEBE_JS_URL = "https://unpkg.com/thebe@0.8.2/lib/index.js"; const thebe_selector = ".thebe,.cell"; const thebe_selector_input = "pre"; const thebe_selector_output = ".output, .cell_output"</script>
     <script>DOCUMENTATION_OPTIONS.pagename = 'appendix/acknowledgement';</script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    <script src="../_static/matomo.js?v=8af330ab"></script>
     <script src="../_static/sklearn_mooc.js?v=cdec65c7"></script>
+    <script src="../_static/matomo.js?v=8af330ab"></script>
     <link rel="icon" href="../_static/favicon.ico"/>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />

appendix/acknowledgement.html

@@ -63,8 +63,8 @@
     <script defer="defer" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
     <script>DOCUMENTATION_OPTIONS.pagename = 'appendix/datasets_intro';</script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    <script src="../_static/matomo.js?v=8af330ab"></script>
     <script src="../_static/sklearn_mooc.js?v=cdec65c7"></script>
+    <script src="../_static/matomo.js?v=8af330ab"></script>
     <link rel="icon" href="../_static/favicon.ico"/>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />

appendix/datasets_intro.html

@@ -61,8 +61,8 @@
     <script>const THEBE_JS_URL = "https://unpkg.com/thebe@0.8.2/lib/index.js"; const thebe_selector = ".thebe,.cell"; const thebe_selector_input = "pre"; const thebe_selector_output = ".output, .cell_output"</script>
     <script>DOCUMENTATION_OPTIONS.pagename = 'appendix/glossary';</script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    <script src="../_static/matomo.js?v=8af330ab"></script>
     <script src="../_static/sklearn_mooc.js?v=cdec65c7"></script>
+    <script src="../_static/matomo.js?v=8af330ab"></script>
     <link rel="icon" href="../_static/favicon.ico"/>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />

appendix/glossary.html

@@ -61,8 +61,8 @@
     <script>const THEBE_JS_URL = "https://unpkg.com/thebe@0.8.2/lib/index.js"; const thebe_selector = ".thebe,.cell"; const thebe_selector_input = "pre"; const thebe_selector_output = ".output, .cell_output"</script>
     <script>DOCUMENTATION_OPTIONS.pagename = 'appendix/notebook_timings';</script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    <script src="../_static/matomo.js?v=8af330ab"></script>
     <script src="../_static/sklearn_mooc.js?v=cdec65c7"></script>
+    <script src="../_static/matomo.js?v=8af330ab"></script>
     <link rel="icon" href="../_static/favicon.ico"/>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />
@@ -1139,10 +1139,10 @@ <h1>Notebook timings<a class="headerlink" href="#notebook-timings" title="Link t
 <td><p>✅</p></td>
 </tr>
 <tr class="row-odd"><td><p><a class="xref doc reference internal" href="../python_scripts/parameter_tuning_grid_search.html"><span class="doc">python_scripts/parameter_tuning_grid_search</span></a></p></td>
-<td><p>2025-08-07 17:33</p></td>
+<td><p>2025-08-13 11:33</p></td>
 <td><p>cache</p></td>
-<td><p>2.2</p></td>
-<td><p><abbr title="CellExecutionError">❌</abbr></p></td>
+<td><p>11.8</p></td>
+<td><p>✅</p></td>
 </tr>
 <tr class="row-even"><td><p><a class="xref doc reference internal" href="../python_scripts/parameter_tuning_manual.html"><span class="doc">python_scripts/parameter_tuning_manual</span></a></p></td>
 <td><p>2025-08-07 11:47</p></td>

appendix/notebook_timings.html

@@ -61,8 +61,8 @@
     <script>const THEBE_JS_URL = "https://unpkg.com/thebe@0.8.2/lib/index.js"; const thebe_selector = ".thebe,.cell"; const thebe_selector_input = "pre"; const thebe_selector_output = ".output, .cell_output"</script>
     <script>DOCUMENTATION_OPTIONS.pagename = 'appendix/toc_redirect';</script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    <script src="../_static/matomo.js?v=8af330ab"></script>
     <script src="../_static/sklearn_mooc.js?v=cdec65c7"></script>
+    <script src="../_static/matomo.js?v=8af330ab"></script>
     <link rel="icon" href="../_static/favicon.ico"/>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />

appendix/toc_redirect.html

@@ -61,8 +61,8 @@
     <script>const THEBE_JS_URL = "https://unpkg.com/thebe@0.8.2/lib/index.js"; const thebe_selector = ".thebe,.cell"; const thebe_selector_input = "pre"; const thebe_selector_output = ".output, .cell_output"</script>
     <script>DOCUMENTATION_OPTIONS.pagename = 'concluding_remarks';</script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
-    <script src="_static/matomo.js?v=8af330ab"></script>
     <script src="_static/sklearn_mooc.js?v=cdec65c7"></script>
+    <script src="_static/matomo.js?v=8af330ab"></script>
     <link rel="icon" href="_static/favicon.ico"/>
     <link rel="index" title="Index" href="genindex.html" />
     <link rel="search" title="Search" href="search.html" />