Eve library

phase-123.md

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

<!-- prettier-ignore-start -->

Phase 123: Kalika Transport, Optical & Magnetic Properties — Boltzmann Transport, Dielectric Response, Magnetism, Spintronics & Topological Materials#

Covers prediction of measurable material properties from first-principles electronic structure. Implements electronic and thermal transport (Boltzmann transport equation, relaxation time models, thermoelectric optimization), optical response (dielectric function, absorption, nonlinear optics), magnetism (exchange coupling, spin dynamics, magnetic anisotropy), spintronics (spin Hall effect, spin textures, magnetoresistance), topological invariants (Z2, Chern number, surface states, topological classification), piezoelectric and ferroelectric properties (Berry phase polarization, piezoelectric tensors), elastic and mechanical properties (elastic constants, hardness, stability criteria), and thermal properties (specific heat, thermal expansion, thermal conductivity). Targets parity with BoltzTraP2, BoltzWann, EPW (transport), VASP optics, Exciting (optical), VAMPIRE/Spirit (magnetism), Z2Pack/WannierTools (topology), and ElaStic/MechElastic (elasticity).

Tech stack: Rust (~40%) for performance-critical transport integrals, BZ integration, Monte Carlo spin dynamics, and tensor contractions; TypeScript (~50%) for orchestration, data models, analysis pipelines, and API surfaces; Python (~10%) for interoperability with existing codes (BoltzTraP2 I/O, VASP optics parsing, VAMPIRE config generation).


123.1 Scaffolding & Core Types (@kalika/transport)#

123.1.1 Project Setup#

  • 123.1.1.1 Create libs/kalika/transport/ directory structure with project.json, package.json, tsconfig.json, tsconfig.lib.json, tsconfig.spec.json, and vitest.config.ts. Add @kalika/transport path mapping to tsconfig.base.json. Configure dual Rust/TypeScript build pipeline with tsup for TS and wasm-pack/napi-rs for Rust components
  • 123.1.1.2 Create libs/kalika/transport/rust/ Cargo workspace member with Cargo.toml depending on ndarray, num-complex, rayon, wasm-bindgen, and napi-rs. Set up src/lib.rs with module declarations for bte, scattering, integration, and tensor
  • 123.1.1.3 Create barrel exports in src/index.ts exporting all public types, classes, and factory functions across transport, optical, magnetic, spintronics, topological, piezoelectric, elastic, and thermal submodules

123.1.2 Core Tensor Types#

  • 123.1.2.1 Implement TransportTensor type: rank-2 symmetric tensor (3x3 matrix) with crystal symmetry constraints, temperature and chemical potential labels, units tracking (SI and Gaussian), eigenvalue decomposition, rotation under point group operations, Voigt notation conversion, and pretty-printing with scientific notation
  • 123.1.2.2 Implement ConductivityTensor extending TransportTensor: electrical conductivity sigma_ab in S/m or S/cm, with methods for trace (isotropic conductivity), resistivity tensor (matrix inverse), anisotropy ratio sigma_max/sigma_min, and temperature-dependent storage as sigma(T, mu) grid
  • 123.1.2.3 Implement SeebeckTensor: thermopower S_ab in uV/K, computed as ratio of Onsager coefficients L1/L0, with sign convention (negative for n-type, positive for p-type), trace for isotropic Seebeck, and power factor tensor S^2 * sigma computation
  • 123.1.2.4 Implement ThermalConductivityTensor: electronic thermal conductivity kappa_e,ab in W/(mK), computed from Onsager coefficients as (1/T)[L2 - (L1)^2/L0], with Lorenz number tensor L_ab = kappa_e/(sigmaT) and Wiedemann-Franz deviation tracking
  • 123.1.2.5 Implement HallTensor: rank-3 antisymmetric Hall tensor R_H,abc in m^3/C, Hall coefficient extraction for specific field directions, Hall mobility mu_H = R_H * sigma, and Hall factor r_H = mu_H / mu_drift
  • 123.1.2.6 Implement DielectricTensor: frequency-dependent complex dielectric function epsilon(omega) = epsilon_1 + i*epsilon_2 as 3x3 tensor, with storage as arrays over frequency grid, interpolation, Kramers-Kronig consistency check, static limit epsilon_0, and high-frequency limit epsilon_inf
  • 123.1.2.7 Implement OpticalSpectrum type: container for frequency-dependent optical quantities (absorption coefficient, reflectivity, refractive index, extinction coefficient, optical conductivity, energy loss function) with unit conversions (eV, nm, cm-1, THz), broadening parameters, and plotting data export
  • 123.1.2.8 Implement MagneticStructure type: magnetic configuration on a crystal lattice with atomic site positions, spin vectors (magnitude + direction for each site), magnetic space group, propagation vector(s), classification (FM, AFM subtypes, ferrimagnetic, non-collinear), total magnetic moment, and sublattice decomposition
  • 123.1.2.9 Implement TopologicalInvariant type: container for topological classification including Z2 indices (nu_0; nu_1 nu_2 nu_3), Chern numbers (per band, total), mirror Chern numbers, symmetry indicators, topological class label (trivial, strong TI, weak TI, Dirac/Weyl/nodal-line semimetal), and confidence/convergence metadata
  • 123.1.2.10 Implement PiezoelectricTensor type: rank-3 tensor d_ijk (strain convention) and e_ijk (stress convention) in pC/N and C/m^2, with Voigt notation (d_ij 3x6 matrix), symmetry reduction for all 32 point groups, and conversion between d and e via elastic constants
  • 123.1.2.11 Implement ElasticTensor type: rank-4 elastic stiffness tensor C_ijkl stored in 6x6 Voigt notation C_ij, with symmetry constraints for all 7 crystal systems (triclinic through cubic), compliance tensor S_ij = C^{-1}, eigenvalue decomposition (Kelvin notation), and positive-definiteness check

