DOC remove color quantization K-means example (#29961)

glemaitre · web-flow · commit 48ef3baff59b · 2024-10-14T13:54:42.000+02:00
diff --git a/doc/conf.py b/doc/conf.py
@@ -478,6 +478,9 @@ def add_js_css_files(app, pagename, templatename, context, doctree):
     "auto_examples/linear_model/plot_lasso_coordinate_descent_path": (
         "auto_examples/linear_model/plot_lasso_lasso_lars_elasticnet_path"
     ),
+    "auto_examples/cluster/plot_color_quantization": (
+        "auto_examples/cluster/plot_face_compress"
+    ),
 }
 html_context["redirects"] = redirects
 for old_link in redirects:
diff --git a/doc/datasets/loading_other_datasets.rst b/doc/datasets/loading_other_datasets.rst
@@ -19,11 +19,20 @@ and pipelines on 2D data.
    load_sample_images
    load_sample_image
 
-.. image:: ../auto_examples/cluster/images/sphx_glr_plot_color_quantization_001.png
-   :target: ../auto_examples/cluster/plot_color_quantization.html
+.. plot::
+   :context: close-figs
    :scale: 30
    :align: right
+   :include-source: False
 
+    import matplotlib.pyplot as plt
+    from sklearn.datasets import load_sample_image
+
+    china = load_sample_image("china.jpg")
+    plt.imshow(china)
+    plt.axis('off')
+    plt.tight_layout()
+    plt.show()
 
 .. warning::
 
@@ -33,10 +42,6 @@ and pipelines on 2D data.
   if you plan to use ``matplotlib.pyplpt.imshow``, don't forget to scale to the range
   0 - 1 as done in the following example.
 
-.. rubric:: Examples
-
-* :ref:`sphx_glr_auto_examples_cluster_plot_color_quantization.py`
-
 .. _libsvm_loader:
 
 Datasets in svmlight / libsvm format
diff --git a/doc/modules/clustering.rst b/doc/modules/clustering.rst
@@ -236,11 +236,6 @@ computing cluster centers and values of inertia. For example, assigning a
 weight of 2 to a sample is equivalent to adding a duplicate of that sample
 to the dataset :math:`X`.
 
-K-means can be used for vector quantization. This is achieved using the
-``transform`` method of a trained model of :class:`KMeans`. For an example of
-performing vector quantization on an image refer to
-:ref:`sphx_glr_auto_examples_cluster_plot_color_quantization.py`.
-
 .. rubric:: Examples
 
 * :ref:`sphx_glr_auto_examples_cluster_plot_cluster_iris.py`: Example usage of
diff --git a/examples/cluster/plot_color_quantization.py b/examples/cluster/plot_color_quantization.py
diff --git a/sklearn/cluster/_kmeans.py b/sklearn/cluster/_kmeans.py
@@ -1363,9 +1363,6 @@ class KMeans(_BaseKMeans):
     For examples of common problems with K-Means and how to address them see
     :ref:`sphx_glr_auto_examples_cluster_plot_kmeans_assumptions.py`.
 
-    For an example of how to use K-Means to perform color quantization see
-    :ref:`sphx_glr_auto_examples_cluster_plot_color_quantization.py`.
-
     For a demonstration of how K-Means can be used to cluster text documents see
     :ref:`sphx_glr_auto_examples_text_plot_document_clustering.py`.
 
