<!-- 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

- [x] **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
- [x] **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`
- [x] **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

- [x] **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
- [x] **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
- [x] **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
- [x] **123.1.2.4** Implement `ThermalConductivityTensor`: electronic thermal
      conductivity kappa_e,ab in W/(m*K), computed from Onsager coefficients as
      (1/T)[L2 - (L1)^2/L0], with Lorenz number tensor L_ab = kappa_e/(sigma*T)
      and Wiedemann-Franz deviation tracking
- [x] **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
- [x] **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
- [x] **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
- [x] **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
- [x] **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
- [x] **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
- [x] **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

- [x] **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
- [x] **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
- [x] **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)
- [x] **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
- [x] **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

- [x] **123.2.1.1** Implement transport distribution function (TDF)
      Xi*ab(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
- [x] **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
- [x] **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

- [x] **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)
- [x] **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
- [x] **123.2.2.3** Implement electronic thermal conductivity tensor
      kappa*e,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
- [x] **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
- [x] **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
- [x] **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
- [x] **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

- [x] **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
- [x] **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)
- [x] **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

- [x] **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
- [x] **123.2.4.2** Implement polar optical phonon (Fröhlich) scattering rate
      (Rust): 1/tau_POP = (e^2 * omega_LO / (4*pi*epsilon_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
- [x] **123.2.4.3** Implement ionized impurity scattering: Brooks-Herring
      screened Coulomb model 1/tau_BH(E) = (n_i _ Z^2 _ e^4) / (16*pi*epsilon^2
      * sqrt(2*m*) * E^{3/2}) * [ln(1+b) - b/(1+b)] where b =
      8*m*E*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
- [x] **123.2.4.4** Implement alloy scattering rate: 1/tau*alloy(E) = (3*pi/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)
- [x] **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
- [x] **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
- [x] **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 * [(N*q+1-f*{mk+q}) delta(E*nk -
      E*{mk+q} - hbar*omega) + (N*q+f*{mk+q}) delta(E*nk - E*{mk+q} +
      hbar\*omega)] via dense q-point integration

#### 123.2.5 Mobility and Carrier Concentration

- [x] **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
- [x] **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)
- [x] **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

- [x] **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
- [x] **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

- [x] **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
- [x] **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
- [x] **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
- [x] **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

- [x] **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
- [x] **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)
- [x] **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

- [x] **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)
- [x] **123.3.2.2** Implement Pisarenko relation analysis: plot S vs. n at fixed
      T and fit to single parabolic band model S = (8*pi^2*k_B^2*T) / (3*e*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
- [x] **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

- [x] **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
- [x] **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
- [x] **123.3.3.3** Implement thermoelectric quality factor B: B =
      (2*e*k_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
- [x] **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

- [x] **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

- [x] **123.4.2.1** Implement imaginary dielectric function epsilon*2(omega) in
      independent particle (IP) approximation (Rust): epsilon_2,ab(omega) =
      (4*pi^2*e^2) / (m^2*omega^2*V) \* 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
- [x] **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)
- [x] **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
- [x] **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
- [x] **123.4.2.5** Implement intraband (Drude) contribution to dielectric
      function: epsilon*intra(omega) = -omega_p^2 / (omega^2 + i*gamma*omega)
      where omega_p^2 = (4*pi*e^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

- [x] **123.4.3.1** Implement optical conductivity tensor: sigma_ab(omega) =
      -i*omega * [epsilon_ab(omega) - delta_ab] / (4*pi) in Gaussian units, or
      sigma = -i*omega*epsilon_0*[epsilon - 1] in SI. Compute real part
      Re[sigma] (absorption) and imaginary part (dispersion)
- [x] **123.4.3.2** Implement absorption coefficient: alpha(omega) = (2*omega/c)
      * Im[sqrt(epsilon(omega))] in cm^{-1}, alternatively alpha =
      2*omega*k(omega)/c where k is the extinction coefficient. Compute for each
      polarization direction and powder average
- [x] **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
- [x] **123.4.3.4** Implement transmittance T(omega) = (1-R)^2 * exp(-alpha*d) /
      (1 - R^2*exp(-2*alpha\*d)) for a slab of thickness d, including multiple
      internal reflections (Fabry-Perot), and absorbance A = -log10(T)
- [x] **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)
- [x] **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
- [x] **123.4.3.7** Implement joint density of states: JDOS(omega) =
      (2/(2*pi)^3) * integral*BZ 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
- [x] **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

- [x] **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)
- [x] **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

- [x] **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
- [x] **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
- [x] **123.4.5.3** Implement Kerr effect (optical Kerr) from chi^(3):
      intensity-dependent refractive index n_2 = (3/(4*n_0^2*epsilon_0*c)) *
      Re[chi^(3)_xxxx(-omega; omega, -omega, omega)] for self-phase modulation
      applications
- [x] **123.4.5.4** Implement shift current (bulk photovoltaic effect): J*a =
      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
- [x] **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

- [x] **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
- [x] **123.4.6.2** Implement static dielectric constant (electronic + ionic):
      epsilon*0,ab = epsilon_inf,ab + (4*pi/V) * sum_nu (S_nu,a \* S_nu,b) /
      omega_nu^2 where S_nu is the mode oscillator strength S*{nu,a} = sum*k
      Z\**{k,ab} \* e\_{nu,k,b} / sqrt(M_k) and omega_nu are the phonon
      frequencies at Gamma
- [x] **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
- [x] **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
- [x] **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

- [x] **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

- [x] **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
- [x] **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
- [x] **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

- [x] **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
- [x] **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

- [x] **123.5.4.1** Implement J*ij 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
- [x] **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
- [x] **123.5.4.3** Implement Green's function method for J*ij (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
- [x] **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
- [x] **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

- [x] **123.5.5.1** Implement mean-field Curie temperature: k*B * 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
- [x] **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.1*T_C^MF to 3*T_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)
- [x] **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
- [x] **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

- [x] **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
- [x] **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]
- [x] **123.5.6.3** Implement spin stiffness constant D: from the quadratic
      dispersion omega(q) = D*q^2 + O(q^4) near the zone center (FM case), D =
      2*S*J_eff*a^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

- [x] **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
- [x] **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
- [x] **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: E*MAE proportional to
      sum*{occ,unocc} |<occ|L.S|unocc>|^2 / (E_unocc - E_occ)

#### 123.5.8 Magnetic Susceptibility and M(H) Curves

- [x] **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(3*k_B*C / (N*mu_B^2))
- [x] **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

- [x] **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
- [x] **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
- [x] **123.5.9.3** Implement magnetic domain wall energy: from the exchange
      stiffness A = sum*j J*{0j} _ S^2 _ r_j^2 / (6*V_cell) and anisotropy K,
      compute domain wall width delta = pi*sqrt(A/K) and domain wall energy
      sigma_DW = 4*sqrt(A*K) per unit area
- [x] **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

- [x] **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

- [x] **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
- [x] **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

- [x] **123.6.1.1** Create `libs/kalika/spintronics/` with standard project
      scaffolding

#### 123.6.2 Spin Hall and Anomalous Hall Effects

- [x] **123.6.2.1** Implement spin Hall conductivity sigma^SH*ij (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
- [x] **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
- [x] **123.6.2.3** Implement Berry curvature computation (Rust): for each band
      n at each k-point, compute Omega*n^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
- [x] **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

- [x] **123.6.3.1** Implement Rashba spin splitting analysis: for surfaces or
      heterostructures with broken inversion symmetry, extract the Rashba
      parameter alpha*R from the band structure splitting E*+/-(k) =
      hbar^2*k^2/(2*m*) +/- 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
- [x] **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)
- [x] **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

- [x] **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
- [x] **123.6.4.2** Implement D'yakonov-Perel spin relaxation rate: 1/T_1^DP =
      alpha_R^2 * (2*m*/(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)
- [x] **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

- [x] **123.6.5.1** Implement tunneling magnetoresistance (TMR) model: Julliere
      model TMR = 2*P_1*P_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)
- [x] **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
- [x] **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
- [x] **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
- [x] **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)
- [x] **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

- [x] **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

- [x] **123.7.2.1** Implement Z2 invariant from parity analysis (Fu-Kane
      formula): nu*0 = product*{i=1}^{8} delta*i (mod 2) where delta_i =
      product*{m=1}^{N*occ} 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
- [x] **123.7.2.2** Implement Z2 invariant from Wilson loop / hybrid Wannier
      charge centers (Rust): for each k*3 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
- [x] **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

- [x] **123.7.3.1** Implement Chern number from Berry curvature integration
      (Rust): C_n = (1/(2*pi)) * 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/(2*pi)) * 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
- [x] **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 n*M = (C*+ -
      C\_-) / 2 — classifies topological crystalline insulators (e.g., SnTe
      class)
- [x] **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

- [x] **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
- [x] **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

- [x] **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
- [x] **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)
- [x] **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
- [x] **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

- [x] **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
- [x] **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
- [x] **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
- [x] **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

- [x] **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.
- [x] **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)
- [x] **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)
- [x] **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

- [x] **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/(2*pi*h)) \* theta from the Chern-Simons 3-form
- [x] **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
- [x] **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
- [x] **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

- [x] **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
- [x] **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

- [x] **123.8.1.1** Create `libs/kalika/piezoelectric/` with standard project
      scaffolding

#### 123.8.2 Piezoelectric Tensor

- [x] **123.8.2.1** Implement piezoelectric stress tensor e*ijk 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
- [x] **123.8.2.2** Implement piezoelectric strain tensor d*ijk: d*{i,ab} =
      sum*c 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)
- [x] **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)
- [x] **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

- [x] **123.8.3.1** Implement spontaneous polarization via Berry phase (King-
      Smith-Vanderbilt): P*i = (e/(2*pi)) * sum_n integral_BZ <u_nk|d/dk_i|u_nk>
      dk = (e/(2*pi)) * 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})>
- [x] **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
- [x] **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
- [x] **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

- [x] **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
- [x] **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
- [x] **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
- [x] **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
- [x] **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

- [x] **123.9.1.1** Create `libs/kalika/elastic/` with standard project
      scaffolding

#### 123.9.2 Elastic Constants Tensor

- [x] **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%)
- [x] **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 =
      V*0 \* [sum*{ij} (1/2) C*ij 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
- [x] **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)
- [x] **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

- [x] **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
- [x] **123.9.3.2** Implement Young's modulus E = 9*B*G / (3*B + G) and Poisson
      ratio nu = (3*B - 2*G) / (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
- [x] **123.9.3.3** Implement anisotropy indices: Zener anisotropy ratio A_Z =
      2*C_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
- [x] **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

- [x] **123.9.4.1** Implement Vickers hardness models: (a) Chen model H_V =
      2*(k^2*G)^{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
- [x] **123.9.4.2** Implement fracture toughness estimation: Griffith criterion
      K_IC = sqrt(2*E*gamma_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
- [x] **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

- [x] **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)
- [x] **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)
- [x] **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
- [x] **123.9.5.4** Implement Debye temperature from elastic constants: Theta_D
      = (h/k_B) * [3*N/(4*pi*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
- [x] **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

- [x] **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
- [x] **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

- [x] **123.10.1.1** Create `libs/kalika/thermal-properties/` with standard
      project scaffolding

#### 123.10.2 Specific Heat

- [x] **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 _ (hbar*omega/(k_BT))^2 * exp(hbar*omega/(k_BT)) /
      [exp(hbar*omega/(k_BT)) - 1]^2 is the Einstein mode contribution — reads
      phonon DOS from Phase 119
- [x] **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
- [x] **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)
- [x] **123.10.2.4** Implement Debye model specific heat: C_v^Debye(T) = 9*N*k_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

- [x] **123.10.3.1** Implement thermal expansion coefficient alpha(T) from
      quasiharmonic approximation (Phase 119 integration): alpha*ab(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
- [x] **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

- [x] **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
- [x] **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)
- [x] **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

- [x] **123.10.5.1** Implement acoustic mismatch model (AMM): thermal boundary
      resistance R*K = (1/(2*pi^2*k_B^4*T^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
- [x] **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

- [x] **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
- [x] **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
- [x] **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

- [x] **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
- [x] **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%
- [x] **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

- [x] **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
- [x] **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

- [x] **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
- [x] **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

- [x] **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)
- [x] **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

- [x] **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

- [x] **123.11.7.1** Implement specific heat benchmark: compute C_v(T) for Si
      from phonon DOS, verify approach to Dulong-Petit limit (3*N*k_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
- [x] **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

- [x] **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)
- [x] **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)
- [x] **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)
- [x] **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 -->
