(git:27c966b)
Loading...
Searching...
No Matches
bse_full_diag Module Reference

Routines for the full diagonalization of GW + Bethe-Salpeter for computing electronic excitations. More...

Functions/Subroutines

subroutine, public create_a (fm_s_ia, fm_s_bar_ij, fm_s_ab, fm_a, eigenval, unit_nr, homo, virtual, dimen_ri, bse_env)
 Matrix A constructed from GW energies and 3c-B-matrices (cf. subroutine screen_slabs) A_ia,jb = (ε_a-ε_i) δ_ij δ_ab + α * v_ia,jb - W_ij,ab ε_a, ε_i are GW singleparticle energies from Eigenval_reduced α is a spin-dependent factor v_ia,jb = \sum_P B^P_ia B^P_jb (unscreened Coulomb interaction) W_ij,ab = \sum_P \bar{B}^P_ij B^P_ab (screened Coulomb interaction).
subroutine, public create_b (fm_s_ia, fm_s_bar_ia, fm_b, homo, virtual, dimen_ri, unit_nr, bse_env)
 Matrix B constructed from 3c-B-matrices (cf. subroutine screen_slabs) B_ia,jb = α * v_ia,jb - W_ib,aj α is a spin-dependent factor v_ia,jb = \sum_P B^P_ia B^P_jb (unscreened Coulomb interaction) W_ib,aj = \sum_P \bar{B}^P_ib B^P_aj (screened Coulomb interaction).
subroutine, public create_a_and_b (fm_s_ia, fm_s_ij, fm_s_ab, fm_s_bar_ia, fm_s_bar_ij, fm_a, fm_b, do_abba, eigenval, unit_nr, homo, virtual, dimen_ri, bse_env)
 Explicit A, and B for ABBA, from the slabs the screening method contracts: the bare ones for TDHF and ALPHA screening, the W-multiplied ones otherwise.
subroutine, public create_hermitian_form_rpa (fm_c, gap)
 Form C = sqrt(Δ) (Δ + 2 B) sqrt(Δ) in place for RPA, where A-B = diag(Δ).
subroutine, public create_hermitian_form_of_abba (fm_a, fm_b, fm_c, fm_sqrt_a_minus_b, fm_inv_sqrt_a_minus_b, unit_nr, bse_env, diag_est)
 Construct Matrix C=(A-B)^0.5 (A+B) (A-B)^0.5 to solve full BSE matrix as a hermitian problem (cf. Eq. (A7) in F. Furche J. Chem. Phys., Vol. 114, No. 14, (2001)). We keep fm_sqrt_A_minus_B and fm_inv_sqrt_A_minus_B for print of singleparticle transitions of ABBA as described in Eq. (A10) in F. Furche J. Chem. Phys., Vol. 114, No. 14, (2001).
subroutine, public diagonalize_c (fm_c, homo, virtual, homo_irred, fm_sqrt_a_minus_b, fm_inv_sqrt_a_minus_b, unit_nr, diag_est, bse_env, mo_coeff)
 Solving eigenvalue equation C Z^n = (Ω^n)^2 Z^n . Here, the eigenvectors Z^n relate to X^n via Eq. (A10) in F. Furche J. Chem. Phys., Vol. 114, No. 14, (2001).
subroutine, public diagonalize_a (fm_a, homo, virtual, homo_irred, unit_nr, diag_est, bse_env, mo_coeff)
 Solving hermitian eigenvalue equation A X^n = Ω^n X^n.
subroutine, public postprocess_bse (exc_ens, fm_eigvec_x, bse_env, mo_coeff, homo, virtual, homo_irred, unit_nr, flag_tda, fm_eigvec_y)
 Prints the success message (incl. energies) for full diag of BSE (TDA/full ABBA via flag).

Detailed Description

Routines for the full diagonalization of GW + Bethe-Salpeter for computing electronic excitations.

History
10.2023 created [Maximilian Graml]

Function/Subroutine Documentation

◆ create_a()

