QR 2 -code : An open-source program for double resonance Raman spectra
Jianqi Huang, Renhui Liu, Ye Zhang, Nguyen Tuan Hung, Huaihong Guo, Riichiro Saito, Teng Yang · 2025
Read QR 2 -code : An open-source program for double resonance Raman spectra by Jianqi Huang, Renhui Liu, Ye Zhang, Nguyen Tuan Hung, Huaihong Guo, Riichiro Saito, Teng Yang (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2505-10041.txt.
Introduction
Jianqi Huang and six co-authors release an open source program for Raman spectra in a 2025 paper. Raman scattering uses light to probe vibrations in materials, and a double resonance version gives extra detail. Their program computes these spectra from first principles, starting from standard quantum simulation outputs.
The program handles ordinary resonance spectra, double resonance spectra, and spectra changed by defects. For defect cases it uses a simple constant assumption for one scattering term. Hands on tutorials use graphene as the example material. Results agree with an earlier Raman program on test cases. All code, examples, and scripts are posted openly for reuse.
Catalog record
| CREATOR | Jianqi Huang, Renhui Liu, Ye Zhang, Nguyen Tuan Hung, Huaihong Guo, Riichiro Saito, Teng Yang |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 52 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2505-10041
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
QR 2 -code : An open-source program for double resonance Raman spectra Jianqi Huang, Renhui Liu, Ye Zhang, Nguyen Tuan Hung, Huaihong Guo, Riichiro Saito, Teng Yang Abstract We present an open-source program QR 2 -code that computes double-resonance Raman (DRR) spectra using first-principles calculations. QR 2 -code can calculate not only two-phonon DRR spectra but also single-resonance Raman spectra and defect-induced DRR spectra. For defect-induced DDR spectra, we simply assume that the electron-defect matrix element of elastic scattering is a constant. Hands-on tutorials for graphene are given to show how to run QR 2 -code for single-resonance, double-resonance, and defect-induced Raman spectra. We also compare the single-resonance Raman spectra by QR 2 -code with that by QERaman code. In QR 2 -code , the energy dispersions of electron and phonon are taken from Quantum ESPRESSO ( QE ) code, and the electron-phonon matrix element is obtained from the electron-phonon Wannier ( EPW ) code. All codes, examples, and scripts are available on the GitHub repository. Journal: Computer Physics Communications PROGRAM SUMMARY Program Title: QR 2 -code Developer’s repository link: https://github.com/JoeyyHuang/QR2-code Licensing provisions: GNU General Public Licence 3.0 Programming language: Fortran External routines : Quantum ESPRESSO v7.3.1 , EPW v5.8.1 Nature of problem: A DFT-based program for computation and analysis of the single, double resonance, and defect-induced Raman spectra. Solution method: The Raman spectrum is calculated by the time-dependent perturbation theory, in which the electron-photon and electron-phonon matrix elements are obtained from the modified packages Quantum ESPRESSO and EPW , respectively. Supplementary material: http://qr2-code.com 1 Introduction Raman spectra of low-dimensional materials are frequently observed by changing the laser excitation energies, in which the resonance Raman effect is essential not only for assigning the phonon modes but also for the electronic structure of materials [ 1 , 2 , 3 ] . In the previous work, we have developed an open-source program, QERaman [ 4 ] , for calculating single-resonance Raman (SRR) spectra by using the Quantum ESPRESSO (QE) code [ 5 ] , an open-source package for first-principles calculations. However, QERaman does not support the double-resonance Raman (DRR) spectra, which are often observed in Raman spectra of low-dimensional materials. For example, seven peaks in the Raman spectra of the MoTe 2 monolayer, which are assigned to DRR peaks, have been observed experimentally from 150 to 350 cm -1 [ 6 ] . The double-resonance Raman peaks have also been observed on graphene [ 7 ] , h-BN [ 8 ] , MoS 2 [ 9 , 10 ] , graphite [ 11 ] , or single-wall carbon nanotubes [ 12 , 13 ] . Therefore, simultaneously calculating the SRR and DRR spectra is useful to analyze the observed Raman spectra, particularly for low-dimensional materials, since low-dimensional materials often show sharp DRR peaks because of flat phonon dispersion. The DRR spectra require electron-phonon coupling matrix elements as a function of phonon wavevector \bm{q} over the entire Brillouin zone (BZ). This requires a great deal of computation time compared with the SRR spectra, in which we only need the electron-phonon matrix element at the \Gamma point in the BZ [ 4 ] . In order to avoid this difficulty, several methods have been developed to reduce the computation times of the DRR calculation. For graphene or carbon nanotubes, several groups, including the author’s group, have developed a tight-binding method for calculating the DRR spectra [ 12 , 14 , 15 ] . Recently, Huang et al. [ 6 , 10 , 16 , 17 , 18 ] made a new program, named QR 2 -code , for calculating DRR spectra by using QE code [ 5 ] combined with the electron-phonon Wannier ( EPW ) code [ 19 ] . The QR 2 -code offers three advantages compared to the QERaman . First, QR 2 -code uses maximally localized Wannier functions in EPW to evaluate the electron-phonon matrix element as a function of \bm{q} . The EPW calculation thus enables DRR calculations within a reasonably short computational time. It is noted that in QERaman , the electron-phonon matrix element is obtained by the modified ph.x in QE . Second, QR 2 -code accounts for the Fröhlich electron-phonon coupling, which describes the interaction between electrons and long-wavelength longitudinal optical phonons and is implemented within EPW . Third, by assuming that the electron-defect matrix element for elastic scattering is constant, the QR 2 -code can produce a defect-induced DRR spectra, though we can not discuss the relative intensity of defect-induced DRR spectra to two-phonon DRR spectra. The goal of the paper is to give the open-source of QR 2 -code , which could be useful for the community. We hope that many users will test the program and that they will give any comments to improve QR 2 -code . The organization of this paper is as follows. In Sec. 2 , we briefly introduce the quantum theory of resonance Raman spectrum. In Sec. 3 , we explain the installation and usage of QR 2 -code . In Sec. 4 , we show examples of SRR, two-phonon DRR, and defect-induced DRR of graphene. Other examples for MoS 2 monolayer and bulk h-BN are also available in the GitHub repository. We also compare the results of QR 2 -code with QERaman . Finally, a summary is given in Sec. 5 . 2 Quantum theory for resonance Raman spectrum A Raman scattering process comprises an incident-photon absorption of an electron with the electron wavevector \bm{k} in the valence band, electron-phonon scattering of the photo-excited electron with one or two phonons (or one elastic-scattering + one phonon), and a scattered-photon emission by recombining the photo-excited electron with a hole at the \bm{k} [ 20 , 21 ] . Here, we consider three kinds of resonance Raman processes, i.e., SRR, DRR, and defect-induced DRR processes. Here, resonance means that the intermediate state of the photo-excited electron is a real electronic state, which makes the scattering amplitude become large, which is known as the resonance Raman effect. The SSR process involves only one scattering of the photo-excited electron with a phonon with the phonon wavevector \bm{q} near the \Gamma point in the BZ, that is, \bm{q}=\mathbf{0} is required to recombine the scattered photo-excited electron with a hole. On the other hand, the DRR involves two phonons that possess opposite momentum \bm{q} and -\bm{q} ( \bm{q}\neq\mathbf{0} ), in which the non-zero \bm{q} is selected in the BX with a relatively large electron-phonon matrix element. The defect-induced DRR is a special case of DRR, where either the first or the second electron-phonon scattering is replaced by an elastic scattering by a defect of the lattice. A typical example of defect-induced DRR is the D and D ′ bands in graphene [ 2 ] . Raman spectra plot the intensity of the scattered photon as a function of Raman shift, \omega_{\text{RS}} , in units of cm -1 . The detailed derivation of the formula is given in our previous articles [ 6 ] . In the following, we will show the Raman scattering amplitude for each Raman process that is given by time-dependent perturbation theory, in which electron-photon and electron-phonon interactions are the perturbation Hamiltonian. 2.1 Single-resonance Raman intensity Intensity of the