UKHD-NP · leventetn · Sep 28, 2026 · Sep 28, 2026 · Sep 28, 2026 · Sep 28, 2026
diff --git a/HISTORY.md b/HISTORY.md
@@ -14,6 +14,10 @@ and this project adheres to
 
 - `peptide_intensities()`, `proteoform_intensities()`: new `facet_by`
   parameter splitting the samples (`.obs`) across a grid of subplots
+- `var_detected_by_cat_upset()`: UpSet plot of which features (`.var`)
+  are detected in which categories of an `.obs` column, with
+  per-category `min_count` / `min_fraction` detection thresholds and a
+  `No category` set for features detected in none of them
 
 **Preprocessing** (`pr.pp`)
 

diff --git a/docs/sphinx/source/api/pl.rst b/docs/sphinx/source/api/pl.rst
@@ -29,6 +29,7 @@ control, exploratory analysis, and statistical results.
    proteopy.pl.binary_heatmap
    proteopy.pl.completeness_per_sample
    proteopy.pl.completeness_per_var
+   proteopy.pl.var_detected_by_cat_upset
 
 .. rubric:: Metadata exploration
 

diff --git a/docs/sphinx/source/tutorials/index.rst b/docs/sphinx/source/tutorials/index.rst
@@ -10,3 +10,4 @@ workflows.
    karayel-2020_proteome-remodeling-during-human-erythropoiesis
    bludau-2021_tissue-specific-proteoform-inference-across-five-mouse-organs
    The proteodata format <proteodata_basics>
+   Plotting tutorial <plotting>
diff --git a/docs/sphinx/source/tutorials/plotting.ipynb b/docs/sphinx/source/tutorials/plotting.ipynb
@@ -0,0 +1 @@
+../../../tutorials/plotting.ipynb
diff --git a/docs/tutorials/plotting.ipynb b/docs/tutorials/plotting.ipynb
diff --git a/proteopy/pl/__init__.py b/proteopy/pl/__init__.py
@@ -35,6 +35,10 @@
     hclustv_profile_intensities,
 )
 
+from .upset import (
+    var_detected_by_cat_upset,
+)
+
 from .sequence import (
     peptides_on_sequence,
     peptides_on_prot_sequence,