Eve library

phase-129.md

Tracker

Revision 1

On this page

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

Phase 129: Kalika Multiscale Materials Engineering — Phase-Field, Crystal Plasticity, Fracture, Manufacturing Processes & Process-Structure-Property-Performance Digital Twins#

The atomistic and first-principles stack in Phases 116-128 is already strong enough to support frontier computational materials science, but the platform is not complete for elite research groups until it spans the mesoscale and continuum layers where microstructure, processing history, manufacturability, damage accumulation, and service performance are decided. This phase closes that gap. It adds phase-field microstructure evolution, crystal plasticity, discrete dislocation dynamics, fracture and fatigue mechanics, process simulation (solidification, additive manufacturing, welding, sintering, heat treatment), and the multiscale couplings needed to turn Kalika from an atomistic discovery workbench into a full materials-engineering platform. It extends Phase 123 (mechanical properties), Phase 125 (thermodynamics and phase transformations), Phase 126 (functional materials workflows), and Phase 128 (research platform) with the simulation machinery used by leading labs to connect composition and processing to actual device and structural performance.


129.1 Scaffolding & Core Types (@kalika/multiscale)#

129.1.1 Library Structure#

  • 129.1.1.1 Create libs/kalika/multiscale/ with Nx scaffolding, package.json, project.json, tsconfig.json, src/index.ts, Rust compute crates for PDE kernels and sparse solvers, and Python bridges for scientific ecosystem interoperability
  • 129.1.1.2 Create sub-libraries: @kalika/phase-field, @kalika/crystal-plasticity, @kalika/dislocation-dynamics, @kalika/process-simulation, @kalika/damage-mechanics, and @kalika/multiscale-workflows
  • 129.1.1.3 Register path mappings for all new multiscale libraries in tsconfig.base.json and add dependency edges to Phases 117, 120, 122, 123, 125, 126, and 128
  • 129.1.1.4 Configure build targets for TypeScript APIs, Rust native/WASM kernels, integration tests, benchmark targets, and example workflow bundles for phase-field, CPFEM, and process simulation

129.1.2 Common Type System#

  • 129.1.2.1 Define RepresentativeVolumeElement type: geometry, mesh, constituent phases, defects, grain topology, texture, boundary conditions, and links back to atomistic/calibration datasets
  • 129.1.2.2 Define FieldVariable hierarchy: scalar, vector, tensor, order parameter, concentration field, damage field, temperature field, plastic slip field, and level-set field on structured/unstructured meshes
  • 129.1.2.3 Define ConstitutiveModel interface: state variables, evolution equations, tangent operator, admissibility checks, calibration provenance, and supported loading/process regimes
  • 129.1.2.4 Define MicrostructureState type: grain IDs, phase labels, orientation per grain, precipitate population, porosity, dislocation density, residual stress, and texture descriptors
  • 129.1.2.5 Define ProcessHistory type: thermal schedule, deformation path, atmosphere, pressure, scan path, cooling rate, dwell times, tool parameters, and facility provenance
  • 129.1.2.6 Define PerformancePrediction type: elastic/plastic response, fatigue life, creep rupture time, fracture resistance, conductivity degradation, corrosion susceptibility, and uncertainty bounds

129.2 Phase-Field Microstructure Evolution (@kalika/phase-field)#

129.2.1 Core PDE Infrastructure#

  • 129.2.1.1 Implement structured-grid and adaptive-mesh phase-field solver infrastructure for Allen-Cahn, Cahn-Hilliard, phase-field-crystal, and coupled thermo-chemo-mechanical systems
  • 129.2.1.2 Implement free-energy functional framework: bulk/chemical/interfacial/elastic/electrostatic contributions with symbolic composition of functionals and automatic residual/Jacobian generation
  • 129.2.1.3 Implement semi-implicit Fourier spectral solvers for periodic domains and sparse finite-element/finite-volume solvers for arbitrary geometries
  • 129.2.1.4 Implement adaptive timestep control based on energy dissipation, CFL criteria, and nonlinear solver convergence

129.2.2 Microstructure Physics#

  • 129.2.2.1 Implement grain growth and curvature-driven coarsening: isotropic and anisotropic grain boundary mobility, stored-energy driven growth, and pinning by particles/pores
  • 129.2.2.2 Implement spinodal decomposition and nucleation/growth in multicomponent alloys using CALPHAD-derived chemical free energies from Phase 125
  • 129.2.2.3 Implement precipitation microstructure evolution: coherent, semi-coherent, and incoherent precipitates with elastic strain energy, anti-phase boundary contributions, and coarsening kinetics
  • 129.2.2.4 Implement martensitic and ferroic domain phase-field models: strain-coupled order parameters, variant selection, twinning, and domain wall motion under mechanical/electric/magnetic loading
  • 129.2.2.5 Implement porosity evolution, pore coalescence, and sintering shrinkage for ceramics, powders, and additively manufactured feedstocks
  • 129.2.2.6 Implement corrosion and oxidation front propagation: coupled diffusion-reaction moving-interface models for oxide growth, passivation breakdown, and localized attack

129.2.3 Multiphysics Coupling#

  • 129.2.3.1 Couple phase-field composition/order parameters to thermal fields from process simulation for heat-treatment, solidification, and additive-manufacturing workflows
  • 129.2.3.2 Couple phase-field to elasticity and eigenstrain fields for transformation strain, coherency stress, and stress-assisted precipitation/dissolution
  • 129.2.3.3 Implement electrochemical phase-field models for dendrite growth, electrodeposition, SEI evolution, and interfacial stability in battery systems
  • 129.2.3.4 Implement grain-boundary and interface mobility calibration from atomistic calculations, MD data, and experimental benchmarks

129.2.4 Analysis & Visualization#

  • 129.2.4.1 Implement microstructure statistics extraction: grain size distributions, aspect ratio, interfacial area density, phase connectivity, tortuosity, texture evolution, and precipitate size distributions
  • 129.2.4.2 Implement microstructure movie export and interactive overlays for order parameters, concentration, elastic energy density, and local driving forces in the Phase 128 workbench
  • 129.2.4.3 Implement reduced-order surrogate extraction from phase-field trajectories for fast process-design and uncertainty studies

129.3 Crystal Plasticity & Continuum Mechanics (@kalika/crystal-plasticity)#

129.3.1 Constitutive Infrastructure#

  • 129.3.1.1 Implement finite-strain crystal plasticity constitutive framework: multiplicative decomposition F = F_e F_p, state update, objective stress rates, and consistent tangent operators
  • 129.3.1.2 Implement slip-system libraries for FCC, BCC, HCP, olivine, perovskite, layered oxides, and other materials classes relevant to Kalika
  • 129.3.1.3 Implement rate-dependent and rate-independent slip kinetics, latent hardening, kinematic hardening, twinning, detwinning, and transformation-induced plasticity
  • 129.3.1.4 Implement anisotropic elasticity and thermomechanical constitutive coupling including thermal expansion, thermal softening, and residual-stress evolution

129.3.2 CPFEM Solvers#

  • 129.3.2.1 Implement crystal-plasticity finite-element solver on hexahedral/tetrahedral meshes with Newton-Raphson nonlinear solves and sparse direct/iterative linear solvers
  • 129.3.2.2 Implement periodic RVE homogenization workflows: compute effective stress-strain response, localization fields, texture-dependent yield surfaces, and tangent moduli
  • 129.3.2.3 Implement texture-aware polycrystal simulations from EBSD or synthetic microstructures, including grain-wise orientations and grain-boundary conditions
  • 129.3.2.4 Implement coupled CPFEM-fatigue and CPFEM-damage hooks for crack-initiation indicators, slip localization metrics, and cyclic ratcheting

