rootfig 0.2.1__tar.gz → 0.2.2__tar.gz

{rootfig-0.2.1 → rootfig-0.2.2}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.5
 Name: rootfig
-Version: 0.2.1
+Version: 0.2.2
 Summary: Publication-quality figures straight from ROOT trees, without ROOT: uproot + Awkward + hist + mplhep with a TTree::Draw-like API.
 Project-URL: Homepage, https://github.com/jbeirer/rootfig
-Project-URL: Documentation, https://github.com/jbeirer/rootfig#readme
+Project-URL: Documentation, https://jbeirer.github.io/rootfig/
 Project-URL: Repository, https://github.com/jbeirer/rootfig
 Project-URL: Issues, https://github.com/jbeirer/rootfig/issues
 Author-email: Joshua Falco Beirer <jbeirer@cern.ch>
@@ -35,41 +35,42 @@ Description-Content-Type: text/markdown
 
 **Publication-quality figures straight from ROOT trees, without ROOT.**
 
-`rootfig` is the `TTree::Draw` workflow for the Scientific Python HEP stack:
-give it ROOT files, a tree, an expression, a selection and a weight, and get a
-styled matplotlib figure back in one call. It reads with
-[uproot](https://github.com/scikit-hep/uproot5), computes with
-[Awkward Array](https://github.com/scikit-hep/awkward), fills
-[hist](https://github.com/scikit-hep/hist) histograms and draws with
-[mplhep](https://github.com/scikit-hep/mplhep). It adds the missing glue:
-predictable per-event/per-object selection semantics, weights, shared
-binning across samples, normalisation, ratio panels and good defaults.
-
+[![Docs](https://img.shields.io/badge/docs-online-blue)](https://jbeirer.github.io/rootfig/)
 [![CI](https://github.com/jbeirer/rootfig/actions/workflows/ci.yml/badge.svg)](https://github.com/jbeirer/rootfig/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/jbeirer/rootfig/branch/main/graph/badge.svg)](https://codecov.io/gh/jbeirer/rootfig)
 [![PyPI](https://img.shields.io/pypi/v/rootfig.svg)](https://pypi.org/project/rootfig/)
 [![Python](https://img.shields.io/pypi/pyversions/rootfig.svg)](https://pypi.org/project/rootfig/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
+**[Documentation](https://jbeirer.github.io/rootfig/) ·
+[Gallery](https://jbeirer.github.io/rootfig/gallery/) ·
+[Quick start](https://jbeirer.github.io/rootfig/quickstart/)**
+
+Go from ROOT files to a styled figure in one call. Choose a variable, add a
+selection, and plot:
+
 ```python
 import rootfig as rf
 
 rf.plot("events.root", "Muon_pt", tree="events", selection="Muon_pt > 20", bins=50)
 ```
 
+Start with a single distribution; add samples, weights, stacks and ratio
+panels as your analysis grows. Every plot gives you a matplotlib figure to
+customise and save. No ROOT installation required.
+
 <p align="center">
-  <img src="docs/images/gallery/stack_data.png" alt="Stacked simulation with data and a ratio panel" width="48%">
-  <img src="docs/images/gallery/xbreak_ratio.png" alt="Broken x axis with a ratio panel" width="48%">
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/stack_data.png" alt="Stacked simulation with data and a ratio panel" width="48%"></a>
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/xbreak_ratio.png" alt="Broken x axis with a ratio panel" width="48%"></a>
 </p>
 <p align="center">
-  <img src="docs/images/gallery/object_vs_event.png" alt="Per-object versus per-event selections" width="48%">
-  <img src="docs/images/gallery/hist2d.png" alt="Two-dimensional histogram" width="48%">
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/object_vs_event.png" alt="Per-object versus per-event selections" width="48%"></a>
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/hist2d.png" alt="Two-dimensional histogram" width="48%"></a>
 </p>
 
-These and a dozen more figures, each next to the code that made it, are in the
-[gallery](https://jbeirer.github.io/rootfig/gallery/). All of them come from
-[`examples/gallery`](examples/gallery/__init__.py), which writes toy ROOT files and
-draws every example in a few seconds; the same figures are pixel-compared in CI.
+**[Explore the gallery →](https://jbeirer.github.io/rootfig/gallery/)**
+See each figure alongside the code that makes it, from simple overlays to
+stacked data/MC comparisons, broken axes and 2D histograms.
 
 ## Installation
 
@@ -82,7 +83,7 @@ uv add rootfig
 Python 3.12 or newer. No ROOT installation is needed; `TTree` and `RNTuple`
 files are both supported.
 
-## Quick start
+## Compare samples in one call
 
 ```python
 import rootfig as rf
@@ -100,8 +101,9 @@ rf.plot(
 )
 ```
 
-For analysis scripts with many samples, variables and plots, describe things
-once and reuse them:
+## Build up to a full analysis
+
+Define samples, variables, cuts and styles once, then reuse them across plots:
 
 ```python
 import rootfig as rf
@@ -132,56 +134,50 @@ Everything you get back is a standard object: `p.fig` and `p.ax` are
 matplotlib `Figure`/`Axes`, `p.hists` are `hist.Hist` objects, and
 `rf.load(...)` returns Awkward arrays.
 
-## Features
-
-- **One call from files to figure**, reading only the branches the expressions need.
-- **Expressions in Python syntax**: `sqrt(px**2 + py**2)`, `count(Jet_pt) >= 2`,
-  `` `jet1_b-tag` > 0.5 ``, `and`/`or`/`not`, chained comparisons.
-- **Jagged branches done right**: per-object cuts mask objects, per-event
-  cuts drop events, ambiguous combinations raise a clear error instead of
-  silently broadcasting.
-- **Weights**: per-event weights broadcast onto objects, per-object weights,
-  constant scale factors, multiplicative combination of sample and plot weights.
-- **Histograms with uncertainties** (`hist` with `Weight` storage), shared
-  binning across samples, automatic or robust ranges, log bins, flow bins.
-- **Overlays, stacks, data points, ratio panels** with correct error
-  propagation for weighted histograms and a reference-uncertainty band.
-- **Normalisation**: to unity, density, per bin width, or to a number; or to
-  a **luminosity** from cross sections and generated-event counts
-  (`Sample(xsec="0.2 pb", ngen="eventsProcessed")`, `lumi="10.8 ab^-1"`).
-- **Analysis tables and panels**: cut flows with yields and efficiencies,
-  significance panels (S/√B), efficiency-versus-variable plots with binomial
-  intervals, profiles and resolutions.
-- **Experiment-neutral defaults**, with mplhep styles and labels for ATLAS,
-  CMS, LHCb, ALICE and DUNE one keyword away; any other experiment name, GeV
-  and ab⁻¹ work too.
-- **EDM4hep-friendly**: sub-branches of split collections are addressed as
-  `ReconstructedParticles.momentum.x`, with `pt`, `p`, `theta`, `costheta`,
-  `eta`, `phi` and `mass` helpers.
-- **Also**: 2D histograms, summary statistics tables, statistics boxes,
-  correlation matrices, multi-file globs, entry ranges for quick looks.
+## What you can do
+
+- **Select events and objects with readable expressions.** Write cuts such as
+  `count(Jet_pt) >= 2` or `Muon_pt > 20`; event and object selections have
+  explicit rules, and event weights carry through to each selected object.
+- **Compare samples with a few keywords.** Overlays, stacks, data points and
+  ratio panels share binning and propagate histogram uncertainties.
+  Normalise to unity, density, bin width or luminosity.
+- **Style figures for your analysis.** Add experiment labels, units, log axes
+  and broken axes, then refine the result with matplotlib.
+- **Go beyond 1D plots.** Draw 2D histograms, correlations, efficiencies,
+  profiles, resolutions and significance panels; produce cut flows and
+  summary statistics from the same inputs.
+- **Work directly with your files.** Read `TTree` and `RNTuple` data, combine
+  files with globs, limit entry ranges for quick checks, and use EDM4hep
+  split collections. Only the branches your expressions need are read.
 
 ## Documentation
 
-- [Quick start](docs/quickstart.md)
-- [Expressions and selections](docs/expressions.md)
-- [Samples, variables, cuts and styles](docs/composable.md)
-- [Plotting options](docs/plotting.md)
-- [Relation to uproot, Awkward, hist, mplhep and matplotlib](docs/ecosystem.md)
+**[Read the docs](https://jbeirer.github.io/rootfig/)** or
+**[browse the gallery](https://jbeirer.github.io/rootfig/gallery/)** for examples
+with figures and code.
+
+- [Quick start](https://jbeirer.github.io/rootfig/quickstart/): your first plot, selections and weights.
+- [Expressions and selections](https://jbeirer.github.io/rootfig/expressions/): syntax and event/object rules.
+- [Samples, variables, cuts and styles](https://jbeirer.github.io/rootfig/composable/): reusable analysis definitions.
+- [Plotting options](https://jbeirer.github.io/rootfig/plotting/): binning, normalisation, panels and styling.
+- [API reference](https://jbeirer.github.io/rootfig/api/): full signatures and options.
 
 ## Relation to the ecosystem
 
-`rootfig` does not replace any of the libraries it builds on:
+`rootfig` brings a `TTree::Draw`-like workflow to the Scientific Python HEP
+stack, building on familiar libraries:
 
 | Task | Library | What rootfig adds |
 | --- | --- | --- |
-| Reading ROOT files | uproot | file globs, tree auto-detection, reading only the required branches |
-| Jagged arrays | Awkward Array | the per-event/per-object rules for cuts and weights |
-| Histograms | hist / boost-histogram | shared binning, automatic ranges, normalisation, ratios |
-| Drawing | mplhep + matplotlib | overlays, stacks, ratio panels, labels and legends with good defaults |
+| Reading ROOT files | [uproot](https://github.com/scikit-hep/uproot5) | file globs, tree auto-detection, reading only the required branches |
+| Jagged arrays | [Awkward Array](https://github.com/scikit-hep/awkward) | the per-event/per-object rules for cuts and weights |
+| Histograms | [hist](https://github.com/scikit-hep/hist) / boost-histogram | shared binning, automatic ranges, normalisation, ratios |
+| Drawing | [mplhep](https://github.com/scikit-hep/mplhep) + matplotlib | overlays, stacks, ratio panels, labels and legends with good defaults |
 
 If you already have `hist.Hist` objects, `rf.plot_histograms` draws them with
-the same options. If you want the arrays, `rf.load` returns them.
+the same options. If you want the arrays, `rf.load` returns them. See
+[the ecosystem guide](https://jbeirer.github.io/rootfig/ecosystem/) for details.
 
 ## Development
 

rootfig-0.2.2/README.md

@@ -0,0 +1,164 @@
+# rootfig
+
+**Publication-quality figures straight from ROOT trees, without ROOT.**
+
+[![Docs](https://img.shields.io/badge/docs-online-blue)](https://jbeirer.github.io/rootfig/)
+[![CI](https://github.com/jbeirer/rootfig/actions/workflows/ci.yml/badge.svg)](https://github.com/jbeirer/rootfig/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jbeirer/rootfig/branch/main/graph/badge.svg)](https://codecov.io/gh/jbeirer/rootfig)
+[![PyPI](https://img.shields.io/pypi/v/rootfig.svg)](https://pypi.org/project/rootfig/)
+[![Python](https://img.shields.io/pypi/pyversions/rootfig.svg)](https://pypi.org/project/rootfig/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**[Documentation](https://jbeirer.github.io/rootfig/) ·
+[Gallery](https://jbeirer.github.io/rootfig/gallery/) ·
+[Quick start](https://jbeirer.github.io/rootfig/quickstart/)**
+
+Go from ROOT files to a styled figure in one call. Choose a variable, add a
+selection, and plot:
+
+```python
+import rootfig as rf
+
+rf.plot("events.root", "Muon_pt", tree="events", selection="Muon_pt > 20", bins=50)
+```
+
+Start with a single distribution; add samples, weights, stacks and ratio
+panels as your analysis grows. Every plot gives you a matplotlib figure to
+customise and save. No ROOT installation required.
+
+<p align="center">
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/stack_data.png" alt="Stacked simulation with data and a ratio panel" width="48%"></a>
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/xbreak_ratio.png" alt="Broken x axis with a ratio panel" width="48%"></a>
+</p>
+<p align="center">
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/object_vs_event.png" alt="Per-object versus per-event selections" width="48%"></a>
+  <a href="https://jbeirer.github.io/rootfig/gallery/"><img src="docs/images/gallery/hist2d.png" alt="Two-dimensional histogram" width="48%"></a>
+</p>
+
+**[Explore the gallery →](https://jbeirer.github.io/rootfig/gallery/)**
+See each figure alongside the code that makes it, from simple overlays to
+stacked data/MC comparisons, broken axes and 2D histograms.
+
+## Installation
+
+```bash
+pip install rootfig
+# or
+uv add rootfig
+```
+
+Python 3.12 or newer. No ROOT installation is needed; `TTree` and `RNTuple`
+files are both supported.
+
+## Compare samples in one call
+
+```python
+import rootfig as rf
+
+# Overlay two samples, normalised to unity, with a ratio panel.
+rf.plot(
+    ["signal.root", "background.root"],
+    "Muon_pt",
+    tree="events",
+    selection="abs(Muon_eta) < 2.5",
+    weight="event_weight",
+    bins=(50, 0, 200),
+    normalize=True,
+    ratio=True,
+)
+```
+
+## Build up to a full analysis
+
+Define samples, variables, cuts and styles once, then reuse them across plots:
+
+```python
+import rootfig as rf
+
+signal = rf.Sample("sig_*.root", tree="events", label="Signal", weight="mc_weight")
+background = rf.Sample("bkg.root", tree="events", label="Background", weight="mc_weight")
+data = rf.Sample("data.root", tree="events", label="Data", is_data=True)
+
+pt = rf.Variable("Muon_pt", bins=(50, 0, 200), label=r"$p_T^{\mu}$", unit="GeV")
+baseline = rf.Cut("nMuon >= 1") & "abs(Muon_eta) < 2.5"
+style = rf.Style(experiment="ATLAS", status="Internal", lumi=140, com=13.6)
+
+p = rf.plot(
+    [background, signal],
+    pt,
+    observed=data,
+    selection=baseline,
+    stack=True,
+    ratio=True,
+    logy=True,
+    style=style,
+)
+p.ax.set_ylim(top=1e5)  # it is a normal matplotlib Axes
+p.save("muon_pt.pdf")
+```
+
+Everything you get back is a standard object: `p.fig` and `p.ax` are
+matplotlib `Figure`/`Axes`, `p.hists` are `hist.Hist` objects, and
+`rf.load(...)` returns Awkward arrays.
+
+## What you can do
+
+- **Select events and objects with readable expressions.** Write cuts such as
+  `count(Jet_pt) >= 2` or `Muon_pt > 20`; event and object selections have
+  explicit rules, and event weights carry through to each selected object.
+- **Compare samples with a few keywords.** Overlays, stacks, data points and
+  ratio panels share binning and propagate histogram uncertainties.
+  Normalise to unity, density, bin width or luminosity.
+- **Style figures for your analysis.** Add experiment labels, units, log axes
+  and broken axes, then refine the result with matplotlib.
+- **Go beyond 1D plots.** Draw 2D histograms, correlations, efficiencies,
+  profiles, resolutions and significance panels; produce cut flows and
+  summary statistics from the same inputs.
+- **Work directly with your files.** Read `TTree` and `RNTuple` data, combine
+  files with globs, limit entry ranges for quick checks, and use EDM4hep
+  split collections. Only the branches your expressions need are read.
+
+## Documentation
+
+**[Read the docs](https://jbeirer.github.io/rootfig/)** or
+**[browse the gallery](https://jbeirer.github.io/rootfig/gallery/)** for examples
+with figures and code.
+
+- [Quick start](https://jbeirer.github.io/rootfig/quickstart/): your first plot, selections and weights.
+- [Expressions and selections](https://jbeirer.github.io/rootfig/expressions/): syntax and event/object rules.
+- [Samples, variables, cuts and styles](https://jbeirer.github.io/rootfig/composable/): reusable analysis definitions.
+- [Plotting options](https://jbeirer.github.io/rootfig/plotting/): binning, normalisation, panels and styling.
+- [API reference](https://jbeirer.github.io/rootfig/api/): full signatures and options.
+
+## Relation to the ecosystem
+
+`rootfig` brings a `TTree::Draw`-like workflow to the Scientific Python HEP
+stack, building on familiar libraries:
+
+| Task | Library | What rootfig adds |
+| --- | --- | --- |
+| Reading ROOT files | [uproot](https://github.com/scikit-hep/uproot5) | file globs, tree auto-detection, reading only the required branches |
+| Jagged arrays | [Awkward Array](https://github.com/scikit-hep/awkward) | the per-event/per-object rules for cuts and weights |
+| Histograms | [hist](https://github.com/scikit-hep/hist) / boost-histogram | shared binning, automatic ranges, normalisation, ratios |
+| Drawing | [mplhep](https://github.com/scikit-hep/mplhep) + matplotlib | overlays, stacks, ratio panels, labels and legends with good defaults |
+
+If you already have `hist.Hist` objects, `rf.plot_histograms` draws them with
+the same options. If you want the arrays, `rf.load` returns them. See
+[the ecosystem guide](https://jbeirer.github.io/rootfig/ecosystem/) for details.
+
+## Development
+
+```bash
+git clone https://github.com/jbeirer/rootfig
+cd rootfig
+uv sync --all-groups
+uv run pytest
+uv run ruff check . && uv run ruff format --check .
+uv run mypy
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

{rootfig-0.2.1 → rootfig-0.2.2}/pyproject.toml

@@ -40,7 +40,7 @@ dependencies = [
 
 [project.urls]
 Homepage = "https://github.com/jbeirer/rootfig"
-Documentation = "https://github.com/jbeirer/rootfig#readme"
+Documentation = "https://jbeirer.github.io/rootfig/"
 Repository = "https://github.com/jbeirer/rootfig"
 Issues = "https://github.com/jbeirer/rootfig/issues"
 

{rootfig-0.2.1 → rootfig-0.2.2}/src/rootfig/__init__.py

@@ -52,7 +52,7 @@ from rootfig.histograms import (
 from rootfig.model import Cut, Sample, Style, Variable, log_bins
 from rootfig.plotting import Plot, use_style
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 
 __all__ = [
     "BinningError",

rootfig-0.2.1/README.md

@@ -1,168 +0,0 @@
-# rootfig
-
-**Publication-quality figures straight from ROOT trees, without ROOT.**
-
-`rootfig` is the `TTree::Draw` workflow for the Scientific Python HEP stack:
-give it ROOT files, a tree, an expression, a selection and a weight, and get a
-styled matplotlib figure back in one call. It reads with
-[uproot](https://github.com/scikit-hep/uproot5), computes with
-[Awkward Array](https://github.com/scikit-hep/awkward), fills
-[hist](https://github.com/scikit-hep/hist) histograms and draws with
-[mplhep](https://github.com/scikit-hep/mplhep). It adds the missing glue:
-predictable per-event/per-object selection semantics, weights, shared
-binning across samples, normalisation, ratio panels and good defaults.
-
-[![CI](https://github.com/jbeirer/rootfig/actions/workflows/ci.yml/badge.svg)](https://github.com/jbeirer/rootfig/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/jbeirer/rootfig/branch/main/graph/badge.svg)](https://codecov.io/gh/jbeirer/rootfig)
-[![PyPI](https://img.shields.io/pypi/v/rootfig.svg)](https://pypi.org/project/rootfig/)
-[![Python](https://img.shields.io/pypi/pyversions/rootfig.svg)](https://pypi.org/project/rootfig/)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-
-```python
-import rootfig as rf
-
-rf.plot("events.root", "Muon_pt", tree="events", selection="Muon_pt > 20", bins=50)
-```
-
-<p align="center">
-  <img src="docs/images/gallery/stack_data.png" alt="Stacked simulation with data and a ratio panel" width="48%">
-  <img src="docs/images/gallery/xbreak_ratio.png" alt="Broken x axis with a ratio panel" width="48%">
-</p>
-<p align="center">
-  <img src="docs/images/gallery/object_vs_event.png" alt="Per-object versus per-event selections" width="48%">
-  <img src="docs/images/gallery/hist2d.png" alt="Two-dimensional histogram" width="48%">
-</p>
-
-These and a dozen more figures, each next to the code that made it, are in the
-[gallery](https://jbeirer.github.io/rootfig/gallery/). All of them come from
-[`examples/gallery`](examples/gallery/__init__.py), which writes toy ROOT files and
-draws every example in a few seconds; the same figures are pixel-compared in CI.
-
-## Installation
-
-```bash
-pip install rootfig
-# or
-uv add rootfig
-```
-
-Python 3.12 or newer. No ROOT installation is needed; `TTree` and `RNTuple`
-files are both supported.
-
-## Quick start
-
-```python
-import rootfig as rf
-
-# Overlay two samples, normalised to unity, with a ratio panel.
-rf.plot(
-    ["signal.root", "background.root"],
-    "Muon_pt",
-    tree="events",
-    selection="abs(Muon_eta) < 2.5",
-    weight="event_weight",
-    bins=(50, 0, 200),
-    normalize=True,
-    ratio=True,
-)
-```
-
-For analysis scripts with many samples, variables and plots, describe things
-once and reuse them:
-
-```python
-import rootfig as rf
-
-signal = rf.Sample("sig_*.root", tree="events", label="Signal", weight="mc_weight")
-background = rf.Sample("bkg.root", tree="events", label="Background", weight="mc_weight")
-data = rf.Sample("data.root", tree="events", label="Data", is_data=True)
-
-pt = rf.Variable("Muon_pt", bins=(50, 0, 200), label=r"$p_T^{\mu}$", unit="GeV")
-baseline = rf.Cut("nMuon >= 1") & "abs(Muon_eta) < 2.5"
-style = rf.Style(experiment="ATLAS", status="Internal", lumi=140, com=13.6)
-
-p = rf.plot(
-    [background, signal],
-    pt,
-    observed=data,
-    selection=baseline,
-    stack=True,
-    ratio=True,
-    logy=True,
-    style=style,
-)
-p.ax.set_ylim(top=1e5)  # it is a normal matplotlib Axes
-p.save("muon_pt.pdf")
-```
-
-Everything you get back is a standard object: `p.fig` and `p.ax` are
-matplotlib `Figure`/`Axes`, `p.hists` are `hist.Hist` objects, and
-`rf.load(...)` returns Awkward arrays.
-
-## Features
-
-- **One call from files to figure**, reading only the branches the expressions need.
-- **Expressions in Python syntax**: `sqrt(px**2 + py**2)`, `count(Jet_pt) >= 2`,
-  `` `jet1_b-tag` > 0.5 ``, `and`/`or`/`not`, chained comparisons.
-- **Jagged branches done right**: per-object cuts mask objects, per-event
-  cuts drop events, ambiguous combinations raise a clear error instead of
-  silently broadcasting.
-- **Weights**: per-event weights broadcast onto objects, per-object weights,
-  constant scale factors, multiplicative combination of sample and plot weights.
-- **Histograms with uncertainties** (`hist` with `Weight` storage), shared
-  binning across samples, automatic or robust ranges, log bins, flow bins.
-- **Overlays, stacks, data points, ratio panels** with correct error
-  propagation for weighted histograms and a reference-uncertainty band.
-- **Normalisation**: to unity, density, per bin width, or to a number; or to
-  a **luminosity** from cross sections and generated-event counts
-  (`Sample(xsec="0.2 pb", ngen="eventsProcessed")`, `lumi="10.8 ab^-1"`).
-- **Analysis tables and panels**: cut flows with yields and efficiencies,
-  significance panels (S/√B), efficiency-versus-variable plots with binomial
-  intervals, profiles and resolutions.
-- **Experiment-neutral defaults**, with mplhep styles and labels for ATLAS,
-  CMS, LHCb, ALICE and DUNE one keyword away; any other experiment name, GeV
-  and ab⁻¹ work too.
-- **EDM4hep-friendly**: sub-branches of split collections are addressed as
-  `ReconstructedParticles.momentum.x`, with `pt`, `p`, `theta`, `costheta`,
-  `eta`, `phi` and `mass` helpers.
-- **Also**: 2D histograms, summary statistics tables, statistics boxes,
-  correlation matrices, multi-file globs, entry ranges for quick looks.
-
-## Documentation
-
-- [Quick start](docs/quickstart.md)
-- [Expressions and selections](docs/expressions.md)
-- [Samples, variables, cuts and styles](docs/composable.md)
-- [Plotting options](docs/plotting.md)
-- [Relation to uproot, Awkward, hist, mplhep and matplotlib](docs/ecosystem.md)
-
-## Relation to the ecosystem
-
-`rootfig` does not replace any of the libraries it builds on:
-
-| Task | Library | What rootfig adds |
-| --- | --- | --- |
-| Reading ROOT files | uproot | file globs, tree auto-detection, reading only the required branches |
-| Jagged arrays | Awkward Array | the per-event/per-object rules for cuts and weights |
-| Histograms | hist / boost-histogram | shared binning, automatic ranges, normalisation, ratios |
-| Drawing | mplhep + matplotlib | overlays, stacks, ratio panels, labels and legends with good defaults |
-
-If you already have `hist.Hist` objects, `rf.plot_histograms` draws them with
-the same options. If you want the arrays, `rf.load` returns them.
-
-## Development
-
-```bash
-git clone https://github.com/jbeirer/rootfig
-cd rootfig
-uv sync --all-groups
-uv run pytest
-uv run ruff check . && uv run ruff format --check .
-uv run mypy
-```
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
-
-## License
-
-MIT. See [LICENSE](LICENSE).