qttools.greens_function_solver.rgf#
source module qttools.greens_function_solver.rgf
Classes
-
RGF — Selected inversion solver based on the Schur complement.
source class RGF(max_batch_size: int = 100)
Bases : GFSolver
Selected inversion solver based on the Schur complement.
Initializes the selected inversion solver.
Parameters
-
max_batch_size : int, optional — Maximum batch size to use when inverting the matrix, by default 100.
Methods
-
selected_inv — Performs selected inversion of a block-tridiagonal matrix.
-
selected_solve — Produces elements of the solution to the congruence equation.
source method RGF.selected_inv(a: DSDBSparse, obc_blocks: OBCBlocks | None = None, out: DSDBSparse | None = None) → None | DSDBSparse
Performs selected inversion of a block-tridiagonal matrix.
Parameters
-
a : DSDBSparse — Matrix to invert.
-
obc_blocks : OBCBlocks, optional — OBC blocks for lesser, greater and retarded Green's functions. By default None.
-
out : DSDBSparse, optional — Preallocated output matrix, by default None.
Returns
-
None | DSDBSparse — If
out
is None, returns None. Otherwise, returns the inverted matrix as a DSDBSparse object.
source method RGF.selected_solve(a: DSDBSparse, sigma_lesser: DSDBSparse, sigma_greater: DSDBSparse, obc_blocks: OBCBlocks | None = None, out: tuple[DSDBSparse, ...] | None = None, return_retarded: bool = False, return_current: bool = False) → None | tuple | NDArray
Produces elements of the solution to the congruence equation.
This method produces selected elements of the solution to the relation:
Parameters
-
a : DSDBSparse — Matrix to invert.
-
sigma_lesser : DSDBSparse — Lesser matrix. This matrix is expected to be skew-hermitian, i.e. \(\Sigma_{ij} = -\Sigma_{ji}^*\).
-
sigma_greater : DSDBSparse — Greater matrix. This matrix is expected to be skew-hermitian, i.e. \(\Sigma_{ij} = -\Sigma_{ji}^*\).
-
obc_blocks : OBCBlocks, optional — OBC blocks for lesser, greater and retarded Green's functions. By default None.
-
out : tuple[DSDBSparse, ...] | None, optional — Preallocated output matrices, by default None
-
return_retarded : bool, optional — Wether the retarded Green's function should be returned along with lesser and greater, by default False
-
return_current : bool, optional — Whether to compute and return the current for each layer via the Meir-Wingreen formula. By default False.
Returns
-
None | tuple | NDArray — If
out
is None, returns None. Otherwise, the solutions are returned as DSBParse matrices. Ifreturn_retarded
is True, returns a tuple with the retarded Green's function as the last element. Ifreturn_current
is True, returns the current for each layer.
Raises
-
ValueError