(git:dae9da4)
Loading...
Searching...
No Matches
kpoint_mo_symmetry_methods Module Reference

Utilities for transforming k-point MO coefficients under symmetry operations. More...

Functions/Subroutines

subroutine, public kpoint_cell_gauge_action (kpoints, representative, operation, target, action, rotation, antiunitary, status)
 AO action in the cell Fourier gauge H(k)=sum_R exp(+ikR) H(R).
logical function, public kpoint_same_periodic (xkp_a, xkp_b)
 Compare two fractional k-points modulo reciprocal lattice vectors.
subroutine, public kpoint_transform_scf_mo (src, dst, qs_kpoint, ikred, isym, success, reason)
 Transform one SCF MO coefficient matrix to an equivalent full-mesh k-point.

Detailed Description

Utilities for transforming k-point MO coefficients under symmetry operations.

Function/Subroutine Documentation

◆ kpoint_cell_gauge_action()

subroutine, public kpoint_mo_symmetry_methods::kpoint_cell_gauge_action ( type(kpoint_type), pointer kpoints,
integer, intent(in) representative,
integer, intent(in) operation,
real(dp), dimension(3), intent(in) target,
complex(dp), dimension(:, :), intent(out) action,
real(dp), dimension(3, 3), intent(out) rotation,
logical, intent(out) antiunitary,
integer, intent(out) status )

AO action in the cell Fourier gauge H(k)=sum_R exp(+ikR) H(R).

Parameters
kpointsSymmetry geometry and Gaussian basis rotation blocks
representativeSource irreducible point
operationOrbit operation; zero identity, minus one pure time reversal
TARGETTarget fractional k point, modulo reciprocal vectors
actionScalar AO action, excluding conjugation and physical spin rotation
rotationCartesian spatial operation
antiunitaryWhether the source coefficients must be conjugated
statusZero on success, negative for unavailable or inconsistent mappings
Note
An atom shifted to image L contributes exp(-i*k_target*L). No atomic-gauge reciprocal-vector phase or legacy SCF phase calibration belongs in this cell gauge.

Definition at line 48 of file kpoint_mo_symmetry_methods.F.

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

◆ kpoint_same_periodic()

logical function, public kpoint_mo_symmetry_methods::kpoint_same_periodic ( real(kind=dp), dimension(3), intent(in) xkp_a,
real(kind=dp), dimension(3), intent(in) xkp_b )

Compare two fractional k-points modulo reciprocal lattice vectors.

Parameters
xkp_afirst k-point
xkp_bsecond k-point
Returns
true if the k-points are equivalent

Definition at line 131 of file kpoint_mo_symmetry_methods.F.

Here is the caller graph for this function:

◆ kpoint_transform_scf_mo()

subroutine, public kpoint_mo_symmetry_methods::kpoint_transform_scf_mo ( type(cp_cfm_type), intent(in) src,
type(cp_cfm_type), intent(in) dst,
type(kpoint_type), pointer qs_kpoint,
integer, intent(in) ikred,
integer, intent(in) isym,
logical, intent(out) success,
character(len=*), intent(out) reason )

Transform one SCF MO coefficient matrix to an equivalent full-mesh k-point.

Parameters
srcsource MO coefficients
dsttransformed MO coefficients
qs_kpointSCF k-point object containing symmetry operations
ikredrepresentative k-point index
isymsymmetry operation index; 0 direct copy, -1 time reversal
successtrue if the transformation was performed
reasondiagnostic message

Definition at line 152 of file kpoint_mo_symmetry_methods.F.

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