Johanna Langner , Anjan Sadhukhan , Jayanta K. Saha , Henryk A. Witek
{"title":"An algorithm for automated extraction of resonance parameters from the stabilization method","authors":"Johanna Langner , Anjan Sadhukhan , Jayanta K. Saha , Henryk A. Witek","doi":"10.1016/j.cpc.2025.109815","DOIUrl":null,"url":null,"abstract":"<div><div>The application of the stabilization method (Hazi and Taylor, 1970 [1]) to extract accurate energy and lifetimes of resonance states is challenging: The process requires labor-intensive numerical manipulation of a large number of eigenvalues of a parameter-dependent Hamiltonian matrix, followed by a fitting procedure. In this article, we present <span>ReSMax</span>, an efficient algorithm implemented as an open-access <span>Python</span> code, which offers full automation of the stabilization diagram analysis in a user-friendly environment while maintaining high numerical precision of the computed resonance characteristics. As a test case, we use <span>ReSMax</span> to analyze the natural parity doubly-excited resonance states (<span><math><mmultiscripts><mrow><mtext>S</mtext></mrow><none></none><mrow><mtext>e</mtext></mrow><mprescripts></mprescripts><none></none><mrow><mn>1</mn></mrow></mmultiscripts></math></span>, <span><math><mmultiscripts><mrow><mtext>S</mtext></mrow><none></none><mrow><mtext>e</mtext></mrow><mprescripts></mprescripts><none></none><mrow><mn>3</mn></mrow></mmultiscripts></math></span>, <span><math><mmultiscripts><mrow><mtext>P</mtext></mrow><none></none><mrow><mtext>o</mtext></mrow><mprescripts></mprescripts><none></none><mrow><mn>1</mn></mrow></mmultiscripts></math></span>, and <span><math><mmultiscripts><mrow><mtext>P</mtext></mrow><none></none><mrow><mtext>o</mtext></mrow><mprescripts></mprescripts><none></none><mrow><mn>3</mn></mrow></mmultiscripts></math></span>) of helium, demonstrating the accuracy and efficiency of the developed methodology. The presented algorithm is applicable to a wide range of resonances in atomic, molecular, and nuclear systems.</div></div><div><h3>Program summary</h3><div><em>Program Title:</em> <span>ReSMax</span></div><div><em>CPC Library link to program files:</em> <span><span>https://doi.org/10.17632/8yny7jycgz.1</span><svg><path></path></svg></span></div><div><em>Developer's repository link:</em> <span><span>https://github.com/giogina/ReSMax</span><svg><path></path></svg></span></div><div><em>Licensing provisions:</em> MIT</div><div><em>Programming language:</em> Python</div><div><em>Nature of problem:</em> The stabilization method is a widely used indirect approach for identifying resonance states (RSs) in atomic and molecular systems. It analyzes the behavior of energy eigenvalues of the system's Hamiltonian as a function of a basis set parameter, as visualized in stabilization diagrams (SDs) [1]. Resonance states manifest as plateaus in these SDs and are characterized by the position and width of the associated Lorentzian peaks in the density of states (DOS) [2]. However, applying this method in practice remains labor-intensive and error-prone: analyzing large eigenvalue datasets, identifying plateau regions, and fitting DOS peaks manually requires significant effort and expert judgment. These difficulties limit the method's scalability and reproducibility, especially for systems with many closely spaced resonances or high angular momentum states. There is currently no widely available open-source tool that automates the entire workflow in a robust, accurate, and user-friendly way.</div><div><em>Solution method:</em> <span>ReSMax</span> is an open-source Python program that automates the extraction of resonance parameters from stabilization diagrams. Given an input file containing the eigenvalue spectrum of a Hamiltonian across a range of basis set parameter values, it computes the density of states (DOS) for each root, identifies local maxima corresponding to potential resonances, and fits them to Lorentzian functions. Peaks are grouped into resonance candidates based on energy proximity and root uniqueness, and the best-fitting peak is selected for each resonance. A combination of numerical filtering, symmetry checks, and fit quality metrics ensures robust peak detection. Automatic resonance detection completes in a few seconds. An interactive interface allows optional refinement of resonance assignments before final export of the results.</div><div><em>Additional comments including restrictions and unusual features:</em> Resonances indicated by descending plateaus in the SD — which can appear due to insufficient basis set size for fluorescence-active resonances as well as directly below ionization thresholds — are assigned approximate energies and flagged for manual inspection. While <span>ReSMax</span> was developed for helium-like ions, the method is general and capable of detecting resonance states of a wide range of systems.</div></div><div><h3>References</h3><div><ul><li><span>[1]</span><span><div>A.U. Hazi, H.S. Taylor, Phys. Rev. A 1 (1970) 1109.</div></span></li><li><span>[2]</span><span><div>V.A. Mandelshtam, T.R. Ravuri, H.S. Taylor, Phys. Rev. Lett. 70 (1993) 1932.</div></span></li></ul></div></div>","PeriodicalId":285,"journal":{"name":"Computer Physics Communications","volume":"316 ","pages":"Article 109815"},"PeriodicalIF":3.4000,"publicationDate":"2025-08-13","publicationTypes":"Journal Article","fieldsOfStudy":null,"isOpenAccess":false,"openAccessPdf":"","citationCount":"0","resultStr":null,"platform":"Semanticscholar","paperid":null,"PeriodicalName":"Computer Physics Communications","FirstCategoryId":"101","ListUrlMain":"https://www.sciencedirect.com/science/article/pii/S0010465525003170","RegionNum":2,"RegionCategory":"物理与天体物理","ArticlePicture":[],"TitleCN":null,"AbstractTextCN":null,"PMCID":null,"EPubDate":"","PubModel":"","JCR":"Q1","JCRName":"COMPUTER SCIENCE, INTERDISCIPLINARY APPLICATIONS","Score":null,"Total":0}
引用次数: 0
Abstract
The application of the stabilization method (Hazi and Taylor, 1970 [1]) to extract accurate energy and lifetimes of resonance states is challenging: The process requires labor-intensive numerical manipulation of a large number of eigenvalues of a parameter-dependent Hamiltonian matrix, followed by a fitting procedure. In this article, we present ReSMax, an efficient algorithm implemented as an open-access Python code, which offers full automation of the stabilization diagram analysis in a user-friendly environment while maintaining high numerical precision of the computed resonance characteristics. As a test case, we use ReSMax to analyze the natural parity doubly-excited resonance states (, , , and ) of helium, demonstrating the accuracy and efficiency of the developed methodology. The presented algorithm is applicable to a wide range of resonances in atomic, molecular, and nuclear systems.
Program summary
Program Title:ReSMax
CPC Library link to program files:https://doi.org/10.17632/8yny7jycgz.1
Nature of problem: The stabilization method is a widely used indirect approach for identifying resonance states (RSs) in atomic and molecular systems. It analyzes the behavior of energy eigenvalues of the system's Hamiltonian as a function of a basis set parameter, as visualized in stabilization diagrams (SDs) [1]. Resonance states manifest as plateaus in these SDs and are characterized by the position and width of the associated Lorentzian peaks in the density of states (DOS) [2]. However, applying this method in practice remains labor-intensive and error-prone: analyzing large eigenvalue datasets, identifying plateau regions, and fitting DOS peaks manually requires significant effort and expert judgment. These difficulties limit the method's scalability and reproducibility, especially for systems with many closely spaced resonances or high angular momentum states. There is currently no widely available open-source tool that automates the entire workflow in a robust, accurate, and user-friendly way.
Solution method:ReSMax is an open-source Python program that automates the extraction of resonance parameters from stabilization diagrams. Given an input file containing the eigenvalue spectrum of a Hamiltonian across a range of basis set parameter values, it computes the density of states (DOS) for each root, identifies local maxima corresponding to potential resonances, and fits them to Lorentzian functions. Peaks are grouped into resonance candidates based on energy proximity and root uniqueness, and the best-fitting peak is selected for each resonance. A combination of numerical filtering, symmetry checks, and fit quality metrics ensures robust peak detection. Automatic resonance detection completes in a few seconds. An interactive interface allows optional refinement of resonance assignments before final export of the results.
Additional comments including restrictions and unusual features: Resonances indicated by descending plateaus in the SD — which can appear due to insufficient basis set size for fluorescence-active resonances as well as directly below ionization thresholds — are assigned approximate energies and flagged for manual inspection. While ReSMax was developed for helium-like ions, the method is general and capable of detecting resonance states of a wide range of systems.
References
[1]
A.U. Hazi, H.S. Taylor, Phys. Rev. A 1 (1970) 1109.
期刊介绍:
The focus of CPC is on contemporary computational methods and techniques and their implementation, the effectiveness of which will normally be evidenced by the author(s) within the context of a substantive problem in physics. Within this setting CPC publishes two types of paper.
Computer Programs in Physics (CPiP)
These papers describe significant computer programs to be archived in the CPC Program Library which is held in the Mendeley Data repository. The submitted software must be covered by an approved open source licence. Papers and associated computer programs that address a problem of contemporary interest in physics that cannot be solved by current software are particularly encouraged.
Computational Physics Papers (CP)
These are research papers in, but are not limited to, the following themes across computational physics and related disciplines.
mathematical and numerical methods and algorithms;
computational models including those associated with the design, control and analysis of experiments; and
algebraic computation.
Each will normally include software implementation and performance details. The software implementation should, ideally, be available via GitHub, Zenodo or an institutional repository.In addition, research papers on the impact of advanced computer architecture and special purpose computers on computing in the physical sciences and software topics related to, and of importance in, the physical sciences may be considered.