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

Gamma-point (q = 0) correction of W and Σ for periodic RI-RS GW. More...

Functions/Subroutines

subroutine, public prepare_ri_rs_gamma_correction (qs_env, bs_env)
 Preserve distributed AO position, Hamiltonian and overlap images before QS release. Only the sparse operators and their immutable image traversal survive; SCF grids and neighbor lists can be released by the common GW initialization path.
subroutine, public gamma_point_correction (bs_env, qs_env, gwkp_env)
 Gamma-correction head and wing coefficients for the near-Gamma cells. Construct the q->0 dielectric limit along face-cubature and mesh-sample directions from SCF dipole transitions and the directly fitted Gamma Gaussian body.
subroutine, public singular_head_cell_factors (bs_env, cells, factors)
 Integrate 1/q**2 (3D) or 1/|q| (2D slab) over the distinct shifted-mesh cells around Gamma. The regular mesh sum already contains the near-Gamma model samples, which are subtracted here. In 3D the returned coefficient multiplies the factored head density 4*pi*Z_l0(0)*conjg(Z_l'0(0))/M_0(0)**2; in 2D it has units of inverse in-plane momentum. The face-to-polar Jacobian resolves the integrable singularity without sampling q=0.
subroutine, public add_gamma_corr_cell_correction (bs_env, cells, model, i_t, z_head, first_pair, w_grid_r)
 Add the Gamma-correction head and wings of one time point to the local grid pairs. The wing of cell R is w_l(R,τ) = Σ_ω cos(τ,ω) Σ_c wing_cartesian_lc(ω) c_c(R,ω); one GEMM per cell forms it together with its conjugate-side partner.
subroutine, public add_gamma_corr_pair_cell (bs_env, cells, icell, head_scalar, head_vector, first_pair, values_r, wing_left, wing_right)
 Scatter one low-rank Gamma correction into the centred grid-pair images. For s=nearest_integer[H^{-1}(r_l-r_l')], C_ll'(R)=C0_ll'(R-s). R-s is wrapped into the finite FFT cell with its transfer-mesh Bloch twist. Half-cell ties average adjacent integer images, retaining Hermiticity and cell-wrapping covariance. The mirrored conjugate-transpose contribution enforces reciprocity also on Nyquist faces. No grid-pair angular tensor is formed. values_R holds flattened column-major pairs beginning at first_pair.

Detailed Description

Gamma-point (q = 0) correction of W and Σ for periodic RI-RS GW.

Author
Jan Wilhelm (with help of ChatGPT, GPT-6 Sol and GPT-6 Astra)

Function/Subroutine Documentation

◆ prepare_ri_rs_gamma_correction()

subroutine, public gw_ri_rs_small_cell_full_kp_gamma::prepare_ri_rs_gamma_correction ( type(qs_environment_type), pointer qs_env,
type(post_scf_bandstructure_type), pointer bs_env )

Preserve distributed AO position, Hamiltonian and overlap images before QS release. Only the sparse operators and their immutable image traversal survive; SCF grids and neighbor lists can be released by the common GW initialization path.

Parameters
qs_envConverged Quickstep state.
bs_envBand-structure settings.

Definition at line 106 of file gw_ri_rs_small_cell_full_kp_gamma.F.

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

◆ gamma_point_correction()

subroutine, public gw_ri_rs_small_cell_full_kp_gamma::gamma_point_correction ( type(post_scf_bandstructure_type), pointer bs_env,
type(qs_environment_type), pointer qs_env,
type(gwkp_type), intent(inout) gwkp_env )

Gamma-correction head and wing coefficients for the near-Gamma cells. Construct the q->0 dielectric limit along face-cubature and mesh-sample directions from SCF dipole transitions and the directly fitted Gamma Gaussian body.

Parameters
bs_env...
qs_env...
gwkp_envRI-RS work data and Gamma correction.

Definition at line 178 of file gw_ri_rs_small_cell_full_kp_gamma.F.

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

◆ singular_head_cell_factors()

subroutine, public gw_ri_rs_small_cell_full_kp_gamma::singular_head_cell_factors ( type(post_scf_bandstructure_type), pointer bs_env,
integer, dimension(:, :), intent(in) cells,
complex(kind=dp), dimension(:), intent(out), allocatable factors )

Integrate 1/q**2 (3D) or 1/|q| (2D slab) over the distinct shifted-mesh cells around Gamma. The regular mesh sum already contains the near-Gamma model samples, which are subtracted here. In 3D the returned coefficient multiplies the factored head density 4*pi*Z_l0(0)*conjg(Z_l'0(0))/M_0(0)**2; in 2D it has units of inverse in-plane momentum. The face-to-polar Jacobian resolves the integrable singularity without sampling q=0.

Parameters
bs_env...
cells...
factors...

Definition at line 523 of file gw_ri_rs_small_cell_full_kp_gamma.F.

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

◆ add_gamma_corr_cell_correction()

subroutine, public gw_ri_rs_small_cell_full_kp_gamma::add_gamma_corr_cell_correction ( type(post_scf_bandstructure_type), pointer bs_env,
integer, dimension(:, :), intent(in) cells,
type(gamma_correction_type), intent(in) model,
integer, intent(in) i_t,
complex(kind=dp), dimension(:), intent(in) z_head,
integer, intent(in) first_pair,
real(kind=dp), dimension(:, :, :), intent(inout) w_grid_r )

Add the Gamma-correction head and wings of one time point to the local grid pairs. The wing of cell R is w_l(R,τ) = Σ_ω cos(τ,ω) Σ_c wing_cartesian_lc(ω) c_c(R,ω); one GEMM per cell forms it together with its conjugate-side partner.

Parameters
bs_env...
cells...
model...
i_t...
Z_headGrid coefficients Z_l0(0) of the Gamma head function
first_pair...
W_grid_R...

Definition at line 819 of file gw_ri_rs_small_cell_full_kp_gamma.F.

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

◆ add_gamma_corr_pair_cell()

subroutine, public gw_ri_rs_small_cell_full_kp_gamma::add_gamma_corr_pair_cell ( type(post_scf_bandstructure_type), pointer bs_env,
integer, dimension(:, :), intent(in) cells,
integer, intent(in) icell,
complex(kind=dp), intent(in) head_scalar,
complex(kind=dp), dimension(:), intent(in) head_vector,
integer, intent(in) first_pair,
real(kind=dp), dimension(:, :, :), intent(inout) values_r,
complex(kind=dp), dimension(:), intent(in), optional wing_left,
complex(kind=dp), dimension(:), intent(in), optional wing_right )

Scatter one low-rank Gamma correction into the centred grid-pair images. For s=nearest_integer[H^{-1}(r_l-r_l')], C_ll'(R)=C0_ll'(R-s). R-s is wrapped into the finite FFT cell with its transfer-mesh Bloch twist. Half-cell ties average adjacent integer images, retaining Hermiticity and cell-wrapping covariance. The mirrored conjugate-transpose contribution enforces reciprocity also on Nyquist faces. No grid-pair angular tensor is formed. values_R holds flattened column-major pairs beginning at first_pair.

Parameters
bs_env...
cells...
icell...
head_scalar...
head_vector...
first_pair...
values_R...
wing_left...
wing_right...

Definition at line 1745 of file gw_ri_rs_small_cell_full_kp_gamma.F.

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