Add cluster_resolution_finder and cluster_decision_tree for help deciding the proper resolution

.github/workflows/ci.yml

@@ -64,19 +64,19 @@ jobs:
 
       - name: Install dependencies
         if: matrix.dependencies-version == null
-        run: uv pip install --system --compile "scanpy[dev,test-full] @ ."
+        run: uv pip install --system --compile "scanpy[dev,test-full,leiden] @ ."
       - name: Install dependencies (no optional features)
         if: matrix.dependencies-version == 'min-optional'
-        run: uv pip install --system --compile "scanpy[dev,test-min] @ ."
+        run: uv pip install --system --compile "scanpy[dev,test-min,leiden] @ ."
       - name: Install dependencies (minimum versions)
         if: matrix.dependencies-version == 'minimum'
         run: |
           uv pip install --system --compile tomli packaging
-          deps=$(python3 ci/scripts/min-deps.py pyproject.toml --extra dev test)
+          deps=$(python3 ci/scripts/min-deps.py pyproject.toml --extra dev test leiden)
           uv pip install --system --compile $deps "scanpy @ ."
       - name: Install dependencies (pre-release versions)
         if: matrix.dependencies-version == 'pre-release'
-        run: uv pip install -v --system --compile --pre "scanpy[dev,test-full] @ ." "anndata[dev,test] @ git+https://github.com/scverse/anndata.git"
+        run: uv pip install -v --system --compile --pre "scanpy[dev,test-full,leiden] @ ." "anndata[dev,test] @ git+https://github.com/scverse/anndata.git"
 
       - name: Run pytest
         if: matrix.test-type == null

.gitignore

@@ -9,6 +9,10 @@
 /docs/api/generated
 /docs/external/generated
 /docs/jupyter_execute
+cluster tree demo figure.pptx
+mytest.py
+_cluster_tree_standelone.py
+expected.png
 
 # tests
 /*cache/
@@ -45,3 +49,5 @@ Thumbs.db
 # asv benchmark files
 /benchmarks/.asv
 /benchmarks/data/
+myenv/
+test.py

.readthedocs.yml

@@ -23,3 +23,4 @@ python:
     - doc
     - dev  # for towncrier
     - leiden
+    - pytest-mpl  # image comparison

src/scanpy/plotting/__init__.py

@@ -13,6 +13,7 @@
     tracksplot,
     violin,
 )
+from ._cluster_tree import cluster_decision_tree
 from ._dotplot import DotPlot, dotplot
 from ._matrixplot import MatrixPlot, matrixplot
 from ._preprocessing import filter_genes_dispersion, highly_variable_genes
@@ -58,6 +59,7 @@
     "DotPlot",
     "MatrixPlot",
     "StackedViolin",
+    "cluster_decision_tree",
     "clustermap",
     "correlation_matrix",
     "dendrogram",