Skip to content

Nexus: line-crossing distribution method and implementation - #6224

Merged
prckent merged 11 commits into
QMCPACK:developfrom
jtkrogel:nx_stat_lcd
Sep 14, 2026
Merged

prckent merged 11 commits into
QMCPACK:developfrom
jtkrogel:nx_stat_lcd

Conversation

@jtkrogel

@jtkrogel jtkrogel commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

This PR adds line-crossing-distribution utilities for time series (i.e. Monte Carlo trace data). These are not user-facing.

The line-crossing distribution is intended to robustly identify an equilibrium value in a noisy trace that may contain wild outliers or later long-term departures from equilibrium behavior. It represents each adjacent pair of values in the trace as an interval, then counts how often those intervals cross each possible value. The distribution peak estimates the value most consistently crossed by the series, making it less sensitive than other methods, including median estimation. A near-term use case is to identify whether and how a QMC run (particularly DMC) fails.

These contributions comprise an intermediate step to replacing QmcpackAnalyzer.

I developed the LCD method/algorithm and wrote all the code. Documentation, tests, input hardening, and optimization were performed with GPT-5.6 Terra medium.

@github-actions github-actions Bot added nexus python Pull requests that update python code labels Sep 11, 2026

@prckent prckent left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM but conflicts need to be fixed

@ye-luo
ye-luo self-requested a review September 12, 2026 02:48
# Conflicts:
#	nexus/nexus/statistics.py
#	nexus/nexus/tests/test_statistics.py
@jtkrogel

jtkrogel commented Sep 14, 2026

Copy link
Copy Markdown
Contributor Author

@prckent should be ready now

@prckent

prckent commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

@ye-luo Any particular reason you requested to review?

@ye-luo

ye-luo commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

I put my review request on the wrong PR.

@ye-luo
ye-luo removed their request for review September 14, 2026 15:56
@prckent

prckent commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Test this please

@prckent
prckent merged commit 036f4b0 into QMCPACK:develop Sep 14, 2026
52 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

nexus python Pull requests that update python code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants