Search arXiv⌕ Search
Home/Archive/arXiv

arXiv · 2608.27177

ElemCo.jl: A Julia package for electron-correlation methods

Daniel Kats·Charlotte Rickert·Thomas Schraivogel·Kristoffer Simula·Denis Usvyat·Fangcheng Wu
View original source ↗Read source document ↗Export metadata ↓

Abstract

We present ElemCo.jl, an open-source Julia package for molecular electronic structure and properties calculations with a particular emphasis on Coupled Cluster and Distinguishable Cluster methods. The package provides a high-level, macro-based user interface which makes routine calculations accessible to users with no prior Julia experience. A newly developed visualizer, JLmol, assists in the graphical preparation of ElemCo.jl input files and displays results such as molecular orbitals. ElemCo.jl offers restricted closed-shell and unrestricted variants of state-of-the-art electron-correlation methods such as FCI, MP2, CCSD(T) as well as EOM-CCSD and the DC methods DCSD and DC-CCSDT. In addition to traditional approaches, ElemCo.jl provides recently developed methods that are currently unique to the package. These include tensor-decomposed implementations of DCSD and DC-CCSDT (SVD-DCSD and SVD-DC-CCSDT) as well as two-determinant and fixed-reference CC and DC methods. For excited-state calculations, ElemCo.jl also offers EOM-DCSD, which is benchmarked in this work against CC3 on the QUEST3 benchmark set, alongside EOM-CCSD. Furthermore, both ground and excited states, including those of multireference character, can be treated using CIPHI - an efficient selected Configuration Interaction (CI) approach employing a CIPSI/Heat-Bath-CI-based algorithm. Users can directly invoke internal functions from the input file, enabling them to test and compose new methods without the need to modify ElemCo.jl's source code. Also, ElemCo.jl can be readily interfaced with external quantum chemistry codes through the Fcidump format, for example as the high-level solver for transcorrelated Hamiltonians, periodic embedded fragments, etc. We provide a detailed overview of ElemCo.jl's methodological repertoire and discuss its technical details and implementation, performance, interfaces, and usage.

Explore related subjects

physics.chem-phcond-mat.mtrl-sci

Keep this discovery

Explore connections, maps & timelines

BibTeXRIS

Daniel Kats, Charlotte Rickert, Thomas Schraivogel, Kristoffer Simula, Denis Usvyat, Fangcheng Wu. 2026-08-27. ElemCo.jl: A Julia package for electron-correlation methods. https://arxiv.org/abs/2608.27177

Cite the original work for its findings. Save a collection to share your selection of sources.

KEEP EXPLORING

Related papers

arXiv2026

Charge Transfer with a Spin. I: A Variational Constrained-CASSCF Framework for Investigating Charge Transfer in the Presence of Spin-Orbit Coupling

Charge transfer in open-shell molecular systems can involve a delicate interplay between charge localization, orbital relaxation, and spin-orbit coupling (SOC), particularly near ground-excited state crossings. Here, we introduce a very inexpensive variational framework for treating these effects in odd-electron systems by extending the electron/hole-transfer Dynamically-weighted State-Averaged Constrained CASSCF (eDSC/hDSC) method to include SOC. Our method incorporates the SOC Hamiltonian directly into the variational orbital optimization through complex-valued spinor orbitals, allowing orbital and spin degrees of freedom to relax self-consistently while preserving the time-reversal symmetry of doublet states. The method achieves smooth potential energy surfaces and rapid self-consistent field (SCF) convergence; moreover, from physically small to artificially large SOC strengths, the calculation can be converged to very tight thresholds across the whole potential energy surface. While the results presented here are for systems with two charge centers, as shown in the appendix, the theory is quite general and can be adapted to either a system of $N$ charge centers or a metal-molecule surface with a continuum of states, so that charge transport (and not just charge transfer) can also be studied. The approach therefore provides a route towards ab initio studies of spin-dependent charge transfer and charge transport in molecular systems with nontrivial spin degrees of freedom.

physics.chem-ph↗
arXiv2026

Charge Transfer with a Spin. II: A Framework for Diabatization which Localizes Charge and Spin

We investigate a diabatization procedure that localizes charges (in real space) and localizes spins (in spin space) for open-shell systems that exhibit charge transfer in the presence of spin-orbit coupling. The procedure is applied to a two-state crossing between pairs of Kramers-restricted doublet states (which can also be considered effectively a four-state crossing). To generate the relevant diabatic states, we employ a two-step optimization over complex-unitary rotations that sequentially maximizes dipole and spin moments through iterative Jacobi sweeps; the resulting update rules are effectively equivalent to those of approximate joint diagonalization (AJD) applied to charge and spin. The method converges rapidly and yields smooth diabatic potential energy surfaces that preserve dipole and spin properties (e.g., a smoothly varying spin quantization axis) along the reaction coordinate while maintaining time-reversal symmetry.

physics.chem-ph↗
arXiv2026

Fixed-Dimensional Latent Flow for Generating Variable-Size 3D Molecules

Molecular size is coupled to composition, structure, and function, yet most 3D molecular generators require a predefined atom count. We introduce Equivariant-Free Transformer-Autoencoded Latent Flow Matching, a two-stage framework that samples a fixed-dimensional latent vector using flow matching and uses an autoregressive Transformer to determine molecular size, atom types, coordinates, and chemical attributes. Canonical atom ordering and rigid-pose alignment enable Transformers without equivariant layers, while decoded attributes guide bond reconstruction. On PCQM4Mv2, unconditional generation yields 87.9\% unique, novel molecules passing sanitization and PoseBusters checks, exceeding baselines with lower end-to-end training and sampling time and higher end-to-end throughput. Across ten target HOMO-LUMO gaps, internal ranking retains 30\% of screened candidates and increases the density functional theory-verified hit rate within 0.1 eV from 25.0\% to 52.4\%, while largely preserving novelty and diversity. These results demonstrate fixed-dimensional latent generation with autoregressive decoding as a practical approach to molecular design without prespecifying size.

physics.chem-ph↗