rootfig 0.1.0__tar.gz → 0.2.0__tar.gz

{rootfig-0.1.0 → rootfig-0.2.0}/.gitignore

@@ -9,6 +9,7 @@ build/
 .ruff_cache/
 .coverage
 coverage.xml
+junit.xml
 htmlcov/
 site/
 *.root

{rootfig-0.1.0 → rootfig-0.2.0}/CONTRIBUTING.md

@@ -26,8 +26,10 @@ uv build && uvx twine check dist/*     # packaging
 ```
 
 CI runs all of these on Python 3.12, 3.13 and 3.14 (Linux), plus macOS
-on 3.13. Tests that use ROOT's tutorial files run only when
-`root-config` is available locally and are skipped otherwise; do not add
+on 3.13, and once more with every direct dependency at the minimum version
+declared in `pyproject.toml` (`uv sync --resolution lowest-direct`). Tests
+that use ROOT's tutorial files run only when `root-config` is available
+locally and are skipped otherwise; do not add
 tests that require ROOT or network access.
 
 ## Layout
@@ -111,18 +113,17 @@ docstring; the test suite fails until its baseline image exists.
 
 - Add tests for behaviour changes; unit tests assert histogram contents and
   matplotlib structure. Rendered output is covered by the gallery (below).
-- Update `CHANGELOG.md` under "Unreleased".
 - Run the checks above before pushing; `pre-commit run --all-files` does most
   of it.
 
 ## Releasing
 
-1. Update the version in `src/rootfig/__init__.py` and move the changelog
-   entries under a new heading.
+1. Update the version in `src/rootfig/__init__.py`.
 2. Commit, tag `vX.Y.Z`, push the tag.
-3. The `release.yml` workflow builds the distribution and publishes it to
-   PyPI via Trusted Publishing (configure the publisher on PyPI first:
-   repository `jbeirer/rootfig`, workflow `release.yml`, environment `pypi`).
+3. The `release.yml` workflow builds the distribution, refuses a tag that does
+   not match `rootfig.__version__`, and publishes it to PyPI via Trusted
+   Publishing (configure the publisher on PyPI first: repository
+   `jbeirer/rootfig`, workflow `release.yml`, environment `pypi`).
 
 The documentation is published by the `docs` job of `ci.yml` on every push to
 `main` (`mkdocs gh-deploy` to the `gh-pages` branch). Once, in the repository

{rootfig-0.1.0 → rootfig-0.2.0}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.5
 Name: rootfig
-Version: 0.1.0
+Version: 0.2.0
 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: Repository, https://github.com/jbeirer/rootfig
 Project-URL: Issues, https://github.com/jbeirer/rootfig/issues
-Project-URL: Changelog, https://github.com/jbeirer/rootfig/blob/main/CHANGELOG.md
 Author-email: Joshua Falco Beirer <jbeirer@cern.ch>
 License-Expression: MIT
 License-File: LICENSE
@@ -24,12 +23,12 @@ Classifier: Topic :: Scientific/Engineering :: Physics
 Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
-Requires-Dist: awkward>=2.6
-Requires-Dist: hist>=2.7
-Requires-Dist: matplotlib>=3.10
-Requires-Dist: mplhep>=0.3.50
+Requires-Dist: awkward>=2.8
+Requires-Dist: hist>=2.7.2
+Requires-Dist: matplotlib>=3.11
+Requires-Dist: mplhep>=1.3
 Requires-Dist: numpy>=1.26
-Requires-Dist: uproot>=5.3
+Requires-Dist: uproot>=5.7.4
 Description-Content-Type: text/markdown
 
 # rootfig

{rootfig-0.1.0 → rootfig-0.2.0}/docs/composable.md

@@ -44,8 +44,12 @@ mem = rf.Sample({"x": awkward_array, "w": weights}, label="in memory")
   ```
 
   Without a luminosity such samples raise a [`LuminosityError`][rootfig.LuminosityError].
-- `entry_start`/`entry_stop` restrict reading for quick looks at large files.
-- `sample.with_(label="...")` returns a modified copy.
+- `entry_start`/`entry_stop` restrict reading for quick looks at large files
+  (a plot reads every needed branch of every file into memory at once). For a
+  ready-made `FileSource`, give the range to the source itself; passing it to
+  `Sample` afterwards raises a [`SourceError`][rootfig.SourceError].
+- `sample.with_(label="...")` returns a modified copy; replacement values are
+  validated like constructor arguments.
 
 Passing a list of files to `plot()` creates one sample per file. To merge
 several files into *one* sample, use a glob or a `Sample`.
@@ -67,7 +71,8 @@ met = rf.Variable(
   `"robust"` (ignores far outliers such as `-999` sentinels).
 - `label` and `unit` form the axis label `label [unit]`; the unit also appears
   in the automatic y label (`Events / 4 GeV`).
-- `name` is used for file names by `Plot.save(directory)`.
+- `name` is used for file names by `Plot.save(directory)`; it must be a plain
+  file stem (no path separators).
 
 `bins`, `range`, `xlabel` and `unit` given to `plot()` override the variable.
 

{rootfig-0.1.0 → rootfig-0.2.0}/docs/ecosystem.md

@@ -54,6 +54,9 @@ would do to a matplotlib figure, you can do to `Plot.fig` and `Plot.ax`.
 - You already have flat NumPy columns or `boost-histogram` objects and want
   rich comparison panels: [plothist](https://plothist.readthedocs.io).
 - You need a full columnar analysis framework with lazy, distributed
-  processing: [coffea](https://coffeateam.github.io/coffea/).
+  processing: [coffea](https://coffeateam.github.io/coffea/). rootfig reads
+  every branch a plot needs from every file into memory at once (only the
+  required branches, optionally an entry range), which suits quick looks and
+  moderate ntuples, not multi-terabyte datasets.
 - You want to build fit templates and workspaces: [cabinetry](https://cabinetry.readthedocs.io).
 - You want a quick terminal look at a branch: [histoprint](https://github.com/scikit-hep/histoprint).

{rootfig-0.1.0 → rootfig-0.2.0}/docs/expressions.md

@@ -16,9 +16,11 @@ syntax evaluated with NumPy/Awkward semantics over the branches of the tree.
 | Constants | `pi`, `e`, `inf`, `nan`, `True`, `False` |
 
 `and`, `or`, `not` and chained comparisons are rewritten to element-wise
-operations, so they work on arrays. Attribute access, lambdas,
-comprehensions, string literals and calls to anything but the functions
-below are rejected at parse time with an [`ExpressionError`][rootfig.ExpressionError].
+operations, so they work on arrays. Dotted names such as
+`ReconstructedParticles.momentum.x` are read as one branch name (see below);
+any other attribute access, lambdas, comprehensions, string literals and calls
+to anything but the functions below are rejected at parse time with an
+[`ExpressionError`][rootfig.ExpressionError].
 An unknown branch raises [`MissingBranchError`][rootfig.MissingBranchError]
 with close-match suggestions.
 

{rootfig-0.1.0 → rootfig-0.2.0}/docs/plotting.md

@@ -43,19 +43,32 @@ dataset scaled to the full one, for instance).
 Variances are scaled consistently. Flow bins scale with the same factor; for
 `"width"` and `"density"` they are divided by the width of the neighbouring
 visible bin. Plain `hist.Hist` objects with a count storage passed to
-`plot_histograms` are converted to `Weight` storage first.
+`plot_histograms` are converted to `Weight` storage first. If such a histogram
+was filled with weights (or rescaled) its sum of squared weights is lost, and
+rootfig refuses it with a `ValueError` rather than invent uncertainties; pass
+`assume_poisson=True` to use the absolute bin contents as variances (with a
+warning), or fill with `hist.storage.Weight()` in the first place.
+
+The rescaling modes divide by the signed sum of the visible bins: a histogram
+dominated by negative weights still sums to the target, its shape flips sign,
+and a warning says so. An empty histogram, or one whose positive and negative
+weights cancel exactly, is left unchanged with a warning and keeps the plain
+`Events` label (`Histogram.normalization` stays `None`).
 
 ## Ratio panel
 
 `ratio=True` adds a lower panel sharing the x axis:
 
 - with a stack: data / total MC, error bars from the data, grey band for the
-  MC statistical uncertainty (`ratio_uncertainty="numerator"`);
-- with data and overlaid samples: data / first sample;
-- otherwise: every sample / the first sample, uncertainties of both
+  MC statistical uncertainty (`ratio_uncertainty="numerator"`); a stacked
+  ratio needs an `observed=` sample;
+- with data and overlaid samples: data / the first non-data sample (only the
+  data appears in the panel);
+- otherwise: every further sample / the first sample, uncertainties of both
   propagated in quadrature (`ratio_uncertainty="propagate"`).
 
-`ratio="Background"` picks the reference by label.
+`ratio="Background"` picks the reference by label; all other histograms, data
+included, are divided by it.
 
 `ratio="significance"` (or `"s/sqrt(b)"`, `"s/sqrt(s+b)"`) draws a
 **significance panel** instead: per bin, the signal over the square root of
@@ -113,6 +126,12 @@ computed values are returned in `Plot.ratios` as
   `(main, ratio)` for ratio plots), so several rootfig plots can share a figure.
 - `save="file.pdf"` saves immediately; `Plot.save(path)` accepts a directory
   (file named after the variable) and `formats=["pdf", "png"]`.
+- Figures use matplotlib's constrained layout, so labels, legends and colour
+  bars fit inside the canvas and a saved file has exactly the `figsize`
+  dimensions: 1D, 2D and ratio plots of one size share one shape. Figures
+  drawn into your own `ax` are saved with a tight bounding box instead.
+- Fonts are fixed on the figure when it is made, so saving or displaying it
+  later renders exactly the layout that was computed, in the style's fonts.
 - `Plot.fig`, `Plot.ax`, `Plot.ratio_ax` are plain matplotlib objects;
   `Plot.histograms` wrap the `hist.Hist` objects with labels and statistics.
 
@@ -126,6 +145,8 @@ rf.correlation(sample, ["MET", "nJet", "HT"], selection="nJet >= 2", percent=Tru
 `rf.plot2d` options: `logz`, `logx`, `logy`, `cmap` (any matplotlib colour
 map, default `viridis`), `colorbar=False`, `zlabel` (default `Events` or the
 normalisation), `normalize`, `title`, `text`, `style`, `figsize`, `ax`, `save`.
+The figure has the same size as a 1D plot; the colour bar takes its space from
+the axes.
 
 `rf.correlation` options: `labels` (tick labels, default the variable labels),
 `percent=True` (integer percentages instead of two-decimal coefficients),
@@ -168,7 +189,9 @@ Negative weights (NLO samples) can make a weighted variance negative or an
 efficiency leave `[0, 1]`. rootfig then reports `nan` for the standard
 deviation, the profile error or the confidence interval (with a warning for
 efficiencies) rather than a made-up uncertainty; means, yields and histogram
-contents are unaffected.
+contents are unaffected. Bins whose total weight is negative keep their mean
+or efficiency (the plain ratio) but get no uncertainty; bins whose weights
+cancel to exactly zero count as empty (`nan`).
 
 ## Cut flows
 
@@ -183,6 +206,10 @@ table.get("ZH").efficiencies  # relative to the previous step
 table.get("ZH").absolute_efficiencies
 ```
 
+Step efficiencies are plain ratios of weighted yields (`nan` after a zero
+yield). With signed (NLO) weights a yield can be negative and a ratio can lie
+outside `[0, 1]`; it is reported as is.
+
 Cuts apply cumulatively; a sample's own selection is the first row. Per-object
 cuts pass an event when any object passes. `weight`, `lumi` and `nonfinite`
 work as in `plot()`: events with a missing or non-finite weight are excluded

{rootfig-0.1.0 → rootfig-0.2.0}/pyproject.toml

@@ -26,13 +26,16 @@ classifiers = [
   "Topic :: Scientific/Engineering :: Visualization",
   "Typing :: Typed",
 ]
+# Floors are the oldest versions the test suite passes with (CI job "minimum-versions"):
+# uproot 5.7.4 reads nested RNTuple fields and entry ranges across files and writes the
+# fixed-size test arrays; mplhep 1.3 has exp_label(text=) and hist2dplot(mask=).
 dependencies = [
-  "uproot>=5.3",
-  "awkward>=2.6",
+  "uproot>=5.7.4",
+  "awkward>=2.8",
   "numpy>=1.26",
-  "hist>=2.7",
-  "mplhep>=0.3.50",
-  "matplotlib>=3.10",
+  "hist>=2.7.2",
+  "mplhep>=1.3",
+  "matplotlib>=3.11",
 ]
 
 [project.urls]
@@ -40,7 +43,6 @@ Homepage = "https://github.com/jbeirer/rootfig"
 Documentation = "https://github.com/jbeirer/rootfig#readme"
 Repository = "https://github.com/jbeirer/rootfig"
 Issues = "https://github.com/jbeirer/rootfig/issues"
-Changelog = "https://github.com/jbeirer/rootfig/blob/main/CHANGELOG.md"
 
 [dependency-groups]
 dev = [
@@ -62,7 +64,7 @@ path = "src/rootfig/__init__.py"
 [tool.hatch.build.targets.sdist]
 include = [
   "src/rootfig", "tests", "docs", "examples", "mkdocs.yml",
-  "README.md", "CHANGELOG.md", "CONTRIBUTING.md", "LICENSE", "pyproject.toml",
+  "README.md", "CONTRIBUTING.md", "LICENSE", "pyproject.toml",
 ]
 
 [tool.hatch.build.targets.wheel]

{rootfig-0.1.0 → rootfig-0.2.0}/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.1.0"
+__version__ = "0.2.0"
 
 __all__ = [
     "BinningError",

{rootfig-0.1.0 → rootfig-0.2.0}/src/rootfig/api.py

@@ -14,11 +14,10 @@ from dataclasses import dataclass
 from typing import Any
 
 import awkward as ak
-import matplotlib.pyplot as plt
 import numpy as np
 
 from rootfig._typing import FloatArray, Hist
-from rootfig.errors import RootfigWarning, SelectionError, SourceError
+from rootfig.errors import BinningError, RootfigWarning, SelectionError, SourceError
 from rootfig.expressions import parse
 from rootfig.histograms import (
     SIGNIFICANCE_KINDS,
@@ -36,6 +35,7 @@ from rootfig.histograms import (
     correlation_matrix,
     describe_table,
     load_columns,
+    load_columns_each,
     read_arrays,
     significance,
 )
@@ -76,6 +76,7 @@ from rootfig.plotting import (
     draw_ratio_panel,
     draw_significance_panel,
     envelope,
+    finalize_figure,
     finish_axes,
     fold_flow_bins,
     label_flow_bins,
@@ -345,9 +346,11 @@ def plot(
     stack
         Stack the non-data samples.
     ratio
-        ``True`` for a ratio panel (data / total for stacks or data plots,
-        otherwise each sample over the first), a sample label to use as the
-        reference, or a significance panel: ``"significance"`` (``S/sqrt(B)``),
+        ``True`` for a ratio panel: data / total MC for a stack (needs
+        ``observed=``), data / the first non-data sample when data is overlaid,
+        otherwise every further sample over the first; a sample label to use
+        as the reference (all other histograms, data included, are divided by
+        it); or a significance panel: ``"significance"`` (``S/sqrt(B)``),
         ``"s/sqrt(b)"`` or ``"s/sqrt(s+b)"``, where the signal is the last
         non-data sample (the top of a stack) and the background the sum of the
         others; ``("s/sqrt(b)", "Signal")`` names the signal sample.
@@ -462,6 +465,7 @@ def plot_histograms(
     style: StyleLike = None,
     figsize: tuple[float, float] | None = None,
     ax: AxesLike = None,
+    assume_poisson: bool = False,
     save: str | None = None,
 ) -> Plot:
     """Draw already-filled histograms (``hist.Hist`` or :class:`~rootfig.histograms.Histogram`).
@@ -472,10 +476,16 @@ def plot_histograms(
     :class:`~rootfig.histograms.Histogram` objects with ``is_data=True``.
     Overlaid histograms may have different binnings; stacks, ratio panels and
     ``flow="show"`` need identical bin edges.
+
+    A count-storage histogram that was filled with weights (or rescaled) has
+    lost its sum of squared weights and is rejected with a ``ValueError``;
+    ``assume_poisson=True`` draws it anyway with the absolute bin contents as
+    variances (a warning is issued). Fill with ``hist.storage.Weight()`` to keep
+    the real uncertainties.
     """
     if logx is None:
         logx = variable.log if variable is not None else False
-    histograms_ = _wrap_hists(hists, labels)
+    histograms_ = _wrap_hists(hists, labels, assume_poisson=assume_poisson)
     if not histograms_:
         msg = "no histograms to draw"
         raise ValueError(msg)
@@ -644,6 +654,7 @@ def plot_histograms(
             if layout.ratio is not None and layout.ratio_right is not None:
                 apply_xbreak(layout.ratio, layout.ratio_right, *segments)
 
+        finalize_figure(layout.fig, layout.main)  # last: fonts and label anchoring
     result = Plot(
         fig=layout.fig,
         ax=layout.main,
@@ -693,10 +704,11 @@ def plot2d(
 
     ``x`` and ``y`` must have the same structure (both per-event, or both
     per-object from the same collection). ``bins`` applies to both axes unless
-    it is a pair of binning specifications, one per axis; per-axis ranges,
-    labels and logarithmic scales (``logx``/``logy`` default to the variables'
-    ``log`` flags) are best given through :class:`~rootfig.model.Variable`
-    objects.
+    it is a pair of binning specifications, one per axis (so ``(40, 20)`` is
+    two bin counts, never a range; a range needs ``(n, low, high)``); per-axis
+    ranges, labels and logarithmic scales (``logx``/``logy`` default to the
+    variables' ``log`` flags) are best given through
+    :class:`~rootfig.model.Variable` objects.
     """
     sample = _single_sample(data, tree=tree)
     x_bins, y_bins = _split_bins(bins)
@@ -711,11 +723,9 @@ def plot2d(
         histogram_ = _normalize_for_plot(histogram_, normalize)
     resolved_style = _style_for(style, text, lumi)
     with style_context(resolved_style) as st:
-        default_size = st.figsize or figsize
-        if default_size is None:
-            width, height = plt.rcParams["figure.figsize"]
-            default_size = (width * 1.15, height)
-        layout = make_figure(st, ratio=False, ax=ax, figsize=default_size)
+        # Same canvas as a 1D plot; the colour bar takes its space from the main axes
+        # (draw_hist2d stops mplhep from widening the figure).
+        layout = make_figure(st, ratio=False, ax=ax, figsize=figsize or st.figsize)
         fig, main_ax = layout.fig, layout.main
         draw_hist2d(
             histogram_,
@@ -732,6 +742,7 @@ def plot2d(
         if title:
             main_ax.set_title(title)
         add_experiment_label(main_ax, st, has_data=sample.is_data)
+        finalize_figure(fig, main_ax)  # last: fonts and label anchoring
     result = Plot(fig=fig, ax=main_ax, histograms=[histogram_], variable=var_x)
     if save:
         result.save(save)
@@ -812,10 +823,11 @@ def summarize(
     var_list = [variables] if isinstance(variables, str | Variable) else list(variables)
     rows: list[tuple[str, str, Summary]] = []
     for sample in samples:
-        for var in var_list:
-            columns = load_columns(
-                sample, [var], selection=selection, weight=weight, lumi=lumi, nonfinite=nonfinite
-            )
+        # One read per sample: the branches of all variables are fetched together.
+        per_variable = load_columns_each(
+            sample, var_list, selection=selection, weight=weight, lumi=lumi, nonfinite=nonfinite
+        )
+        for var, columns in zip(var_list, per_variable, strict=True):
             rows.append((sample.label, as_variable(var).expression, summarize_columns(columns)))
     return SummaryTable(tuple(rows))
 
@@ -868,6 +880,7 @@ def correlation(
             matrix, tick_labels, main_ax, cmap=cmap, annotate=annotate, percent=percent
         )
         main_ax.set_title(title if title is not None else f"{sample.label}: correlation")
+        finalize_figure(fig, main_ax)
     result = Plot(fig=fig, ax=main_ax, matrix=matrix)
     if save:
         result.save(save)
@@ -1013,6 +1026,7 @@ def efficiency(
                 logy=False,
                 floating=[legend_artist] if floating and legend_artist is not None else [],
             )
+        finalize_figure(layout.fig, layout.main)  # last: fonts and label anchoring
     result = Plot(
         fig=layout.fig,
         ax=layout.main,
@@ -1062,7 +1076,8 @@ def profile(
     e.g. ``"(reco_pt - true_pt) / true_pt"``). ``x`` and ``y`` must have the same
     structure (both per-event or both per-object of one collection). ``xlabel``
     and ``unit`` describe the x axis; ``logx``/``logy`` default to the
-    variables' ``log`` flags. With negative weights a bin whose weighted
+    variables' ``log`` flags. With negative weights a bin whose total weight
+    is negative keeps its mean but has no error, and a bin whose weighted
     variance is negative has no standard deviation (``nan``). The
     :class:`~rootfig.histograms.Profile` objects are returned in ``Plot.profiles``.
 
@@ -1142,6 +1157,7 @@ def profile(
                 logy=logy,
                 floating=[legend_artist] if floating and legend_artist is not None else [],
             )
+        finalize_figure(layout.fig, layout.main)  # last: fonts and label anchoring
     result = Plot(fig=layout.fig, ax=layout.main, variable=var_x, profiles=profiles)
     if save:
         result.save(save)
@@ -1221,7 +1237,12 @@ RatioSpec = bool | str | tuple[str, str]
 """What ``ratio=`` accepts: a flag, a reference label, a significance kind, or (kind, signal)."""
 
 
-def _wrap_hists(hists: Sequence[Histogram | Hist], labels: Sequence[str] | None) -> list[Histogram]:
+def _wrap_hists(
+    hists: Sequence[Histogram | Hist],
+    labels: Sequence[str] | None,
+    *,
+    assume_poisson: bool = False,
+) -> list[Histogram]:
     if labels is not None and len(labels) != len(hists):
         msg = f"got {len(labels)} labels for {len(hists)} histograms"
         raise ValueError(msg)
@@ -1235,7 +1256,8 @@ def _wrap_hists(hists: Sequence[Histogram | Hist], labels: Sequence[str] | None)
         else:
             axis_name = item.axes[0].name if item.ndim == 1 else ""
             label = axis_name or f"hist {index + 1}"
-        wrapped.append(Histogram(as_weight_storage(item), label=str(label)))
+        converted = as_weight_storage(item, assume_poisson=assume_poisson)
+        wrapped.append(Histogram(converted, label=str(label)))
     return wrapped
 
 
@@ -1289,9 +1311,27 @@ def _ratio_setup(
 
 
 def _split_bins(bins: Bins | tuple[Bins, Bins] | None) -> tuple[Any, Any]:
-    """Interpret ``bins`` for two axes: a pair of specifications, or one spec for both."""
+    """Interpret ``bins`` for two axes: a pair of specifications, or one spec for both.
+
+    Raises
+    ------
+    BinningError
+        If the pair consists of two numbers that are not both integers: that
+        reads like a ``(low, high)`` range, which a pair never is.
+    """
     if bins is None:
         return None, None
     if isinstance(bins, tuple) and len(bins) == 2:
+        numbers = all(
+            isinstance(b, int | float | np.number) and not isinstance(b, bool) for b in bins
+        )
+        if numbers and not all(isinstance(b, int | np.integer) for b in bins):
+            msg = (
+                f"bins={bins!r}: for plot2d a 2-tuple is (x_bins, y_bins), one specification "
+                "per axis, so two numbers are two bin counts, not a range. Give the range per "
+                f"axis, e.g. bins=((50, {bins[0]}, {bins[1]}), (50, {bins[0]}, {bins[1]})), or "
+                "use rf.Variable(x, bins=50, range=(low, high))"
+            )
+            raise BinningError(msg)
         return bins[0], bins[1]
     return bins, bins

{rootfig-0.1.0 → rootfig-0.2.0}/src/rootfig/expressions/parser.py

@@ -349,7 +349,10 @@ def parse(expression: ExpressionLike) -> Expression:
     ------
     ExpressionError
         If the text is not a single Python expression or uses a disallowed
-        construct (attribute access, unknown functions, string literals, ...).
+        construct (unknown functions, string literals, lambdas, comprehensions,
+        conditional expressions, ...). Dotted names such as
+        ``Collection.field.sub`` are read as one branch name (podio/EDM4hep
+        files), not as attribute access; attributes of anything else are rejected.
     """
     if isinstance(expression, Expression):
         return expression

{rootfig-0.1.0 → rootfig-0.2.0}/src/rootfig/histograms/__init__.py

@@ -15,6 +15,7 @@ from rootfig.histograms.pipeline import (
     combined_selection,
     combined_weight,
     load_columns,
+    load_columns_each,
     read_arrays,
     source_length,
 )
@@ -55,6 +56,7 @@ __all__ = [
     "efficiency",
     "fill",
     "load_columns",
+    "load_columns_each",
     "normalization_label",
     "normalize",
     "normalize_hist",