129.3.3 Calibration & Use Cases#

  • 129.3.3.1 Implement inverse calibration of crystal-plasticity parameters from tensile/compression/shear curves, nanoindentation, micropillar tests, diffraction strain measurements, and DIC fields
  • 129.3.3.2 Implement forming workflows: rolling, extrusion, drawing, stamping, and forging with texture prediction and residual stress output
  • 129.3.3.3 Implement battery-electrode chemo-mechanics workflows: volume expansion, cyclic plasticity, particle fracture indicators, and binder/current-collector interaction models

129.4 Dislocation & Defect-Mediated Mechanics (@kalika/dislocation-dynamics)#

129.4.1 Mesoscale Defect Dynamics#

  • 129.4.1.1 Implement discrete dislocation dynamics (DDD) kernels for line discretization, elastic interactions, mobility laws, annihilation, junction formation, and cross-slip
  • 129.4.1.2 Implement continuum dislocation density models: GND/SSD evolution, transport equations, back-stress terms, and hardening laws
  • 129.4.1.3 Implement irradiation defect cluster evolution and sink strengths for vacancy/interstitial loops, voids, bubbles, and precipitate obstacles
  • 129.4.1.4 Implement hydrogen-assisted and solute-drag defect mobility modifiers for embrittlement, dynamic strain aging, and radiation-assisted degradation

129.4.2 Bridging & Outputs#

  • 129.4.2.1 Implement atomistic-to-dislocation calibration: Peierls barriers, stacking-fault energies, core structures, and solute interaction energies from Phases 116, 118, and 122
  • 129.4.2.2 Implement DDD-to-CPFEM homogenization: derive hardening laws, obstacle strengths, and size-effect-aware constitutive parameters from dislocation simulations
  • 129.4.2.3 Implement outputs for dislocation density maps, slip-band statistics, strain bursts, obstacle bypass mechanisms, and avalanche statistics

129.5 Damage, Fracture, Fatigue, Creep & Tribology (@kalika/damage-mechanics)#

129.5.1 Damage & Fracture#

  • 129.5.1.1 Implement phase-field fracture and cohesive-zone modeling for brittle, ductile, and mixed-mode cracking with crack initiation, propagation, branching, and arrest
  • 129.5.1.2 Implement LEFM/EPFM utilities: stress intensity factors, J-integral, crack-tip opening displacement, and R-curve extraction
  • 129.5.1.3 Implement microstructure-sensitive fracture workflows: grain-boundary decohesion, precipitate cracking, inclusion-triggered initiation, and hydrogen embrittlement-assisted failure

129.5.2 Fatigue & Creep#

  • 129.5.2.1 Implement high-cycle and low-cycle fatigue models: S-N, strain-life, critical-plane, and energy-based indicators calibrated from CPFEM/local field outputs
  • 129.5.2.2 Implement fatigue crack initiation and growth: Paris law, threshold behavior, overload retardation, environment-assisted growth, and short-crack corrections
  • 129.5.2.3 Implement creep constitutive models: Norton-Bailey, diffusional creep, power-law creep, creep-fatigue interaction, and rupture-life estimation

129.5.3 Contact & Surface Degradation#

  • 129.5.3.1 Implement tribology workflows: Hertzian contact, frictional heating, wear models, third-body effects, and coating performance
  • 129.5.3.2 Implement corrosion-fatigue and oxidation-assisted damage couplings for aggressive-environment service prediction

129.6 Process Simulation & Manufacturing Digital Twins (@kalika/process-simulation)#

129.6.1 Thermal Process Modeling#

  • 129.6.1.1 Implement transient heat-transfer solvers for conduction, convection, radiation, latent heat release, and moving heat sources
  • 129.6.1.2 Implement heat-treatment simulation: solutionizing, aging, annealing, quenching, tempering, and controlled cooling with CALPHAD and phase-field coupling

