sisl.physics.SlaterKoster

class sisl.physics.SlaterKoster

Bases: object

Two-center Slater-Koster parameterization of a tight-binding model

Use it as the function of construct:

>>> H.construct(sk)

Atoms are keyed by tag, and shells by the label <n><l>[Z<zeta>][P] of AtomicOrbital (Z1 is the default, e.g. "2p" is "2pZ1"). Shells up to \(l=2\) are supported.

An integral \(V_{ab\mu}\) has shell a of atom A at the origin and shell b of atom B along \(+z\), as in [17] (thus \(V_{sp\sigma}>0\) for the usual models). The key (B, A), (b, a) gets \((-1)^{l_a+l_b}V_{ab\mu}\); do not give both.

Parameters that are missing give no matrix element, and a warning. Give an integral as 0 to set no matrix element without a warning.

Parameters:
  • hopping – the integrals, hopping[(A, B)][(a, b)][mu] with mu one of "sigma", "pi", "delta". An integral is a value (constant up to R), a tuple (R_list, values) (values[i] for R_list[i-1] < r <= R_list[i], each a value; (R, value) for one range), or a function V(r) (up to R, it returns a value for each r). A value is a scalar, [up, down], or a 2x2 spin matrix [[uu, ud], [du, dd]], for the spin of H (a scalar is the same for both spins). The key (B, A), (b, a) gets the Hermitian conjugate of a spin matrix.

  • onsite – on-site energies, onsite[A][a], a value as in hopping (Hermitian).

  • overlap – overlap integrals, in the same form as hopping, with scalar values. The on-site overlap is 1. If None, the model is orthogonal.

  • R – the range of the constant and function integrals.

Examples

The \(p_z\) model of graphene:

>>> C = sisl.Atom(6, sisl.AtomicOrbital("2pzZ1", R=1.5), tag="C")
>>> sk = sisl.SlaterKoster(
...     {("C", "C"): {("2p", "2p"): {"pi": (1.5, -2.7)}}}, onsite={"C": {"2p": 0}}
... )
>>> H = sisl.Hamiltonian(sisl.geom.graphene(atoms=C))
>>> H.construct(sk)

Notes

Only pairs inside the supercell of H (nsc) get matrix elements. Create H with an nnzpr that holds all elements of a row: a row that grows is slow.

The first call creates the neighbor list and all matrix elements of H. Each call writes the rows of the atom ia. The other rows are kept until all atoms are written.

Methods

from_hamiltonian(H[, atol])

Two-center integrals that fit the matrix elements of H best

merge(*sks)

One model with the parameters of all sks

Attributes

R

Largest range of the integrals

atoms

Atoms of the model, one for each tag, with the orbitals of its shells

orthogonal

Whether the model has no overlap integrals

classmethod from_hamiltonian(H, atol=0.01)[source]

Two-center integrals that fit the matrix elements of H best

The method of [8]. For each pair of shells, the bonds are sorted by length, and a bond longer than the previous by more than atol starts a new group. The integrals of a group are the least-squares fit of the blocks of all its bonds (both directions of a pair of equal shells). For a complete shell this is the projection of each block on the angular factors. The on-site energy of a shell is the mean of its diagonal elements.

The integrals are step functions: the step between two groups is at the midpoint, and the last group ends atol after its longest bond. Thus H2.construct(sk) on the geometry of H gives the two-center part of H, and H - H2 is the rest (three-center terms, crystal field, atomic spin-orbit coupling, and the blocks between shells of one atom).

Parameters:
  • H – the Hamiltonian, with AtomicOrbital orbitals up to \(l=2\). Shift the energies to the reference that you want first (shift): with an overlap, a shift \(E_0\) changes the hopping integrals by \(-E_0 S\).

  • atol (float) – the largest difference of two bond lengths in one group (Ang).

Return type:

SlaterKoster

Examples

>>> sk = sisl.SlaterKoster.from_hamiltonian(H)
>>> H2 = H.copy()
>>> H2.construct(sk)

Notes

When the bonds of a group do not determine all integrals (for example \(V_{pp\sigma}\) from only \(p_z\) orbitals in a plane), the integrals are the minimum-norm solution, with a warning.

classmethod merge(*sks)[source]

One model with the parameters of all sks

Each integral keeps its range. A coupling that two models have raises an error: an on-site shell, or a hopping or overlap shell pair (also in the reverse direction).

Parameters:

*sks (SlaterKoster) – the models, all orthogonal or all non-orthogonal

Return type:

SlaterKoster

Examples

>>> sk = sisl.SlaterKoster.merge(sk_CC, sk_CH, sk_HH)
__call__(H, ia, atoms=None, atoms_xyz=None)[source]

Set the rows of atom ia in H (signature of construct)

Parameters:

ia (int)

property R: float

Largest range of the integrals

property atoms: Atoms

Atoms of the model, one for each tag, with the orbitals of its shells

The orbitals of a shell are m = -l..l, and the shells are sorted by (n, l, zeta, P), as in Siesta. The orbitals have no radial function. Their range R is the largest range of the integrals of the atom: thus find_nsc gives the supercell that construct needs. An atom without integrals has the range 0. The element is the tag, or else the element at its start, e.g. "Carbon", "Carbon_edge" and "C_edge" are carbon.

Examples

>>> geometry = sisl.geom.graphene(atoms=sk.atoms["C"])
property orthogonal: bool

Whether the model has no overlap integrals