arrow
Return

DAISpY: A domain assignment and interface solution in pYthon for charge-transfer analysis

delete2026-08-01
delete0
PRE
AI
S
Szczuczko, Julia
L
Lena Szczuczko
K
Katharina Bogusławski *
DOI:10.1016/j.cpc.2026.110357delete
deleteOriginal
deleteOriginal request for help
deleteShare
deleteSave
Abstract

Abstract

En 中文
Understanding the spatial character of electronic excitations, in particular the distinction between local and charge-transfer (CT) contributions, is essential in the analysis of excited-state phenomena. However, commonly used approaches often rely on method-specific representations or implicit partitioning schemes, limiting their reproducibility and transferability across electronic-structure frameworks. Domain Assignment and Interface Solution in pYthon (DAISpY, pronounced daisy) presents a standalone and format-agnostic tool for domain-based CT analysis of excited states. The method builds on a general representation of excited states in terms of configuration interaction CI-like amplitudes and aggregates their contributions into domain -> domain CT matrices. Orbital contributions are assigned to user-defined spatial domains, enabling a direct and intuitive mapping of electron-hole redistribution between molecular fragments. The formalism consistently treats singles, pairs, and doubles excitations while preserving normalization and avoiding double counting. DAISpY is designed as a modular and reproducible analysis framework, supporting multiple input routes, including electronic-structure checkpoint files and portable data representations. The implementation is independent of any specific quantum chemistry package, ensuring broad applicability. PROGRAM SUMMARY Program title: DAISpY (Domain Assignment & Interface Solution in pYthon) CPC Library link to program files: (to be added by Technical Editor) Developer's repository link: https://gitlab.com/pybest-edev/ct-analysis Licensing provisions: GNU General Public License 3 (GPL) Programming language: Python (3.10+) with a C++17 backend Supplementary material: Example datasets, tutorial notebooks, and user documentation Nature of problem: The interpretation of electronic excited states in terms of spatial charge redistribution remains non-trivial, particularly when distinguishing local excitations from inter-fragment charge transfer. Standard approaches, such as orbital inspection, density differences, or population analyses, often depend on specific electronic-structure implementations and may lack a reproducible and transferable definition of CT character. Moreover, excited states expressed as configuration interaction CI-like expansions contain contributions from multiple excitation ranks, making it difficult to quantify how electron density moves between molecular fragments in a consistent and fragment-resolved manner across different computational workflows. Solution method: DAISpY provides a standalone framework for domain-based CT analysis by mapping CI-like excitation amplitudes onto user-defined spatial domains. Molecular orbitals are assigned to domains based on their atomic contributions, and excitation weights are accumulated into CT matrices. The method supports singles, pairs, and doubles excitations, with higher-order contributions consistently decomposed into effective one-electron channels to preserve normalization and avoid double counting. The implementation is modular and format-agnostic, supporting multiple input routes (HDF5 checkpoints or portable data directories) and offering CLI & Python API and a graphical interface for domain definition and analysis.
Keywords:
Charge transfer
Electronic structure analysis
Post-Hartree-Fock methods
Excited-states
Wavefunction analysis
Molecule visualization
Software
Python
C plus plus

Journal

Computer Physics Communications cover
Computer Physics Communications
IF:
3.4
Papers:
1.2W
Citations:
3.7W

Organization

N
Nicolaus Copernicus University
Scholars:
98
Papers: 49
Citations: 0
Cited Papers

Cited Papers

No cited papers available