subroutine, public bse_full_diag::create_a ( type(cp_fm_type), dimension(:), intent(in) fm_s_ia,
type(cp_fm_type), dimension(:), intent(in) fm_s_bar_ij,
type(cp_fm_type), dimension(:), intent(in) fm_s_ab,
type(cp_fm_type), intent(inout) fm_a,
real(kind=dp), dimension(:), intent(in) eigenval,
integer, intent(in) unit_nr,
integer, dimension(:), intent(in) homo,
integer, dimension(:), intent(in) virtual,
integer, intent(in) dimen_ri,
type(bse_env_type), intent(in) bse_env )

Matrix A constructed from GW energies and 3c-B-matrices (cf. subroutine screen_slabs) A_ia,jb = (ε_a-ε_i) δ_ij δ_ab + α * v_ia,jb - W_ij,ab ε_a, ε_i are GW singleparticle energies from Eigenval_reduced α is a spin-dependent factor v_ia,jb = \sum_P B^P_ia B^P_jb (unscreened Coulomb interaction) W_ij,ab = \sum_P \bar{B}^P_ij B^P_ab (screened Coulomb interaction).

Parameters
fm_S_ia...
fm_S_bar_ij...
fm_S_ab...
fm_A...
Eigenval...
unit_nr...
homo...
virtual...
dimen_RI...
bse_envthe BSE environment (settings; para_env, dft_control, exstate_env)

Definition at line 94 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ create_b()

subroutine, public bse_full_diag::create_b ( type(cp_fm_type), dimension(:), intent(in) fm_s_ia,
type(cp_fm_type), dimension(:), intent(in) fm_s_bar_ia,
type(cp_fm_type), intent(inout) fm_b,
integer, dimension(:), intent(in) homo,
integer, dimension(:), intent(in) virtual,
integer, intent(in) dimen_ri,
integer, intent(in) unit_nr,
type(bse_env_type), intent(in) bse_env )

Matrix B constructed from 3c-B-matrices (cf. subroutine screen_slabs) B_ia,jb = α * v_ia,jb - W_ib,aj α is a spin-dependent factor v_ia,jb = \sum_P B^P_ia B^P_jb (unscreened Coulomb interaction) W_ib,aj = \sum_P \bar{B}^P_ib B^P_aj (screened Coulomb interaction).

Parameters
fm_S_ia...
fm_S_bar_ia...
fm_B...
homo...
virtual...
dimen_RI...
unit_nr...
bse_envthe BSE environment (settings)

Definition at line 325 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ create_a_and_b()

subroutine, public bse_full_diag::create_a_and_b ( type(cp_fm_type), dimension(:), intent(in) fm_s_ia,
type(cp_fm_type), dimension(:), intent(in) fm_s_ij,
type(cp_fm_type), dimension(:), intent(in) fm_s_ab,
type(cp_fm_type), dimension(:), intent(in) fm_s_bar_ia,
type(cp_fm_type), dimension(:), intent(in) fm_s_bar_ij,
type(cp_fm_type), intent(inout) fm_a,
type(cp_fm_type), intent(inout) fm_b,
logical, intent(in) do_abba,
real(kind=dp), dimension(:), intent(in) eigenval,
integer, intent(in) unit_nr,
integer, dimension(:), intent(in) homo,
integer, dimension(:), intent(in) virtual,
integer, intent(in) dimen_ri,
type(bse_env_type), intent(in) bse_env )

Explicit A, and B for ABBA, from the slabs the screening method contracts: the bare ones for TDHF and ALPHA screening, the W-multiplied ones otherwise.

Parameters
fm_S_ia...
fm_S_ij...
fm_S_ab...
fm_S_bar_ia...
fm_S_bar_ij...
fm_A...
fm_Bcreated only for ABBA
do_abba...
Eigenval...
unit_nr...
homo...
virtual...
dimen_RI...
bse_envthe BSE environment (settings)

Definition at line 453 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ create_hermitian_form_rpa()

subroutine, public bse_full_diag::create_hermitian_form_rpa ( type(cp_fm_type), intent(inout) fm_c,
real(kind=dp), dimension(:), intent(in) gap )

Form C = sqrt(Δ) (Δ + 2 B) sqrt(Δ) in place for RPA, where A-B = diag(Δ).

Parameters
fm_CRPA coupling matrix B on entry; squared excitation matrix C on exit.
gapPositive occupied-virtual energy differences Δ.

Definition at line 491 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ create_hermitian_form_of_abba()

