Challenges
Datasets
Workspaces
Papers
Discussions
Leaderboard
Log inSign up
Challenges
Datasets
Workspaces
Papers
Discussions
Leaderboard
Blog
Job Board
Q3AS

© 2026 Aqora Quantum S.A.S.

TermsPrivacyLegal Notice

arXiv:2610.32605

QuantumBilliards.jl: An extensible, user friendly, high-performance Julia library for the large scale computation of spectra and eigenstates of quantum billiards and related problems

Matic Orel, Črt Lozej

quant-phphysics.comp-phSubmitted Oct 23, 2026• Announced Oct 26, 2026
arXivHTMLPDF

Abstract

We present QuantumBilliards.jl, an open-source Julia library providing a suite of numerical solvers for the two-dimensional interior Helmholtz eigenproblem with Dirichlet boundary conditions, a paradigmatic model in quantum chaos. The library implements conventional wavenumber-sweep techniques together with several accelerated eigensolvers: the Vergini--Saraceno scaling method, the expanded boundary integral method (EBIM), Beyn's contour-integral method, and the Compact Rational Krylov (CORK) method. It provides a common framework for constructing billiard geometries, exploiting discrete symmetries, computing eigenvalues and eigenstates, and treating smooth, cornered, and multiply connected domains. The library further includes reconstruction of eigenfunctions from boundary normal derivatives and the computation of Poincaré--Husimi (PH) phase-space representations. Available at: https://github.com/Quantum-Chaos-Julia/QuantumBilliards.jl.

AI Summary

The paper presents QuantumBilliards.jl, an open-source Julia framework for computing spectra and eigenstates of the two-dimensional interior Helmholtz problem with Dirichlet boundary conditions. It addresses the numerical workflow needed for high-energy quantum-chaos studies: geometry construction, symmetry reduction, spectral computation, and reconstruction of boundary functions, interior wavefunctions, and Poincaré–Husimi representations. The library combines basis-expansion and boundary-integral sweep solvers with four accelerated methods: Vergini–Saraceno scaling, expanded boundary integrals, Beyn contour integration, and compact rational Krylov (CORK). A common interface supports smooth, cornered, and multiply connected domains. Implementation details include Kress quadrature with corner grading, numerical-nullspace removal for overcomplete bases, and analytic Taylor recurrences that reduce repeated special-function evaluations. Benchmarks over $500\leq k\leq1400$ compute approximately 107,000–109,000 eigenvalues in 2,875–4,125 seconds on a 64-core Threadripper workstation. The scaling solver uses a weaker billiard deformation than Beyn and CORK because of basis-convergence restrictions. Accuracy is examined against exact rectangular spectra, residuals, resolution changes, and cross-method agreement; spectral completeness is assessed through the absence of accumulating drift relative to Weyl’s law. Some CORK rectangle tests reach the double-precision scale $k\epsilon_{\rm mach}$ away from window edges. Stated limitations include dense boundary factorizations costing $O(k^3)$ at fixed points per wavelength, geometry-dependent basis convergence, coupled corner-grading and resolution choices, and window-dependent approximation errors. Vergini–Saraceno has no proven strict eigenvalue-error bounds here. Magnetic and hyperbolic extensions are demonstrated but remain under testing for a subsequent release.

Little sign of AI-generated textIncrementalMissing comparison

Error found: The basis-method section incorrectly equates a generalized Rayleigh-quotient minimization with minimizing ||Fc||₂/||Nc||₂, which generally gives a different minimum. The analytic-Taylor appendix appears to use doubled layer operators without explicitly distinguishing them from the operators defined in the main text. The benchmark section treats absence of drift relative to Weyl's law as establishing spectral completeness, although this test cannot exclude isolated omissions or compensating missing and spurious levels.

Written by gpt-6.1-sol from the paper's full text. Automated: it can be wrong.

Comments
53 pages, 19 figures

Related papers

QuantumToolbox.jl: An efficient Julia framework for simulating open quantum systems

Alberto Mercurio, Yi-Te Huang, Li-Xun Cai +3 more

We present Q u a n t u m T o o l b o x . j l , an open-source Julia package for simulating open quantum systems. Designed with a syntax familiar to users of Q u T i P (Quantum Toolbox in Python), it harnesses Julia's high-performance ecosystem to deliver fast and scalable simulations. The package includes a suite of time-evolution solvers supporting distributed computing and GPU acceleration, enabling efficient simulation of large-scale quantum systems. We also show how Q u a n t u m T o o l b o x . j l can integrate with automatic differentiation tools, making it well-suited for gradient-based optimization tasks such as quantum optimal control. Benchmark comparisons demonstrate substantial performance gains over existing frameworks. With its flexible design and computational efficiency, Q u a n t u m T o o l b o x . j l serves as a powerful tool for both theoretical studies and practical applications in quantum science.