129.6.2 Additive Manufacturing & Welding#

  • 129.6.2.1 Implement powder-bed fusion simulation: scan strategy, hatch spacing, laser/e-beam heat source models, melt-pool thermal history, keyholing risk, and residual-stress prediction
  • 129.6.2.2 Implement directed-energy deposition and welding workflows: bead geometry, dilution, heat-affected zone prediction, solidification texture, and distortion
  • 129.6.2.3 Implement process-parameter optimization: power, speed, layer thickness, scan order, shielding gas, and dwell strategy under quality and productivity constraints

129.6.3 Powder, Sintering & Conventional Processing#

  • 129.6.3.1 Implement powder packing and green-body statistics for ceramic and metallurgical powder routes
  • 129.6.3.2 Implement sintering and densification models: neck growth, pore shrinkage, grain growth, and differential shrinkage
  • 129.6.3.3 Implement casting and solidification digital twins: macrosegregation, dendrite arm spacing estimation, porosity risk, and residual-stress prediction from coupled solidification and thermal models
  • 129.6.3.4 Implement rolling/forging/extrusion process chains linking deformation, recrystallization, texture, and final property outcomes

129.7 Multiscale Coupling, UQ & Decision Support (@kalika/multiscale-workflows)#

129.7.1 Bridging Across Scales#

  • 129.7.1.1 Implement atomistic-to-continuum parameter passing: elastic constants, diffusion coefficients, interfacial energies, mobilities, defect energetics, and constitutive priors with provenance
  • 129.7.1.2 Implement multiscale workflow templates: DFT/MD -> CALPHAD/phase-field -> CPFEM/damage -> performance dashboard
  • 129.7.1.3 Implement structure-preserving surrogate models for expensive process simulations using Gaussian processes, operator learning, and neural surrogates with physics constraints

129.7.2 Uncertainty Quantification#

  • 129.7.2.1 Implement uncertainty propagation across multiscale chains: input distributions, polynomial chaos/Monte Carlo/surrogate-assisted UQ, and sensitivity analysis for dominant uncertainty sources
  • 129.7.2.2 Implement experimental calibration fusion: Bayesian updating of constitutive/process parameters from measured microstructures and performance data
  • 129.7.2.3 Implement robust decision metrics: probability of failure, yield under uncertainty, process-window robustness, and value-of-information for additional measurements or simulations

129.8 Validation, Benchmarks & Platform Integration#

129.8.1 Benchmarks#

  • 129.8.1.1 Implement grain-growth benchmark: verify curvature-driven coarsening exponents and Hillert statistics
  • 129.8.1.2 Implement spinodal decomposition benchmark: validate wavelength selection and coarsening laws against canonical Cahn-Hilliard test problems
  • 129.8.1.3 Implement CPFEM benchmark suite: FCC copper, BCC ferrite, HCP magnesium, and battery-particle chemo- mechanical loading with literature reference curves
  • 129.8.1.4 Implement fracture/fatigue benchmark suite: compact-tension fracture, Paris-law crack growth, creep rupture, and rolling-contact wear against standard datasets
  • 129.8.1.5 Implement additive-manufacturing benchmark: melt-pool dimensions, cooling rates, residual stress, and distortion compared with published benchmark builds

129.8.2 Kalika Workbench Integration#

  • 129.8.2.1 Integrate multiscale workflows into Phase 128 dashboards: process windows, property-performance maps, microstructure viewers, and service-life forecast panels
  • 129.8.2.2 Integrate EBSD/microscopy and diffraction-derived microstructures from Phase 128 into CPFEM and phase-field initial conditions
  • 129.8.2.3 Add multiscale notebook templates: "heat treatment -> precipitate evolution", "EBSD -> CPFEM", "battery particle fracture", and "AM process -> residual stress -> fatigue"
  • 129.8.2.4 Add end-to-end regression tests for one complete process-structure-property-performance workflow with provenance and replay