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

Native character decomposition and metric-aware inversion representations. More...

Functions/Subroutines

subroutine, public spin_rotation (rotation, spin, tolerance, status)
 Lift a Cartesian orthogonal operation to the physical spin-1/2 representation.
subroutine, public transform_spinor_frame (orbital, spin, source, antiunitary, image, tolerance, status)
 Compose orbital, Bloch, physical-spin and optional time-reversal transformations.
subroutine, public character_multiplicities (character, table, multiplicities, tolerance, status)
 Decompose a character against a complete unitary character table.
subroutine, public inversion_representation (metric, coeff, mapping, phase, energies, check_tr, tolerance, energy_tolerance, counts, error, energy_error, status, diagnostics)
 Inversion irreps of an isolated scalar or spinor eigenspace in an AO metric.

Detailed Description

Native character decomposition and metric-aware inversion representations.

Function/Subroutine Documentation

◆ spin_rotation()

subroutine, public topology_symmetry::spin_rotation ( real(dp), dimension(3, 3), intent(in) rotation,
complex(dp), dimension(2, 2), intent(out) spin,
real(dp), intent(in) tolerance,
integer, intent(out) status )

Lift a Cartesian orthogonal operation to the physical spin-1/2 representation.

Parameters
rotationCartesian polar-vector operation, including improper operations
spinSU(2) lift of det(rotation)*rotation; inversion acts trivially on spin
toleranceOrthogonality tolerance
statusZero on success, negative for invalid geometry
Note
The quaternion sign fixes one representative, not a single-valued SO(3) representation. Products must retain the resulting double-group factor system. Orbital parity is separate.

Definition at line 30 of file topology_symmetry.F.

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

◆ transform_spinor_frame()

subroutine, public topology_symmetry::transform_spinor_frame ( complex(dp), dimension(:, :), intent(in) orbital,
complex(dp), dimension(2, 2), intent(in) spin,
complex(dp), dimension(:, :), intent(in) source,
logical, intent(in) antiunitary,
complex(dp), dimension(:, :), intent(out) image,
real(dp), intent(in) tolerance,
integer, intent(out) status )

Compose orbital, Bloch, physical-spin and optional time-reversal transformations.

Parameters
orbitalScalar AO action from the source to the target k, including all lattice phases
spinUnitary spin matrix from spin_rotation
sourceSource spin-major frame
antiunitaryApply physical Theta=i*sigma_y*K before the spatial operation
imageTransformed spin-major frame in the target AO basis
toleranceSpin unitarity tolerance
statusZero on success, negative for malformed data
Note
Orbital metric/Hamiltonian covariance and k mapping must be checked by the caller.

Definition at line 92 of file topology_symmetry.F.

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

◆ character_multiplicities()

subroutine, public topology_symmetry::character_multiplicities ( complex(kind=dp), dimension(:), intent(in) character,
complex(kind=dp), dimension(:, :), intent(in) table,
integer, dimension(:), intent(out) multiplicities,
real(kind=dp), intent(in) tolerance,
integer, intent(out) status )

Decompose a character against a complete unitary character table.

Parameters
CHARACTEROne character per group element (not per conjugacy class)
tableCharacters, group element first and irrep second; identity first
multiplicitiesNonnegative integer multiplicities, invalid unless status=0
toleranceAbsolute numerical tolerance
statusZero on success, negative for invalid/incomplete/nonintegral data
Note
All projective irreps must use the same factor system. This kernel does not infer a space group or certify the supplied character table's provenance.

Definition at line 141 of file topology_symmetry.F.

Here is the caller graph for this function:

◆ inversion_representation()

subroutine, public topology_symmetry::inversion_representation ( complex(kind=dp), dimension(:, :), intent(in) metric,
complex(kind=dp), dimension(:, :), intent(in) coeff,
integer, dimension(:), intent(in) mapping,
complex(kind=dp), dimension(:), intent(in) phase,
real(kind=dp), dimension(:), intent(in) energies,
logical, intent(in) check_tr,
real(kind=dp), intent(in) tolerance,
real(kind=dp), intent(in) energy_tolerance,
integer, dimension(2), intent(out) counts,
real(kind=dp), intent(out) error,
real(kind=dp), intent(out) energy_error,
integer, intent(out) status,
real(kind=dp), dimension(4), intent(out), optional diagnostics )

Inversion irreps of an isolated scalar or spinor eigenspace in an AO metric.

Parameters
metricScalar AO overlap at a TRIM
coeffSelected coefficients, spinor components stacked by AO
mappingTarget AO index under inversion
phaseSource-AO multiplier, including orbital parity and lattice phase
energiesSelected eigenvalues in Hartree
check_trCheck physical spinful time reversal as well as inversion
toleranceDimensionless metric/subspace/character tolerance
energy_toleranceEigenvalue-commutator tolerance in Hartree
countsMultiplicities of even/odd inversion irreps, counting states not pairs
errorLargest dimensionless residual
energy_errorLargest projected symmetry/eigenvalue commutator
statusZero on success; invalid output for nonzero status
diagnosticsOptional metric, normalization, inversion and time-reversal residuals

Definition at line 204 of file topology_symmetry.F.

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