arXiv:2504.21440•Quantum•Sep 29, 2025•29 citations

SmoQyElPhQMC.jl: An open-source Julia package for efficient and scalable quantum Monte Carlo simulations of electron-phonon coupled models

Benjamin Cohen-Stead, James Neuhaus, Kipton M. Barros +2 more

We introduce version 1.0 of the SmoQyElPhQMC.jl package, an open-source Julia code for performing scalable quantum Monte Carlo simulations of electron-phonon coupled model Hamiltonians. SmoQyElPhQMC.jl is built upon the SmoQyDQMC.jl codebase and implements improved versions of the algorithms presented in [B. Cohen-Stead \textit{et al}., Phys. Rev. E 105, 065302 (2022)] to enable (near-linear) scalable simulations of a broad class of uncorrelated $e$-ph models both in system size and inverse temperature. By extending the functionality of the flexible scripting interface introduced in SmoQyDQMC.jl, the SmoQyElPhQMC.jl package continues to allow users to adapt it to different workflows and interface with other software packages in the Julia ecosystem. The code for this package can be downloaded from our GitHub repository at https://github.com/SmoQySuite/SmoQyElPhQMC.jl or installed using the Julia package manager. The online documentation, including examples, can be obtained from our documentation page at https://smoqysuite.github.io/SmoQyElPhQMC.jl/stable/.

arXiv:2606.14425•Jun 12, 2026•1 citation

Rimu.jl: Random integrators for many-body quantum systems

Matija Čufar, C. J. Bradly, Ray Yang +2 more

Rimu$.$jl is a Julia package for solving many-body quantum problems. The core of the package is a matrix-free implementation of Hamiltonians and other operators and compact representation of Fock states, which together allow for efficient methods suitable for high-performance computing. Rimu$.$jl includes a Julia implementation of the full configuration interaction quantum Monte Carlo (FCIQMC) algorithm which is a type of projector QMC algorithm for stochastically solving the time-independent Schrödinger equation. It also includes many well-known model Hamiltonians, and an interface for exact diagonalisation based on external eigenvalue solvers. Both the stochastic and exact diagonalisation methods are accessed with a CommonSolve$.$jl interface. We describe the FCIQMC algorithm and how to obtain estimators of observables as well as the key features of the implementation.

arXiv:2601.19505•Jan 27, 2026•4 citations

Behaviour of boundary functions for quantum billiards

A B cker, S F rstberger, R Schubert +1 more

We study the behaviour of the normal derivative of eigenfunctions of the Helmholtz equation inside billiards with Dirichlet boundary condition. These boundary functions are of particular importance because they uniquely determine the eigenfunctions inside the billiard and also other physical quantities of interest. Therefore, they form a reduced representation of the quantum system, analogous to the Poincaré section of the classical system. For the normal derivatives we introduce an equivalent to the standard Green function and derive an integral equation on the boundary. Based on this integral equation we compute the first two terms of the mean asymptotic behaviour of the boundary functions for large energies. The first term is universal and independent of the shape of the billiard. The second one is proportional to the curvature of the boundary. The asymptotic behaviour is compared with numerical results for the stadium billiard, different limaçon billiards and the circle billiard, and good agreement is found. Furthermore, we derive an asymptotic completeness relation for the boundary functions.

arXiv:nlin/0207034•Journal of Physics A Mathematical and General•Nov 19, 2002•20 citations

Constraint operator solution to quantum billiard problems

David A. McGrew, W. Bauer

We introduce an additional method to solve Schr\"odinger's equation for a free particle in an infinite well of arbitrary shape (the Helmholtz equation with Dirichlet boundary conditions), a problem of interest in the area of quantum chaos. We expand the wave function in a basis of products of sine functions, then use the constraint operator to contain the wave function to a region within the domain of the basis functions. In this manner, a quantum billiard problem of arbitrary shape can be solved. Several methods exist to solve problems of this sort, but as recent work reviewing these methods has shown, all have shortcomings. Our work represents a different direction in the solution of these problems. Our method is different in that it provides a means of computing an eigenbasis. It is also interesting from a physical standpoint in that it can represent the Hamiltonian of a classically chaotic system in the basis of a classically regular system. \textcopyright{} 1996 The American Physical Society.