subroutine, public bse_full_diag::create_hermitian_form_of_abba ( type(cp_fm_type), intent(in) fm_a,
type(cp_fm_type), intent(in) fm_b,
type(cp_fm_type), intent(inout) fm_c,
type(cp_fm_type), intent(inout) fm_sqrt_a_minus_b,
type(cp_fm_type), intent(inout) fm_inv_sqrt_a_minus_b,
integer, intent(in) unit_nr,
type(bse_env_type), intent(in) bse_env,
real(kind=dp), intent(in) diag_est )

Construct Matrix C=(A-B)^0.5 (A+B) (A-B)^0.5 to solve full BSE matrix as a hermitian problem (cf. Eq. (A7) in F. Furche J. Chem. Phys., Vol. 114, No. 14, (2001)). We keep fm_sqrt_A_minus_B and fm_inv_sqrt_A_minus_B for print of singleparticle transitions of ABBA as described in Eq. (A10) in F. Furche J. Chem. Phys., Vol. 114, No. 14, (2001).

Parameters
fm_A...
fm_B...
fm_C...
fm_sqrt_A_minus_B...
fm_inv_sqrt_A_minus_B...
unit_nr...
bse_envthe BSE environment (settings)
diag_est...

Definition at line 535 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ diagonalize_c()

subroutine, public bse_full_diag::diagonalize_c ( type(cp_fm_type), intent(inout) fm_c,
integer, dimension(:), intent(in) homo,
integer, dimension(:), intent(in) virtual,
integer, dimension(:), intent(in) homo_irred,
type(cp_fm_type), intent(inout) fm_sqrt_a_minus_b,
type(cp_fm_type), intent(inout) fm_inv_sqrt_a_minus_b,
integer, intent(in) unit_nr,
real(kind=dp), intent(in) diag_est,
type(bse_env_type), intent(in) bse_env,
type(cp_fm_type), dimension(:), intent(in) mo_coeff )

Solving eigenvalue equation C Z^n = (Ω^n)^2 Z^n . Here, the eigenvectors Z^n relate to X^n via Eq. (A10) in F. Furche J. Chem. Phys., Vol. 114, No. 14, (2001).

Parameters
fm_C...
homo...
virtual...
homo_irred...
fm_sqrt_A_minus_B...
fm_inv_sqrt_A_minus_B...
unit_nr...
diag_est...
bse_envthe BSE environment (settings, and the state the post-processing reads)
mo_coeff...

Definition at line 683 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ diagonalize_a()

subroutine, public bse_full_diag::diagonalize_a ( type(cp_fm_type), intent(inout) fm_a,
integer, dimension(:), intent(in) homo,
integer, dimension(:), intent(in) virtual,
integer, dimension(:), intent(in) homo_irred,
integer, intent(in) unit_nr,
real(kind=dp), intent(in) diag_est,
type(bse_env_type), intent(in) bse_env,
type(cp_fm_type), dimension(:), intent(in) mo_coeff )

Solving hermitian eigenvalue equation A X^n = Ω^n X^n.

Parameters
fm_A...
homo...
virtual...
homo_irred...
unit_nr...
diag_est...
bse_envthe BSE environment (settings, and the state the post-processing reads)
mo_coeff...

Definition at line 813 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ postprocess_bse()

subroutine, public bse_full_diag::postprocess_bse ( real(kind=dp), dimension(:), allocatable exc_ens,
type(cp_fm_type), intent(in) fm_eigvec_x,
type(bse_env_type), intent(in) bse_env,
type(cp_fm_type), dimension(:), intent(in) mo_coeff,
integer homo,
integer virtual,
integer homo_irred,
integer unit_nr,
logical, optional flag_tda,
type(cp_fm_type), intent(in), optional fm_eigvec_y )

Prints the success message (incl. energies) for full diag of BSE (TDA/full ABBA via flag).

Parameters
Exc_ens...
fm_eigvec_X...
bse_envthe BSE environment (settings; the AO multipoles and their reference point, mos, subsys)
mo_coeff...
homo...
virtual...
homo_irred...
unit_nr...
flag_TDA...
fm_eigvec_Y...

Definition at line 1023 of file bse_full_diag.F.

Here is the call graph for this function:
Here is the caller graph for this function: