Feature: pl.ann_hist

HISTORY.md

@@ -13,6 +13,12 @@ and this project adheres to
 **Plotting** (`pr.pl`)
 
 - `pairwise_peptide_correlations_heatmap()`: new feature
+- `ann_hist()`: histogram of `.obs`/`.var` annotations (numeric, str or
+  categorical), a thin wrapper around `seaborn.histplot`. `level_key`
+  plots one value per higher-level group (e.g. one `protein_q_value`
+  per `protein_id` in peptide-level data) and checks the value is
+  constant within each group. `vline` / `hline` add labelled
+  reference lines
 - `peptide_intensities()`, `proteoform_intensities()`: new `facet_by`
   parameter splitting the samples (`.obs`) across a grid of subplots
 

docs/sphinx/source/api/pl.rst

@@ -36,6 +36,7 @@ control, exploratory analysis, and statistical results.
    :toctree: generated/
    :nosignatures:
 
+   proteopy.pl.ann_hist
    proteopy.pl.n_samples_per_category
    proteopy.pl.n_peptides_per_sample
    proteopy.pl.n_proteins_per_sample

proteopy/pl/__init__.py

@@ -38,6 +38,8 @@
     hclustv_profile_intensities,
 )
 
+from .ann_hist import ann_hist
+
 from .sequence import (
     peptides_on_sequence,
     peptides_on_prot_sequence,