123.1.3 Shared Utilities#

  • 123.1.3.1 Implement Brillouin zone integration engine (Rust): adaptive tetrahedron method (Blochl improved tetrahedron) for BZ integrals of tensor quantities, with k-point mesh generation (Monkhorst-Pack, Gamma-centered), symmetry reduction using crystal point group, and convergence estimation from successive mesh refinements
  • 123.1.3.2 Implement Fermi-Dirac distribution utilities: f(E, T, mu), -df/dE (transport window function), Fermi level finder (bisection + Brent's method to enforce charge neutrality), and Sommerfeld expansion coefficients for low-temperature analytics
  • 123.1.3.3 Implement band structure interpolation interface: abstract trait/interface for obtaining E_nk, v_nk = (1/hbar) dE/dk, and effective mass tensor m*_ab = hbar^2 (d^2E/dk_a dk_b)^{-1} at arbitrary k-points, with concrete implementations for Fourier interpolation (BoltzTraP style) and Wannier interpolation (BoltzWann style)
  • 123.1.3.4 Implement Fourier band interpolation (Rust): given band energies on a regular k-mesh, compute star functions (symmetrized plane waves) and expand E_nk = sum_R c_R e^{ik.R}, using the BoltzTraP2 algorithm with optimal smoothing parameter selection via leave-one-out cross-validation
  • 123.1.3.5 Implement Wannier band interpolation (Rust): given Wannier Hamiltonian H(R) in real space (from Phase 117 or external Wannier90 output), compute H(k) = sum_R H(R) e^{ik.R} and diagonalize for E_nk and velocities via Hellmann-Feynman theorem v_nk = <n,k| dH/dk |n,k> / hbar

123.2 Electronic Transport — Boltzmann Transport Equation (@kalika/transport)#

123.2.1 Transport Distribution Function#

  • 123.2.1.1 Implement transport distribution function (TDF) Xiab(epsilon) = (1/V) sum{n,k} v*{n,k,a} * v*{n,k,b} _ tau_{n,k} _ delta(epsilon - E_{n,k}) using tetrahedron integration over the BZ (Rust): for each energy epsilon on a fine grid, accumulate velocity products weighted by relaxation time and the delta function approximated via linear tetrahedron interpolation
  • 123.2.1.2 Implement Onsager transport coefficients from TDF: L^(alpha)_ab(T, mu) = e^2 integral Xi_ab(epsilon) _ (epsilon - mu)^alpha _ (-df/dE) dE for alpha = 0, 1, 2 — using adaptive Gauss-Legendre quadrature in the transport window (|epsilon - mu| < ~10 k_BT) where -df/dE is appreciable
  • 123.2.1.3 Implement constant relaxation time approximation (CRTA): set tau_{n,k} = tau_0 (constant, user-specified or 10 fs default), compute sigma/tau_0, S (tau-independent), kappa_e/tau_0, and RH/tau_0^2 — matching the BoltzTraP2 approach where only ratios of Onsager coefficients (Seebeck) are predictive without knowing tau

123.2.2 Transport Properties from Onsager Coefficients#

  • 123.2.2.1 Implement electrical conductivity tensor sigma_ab(T, mu) = L^(0)_ab: compute on a (T, mu) grid with T from 100-1200 K and mu spanning the band gap, store as interpolatable 2D function, provide isotropic average sigma_iso = (1/3) Tr(sigma)
  • 123.2.2.2 Implement Seebeck coefficient tensor S_ab(T, mu) = (1/(eT)) [L^(1)]_ab / [L^(0)]_ab via matrix inversion of L^(0) and multiplication by L^(1): S = (1/(eT)) (L^0)^{-1} L^1. Handle degenerate cases where L^0 is singular (insulating regime) by returning divergent S with appropriate flag
  • 123.2.2.3 Implement electronic thermal conductivity tensor kappae,ab(T, mu) = (1/T) [L^(2)_ab - L^(1)_ac (L^(0))^{-1}{cd} L^(1)_{db}]: the open-circuit (zero electric current) electronic thermal conductivity, distinct from the short-circuit value L^2/T
  • 123.2.2.4 Implement Lorenz number tensor L_ab(T, mu) = kappa_e,ab / (sigma_ab * T): compute deviation from Sommerfeld value L_0 = (pi^2/3)(k_B/e)^2 = 2.44e-8 W*Ohm/K^2, identify non-degenerate regimes where Wiedemann-Franz law breaks down
  • 123.2.2.5 Implement power factor tensor PF_ab(T, mu) = S_ac _ S_cb _ sigma_ab (or in isotropic case PF = S^2 * sigma): key thermoelectric performance metric in W/(m*K^2), compute optimal mu(T) that maximizes PF at each temperature
  • 123.2.2.6 Implement Hall coefficient R_H(T, mu, B_dir) for cubic systems: R_H = sigma_xy / (sigma_xx _ sigma_yy _ B) from the antisymmetric part of the conductivity tensor in finite magnetic field, using the Boltzmann equation with Lorentz force term. Compute Hall carrier density n_H = 1/(e _ R_H) and Hall mobility mu_H = R_H _ sigma
  • 123.2.2.7 Implement Nernst coefficient Q(T, mu): off-diagonal thermoelectric response (transverse voltage under longitudinal temperature gradient + magnetic field), computed from the Boltzmann equation with magnetic field as Q = (alpha_xy _ sigma_xx - alpha_xx _ sigma_xy) / (sigma_xx^2 + sigma_xy^2) where alpha is the thermoelectric conductivity tensor

123.2.3 Magnetotransport#

  • 123.2.3.1 Implement Boltzmann equation with magnetic field (Rust): solve the linearized BTE with Lorentz force term (e/hbar)(v x B) . dk f_1 = -(f_1 - f_0)/tau using the Jones-Zener expansion in powers of omega_c * tau (cyclotron frequency times relaxation time), retaining terms to arbitrary order for convergence in high-field regime
  • 123.2.3.2 Implement magnetoresistance: longitudinal MR Delta_rho/rho_0 as function of B, distinguishing positive MR (open orbits, multi-band), negative MR (weak localization correction), and saturating MR. Compute MR ratio and classify field dependence (linear, quadratic, non-saturating)
  • 123.2.3.3 Implement magnetoconductivity tensor sigma_ab(B, T, mu): full 3x3 conductivity in finite magnetic field, separating symmetric (longitudinal, diagonal) and antisymmetric (Hall) components, for arbitrary field orientation relative to crystal axes

123.2.4 Scattering Mechanisms#

  • 123.2.4.1 Implement acoustic deformation potential scattering rate (Rust): 1/tau_ADP = (2*pi/hbar) * D_ac^2 _ k_BT / (hbar _ v_s)^2 * DOS(E) for the elastic acoustic phonon scattering in the equipartition approximation, with deformation potential D_ac from DFT band edge shifts under strain and sound velocity v_s from elastic constants
  • 123.2.4.2 Implement polar optical phonon (Fröhlich) scattering rate (Rust): 1/tau_POP = (e^2 * omega_LO / (4piepsilon_0)) * (1/epsilon_inf - 1/epsilon_0) _ [N_BE _ F_abs(E) + (N_BE+1) * F_em(E)] where N_BE is the Bose-Einstein occupation of the LO phonon and F_abs/F_em are the absorption/emission phase space integrals — dominant scattering in polar semiconductors
  • 123.2.4.3 Implement ionized impurity scattering: Brooks-Herring screened Coulomb model 1/tau_BH(E) = (n_i _ Z^2 _ e^4) / (16piepsilon^2 * sqrt(2m) * E^{3/2}) * [ln(1+b) - b/(1+b)] where b = 8mE*lambda_D^2/hbar^2 and lambda_D is the Debye screening length. Also implement Conwell-Weisskopf unscreened variant with cutoff at mean impurity spacing
  • 123.2.4.4 Implement alloy scattering rate: 1/taualloy(E) = (3pi/8) * Omega_0 * x(1-x) * Delta_V^2 * DOS(E) / hbar for a random binary alloy A_x B*{1-x} with unit cell volume Omega_0, composition x, and alloy scattering potential Delta_V (from virtual crystal approximation band offset)
  • 123.2.4.5 Implement grain boundary scattering: Mayadas-Shatzkes model with reflection coefficient R at grain boundaries, grain size d, and relaxation rate 1/tau_GB = v_F _ R / (d _ (1-R)) — relevant for polycrystalline and nanostructured thermoelectrics
  • 123.2.4.6 Implement Matthiessen's rule: 1/tau_total = sum_i 1/tau_i for combining independent scattering mechanisms, with beyond- Matthiessen corrections from inter-mechanism interference computed via coupled Boltzmann equations when scattering rates are comparable
  • 123.2.4.7 Implement energy-dependent relaxation time from electron-phonon coupling (EPW interface): read electron-phonon matrix elements |g*{mn,nu}(k,q)|^2 from EPW output, compute 1/tau_nk = (2*pi/hbar) sum*{m,q,nu} |g|^2 * [(Nq+1-f{mk+q}) delta(Enk - E{mk+q} - hbaromega) + (Nq+f*{mk+q}) delta(Enk - E{mk+q} + hbar*omega)] via dense q-point integration

123.2.5 Mobility and Carrier Concentration#

  • 123.2.5.1 Implement mobility tensor mu_ab(T) = sigma_ab / (n * e) where n is the carrier concentration: compute separately for electrons and holes when both contribute, using band-resolved conductivity and carrier density from the Fermi level and band-resolved DOS integration
  • 123.2.5.2 Implement carrier concentration from Fermi level: n(T, mu) = integral f(E, T, mu) _ DOS_CB(E) dE and p(T, mu) = integral [1-f(E, T, mu)] _ DOS_VB(E) dE, with charge neutrality condition n + N_A^- = p + N_D^+ for doped semiconductors to self-consistently determine mu(T)
  • 123.2.5.3 Implement effective mass extraction from band structure: conductivity effective mass m_c* (from inverse mass tensor averaged over Fermi surface), density-of-states effective mass m_d* (from DOS fitting to parabolic model), and Seebeck effective mass m_S* (from experimental S and n via Pisarenko analysis)

123.2.6 Iterative BTE Solution#

  • 123.2.6.1 Implement iterative Boltzmann transport equation solver (Rust): beyond-RTA solution using the self-consistent iteration f^{(n+1)} = f_0 + tau * [collision_in[f^{(n)}] + driving_term], starting from the RTA solution f^{(1)} and iterating until ||f^{(n+1)} - f^{(n)}|| / ||f^{(n)}|| < tolerance (typically 1e-4). This captures the full angular dependence of scattering including momentum-conserving normal (N) processes
  • 123.2.6.2 Implement variational BTE solver: express f_1 in a basis of trial functions {phi_i(k)} and minimize the variational functional to obtain optimal expansion coefficients — provides rigorous upper bound on resistivity and faster convergence than direct iteration for many systems

123.2.7 External Code Interfaces#

  • 123.2.7.1 Implement BoltzTraP2 input parser: read boltztrap2 output files (.trace, .condtens, .halltens) containing sigma/tau, S, kappa_e/tau, RH on (T, mu) grids, parse into ConductivityTensor, SeebeckTensor, ThermalConductivityTensor, and HallTensor objects. Also read .intrans input and .energy/ .struct files for band structure
  • 123.2.7.2 Implement BoltzWann output parser: read Wannier90 + BoltzWann output files (.boltztrap_BoltzWann) containing transport properties on Wannier-interpolated bands, parse transport tensors with proper unit conversion
  • 123.2.7.3 Implement EPW output parser: read EPW *.el_mob_* and *.prtcl_* files containing electron mobility, scattering rates, and electron-phonon coupling strength lambda(T) from the EPW code, map to internal transport types
  • 123.2.7.4 Implement VASP transport output parser: read VASP OUTCAR with LEPSILON / LOPTICS tags for transport-relevant quantities (effective masses from band curvature, Born effective charges, dielectric tensor), and BoltzTraP-compatible EIGENVAL + POSCAR + KPOINTS for band interpolation input

123.3 Thermoelectric Properties (@kalika/thermoelectric)#

123.3.1 Figure of Merit#

  • 123.3.1.1 Create libs/kalika/thermoelectric/ with standard project scaffolding. Implement thermoelectric figure of merit ZT(T, mu) = S^2 _ sigma _ T / kappa_total where kappa_total = kappa_e(T, mu) + kappa_L(T): combine electronic transport from 123.2 with lattice thermal conductivity from Phase 119, compute ZT on a (T, mu) grid and find optimal (T*, mu*) maximizing ZT
  • 123.3.1.2 Implement ZT optimization by Fermi level tuning: for each temperature, scan mu across the band gap to find optimal doping level n_opt(T) that maximizes ZT, balancing the competing effects of increasing sigma (favors high n) and increasing S (favors low n)
  • 123.3.1.3 Implement thermoelectric efficiency: single-leg efficiency eta = (Delta_T / T_h) * [(1+ZT_avg)^{1/2} - 1] / [(1+ZT_avg)^{1/2} + T_c/T_h] for constant-property model, and cumulative temperature-dependent efficiency using the compatibility factor method for temperature-varying properties

123.3.2 Thermoelectric Analysis#

  • 123.3.2.1 Implement compatibility factor s(T) = (1/T) * [(1+ZT)^{1/2} - 1] / S: the reduced current density that maximizes local efficiency, check if s varies by less than factor of 2 across the operating temperature range (compatibility criterion for segmented devices)
  • 123.3.2.2 Implement Pisarenko relation analysis: plot S vs. n at fixed T and fit to single parabolic band model S = (8pi^2k_B^2T) / (3e*h^2) * m_d* _ (pi/(3n))^{2/3} to extract density-of-states effective mass m_d_. Detect deviations from SPB model indicating multi-band or non-parabolic effects
  • 123.3.2.3 Implement bipolar transport correction: when both electrons and holes contribute (narrow-gap semiconductors at high T), compute total sigma = sigma_e + sigma_h, S = (sigma_e _ S_e + sigma_h _ S_h) / (sigma_e + sigma_h), and bipolar thermal conductivity kappa_bp = sigma_e _ sigma_h / (sigma_e + sigma_h) _ (S_e - S_h)^2 * T that degrades ZT

123.3.3 Band Engineering for Thermoelectrics#

  • 123.3.3.1 Implement band convergence analysis: identify number of degenerate or near-degenerate carrier pockets (valley degeneracy N_v) from the band structure, compute the energy offset between inequivalent band extrema, and predict the effect on power factor via PF proportional to N_v^{2/3} in the multi-valley model
  • 123.3.3.2 Implement effective mass models: (a) single parabolic band (SPB) with constant m*, (b) Kane non-parabolic band E(1 + E/E_g) = hbar^2 k^2 / (2m*) with energy-dependent effective mass, (c) two-band model (conduction + valence) for narrow-gap semiconductors. Derive transport integrals analytically for each model and compare with full numerical BTE results
  • 123.3.3.3 Implement thermoelectric quality factor B: B = (2ek_BT/hbar^3) _ (m_d_ / m_e) _ (C_l / N_v^{2/3}) / (Xi_def^2 _ kappa_L) where C_l is the longitudinal elastic constant, Xi_def is the deformation potential, and N_v is valley degeneracy. B > 1 indicates a promising thermoelectric; rank materials by B
  • 123.3.3.4 Implement optimal band gap analysis: compute ZT_max as a function of band gap E_g at each temperature using the SPB model, confirming the rule of thumb E_g,opt ~ 6-10 k_BT, and identify the crossover temperature where bipolar effects become dominant

123.4 Optical Properties & Dielectric Response (@kalika/optics)#

123.4.1 Project Setup#

  • 123.4.1.1 Create libs/kalika/optics/ with standard project scaffolding. Configure Rust workspace member for compute-intensive BZ integration of optical matrix elements

123.4.2 Independent Particle Dielectric Function#

  • 123.4.2.1 Implement imaginary dielectric function epsilon2(omega) in independent particle (IP) approximation (Rust): epsilon_2,ab(omega) = (4pi^2e^2) / (m^2omega^2V) * sum{c,v,k} |<c,k|p_a|v,k>|^2 * delta(E_ck - E_vk - hbar*omega) using tetrahedron method for the delta function and momentum matrix elements from DFT band structure or Wannier interpolation
  • 123.4.2.2 Implement real dielectric function epsilon_1(omega) from Kramers-Kronig transformation: epsilon_1(omega) = 1 + (2/pi) _ P integral_0^inf omega' _ epsilon_2(omega') / (omega'^2 - omega^2) d omega' using numerical principal-value integration with logarithmic frequency grid and high-energy extrapolation (1/omega^2 tail)
  • 123.4.2.3 Implement scissors operator: apply rigid energy shift Delta to all conduction bands E_ck -> E_ck + Delta to correct the DFT band gap underestimation before computing optical properties, with Delta determined from GW band gap or experimental gap
  • 123.4.2.4 Implement velocity gauge (length gauge) optical matrix elements: position matrix elements r_ab = <c|r|v> = -i*hbar * <c|p|v> / (E_c - E_v) for the length gauge formulation, with proper treatment of degenerate states using the covariant derivative of the cell-periodic Bloch functions
  • 123.4.2.5 Implement intraband (Drude) contribution to dielectric function: epsilonintra(omega) = -omega_p^2 / (omega^2 + igammaomega) where omega_p^2 = (4pie^2/V) sum{n,k} |v*{n,k}|^2 * (-df/dE)|*{E=E_nk} is the plasma frequency tensor and gamma is the broadening (scattering rate), important for metals

123.4.3 Derived Optical Quantities#

  • 123.4.3.1 Implement optical conductivity tensor: sigma_ab(omega) = -iomega * [epsilon_ab(omega) - delta_ab] / (4pi) in Gaussian units, or sigma = -iomegaepsilon_0*[epsilon - 1] in SI. Compute real part Re[sigma] (absorption) and imaginary part (dispersion)
  • 123.4.3.2 Implement absorption coefficient: alpha(omega) = (2omega/c) * Im[sqrt(epsilon(omega))] in cm^{-1}, alternatively alpha = 2omega*k(omega)/c where k is the extinction coefficient. Compute for each polarization direction and powder average
  • 123.4.3.3 Implement reflectivity at normal incidence: R(omega) = |(sqrt(epsilon) - 1) / (sqrt(epsilon) + 1)|^2 for each crystal face, and angle-dependent reflectivity using Fresnel equations for s- and p-polarized light
  • 123.4.3.4 Implement transmittance T(omega) = (1-R)^2 * exp(-alphad) / (1 - R^2exp(-2*alpha*d)) for a slab of thickness d, including multiple internal reflections (Fabry-Perot), and absorbance A = -log10(T)
  • 123.4.3.5 Implement complex refractive index: n(omega) + i*k(omega) = sqrt(epsilon(omega)) where n is the refractive index and k is the extinction coefficient, computed from epsilon_1 and epsilon_2 via n = sqrt((sqrt(eps1^2+eps2^2) + eps1)/2), k = sqrt((sqrt(eps1^2+eps2^2) - eps1)/2)
  • 123.4.3.6 Implement energy loss function: -Im[1/epsilon(omega)] = epsilon_2 / (epsilon_1^2 + epsilon_2^2), peaking at the plasma frequency where epsilon_1(omega_p) = 0, relevant for EELS (electron energy loss spectroscopy) comparison
  • 123.4.3.7 Implement joint density of states: JDOS(omega) = (2/(2pi)^3) * integralBZ sum*{c,v} delta(E_ck - E_vk - hbar*omega) dk using tetrahedron method, providing the purely kinematic (no matrix element) spectral weight for optical transitions
  • 123.4.3.8 Implement optical transition selection rules: for each pair of bands (c,v) at each high-symmetry k-point, determine allowed vs. forbidden transitions from the irreducible representations (from Phase 117 symmetry analysis) and the dipole operator symmetry, report polarization selection rules (x, y, z allowed)

123.4.4 BSE and Excitonic Corrections#

  • 123.4.4.1 Implement BSE optical spectrum interface: import the BSE-corrected optical spectrum from Phase 118 (Bethe-Salpeter equation solution), overlay with IP spectrum to visualize excitonic effects (peak redshift, oscillator strength redistribution, bound exciton peaks below the continuum edge)
  • 123.4.4.2 Implement excitonic binding energy extraction: from the BSE spectrum, identify the lowest bound exciton peak energy E_exc and the quasiparticle gap E_QP, compute binding energy E_b = E_QP - E_exc, and classify as Wannier-Mott (E_b << E_g, hydrogen model) or Frenkel (E_b ~ E_g, localized)

123.4.5 Nonlinear Optical Response#

  • 123.4.5.1 Implement second-harmonic generation (SHG) susceptibility chi^(2)abc(2*omega; omega, omega) (Rust): compute from perturbation theory using three-band terms involving momentum matrix elements and energy denominators: chi^(2) proportional to sum{n,m,l,k} <n|p_a|m><m|p_b|l><l|p_c|n> / [(E_mn - omega)(E_ln - 2*omega)] + permutations, with proper handling of resonances via broadening
  • 123.4.5.2 Implement third-harmonic generation susceptibility chi^(3)_abcd(3*omega; omega, omega, omega): four-band perturbation theory expression with 24 permutation terms, implemented via efficient k-space integration in Rust with OpenMP parallelization over k-points
  • 123.4.5.3 Implement Kerr effect (optical Kerr) from chi^(3): intensity-dependent refractive index n_2 = (3/(4n_0^2epsilon_0*c)) * Re[chi^(3)_xxxx(-omega; omega, -omega, omega)] for self-phase modulation applications
  • 123.4.5.4 Implement shift current (bulk photovoltaic effect): Ja = sigma^shift_abc * E_b * E_c^* where the shift current conductivity sigma^shift involves the Berry connection difference between valence and conduction bands: sigma^shift proportional to integral dk sum{c,v} Im[r^b_{vc} * r^c_{cv,a}] * delta(E_cv - omega) — compute via Wannier interpolation for dense k-mesh integration
  • 123.4.5.5 Implement circular photogalvanic effect (CPGE): injection current J_a = eta^inject_abc _ i(E_b E_c^_ - E_c E_b^*) from the antisymmetric (circular) part of the photoconductivity, involving Berry curvature of bands and interband Berry connection — topologically quantized in Weyl semimetals

123.4.6 IR and Static Dielectric Properties#

  • 123.4.6.1 Implement Born effective charge tensor Z*_{k,ab}: the change in polarization along direction a per displacement of atom k along direction b, read from DFPT calculation (Phase 119) or computed via finite differences of Berry phase polarization. Check acoustic sum rule: sum_k Z*_k = 0
  • 123.4.6.2 Implement static dielectric constant (electronic + ionic): epsilon0,ab = epsilon_inf,ab + (4pi/V) * sum_nu (S_nu,a * S_nu,b) / omega_nu^2 where S_nu is the mode oscillator strength S*{nu,a} = sumk Z*{k,ab} * e_{nu,k,b} / sqrt(M_k) and omega_nu are the phonon frequencies at Gamma
  • 123.4.6.3 Implement IR absorption spectrum: infrared absorption intensity for each phonon mode proportional to |S_nu|^2 / omega_nu, with Lorentzian lineshape broadening, computing epsilon(omega) in the phonon frequency range via the Lyddane-Sachs-Teller relation and the damped oscillator model
  • 123.4.6.4 Implement photoconductivity spectrum: additional contribution to optical conductivity from photoexcited carriers, sigma_photo(omega) = e _ (mu_e + mu_h) _ Delta_n(omega) where Delta_n is the steady-state photocarrier density from generation rate G(omega) = alpha(omega) * I / (hbar*omega) and recombination lifetime tau_rec
  • 123.4.6.5 Implement ellipsometry spectra simulation: compute the ellipsometric parameters Psi(omega) and Delta(omega) for a given surface/thin-film geometry using the transfer matrix method with the computed dielectric function, enabling direct comparison with spectroscopic ellipsometry measurements

123.5 Magnetic Properties (@kalika/magnetism)#

123.5.1 Project Setup#

  • 123.5.1.1 Create libs/kalika/magnetism/ with standard project scaffolding. Configure Rust workspace member for Monte Carlo spin dynamics and exchange coupling extraction

123.5.2 Magnetic Structure Enumeration#

  • 123.5.2.1 Implement collinear magnetic ordering enumeration: given a crystal structure with magnetic atoms, generate all symmetry-distinct collinear spin arrangements (FM, AFM-A, AFM-C, AFM-G, ferrimagnetic) by enumerating spin-up/spin-down assignments on magnetic sublattices, using Polya enumeration to count distinct configurations under the space group and pruning equivalent configurations
  • 123.5.2.2 Implement non-collinear magnetic structure generation: spin spirals with propagation vector q (commensurate and incommensurate), helical (spins in plane perpendicular to q), conical (tilted toward q), cycloidal (spins in plane containing q), and general multi-q structures
  • 123.5.2.3 Implement magnetic ground state search: compare DFT total energies of enumerated magnetic configurations, identify the ground state ordering, compute energy differences per magnetic atom between competing states, and classify the magnetic ground state type

123.5.3 Magnetic Moments#

  • 123.5.3.1 Implement magnetic moment analysis: extract spin magnetic moment m_spin from integrated spin density in atomic spheres, orbital magnetic moment m_orb from SOC calculation, total moment m_total = m_spin + m_orb per atom, and net magnetization M = sum_i m_i per formula unit. Compare with Hund's rule predictions
  • 123.5.3.2 Implement magnetic moment decomposition: separate contributions from different angular momentum channels (s, p, d, f) within each atomic sphere, identify the dominant orbital character of the magnetic moment, and compute the orbital-to-spin ratio m_L/m_S (expected ~0 for 3d, significant for 4f elements)

123.5.4 Exchange Coupling Constants#

  • 123.5.4.1 Implement Jij extraction from total energy mapping: given N magnetic configurations with known spin orientations and their DFT total energies, solve the overdetermined linear system E_config = E_0 - sum{i<j} J_ij S_i . S_j for the exchange constants J_ij using least-squares fitting, automatically selecting the minimal set of J parameters (nearest-neighbor, next-nearest, etc.) via Bayesian information criterion
  • 123.5.4.2 Implement broken symmetry approach for J extraction in molecular magnets and dilute systems: compute J from the energy difference between high-spin and broken-symmetry states using the Yamaguchi formula J = (E_HS - E_BS) / (S_HS^2 - S_BS^2) with proper handling of spin contamination
  • 123.5.4.3 Implement Green's function method for Jij (Liechtenstein formula): J_ij = (1/(4*pi)) Im integral{-inf}^{E_F} Tr[Delta_i * G_ij^up * Delta_j * G_ji^down] dE where Delta_i is the exchange splitting at site i and G^{up/down} are spin-resolved Green's functions — requires KKR or LMTO Green's function from electronic structure
  • 123.5.4.4 Implement magnetic force theorem for J_ij: compute exchange constants from the change in band energy under infinitesimal spin rotations at sites i and j, without requiring multiple self-consistent calculations — faster than total energy mapping but less accurate for large moment rotations
  • 123.5.4.5 Implement Heisenberg Hamiltonian construction: H = -sum_{i<j} J_ij S_i . S_j - sum_i K_i (S_i . e_i)^2 - sum_i mu_i . B_ext with exchange coupling J_ij from 123.5.4.1-4, single-ion anisotropy K_i from 123.5.7, and external field B_ext. Store as sparse neighbor list with cutoff radius

123.5.5 Curie/Neel Temperature#

  • 123.5.5.1 Implement mean-field Curie temperature: kB * T_C^MF = (2/3) * sum_j J{0j} * S(S+1) for ferromagnets, and mean-field Neel temperature from the eigenvalues of the J matrix between sublattices. Apply standard mean-field correction factor (T_C^MC / T_C^MF from known lattice models) for improved estimates
  • 123.5.5.2 Implement classical Heisenberg Monte Carlo simulation (Rust): Metropolis algorithm on the Heisenberg model with exchange couplings J_ij from DFT, using parallel tempering (replica exchange) across temperatures from 0.1T_C^MF to 3T_C^MF. Extract T_C/T_N from the peak in specific heat C(T) = (1/k_BT^2) * [<E^2> - <E>^2] and the inflection point of M(T)
  • 123.5.5.3 Implement Monte Carlo observables: magnetization M(T) = |sum_i S_i| / N, staggered magnetization (AFM order parameter), magnetic susceptibility chi(T) = (1/k_BT) _ [<M^2> - <M>^2], Binder cumulant U_4 = 1 - <M^4>/(3_<M^2>^2) for finite-size scaling, and autocorrelation time estimation for error analysis
  • 123.5.5.4 Implement finite-size scaling: run MC simulations on L x L x L supercells with multiple L values, determine T_C from Binder cumulant crossing, extract critical exponents (beta, gamma, nu) from scaling collapse M*L^{beta/nu} vs. (T-T_C)*L^{1/nu}, and extrapolate to thermodynamic limit L -> inf

123.5.6 Spin Wave Theory#

  • 123.5.6.1 Implement linear spin wave theory (LSWT) for magnon dispersion: Holstein-Primakoff transformation of the Heisenberg Hamiltonian, Fourier transform to k-space, diagonalize the quadratic boson Hamiltonian via Bogoliubov transformation (for FM) or generalized Bogoliubov for multi-sublattice systems, yielding magnon frequencies omega_nu(q) and eigenvectors
  • 123.5.6.2 Implement magnon density of states: g_mag(omega) = sum_nu integral_BZ delta(omega - omega_nu(q)) dq / V_BZ using tetrahedron integration, and thermal magnon occupation <n_q> = 1/[exp(hbar*omega_q/(k_BT)) - 1]
  • 123.5.6.3 Implement spin stiffness constant D: from the quadratic dispersion omega(q) = Dq^2 + O(q^4) near the zone center (FM case), D = 2SJ_effa^2 / hbar where J_eff is the effective exchange summed over neighbor shells. The stiffness D is measurable by neutron scattering and determines low-T magnetization via Bloch's T^{3/2} law

123.5.7 Magnetic Anisotropy#

  • 123.5.7.1 Implement magnetocrystalline anisotropy energy (MAE) from DFT+SOC: compute total energy difference between spin aligned along easy axis vs. hard axis using the force theorem (band energy difference) or total energy difference with spin-orbit coupling included self-consistently. Extract anisotropy constants K_1, K_2 by fitting E(theta, phi) to symmetry-adapted anisotropy expansion
  • 123.5.7.2 Implement shape anisotropy: demagnetizing energy E_demag = (mu_0/2) * M . N . M where N is the demagnetizing tensor (depends on sample geometry: N_z = 1 for thin film, N = 1/3 for sphere), competing with magnetocrystalline anisotropy to determine the net easy axis
  • 123.5.7.3 Implement magnetic anisotropy decomposition: separate MAE into spin-orbit coupling (SOC) and dipole-dipole contributions, identify the dominant angular momentum channels contributing to the SOC anisotropy via second-order perturbation theory analysis: EMAE proportional to sum{occ,unocc} |<occ|L.S|unocc>|^2 / (E_unocc - E_occ)

123.5.8 Magnetic Susceptibility and M(H) Curves#

  • 123.5.8.1 Implement magnetic susceptibility chi(T): compute from Monte Carlo simulation chi = (dM/dH)|_{H->0} = (1/k_BT) * [<M^2> - <M>^2] and fit to Curie-Weiss law chi = C / (T - Theta_CW) to extract Curie constant C and Weiss temperature Theta_CW. Report effective magnetic moment mu_eff = sqrt(3k_BC / (N*mu_B^2))
  • 123.5.8.2 Implement magnetization curves M(H, T): Monte Carlo simulation of Heisenberg model with external field, sweeping H from -H_max to +H_max at fixed T to obtain hysteresis loop. Extract coercive field H_c, remnant magnetization M_r, and saturation magnetization M_s

123.5.9 Advanced Magnetic Interactions#

  • 123.5.9.1 Implement Dzyaloshinskii-Moriya interaction (DMI) from DFT: extract antisymmetric exchange vectors D_ij from the energy of spin spirals with SOC (computing E(q) for spirals propagating in different directions, the antisymmetric component reveals D_ij), or from the Liechtenstein formula generalized to include SOC. D_ij determines sense of spin chirality and stabilizes skyrmions
  • 123.5.9.2 Implement spin-orbit torque from band structure: compute the current-induced effective field (anti-damping and field-like torques) from the Berry phase theory of spin transport, relevant for SOT-MRAM devices
  • 123.5.9.3 Implement magnetic domain wall energy: from the exchange stiffness A = sumj J{0j} _ S^2 _ r_j^2 / (6V_cell) and anisotropy K, compute domain wall width delta = pisqrt(A/K) and domain wall energy sigma_DW = 4sqrt(AK) per unit area
  • 123.5.9.4 Implement magnetocaloric effect: compute isothermal entropy change Delta_S_m(T, Delta_H) = integral_0^H (dM/dT)_H dH from Monte Carlo M(T, H) data, and adiabatic temperature change Delta_T_ad = -T * Delta_S_m / C_p relevant for magnetic refrigeration applications

123.5.10 Magnetic Phase Diagrams#

  • 123.5.10.1 Implement magnetic phase diagram construction: systematically vary temperature T and magnetic field H (or other control parameters like pressure, composition), run MC simulations at each (T, H) point, identify phase boundaries from order parameter discontinuities (first-order) or divergent susceptibility (second-order), and produce 2D phase diagrams with labeled regions (FM, AFM, PM, spin-flop, spin-flip, canted, etc.)

123.5.11 External Code Interfaces#

  • 123.5.11.1 Implement VAMPIRE input/output interface: generate VAMPIRE (atomistic spin dynamics) input files (material file with J_ij, K, mu_s from DFT calculations, unit cell file, input control file), parse VAMPIRE output (M(T), M(H), time-dependent magnetization), and map to internal MagneticStructure and analysis types
  • 123.5.11.2 Implement Spirit interface: generate Spirit (spin dynamics) configuration from DFT-derived Heisenberg parameters, including exchange J_ij, DMI D_ij, and anisotropy K for spin dynamics simulations of skyrmions, domain walls, and spin waves

123.6 Spintronics (@kalika/spintronics)#

123.6.1 Project Setup#

  • 123.6.1.1 Create libs/kalika/spintronics/ with standard project scaffolding

123.6.2 Spin Hall and Anomalous Hall Effects#

  • 123.6.2.1 Implement spin Hall conductivity sigma^SHij (Rust): Kubo formula sigma^SH_xy = (e/V) sum{n!=m,k} 2 _ Im[<n,k|j^z_x|m,k> _ <m,k|v_y|n,k>] * (f_nk - f_mk) / (E_nk - E_mk)^2 where j^z_x = (1/2){s_z, v_x} is the spin current operator — compute via dense k-mesh integration with adaptive refinement near degeneracies
  • 123.6.2.2 Implement anomalous Hall conductivity (intrinsic): sigma^AH_xy = -(e^2/hbar) _ (1/V_BZ) _ integral_BZ sum_n f_nk * Omega^z_n(k) dk where Omega^z_n is the Berry curvature of band n, computed via the Kubo formula with SOC band structure. Distinguish intrinsic (Berry curvature), side-jump, and skew-scattering contributions
  • 123.6.2.3 Implement Berry curvature computation (Rust): for each band n at each k-point, compute Omegan^c(k) = -2 * sum{m!=n} Im[<n,k|v_a|m,k> * <m,k|v_b|n,k>] / (E_nk - E_mk)^2 using the Kubo formula, or equivalently from the U(1) gauge field on a discretized k-mesh (Fukui-Hatsugai-Suzuki method) for topological robustness
  • 123.6.2.4 Implement anomalous Nernst effect: transverse thermoelectric response in magnetic materials, alpha_xy^ANE = -(1/T) _ integral sigma_xy(E) _ (E - mu) * (-df/dE) dE, related to the Berry curvature at the Fermi level via Mott relation

123.6.3 Spin-Orbit Effects#

  • 123.6.3.1 Implement Rashba spin splitting analysis: for surfaces or heterostructures with broken inversion symmetry, extract the Rashba parameter alphaR from the band structure splitting E+/-(k) = hbar^2k^2/(2m*) +/- alpha_R * |k|, by fitting the spin-split bands near the crossing point. Compute the Rashba energy E_R = m* * alpha_R^2 / (2*hbar^2) and momentum offset k_R
  • 123.6.3.2 Implement Dresselhaus spin splitting analysis: for bulk zinc-blende structures lacking inversion symmetry, extract the Dresselhaus parameter beta from the cubic spin splitting H_D = beta _ [k_x(k_y^2 - k_z^2) sigma_x + cyclic], and the linear Dresselhaus term for 2D quantum wells H_D^2D = beta_1 _ (k_x sigma_x - k_y sigma_y)
  • 123.6.3.3 Implement spin texture computation: for each band at each k-point on the Fermi surface (or constant-energy contour), compute the spin expectation value <S>(k) = <psi_nk|sigma|psi_nk> / 2 where sigma is the vector of Pauli matrices, and visualize the spin texture as arrows on the Fermi surface showing spin-momentum locking

123.6.4 Spin Relaxation#

  • 123.6.4.1 Implement Elliott-Yafet spin relaxation rate: 1/T_1^EY = A_EY _ (Delta_SO / E_F)^2 _ (1/tau_p) where Delta_SO is the spin-orbit splitting of bands, tau_p is the momentum scattering time, and A_EY depends on the spin mixing of Bloch states — dominant in centrosymmetric metals and high-Z materials
  • 123.6.4.2 Implement D'yakonov-Perel spin relaxation rate: 1/T_1^DP = alpha_R^2 * (2m/(hbar^3))^2 * tau_p * k_BT for the Rashba case — dominant in non-centrosymmetric semiconductors where the spin precession between scattering events causes dephasing. Rate increases with mobility (opposite to EY)
  • 123.6.4.3 Implement spin lifetime comparison: compute both EY and DP contributions, identify the dominant mechanism based on symmetry and temperature regime, and report total spin relaxation time T_1 and spin diffusion length l_s = sqrt(D * T_1) where D is the charge diffusion constant

123.6.5 Magnetoresistance Devices#

  • 123.6.5.1 Implement tunneling magnetoresistance (TMR) model: Julliere model TMR = 2P_1P_2 / (1 - P_1*P_2) where P_i is the spin polarization of electrode i, and Slonczewski model with barrier-height-dependent TMR for realistic MgO-based magnetic tunnel junctions. Compute spin polarization from the DOS at Fermi level: P = (DOS_up - DOS_down) / (DOS_up + DOS_down)
  • 123.6.5.2 Implement giant magnetoresistance (GMR) model: Valet-Fert model for current-perpendicular-to-plane (CPP) GMR using spin-dependent resistivities rho_up/rho_down and spin diffusion lengths l_sf from the bulk and interface, solving the spin-diffusion equation for multilayer geometry
  • 123.6.5.3 Implement spin Seebeck effect: compute the spin Seebeck coefficient S_s = sigma_s / sigma from the ratio of spin conductivity to charge conductivity, relevant for spin caloritronics in FM/NM bilayers
  • 123.6.5.4 Implement spin-transfer torque: compute the current-induced torque on a free layer magnetization from spin angular momentum transfer, T_STT = (hbar/(2*e)) * (I/A) _ P _ m_free x (m_free x m_fixed) for the Slonczewski torque term, determining the critical current for magnetization switching
  • 123.6.5.5 Implement half-metallicity detection: analyze the spin-resolved DOS at the Fermi level — if one spin channel has zero DOS (gap at E_F) while the other has finite DOS, the material is half-metallic with 100% spin polarization. Compute the half-metallic gap (minority spin gap around E_F)
  • 123.6.5.6 Implement magnetic tunnel junction (MTJ) transport: compute conductance G_P (parallel) and G_AP (antiparallel) from the spin-resolved transmission function using the Landauer-Büttiker formalism with Green's function method for the electrode/barrier/electrode geometry, yielding TMR = (G_P - G_AP)/G_AP

123.7 Topological Materials (@kalika/topology-materials)#

123.7.1 Project Setup#

  • 123.7.1.1 Create libs/kalika/topology-materials/ with standard project scaffolding. Configure Rust workspace member for Wilson loop and Berry phase computations requiring high numerical precision

123.7.2 Z2 Topological Invariant#

  • 123.7.2.1 Implement Z2 invariant from parity analysis (Fu-Kane formula): nu0 = product{i=1}^{8} deltai (mod 2) where delta_i = product{m=1}^{Nocc} xi{2m}(TRIM_i) is the product of parity eigenvalues of occupied Kramers pairs at each of the 8 time-reversal invariant momentum (TRIM) points in 3D — requires inversion symmetry. Also compute weak indices (nu_1, nu_2, nu_3) from parity products on TRIM planes
  • 123.7.2.2 Implement Z2 invariant from Wilson loop / hybrid Wannier charge centers (Rust): for each k3 value, compute the Wilson loop matrix W(k_3) = product{k_1} P(k_1, k_3) where P is the projection onto occupied bands, diagonalize to obtain hybrid Wannier charge centers theta_n(k_3), and determine Z2 from the partner switching of theta_n(k_3) as k_3 traverses half the BZ — works for all systems regardless of symmetry
  • 123.7.2.3 Implement Z2 from Pfaffian method: at each TRIM point, compute the Pfaffian of the sewing matrix w_{mn}(k) = <u_m(-k)|T|u_n(k)> where T is the time-reversal operator, delta_i = Pf[w(TRIM_i)] / sqrt(det[w(TRIM_i)]) = +/-1, and nu_0 = product delta_i — most general method, needed when Wilson loop has convergence issues

123.7.3 Chern Number#

  • 123.7.3.1 Implement Chern number from Berry curvature integration (Rust): C_n = (1/(2pi)) * integral_BZ Omega_n(k) dk_x dk_y for each band n on a 2D BZ (or a fixed-k_z slice in 3D), using the Fukui-Hatsugai-Suzuki discretization C = (1/(2pi)) * sum_plaquettes Im[ln(U_12 * U_23 * U_34 * U_41)] where U_ij = det(<u_m(k_i)|u_n(k_j)>) / |det(...)| are the discretized link variables — guarantees integer Chern number by construction
  • 123.7.3.2 Implement mirror Chern number: for crystals with a mirror symmetry M, decompose the occupied bands into mirror eigenvalue sectors (+i and -i), compute the Chern number C*+ and C*- for each sector on the mirror-invariant plane, and obtain the mirror Chern number nM = (C+ - C_-) / 2 — classifies topological crystalline insulators (e.g., SnTe class)
  • 123.7.3.3 Implement higher-order topological invariants: for systems with C_n rotation symmetry, compute the fractional corner charge from the bulk polarization and the nested Wilson loop spectrum — identifies higher-order TIs with hinge or corner states instead of surface states

123.7.4 Topological Insulator Identification#

  • 123.7.4.1 Implement band inversion analysis: compare the orbital character of valence band maximum (VBM) and conduction band minimum (CBM) at TRIM points between the real material and its atomic limit (or a reference trivial system). Band inversion occurs when the orbital character swaps relative to the atomic limit — the hallmark of topological insulators
  • 123.7.4.2 Implement topological insulator identification pipeline: (1) compute band structure with SOC, (2) check for inverted band gap at any TRIM point, (3) compute Z2 invariants via parity or Wilson loop, (4) classify as trivial (0;000), strong TI (1;*), or weak TI (0; non-zero), (5) report the inverted gap size and surface state Dirac point location

123.7.5 Topological Semimetal Identification#

  • 123.7.5.1 Implement Dirac semimetal detection: search for 4-fold degenerate band crossings (Dirac points) along high-symmetry lines or at high-symmetry points, protected by crystal symmetry + time reversal. Verify the linear dispersion (massless Dirac fermion) by computing the Fermi velocity v_F = (1/hbar) * dE/dk at the crossing and the symmetry representations of the crossing bands
  • 123.7.5.2 Implement Weyl semimetal detection: search for 2-fold degenerate band crossings (Weyl points) in systems lacking either time-reversal or inversion symmetry. For each Weyl point, compute the chirality chi = sgn[det(dH/dk)] = +/-1 from the Berry flux through a small sphere enclosing the point. Verify that Weyl points come in pairs of opposite chirality (Nielsen-Ninomiya theorem)
  • 123.7.5.3 Implement nodal line semimetal detection: search for 1-dimensional line degeneracies in the BZ where two bands cross, forming a closed loop or extended line. Compute the Berry phase around the nodal line (should be pi for symmetry-protected nodal lines) and the drumhead surface states
  • 123.7.5.4 Implement triple-point fermion detection: search for 3-fold band degeneracies (triple points) at high-symmetry points in non-symmorphic space groups, with one linear and one quadratic band dispersion. Identify the relevant irreducible representations forming the triple crossing

123.7.6 Surface States#

  • 123.7.6.1 Implement surface Green's function (iterative method, Rust): compute the surface spectral function A_surf(k_parallel, E) = -(1/pi) Im Tr[G_surf(k_parallel, E)] using the iterative (recursive) surface Green's function method: construct the principal layer Hamiltonian H_00, H_01 from the Wannier Hamiltonian, and iterate G_s = [(E+i*eta)*I - H_00 - H_01^dagger * G_s * H_01]^{-1} until convergence — the Sancho-Rubio algorithm
  • 123.7.6.2 Implement topological surface state visualization: compute the surface spectral function on a fine (k_x, k_y, E) grid, identify the Dirac cone of the topological surface state (linear dispersion, spin-momentum locked), extract the Dirac point energy, Fermi velocity, and spin texture of the surface state
  • 123.7.6.3 Implement Fermi arc computation for Weyl semimetals: compute the surface Fermi surface (constant E = E_F contours of the surface spectral function) and identify Fermi arcs connecting projections of Weyl points of opposite chirality. Verify arc connectivity and chirality matching
  • 123.7.6.4 Implement slab band structure: for explicit surface state computation, construct a slab geometry (N layers of the material with vacuum), compute the band structure k_parallel vs. E, and identify surface-localized states by their wavefunction decay into the bulk (inverse participation ratio or layer projection)

123.7.7 Symmetry-Based Topological Classification#

  • 123.7.7.1 Implement symmetry indicator method: compute the symmetry eigenvalues (irreducible representations) of all occupied bands at all high-symmetry k-points, form the symmetry indicator group Z_2 x Z_4 x ... (depending on space group), and classify the topological phase from the symmetry data alone — matching the Topological Quantum Chemistry (TQC) approach of Bradlyn et al.
  • 123.7.7.2 Implement compatibility relations: check that the irreducible representations at connected high-symmetry points are compatible (i.e., the bands can be smoothly connected without additional crossings). Incompatibility indicates topologically enforced band crossings (symmetry-enforced semimetal)
  • 123.7.7.3 Implement band representation (BANDREP) analysis: given the Wyckoff positions of atoms and their orbital types, construct the elementary band representations (EBRs) from the BANDREP database, express the occupied bands as a linear combination of EBRs, and classify as trivial (positive integer decomposition exists) or topological (fragile or stable, depending on the decomposition)
  • 123.7.7.4 Implement topological classification from space group: for each of the 230 space groups (with and without time reversal, with and without SOC), look up the possible topological phases from the TQC classification tables, and determine which phase the material realizes from its symmetry data

123.7.8 Advanced Topological Phases#

  • 123.7.8.1 Implement axion insulator identification: detect the axion insulator phase (theta = pi quantized magnetoelectric response) from the Z2 invariant + broken time reversal — requires antiferromagnetic TI with surface gap. Compute the magnetoelectric coupling alpha_ME = (e^2/(2pih)) * theta from the Chern-Simons 3-form
  • 123.7.8.2 Implement higher-order topological insulator (HOTI) identification: detect hinge states (1D conducting channels on crystal hinges) and corner states (0D bound states at corners) from the nested Wilson loop spectrum or the filling anomaly — the bulk is gapped, surfaces are gapped, but hinges/corners host protected states
  • 123.7.8.3 Implement Wannier charge center evolution visualization: plot the hybrid Wannier charge centers theta_n(k) as a function of k across the BZ, with Z2 = 1 indicated by an odd number of partner switchings (Wilson loop winding) — the standard visual diagnostic for topological insulators
  • 123.7.8.4 Implement topological superconductor identification: for superconducting materials, compute the BdG (Bogoliubov-de Gennes) band structure with particle-hole symmetry, determine the topological class from the Altland-Zirnbauer classification (class D, DIII, etc.), and compute the relevant Z or Z2 invariant

123.7.9 External Code Interfaces#

  • 123.7.9.1 Implement Z2Pack interface: generate Z2Pack input files (specifying the BZ surface, k-mesh, and band range for Wilson loop computation), parse Z2Pack output (Wannier charge centers, Z2 invariant), and map to internal TopologicalInvariant type
  • 123.7.9.2 Implement WannierTools interface: generate WannierTools input file (wt.in) from the Wannier Hamiltonian, specifying calculations (surface states, Fermi arcs, Z2, Chern number, Weyl point search), parse output files (arc.dat, surfdos.dat, z2.dat), and map to internal types

123.8 Piezoelectric & Ferroelectric Properties (@kalika/piezoelectric)#

123.8.1 Project Setup#

  • 123.8.1.1 Create libs/kalika/piezoelectric/ with standard project scaffolding

123.8.2 Piezoelectric Tensor#

  • 123.8.2.1 Implement piezoelectric stress tensor eijk computation from DFPT: e{i,ab} = dP_i / d(epsilon_ab) = (1/V) _ sum_k,n f_nk _ d<psi_nk|/d(epsilon_ab) _ (dH/d(E_i)) _ |psi_nk> where epsilon_ab is the strain and E_i is the electric field direction — read from DFPT output (VASP PIEZOELECTRIC, QE response functions) or compute via finite differences of Berry phase polarization under strain
  • 123.8.2.2 Implement piezoelectric strain tensor dijk: d{i,ab} = sumc e{i,ac} * S_{cb,ab} where S is the elastic compliance tensor from 123.9 — converts between the stress-convention (e) and strain-convention (d) piezoelectric response. Compute in Voigt notation d_ij (3x6 matrix)
  • 123.8.2.3 Implement piezoelectric symmetry analysis: for each of the 21 non-centrosymmetric crystal classes (centrosymmetric classes have zero piezoelectric response by symmetry), determine the independent components of d_ij from the point group symmetry constraints, reducing the 18 independent components to as few as 1 (class 432)
  • 123.8.2.4 Implement piezoelectric property figures of merit: electromechanical coupling coefficient k_33 = d_33 / sqrt(S_33 _ epsilon_33), piezoelectric voltage constant g_ij = d_ij / epsilon_0 _ epsilon_r, and energy harvesting figure of merit d * g

123.8.3 Berry Phase Polarization#

  • 123.8.3.1 Implement spontaneous polarization via Berry phase (King- Smith-Vanderbilt): Pi = (e/(2pi)) * sum_n integral_BZ <u_nk|d/dk_i|u_nk> dk = (e/(2pi)) * sum_n phi_n^Berry where phi_n^Berry is the Zak phase of band n along direction i. Compute as a string of k-points parallel to the reciprocal lattice vector, with the Zak phase from the product of overlap matrices phi = Im ln det product_j <u(k_j)|u(k{j+1})>
  • 123.8.3.2 Implement polarization quantum: P is defined modulo the polarization quantum P_q = e*R/V (where R is a lattice vector and V is the cell volume), so the absolute polarization is determined by the branch choice. Compute the polarization difference Delta_P between the ferroelectric and centrosymmetric reference structures by adiabatic interpolation along the switching path
  • 123.8.3.3 Implement modern theory of polarization validation: compute P for a sequence of structures interpolating between the paraelectric (centrosymmetric) and ferroelectric phases, verify that Delta_P = P_FE - P_PE is continuous and matches the experimental switchable polarization 2*P_s
  • 123.8.3.4 Implement ferroelectric switching path analysis: compute the total energy and polarization along the minimum energy path (nudged elastic band or linear interpolation) between the two symmetry-equivalent ferroelectric minima through the paraelectric saddle point — yielding the double-well potential depth (switching barrier) and spontaneous polarization

123.8.4 Advanced Ferroelectric Properties#

  • 123.8.4.1 Implement pyroelectric coefficient: p_i = dP_i / dT from the temperature dependence of the spontaneous polarization, computed via Berry phase at thermally expanded lattice parameters (QHA from Phase 119) or from the change in Born effective charges with temperature
  • 123.8.4.2 Implement ferroelectric domain wall energy: compute the energy per unit area of 180-degree and non-180-degree domain walls from DFT supercell calculations with imposed boundary conditions, or estimate from Ginzburg-Landau theory with the double-well potential and gradient coefficient
  • 123.8.4.3 Implement electrostriction tensor Q_ijkl: the quadratic coupling between strain and electric field, epsilon_ij = Q_ijkl _ P_k _ P_l, computed from the strain response to electric field at second order in perturbation theory or from finite-difference calculations
  • 123.8.4.4 Implement flexoelectric tensor mu_ijkl: the coupling between polarization and strain gradient, P_i = mu_ijkl * (d epsilon_jk / d x_l), computed from the response to inhomogeneous strain (phonon-strain coupling) — important for thin films and nanostructures where strain gradients are large
  • 123.8.4.5 Implement improper ferroelectricity detection: identify materials where the polarization is a secondary order parameter coupled to a primary non-polar structural distortion (e.g., octahedral rotations in hexagonal manganites, charge ordering in magnetite) — polarization arises from symmetry-allowed coupling rather than zone-center polar instability

123.9 Elastic & Mechanical Properties (@kalika/elastic)#

123.9.1 Project Setup#

  • 123.9.1.1 Create libs/kalika/elastic/ with standard project scaffolding

123.9.2 Elastic Constants Tensor#

  • 123.9.2.1 Implement elastic constants from stress-strain method: apply a set of symmetry-adapted finite strains (epsilon_1, ..., epsilon_6 in Voigt notation) to the crystal, compute the resulting stress tensor sigma_ij from DFT, and extract C_ij = d(sigma_i) / d(epsilon_j) from linear regression of stress vs. strain at multiple strain magnitudes (typically +/-0.5%, +/-1%, +/-1.5%)
  • 123.9.2.2 Implement elastic constants from energy-strain method: apply finite strains and fit the total energy E(epsilon) to a polynomial E = V0 * [sum{ij} (1/2) Cij epsilon_i epsilon_j + sum{ijk} (1/6) C_ijk epsilon_i epsilon_j epsilon_k + ...], extract C_ij from the quadratic coefficients — more robust than stress-strain for noisy energy calculations, but requires more strain points
  • 123.9.2.3 Implement symmetry-adapted strain sets: for each of the 7 crystal systems, generate the minimal set of independent strain deformations needed to determine all independent elastic constants (3 for cubic, 5 for hexagonal, 6 for tetragonal-4mm, 7 for trigonal-3m, 9 for orthorhombic, 13 for monoclinic, 21 for triclinic)
  • 123.9.2.4 Implement elastic tensor symmetry enforcement: project the raw computed C_ij onto the space of tensors consistent with the crystal point group symmetry, averaging components that should be equal by symmetry and zeroing components that should vanish

123.9.3 Derived Elastic Moduli#

  • 123.9.3.1 Implement Voigt-Reuss-Hill averaging for polycrystalline moduli: Voigt (upper bound) B_V = (1/9)(C_11+C_22+C_33) + (2/9)(C_12+C_13+C_23), Reuss (lower bound) from compliance tensor B_R = 1 / [S_11+S_22+S_33 + 2(S_12+S_13+S_23)], Hill average B_H = (B_V + B_R) / 2. Similarly for shear modulus G_V, G_R, G_H
  • 123.9.3.2 Implement Young's modulus E = 9BG / (3B + G) and Poisson ratio nu = (3B - 2G) / (2(3*B + G)) from B and G. Also compute direction-dependent Young's modulus E(n) from the compliance tensor E^{-1}(n) = n_i n_j n_k n_l * S_ijkl for anisotropy visualization
  • 123.9.3.3 Implement anisotropy indices: Zener anisotropy ratio A_Z = 2C_44 / (C_11 - C_12) for cubic systems (A_Z = 1 for isotropic), universal anisotropy index A_U = 5(G_V/G_R) + (B_V/B_R) - 6 (A_U = 0 for isotropic, applicable to all crystal systems), and log-Euclidean anisotropy from the elastic tensor eigenvalues
  • 123.9.3.4 Implement ductility/brittleness classification: Cauchy pressure C_12 - C_44 (positive → ductile, negative → brittle for cubic), Pugh ratio B/G (> 1.75 → ductile, < 1.75 → brittle), Pettifor criterion, and Poisson ratio (> 0.26 → ductile)

123.9.4 Hardness and Strength#

  • 123.9.4.1 Implement Vickers hardness models: (a) Chen model H_V = 2*(k^2G)^{0.585} - 3 where k = G/B, (b) Tian model H_V = 0.92(B/G)^{1.137} * G^{0.708}, (c) Mazhnik-Oganov model using shear modulus and Poisson ratio, and (d) bond-based models (Gao, Simunek) for covalent materials using bond strengths and coordination numbers
  • 123.9.4.2 Implement fracture toughness estimation: Griffith criterion K_IC = sqrt(2Egamma_s) where gamma_s is the surface energy (from DFT slab calculations or estimated from elastic properties), and Rice-Thomson analysis for dislocation emission vs. cleavage
  • 123.9.4.3 Implement ideal strength: compute the maximum stress under uniaxial tension/compression and shear by applying progressively larger strains until the stress reaches a maximum (the inflection point of E(epsilon)), identifying the ideal tensile/shear strength and the strain at failure

123.9.5 Elastic Stability and Wave Velocities#

  • 123.9.5.1 Implement Born mechanical stability criteria: check that the elastic tensor C_ij is positive definite (all eigenvalues > 0), implementing the specific algebraic conditions for each crystal system (e.g., cubic: C_11 > 0, C_44 > 0, C_11 > |C_12|, C_11 + 2*C_12 > 0)
  • 123.9.5.2 Implement elastic wave velocities from Christoffel equation: for each propagation direction n, solve det|C_ijkl _ n_j _ n_l - rho _ v^2 _ delta_ik| = 0 for the three eigenvalues v_1^2, v_2^2, v_3^2 (one quasi-longitudinal, two quasi-transverse) and eigenvectors (polarization directions)
  • 123.9.5.3 Implement sound velocities: longitudinal v_L = sqrt((B + 4G/3) / rho), transverse v_T = sqrt(G / rho), and mean sound velocity v_m = [(1/3)(2/v_T^3 + 1/v_L^3)]^{-1/3} from polycrystalline elastic moduli and density rho
  • 123.9.5.4 Implement Debye temperature from elastic constants: Theta_D = (h/k_B) * [3N/(4pi*V)]^{1/3} * v_m where N is the number of atoms per cell and V is the cell volume, providing an independent estimate complementing the phonon-derived Debye temperature from Phase 119
  • 123.9.5.5 Implement pressure-dependent elastic constants: compute C_ij(P) at multiple pressures (applying hydrostatic strain), extract dC_ij/dP, predict pressure-induced mechanical instability (phase transition) when a Born criterion is first violated, and compute the pressure-dependent elastic moduli B(P), G(P)

123.9.6 External Code Interfaces#

  • 123.9.6.1 Implement ElaStic/VASP input/output parser: generate ElaStic-compatible strain deformation directories (POSCAR files with applied strains), parse VASP OUTCAR stress tensors from strained calculations, and extract C_ij via linear regression matching the ElaStic workflow
  • 123.9.6.2 Implement MechElastic interface: read and write in MechElastic-compatible format (elastic tensor in Voigt notation), invoke MechElastic analysis routines for cross-validation of derived moduli, stability criteria, and hardness models

123.10 Thermal Properties (@kalika/thermal-properties)#

123.10.1 Project Setup#

  • 123.10.1.1 Create libs/kalika/thermal-properties/ with standard project scaffolding

123.10.2 Specific Heat#

  • 123.10.2.1 Implement lattice specific heat C_v^lat(T) from phonon DOS integration: C_v = integral g(omega) _ c_BE(omega, T) d(omega) where c_BE = k_B _ (hbaromega/(k_BT))^2 * exp(hbaromega/(k_BT)) / [exp(hbar*omega/(k_BT)) - 1]^2 is the Einstein mode contribution — reads phonon DOS from Phase 119
  • 123.10.2.2 Implement electronic specific heat C_v^el(T): Sommerfeld expansion C_v^el = gamma _ T where gamma = (pi^2 / 3) _ k_B^2 * DOS(E_F) is the Sommerfeld coefficient, with higher-order corrections from the energy dependence of the DOS near E_F. For semiconductors, compute from Fermi-Dirac weighted DOS integration
  • 123.10.2.3 Implement total specific heat C_v(T) = C_v^lat + C_v^el + C_v^mag (where C_v^mag is the magnetic contribution from 123.5 Monte Carlo) and C_p(T) = C_v + alpha^2 _ V _ B * T where alpha is the thermal expansion coefficient, V the molar volume, and B the bulk modulus (the C_p - C_v correction)
  • 123.10.2.4 Implement Debye model specific heat: C_v^Debye(T) = 9Nk_B _ (T/Theta_D)^3 _ integral_0^{Theta_D/T} x^4 * e^x / (e^x - 1)^2 dx using numerical quadrature, with Theta_D from elastic constants (123.9) or phonon DOS (Phase 119). Compare with the full phonon DOS result to assess the Debye approximation validity

123.10.3 Thermal Expansion#

  • 123.10.3.1 Implement thermal expansion coefficient alpha(T) from quasiharmonic approximation (Phase 119 integration): alphaab(T) = (1/V) * sum{ij} S*{ab,ij} * sum*{q,nu} gamma*{q,nu,ij} * c*{q,nu}(T) where gamma_{q,nu,ij} is the mode Gruneisen parameter tensor and S is the compliance tensor — provides the full anisotropic thermal expansion tensor for non-cubic systems
  • 123.10.3.2 Implement Gruneisen parameter: mode Gruneisen parameter gamma*{q,nu} = -(V / omega*{q,nu}) _ (d omega_{q,nu} / dV) from phonon frequency shifts under volume change, and the thermodynamic Gruneisen parameter gamma(T) = alpha _ V * B / C_v as a temperature-dependent average

123.10.4 Thermal Conductivity#

  • 123.10.4.1 Implement total thermal conductivity kappa(T) = kappa_L(T) + kappa_e(T): combine lattice thermal conductivity from Phase 119 (phonon BTE or RTA with third-order force constants) with electronic thermal conductivity from 123.2 (Boltzmann transport), providing the full material thermal conductivity for comparison with experiment
  • 123.10.4.2 Implement thermal diffusivity D(T) = kappa(T) / (rho * C_p(T)) where rho is the mass density — determines the timescale of heat diffusion and is directly measurable by flash diffusivity (laser flash analysis)
  • 123.10.4.3 Implement minimum thermal conductivity models: (a) Cahill-Pohl model kappa_min = (pi/6)^{1/3} _ k_B _ n^{2/3} _ sum_i v_i _ (T/Theta_i)^2 _ integral_0^{Theta_i/T} x^3 _ e^x / (e^x-1)^2 dx for amorphous limit, (b) Slack model for crystalline materials using Debye temperature and Gruneisen parameter. Useful as lower bound for lattice thermal conductivity

123.10.5 Thermal Boundary Resistance#

  • 123.10.5.1 Implement acoustic mismatch model (AMM): thermal boundary resistance RK = (1/(2pi^2k_B^4T^3)) * sum*{j} integral_0^{pi/2} cos(theta) _ [1/(t_j(theta) _ v_j _ rho)] sin(theta) d(theta) where t_j is the phonon transmission coefficient from acoustic impedance matching Z = rho _ v at the interface, summed over phonon polarizations j
  • 123.10.5.2 Implement diffuse mismatch model (DMM): assumes all phonons scatter diffusely at the interface, with transmission probability alpha_{1->2} = sum_j C_j,2 _ v_j,2 / (sum_j C_j,1 _ v_j,1 + sum_j C_j,2 * v_j,2) determined by the phonon DOS and velocities on each side of the interface — provides the upper bound of interface thermal resistance

123.11 Integration Testing & Validation (@kalika/transport)#

123.11.1 Transport Validation#

  • 123.11.1.1 Implement BoltzTraP2 benchmark test: compute transport properties of silicon (Si) in CRTA — sigma/tau, S, kappa_e/tau as function of (T, mu) — and verify agreement with published BoltzTraP2 results to within 1% for S(T) at 300K and the sigma/tau peak value
  • 123.11.1.2 Implement thermoelectric benchmark: compute ZT of Bi2Te3 at 300K using BTE transport + lattice thermal conductivity, verify S ~ 200 uV/K (p-type), sigma within factor of 2 of experiment, and ZT ~ 0.5-1.0 at optimal doping
  • 123.11.1.3 Implement scattering rate benchmark: compute mobility of GaAs at 300K including acoustic deformation potential and polar optical phonon scattering, verify mu_e ~ 5000-8000 cm^2/(V*s) matching experimental range

123.11.2 Optical Validation#

  • 123.11.2.1 Implement silicon optical spectrum benchmark: compute epsilon_2(omega) for Si in IP approximation, verify the E_1 peak at ~3.4 eV and E_2 peak at ~4.3 eV positions match VASP optics reference to within 0.1 eV
  • 123.11.2.2 Implement Kramers-Kronig consistency test: compute epsilon_1 from epsilon_2 via KK transformation and verify self-consistency: the KK-derived epsilon_1(0) should match the directly computed static dielectric constant within 5%
  • 123.11.2.3 Implement SHG benchmark: compute chi^(2) of GaAs (zinc-blende, non-centrosymmetric) and verify non-zero response, while confirming chi^(2) = 0 for Si (centrosymmetric) — symmetry selection rule test

123.11.3 Magnetic Validation#

  • 123.11.3.1 Implement bcc Fe benchmark: compute exchange coupling constants J_1, J_2 from 4 collinear magnetic configurations (FM, AFM-A, AFM-C, AFM-G), verify J_1 > 0 (ferromagnetic) and J_1 >> |J_2|, and compute mean-field T_C within 20% of experimental T_C = 1043 K
  • 123.11.3.2 Implement Monte Carlo validation: simulate 2D Ising model on 32x32 lattice with known exact solution (Onsager), verify T_C within 2% of T_C^exact = 2*J / (k_B * ln(1+sqrt(2))) and critical exponent beta ~ 0.125

123.11.4 Topological Validation#

  • 123.11.4.1 Implement Bi2Se3 topological insulator benchmark: compute Z2 invariant from parity eigenvalues at TRIM points, verify (1;000) strong TI classification, and confirm surface Dirac cone at the Gamma point from surface Green's function
  • 123.11.4.2 Implement Chern number benchmark: compute Chern number for the Haldane model on the honeycomb lattice, verify C = +/-1 in the topological phase and C = 0 in the trivial phase, with exact integer quantization from the Fukui-Hatsugai-Suzuki method

123.11.5 Elastic Validation#

  • 123.11.5.1 Implement cubic elastic constants benchmark: compute C_11, C_12, C_44 of diamond (or silicon) from stress-strain method, verify agreement with experimental values within 10% (Si: C_11 ~ 166 GPa, C_12 ~ 64 GPa, C_44 ~ 80 GPa)
  • 123.11.5.2 Implement stability criteria test: verify that the computed elastic constants of a known stable material pass all Born criteria, and that an artificially destabilized tensor (e.g., C_44 set to negative) correctly fails the stability check

123.11.6 Piezoelectric Validation#

  • 123.11.6.1 Implement BaTiO3 ferroelectric benchmark: compute spontaneous polarization of tetragonal BaTiO3 via Berry phase method, verify P_s ~ 20-30 uC/cm^2 matching experimental value, and compute piezoelectric coefficients d_33 and d_15

123.11.7 Thermal Validation#

  • 123.11.7.1 Implement specific heat benchmark: compute C_v(T) for Si from phonon DOS, verify approach to Dulong-Petit limit (3Nk_B ~ 24.9 J/(mol*K) per atom) at high T and T^3 behavior at low T, and compare Debye model with exact phonon result
  • 123.11.7.2 Implement thermal expansion benchmark: compute linear thermal expansion coefficient alpha of Si at 300K from QHA, verify alpha ~ 2.6e-6 K^{-1} within 20% of experimental value

123.11.8 Cross-Module Integration#

  • 123.11.8.1 Implement end-to-end thermoelectric workflow test: from band structure and phonon data, compute all thermoelectric properties (sigma, S, kappa_e, kappa_L, ZT) in a single pipeline call, verify internal consistency (e.g., Wiedemann-Franz at low T, power factor units, ZT dimensionless)
  • 123.11.8.2 Implement end-to-end optical workflow test: from band structure compute epsilon_2 -> KK -> epsilon_1 -> n, k, alpha, R -> ellipsometry parameters, verify unit consistency and physical constraints (n > 0, k >= 0, 0 <= R <= 1, alpha >= 0)
  • 123.11.8.3 Implement end-to-end topological workflow test: from Wannier Hamiltonian, compute Z2 invariant + surface states + spin texture in a single pipeline, verify consistency (Z2 = 1 implies odd number of surface Dirac cones, Fermi arc connectivity matches Weyl point chirality)
  • 123.11.8.4 Implement end-to-end mechanical properties test: from elastic constants compute all derived moduli (B, G, E, nu), stability criteria, wave velocities, Debye temperature, hardness, verify mutual consistency and physical constraints (B > 0, G > 0, -1 < nu < 0.5, v_L > v_T)

<!-- prettier-ignore-end -->