triqs.experimental.lattice.lattice.find_chemical_potential

triqs.experimental.lattice.lattice.find_chemical_potential()

Dispatched C++ function(s).

[1] (target_density: float,
     H_k: TbHk,
     Sigma: BlockGf[MeshImFreq, 2],
     opt: BzIntOptions,
     method: str = "dichotomy",
     precision: float = 1e-05,
     verbosity: bool = False)
  -> float

[2] (target_density: float,
     H_k: TbHk,
     Sigma: BlockGf[MeshReFreq, 2],
     opt: BzIntOptions,
     method: str = "dichotomy",
     precision: float = 1e-05,
     verbosity: bool = False)
  -> float

[3] (target_density: float,
     H_k: TbHk,
     Sigma: Gf[MeshImFreq, 2],
     opt: BzIntOptions,
     method: str = "dichotomy",
     precision: float = 1e-05,
     verbosity: bool = False)
  -> float

[4] (target_density: float,
     H_k: TbHk,
     Sigma: Gf[MeshReFreq, 2],
     opt: BzIntOptions,
     method: str = "dichotomy",
     precision: float = 1e-05,
     verbosity: bool = False)
  -> float

[1, 2] Find the chemical potential that yields a target density for a block self-energy.

This function adjusts the chemical potential \(\mu\) with a root finder until the total density of the local block Green’s function (summed over all blocks) matches the target density.

---

[3, 4] Find the chemical potential that yields a target density for a single-block self-energy.

This function adjusts the chemical potential \(\mu\) with a root finder until the density of the local Green’s function matches the target density.

---

Parameters:

target_densityfloat

Target total on-site density used to determine \(\mu\).

H_kTbHk

Tight-binding Hamiltonian \(H(\mathbf{k})\).

SigmaBlockGf[MeshImFreq, 2], BlockGf[MeshReFreq, 2]

Block self-energy \(\Sigma(\omega)\).

optBzIntOptions

Options controlling the Brillouin-zone integration.

methodstr

Root-finding method used to determine \(\mu\), either “dichotomy” or “bisection”.

precisionfloat

Absolute precision at which \(\mu\) is determined.

verbositybool

Whether to print the convergence progress.

Returns:

float

Chemical potential \(\mu\) reproducing the target density.