Physical review. E, Statistical physics, plasmas, fluids, and related interdisciplinary topics•Nov 1, 1996•4 citations

Codebase release r2.0 for SmoQyDQMC.jl

Benjamin Cohen-Stead, Shruti Agarwal, Sohan Malkaruge Costa +6 more

We introduce version 2.0 of the SmoQyDQMC.jl package, a Julia implementation of the determinant quantum Monte Carlo algorithm. SmoQyDQMC.jl supports generalized tight-binding Hamiltonians with local and extended Hubbard and generalized electron-phonon (e-ph) interactions, including non-linear e-ph coupling and anharmonic lattice potentials. Our implementation uses an optimized hybrid Monte Carlo method with exact forces to efficiently sample the phonon fields, enabling the simulation of low-energy phonon branches, including acoustic phonons. The SmoQyDQMC.jl package also uses a flexible scripting interface, allowing users to adapt it to different workflows and interface with other software packages in the Julia ecosystem. The code for this package can be downloaded from our GitHub repository at https://github.com/SmoQySuite/ SmoQyDQMC.jl or installed using the Julia package manager. The online documentation, including examples, is found at https://smoqysuite.github.io/SmoQyDQMC.jl/stable/.

SciPost Physics Codebases•Jun 9, 2026•0 citations
We present QuantumBilliards.jl, an open-source Julia library providing a suite of numerical solvers for the two-dimensional interior Helmholtz eigenproblem with Dirichlet boundary conditions, a paradigmatic model in quantum chaos. The library implements conventional wavenumber-sweep techniques together with several accelerated eigensolvers: the Vergini--Saraceno scaling method, the expanded boundary integral method (EBIM), Beyn's contour-integral method, and the Compact Rational Krylov (CORK) method. It provides a common framework for constructing billiard geometries, exploiting discrete symmetries, computing eigenvalues and eigenstates, and treating smooth, cornered, and multiply connected domains. The library further includes reconstruction of eigenfunctions from boundary normal derivatives and the computation of Poincaré--Husimi (PH) phase-space representations.
Available at: https://github.com/Quantum-Chaos-Julia/QuantumBilliards.jl.
The paper presents QuantumBilliards.jl, an open-source Julia framework for computing spectra and eigenstates of the two-dimensional interior Helmholtz problem with Dirichlet boundary conditions. It addresses the numerical workflow needed for high-energy quantum-chaos studies: geometry construction, symmetry reduction, spectral computation, and reconstruction of boundary functions, interior wavefunctions, and Poincaré–Husimi representations.
The library combines basis-expansion and boundary-integral sweep solvers with four accelerated methods: Vergini–Saraceno scaling, expanded boundary integrals, Beyn contour integration, and compact rational Krylov (CORK). A common interface supports smooth, cornered, and multiply connected domains. Implementation details include Kress quadrature with corner grading, numerical-nullspace removal for overcomplete bases, and analytic Taylor recurrences that reduce repeated special-function evaluations.
Benchmarks over 500≤k≤1400500\leq k\leq1400500≤k≤1400 compute approximately 107,000–109,000 eigenvalues in 2,875–4,125 seconds on a 64-core Threadripper workstation. The scaling solver uses a weaker billiard deformation than Beyn and CORK because of basis-convergence restrictions. Accuracy is examined against exact rectangular spectra, residuals, resolution changes, and cross-method agreement; spectral completeness is assessed through the absence of accumulating drift relative to Weyl’s law. Some CORK rectangle tests reach the double-precision scale kϵmachk\epsilon_{\rm mach}kϵmach​ away from window edges.
Stated limitations include dense boundary factorizations costing O(k3)O(k^3)O(k3) at fixed points per wavelength, geometry-dependent basis convergence, coupled corner-grading and resolution choices, and window-dependent approximation errors. Vergini–Saraceno has no proven strict eigenvalue-error bounds here. Magnetic and hyperbolic extensions are demonstrated but remain under testing for a subsequent release.
We present Q u a n t u m T o o l b o x . j l , an open-source Julia package for simulating open quantum systems. Designed with a syntax familiar to users of Q u T i P (Quantum Toolbox in Python), it harnesses Julia's high-performance ecosystem to deliver fast and scalable simulations. The package includes a suite of time-evolution solvers supporting distributed computing and GPU acceleration, enabling efficient simulation of large-scale quantum systems. We also show how Q u a n t u m T o o l b o x . j l can integrate with automatic differentiation tools, making it well-suited for gradient-based optimization tasks such as quantum optimal control. Benchmark comparisons demonstrate substantial performance gains over existing frameworks. With its flexible design and computational efficiency, Q u a n t u m T o o l b o x . j l serves as a powerful tool for both theoretical studies and practical applications in quantum science.
We introduce version 1.0 of the SmoQyElPhQMC.jl package, an open-source Julia code for performing scalable quantum Monte Carlo simulations of electron-phonon coupled model Hamiltonians. SmoQyElPhQMC.jl is built upon the SmoQyDQMC.jl codebase and implements improved versions of the algorithms presented in [B. Cohen-Stead \textit{et al}., Phys. Rev. E 105, 065302 (2022)] to enable (near-linear) scalable simulations of a broad class of uncorrelated eee-ph models both in system size and inverse temperature. By extending the functionality of the flexible scripting interface introduced in SmoQyDQMC.jl, the SmoQyElPhQMC.jl package continues to allow users to adapt it to different workflows and interface with other software packages in the Julia ecosystem. The code for this package can be downloaded from our GitHub repository at https://github.com/SmoQySuite/SmoQyElPhQMC.jl or installed using the Julia package manager. The online documentation, including examples, can be obtained from our documentation page at https://smoqysuite.github.io/SmoQyElPhQMC.jl/stable/.
Rimu...jl is a Julia package for solving many-body quantum problems. The core of the package is a matrix-free implementation of Hamiltonians and other operators and compact representation of Fock states, which together allow for efficient methods suitable for high-performance computing. Rimu...jl includes a Julia implementation of the full configuration interaction quantum Monte Carlo (FCIQMC) algorithm which is a type of projector QMC algorithm for stochastically solving the time-independent Schrödinger equation. It also includes many well-known model Hamiltonians, and an interface for exact diagonalisation based on external eigenvalue solvers. Both the stochastic and exact diagonalisation methods are accessed with a CommonSolve...jl interface. We describe the FCIQMC algorithm and how to obtain estimators of observables as well as the key features of the implementation.
We study the behaviour of the normal derivative of eigenfunctions of the Helmholtz equation inside billiards with Dirichlet boundary condition. These boundary functions are of particular importance because they uniquely determine the eigenfunctions inside the billiard and also other physical quantities of interest. Therefore, they form a reduced representation of the quantum system, analogous to the Poincaré section of the classical system. For the normal derivatives we introduce an equivalent to the standard Green function and derive an integral equation on the boundary. Based on this integral equation we compute the first two terms of the mean asymptotic behaviour of the boundary functions for large energies. The first term is universal and independent of the shape of the billiard. The second one is proportional to the curvature of the boundary. The asymptotic behaviour is compared with numerical results for the stadium billiard, different limaçon billiards and the circle billiard, and good agreement is found. Furthermore, we derive an asymptotic completeness relation for the boundary functions.
We introduce an additional method to solve Schr\"odinger's equation for a free particle in an infinite well of arbitrary shape (the Helmholtz equation with Dirichlet boundary conditions), a problem of interest in the area of quantum chaos. We expand the wave function in a basis of products of sine functions, then use the constraint operator to contain the wave function to a region within the domain of the basis functions. In this manner, a quantum billiard problem of arbitrary shape can be solved. Several methods exist to solve problems of this sort, but as recent work reviewing these methods has shown, all have shortcomings. Our work represents a different direction in the solution of these problems. Our method is different in that it provides a means of computing an eigenbasis. It is also interesting from a physical standpoint in that it can represent the Hamiltonian of a classically chaotic system in the basis of a classically regular system. \textcopyright{} 1996 The American Physical Society.
We introduce version 2.0 of the SmoQyDQMC.jl package, a Julia implementation of the determinant quantum Monte Carlo algorithm. SmoQyDQMC.jl supports generalized tight-binding Hamiltonians with local and extended Hubbard and generalized electron-phonon (e-ph) interactions, including non-linear e-ph coupling and anharmonic lattice potentials. Our implementation uses an optimized hybrid Monte Carlo method with exact forces to efficiently sample the phonon fields, enabling the simulation of low-energy phonon branches, including acoustic phonons. The SmoQyDQMC.jl package also uses a flexible scripting interface, allowing users to adapt it to different workflows and interface with other software packages in the Julia ecosystem. The code for this package can be downloaded from our GitHub repository at https://github.com/SmoQySuite/ SmoQyDQMC.jl or installed using the Julia package manager. The online documentation, including examples, is found at https://smoqysuite.github.io/SmoQyDQMC.jl/stable/.