sisl.physics.SlaterKoster
- class sisl.physics.SlaterKoster
Bases:
objectTwo-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]ofAtomicOrbital(Z1is the default, e.g."2p"is"2pZ1"). Shells up to \(l=2\) are supported.An integral \(V_{ab\mu}\) has shell
aof atomAat the origin and shellbof atomBalong \(+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]withmuone of"sigma","pi","delta". An integral is a value (constant up toR), a tuple(R_list, values)(values[i]forR_list[i-1] < r <= R_list[i], each a value;(R, value)for one range), or a functionV(r)(up toR, it returns a value for eachr). 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 annnzprthat 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
Largest range of the integrals
Atoms of the model, one for each tag, with the orbitals of its shells
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, andH - H2is the rest (three-center terms, crystal field, atomic spin-orbit coupling, and the blocks between shells of one atom).- Parameters:
H – the Hamiltonian, with
AtomicOrbitalorbitals 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:
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:
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 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 rangeRis the largest range of the integrals of the atom: thusfind_nscgives the supercell thatconstructneeds. 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"])