Skip to content

[RF] Move former RooChi2Var documentation to RooAbsReal::createChi2()#21700

Merged
guitargeek merged 3 commits intoroot-project:masterfrom
guitargeek:issue-21699
Mar 28, 2026
Merged

[RF] Move former RooChi2Var documentation to RooAbsReal::createChi2()#21700
guitargeek merged 3 commits intoroot-project:masterfrom
guitargeek:issue-21699

Conversation

@guitargeek
Copy link
Copy Markdown
Contributor

The class an implementation detail that is hidden from the user, and the entry point for chi-square test statistics is RooAbsReal::createChi2(). This is where the documentation belongs.

Tested locally that the rendered doxygen is correct.

Closes #21699.

@AlkaidCheng
Copy link
Copy Markdown
Contributor

Thanks @guitargeek , I think we should also show the list of supported arguments (and their defaults). The extended mode and data error defaults to AUTO but it is not immediately clear to users what AUTO will evaluate to without looking at the source codes. (i.e. data error will use SumW2 if it is not poisson weighted, otherwise it uses Expected)

@couet couet removed their request for review March 27, 2026 16:32
In some environments, like on NixOS, `bash` is not directly in
`/usr/bin/`. Use `env` to resolve the location of bash in the general
case.
The class an implementation detail that is hidden from the user, and the
entry point for chi-square test statistics is
`RooAbsReal::createChi2()`. This is where the documentation belongs.

Tested locally that the rendered doxygen is correct.

Closes root-project#21699.
@guitargeek guitargeek force-pushed the issue-21699 branch 2 times, most recently from 54efcfa to dc8310e Compare March 27, 2026 20:24
@guitargeek guitargeek requested a review from vepadulano as a code owner March 27, 2026 20:24
Before, the docs were scattered around different overloads, making it
easy to miss the documentation for the commands that were only included
in one of the docstring (like for `DataError`).
@github-actions
Copy link
Copy Markdown

Test Results

    20 files      20 suites   2d 20h 42m 4s ⏱️
 3 809 tests  3 808 ✅  1 💤 0 ❌
69 582 runs  69 564 ✅ 18 💤 0 ❌

Results for commit 102044e.

@guitargeek guitargeek merged commit dc4322b into root-project:master Mar 28, 2026
26 of 30 checks passed
@guitargeek guitargeek deleted the issue-21699 branch March 28, 2026 07:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing documentation for RooChi2Var since ROOT 6.36

3 participants