Expand description
Material properties and material library.
Defines physical material properties such as density, friction, and restitution, along with a library for managing named materials.
Re-exports§
pub use simd_paths::MaterialBatchStats;pub use simd_paths::SoaMaterialPoints;pub use simd_paths::elastic_stress_batch;pub use simd_paths::elastic_stress_batch_x4;pub use simd_paths::lame;pub use simd_paths::miner_damage_batch;pub use simd_paths::neo_hookean_stress_batch;pub use simd_paths::return_mapping_batch;pub use simd_paths::thermal_expansion_stress_batch;pub use simd_paths::viscoplastic_rate_batch;pub use simd_paths::von_mises_yield_batch;pub use combination::ContactMaterialPair;pub use combination::FrictionCombineRule;pub use combination::ModulusCombineRule;pub use combination::RestitutionCombineRule;pub use combination::ThermalContactResistance;pub use combination::combine_friction;pub use combination::combine_modulus;pub use combination::combine_restitution;pub use combination::hertz_contact_force;pub use combination::hertz_effective_modulus;pub use combination::hertz_effective_radius;pub use combination::maxwell_diffusivity;pub use elastic::LinearElastic;pub use elastic::NeoHookean;pub use eos::EosWithEnergy;pub use eos::EquationOfState;pub use eos::IdealGasEos;pub use eos::MieGruneisenEos as MieGruneisenEosShock;pub use eos::PolynomialEos;pub use eos::StiffenedGasEos;pub use eos::TaitEos;pub use eos::TillotsonEos;pub use eos::VanDerWaalsEos;pub use hyperelastic::DruckerPrager;pub use hyperelastic::J2Plasticity;pub use hyperelastic::JwlEos;pub use hyperelastic::MieGruneisenEos;pub use hyperelastic::MooneyRivlin;pub use hyperelastic::Ogden;pub use viscoelastic::KelvinVoigt;pub use viscoelastic::Maxwell;pub use viscoelastic::StandardLinearSolid;pub use composite::*;pub use creep::*;pub use phase_transform::*;
Modules§
- acoustics
- Auto-generated module structure
- additive_
manufacturing - Auto-generated module structure
- additive_
manufacturing_ materials - Additive manufacturing material models.
- aerospace
- Auto-generated module structure
- aerospace_
materials - Aerospace structural material models.
- alloy_
materials - Metallic alloy material models: composition, mechanical properties, strengthening mechanisms, phase diagrams, thermal and corrosion properties.
- anisotropic
- Auto-generated module structure
- battery_
materials - Battery electrode and electrolyte material models.
- biological_
materials - Biological materials module: soft tissues, bone, cartilage, vascular walls, cell mechanics, hydrogels, and biomechanics analysis tools.
- biomaterials
- Biomaterials module: bone mechanics, cartilage, tendons, hydrogels, cell mechanics, biodegradation kinetics, scaffold porosity, sutures, and dental materials.
- biomechanical_
materials - Auto-generated module structure
- biomechanics
- Auto-generated module structure
- biomedical_
materials - Biomedical material models: soft tissue, bone, blood, hydrogels.
- ceramic_
materials - Ceramic material models: property database, fracture mechanics, thermal shock, creep, sintering densification, hardness conversion, Weibull failure statistics, piezoelectric ceramics (PZT), ferroelectric hysteresis, zirconia phase transformation toughening, alumina properties, thermal conductivity models, Hasselman parameters, and grain growth kinetics.
- ceramics_
materials - Ceramic material models: brittle fracture, sintering, thermal properties.
- combination
- Rules for combining material properties in contact pairs and composite materials.
- composite
- Composite material micromechanics.
- composite_
failure - Composite material failure criteria and progressive damage models.
- composite_
materials - Composite material mechanics.
- composites_
advanced - Advanced composite material models: laminate theory, fiber-matrix, damage.
- construction
- Auto-generated module structure
- corrosion
- Electrochemical corrosion models.
- creep
- Auto-generated module structure
- crystal_
plasticity - Crystal plasticity — slip systems, texture evolution, and polycrystal averaging.
- damage
- Auto-generated module structure
- dielectric_
materials - Dielectric and electromagnetic material models.
- elastic
- Elastic material models (linear, orthotropic, transversely isotropic, and hyperelastic).
- electrochemistry
- Auto-generated module structure
- electromagnetic
- Electromagnetic material properties.
- energy_
materials - Energy materials module: Li-ion batteries, fuel cells, solar cells, thermoelectrics, supercapacitors, hydrogen storage, nuclear materials, and piezoelectric energy harvesting.
- eos
- Auto-generated module structure
- fatigue
- Auto-generated module structure
- fiber_
composites - Fiber-reinforced composite material models.
- foam_
materials - Foam and cellular material models.
- fracture
- Auto-generated module structure
- geological
- Geological and geomechanical material models: soils, rocks, sand, permafrost, seabed sediments, and granular pressure models.
- geomaterial_
models - Geomaterial constitutive models.
- geomaterials
- Geomechanical and geo-material constitutive models.
- geomechanics
- Geomechanics and rock mechanics.
- hydrogen_
storage - Hydrogen storage material models.
- hyperelastic
- Auto-generated module structure
- magnetocaloric_
materials - Magnetocaloric effect (MCE) material models.
- materials_
bench - Benchmark suite for the OxiPhysics materials constitutive kernels.
- metamaterials
- Auto-generated module structure
- multiphysics
- Coupled multiphysics material models.
- nano
- Auto-generated module structure
- nano_
materials - Size-dependent nanomaterial properties and quantum-confinement models.
- nanocomposites
- Nanocomposite and nanomaterial models.
- nanomaterials
- Nanomaterial mechanical, thermal, and quantum properties.
- nuclear_
materials - Nuclear materials science — radiation damage and actinide materials.
- nuclear_
materials_ advanced - Advanced nuclear reactor materials science.
- optical
- Optical material properties.
- optical_
materials - Optical materials — refractive index, photonics, and nonlinear optics.
- phase_
transform - Auto-generated module structure
- plasticity
- Plasticity models for metals, soils, and general inelastic materials.
- polymer_
mechanics - Polymer mechanical models: worm-like chain, freely-jointed chain, viscoelasticity, Prony-series relaxation, glass transition, Flory-Huggins mixing, rubber elasticity, crystallinity effects, and crazing.
- polymer_
physics - Polymer physics — chain models and rubber elasticity.
- polymers_
materials - Polymer material models: rubber elasticity, viscoelasticity, degradation.
- porous_
media - Porous and cellular material models.
- presets
- Auto-generated module structure
- quantum_
materials - Quantum materials properties: band structure, Fermi statistics, carrier transport, thermoelectric effects, and optical response.
- radiation
- Auto-generated module structure
- radiation_
shielding - Radiation shielding and nuclear material models.
- semiconductor
- Semiconductor physics: band gap, carrier transport, junctions, and device models.
- semiconductor_
materials - Semiconductor material models.
- shape_
memory - Shape memory alloy (SMA) materials — Nitinol, Cu-Zn-Al, and related alloys.
- shape_
memory_ alloy - Advanced shape memory alloy (SMA) constitutive modeling.
- simd_
paths - SIMD-accelerated bulk material evaluation using Structure-of-Arrays (SoA) layout.
- smart_
materials - Auto-generated module structure
- superconductor
- Superconductor material models.
- thermal
- Auto-generated module structure
- thermoelectrics
- Thermoelectric material models.
- tribology
- Auto-generated module structure
- tribology_
ext - Extended tribology — friction, wear, and lubrication.
- tribology_
materials - Tribology materials module.
- viscoelastic
- Auto-generated module structure
Structs§
- Extended
Material - Extended material with full physical, mechanical, thermal, acoustic, and optical properties for simulation of complex multi-physics problems.
- Material
- Physical material properties.
- Material
Index - Multi-criterion material selection index (Ashby-type).
- Material
Library - A library of named materials.
- Material
Mixture - Material mixing rules for composite and alloy properties.
Enums§
- Error
- Main error type for the materials module.
Functions§
- acoustic_
reflection_ coefficient - Reflection coefficient at normal incidence between two media: R = ((Z₂ - Z₁) / (Z₂ + Z₁))² (intensity).
- acoustic_
transmission_ coefficient - Transmission coefficient at normal incidence: T = 1 - R = 4·Z₁·Z₂ / (Z₁ + Z₂)².
- bar_
wave_ speed - Bar (longitudinal in thin rod) wave speed: c_bar = sqrt(E / ρ) [m/s].
- best_
thermal_ shock_ resistance - Find the material with the best thermal shock resistance.
- bimaterial_
mismatch_ stress - Mismatch stress at a bi-material interface (Suhir model, simplified): σ_mismatch = E_eff · (α₂ - α₁) · ΔT / (1 - ν_eff)
- critical_
damping - Compute the critical damping coefficient for a spring-mass system.
- damping_
ratio - Compute the damping ratio: zeta = c / c_crit.
- elastic_
moduli_ admissible - Check physical admissibility of (E, ν):
- elastic_
moduli_ from_ E_ nu - Convert (E, ν) → (K, G, λ) — the standard elastic moduli family.
- elastic_
moduli_ from_ kg - Convert (K, G) → (E, ν, λ).
- elastic_
moduli_ from_ lame - Convert (λ, G) → (E, ν, K).
- filter_
by_ max_ density - Filter by maximum density (lightweight materials).
- filter_
by_ min_ stiffness - Filter a slice of
ExtendedMaterialby minimum Young’s modulus. - highest_
specific_ stiffness - Find the material with the highest specific stiffness (E/ρ).
- lerp_
property - Linearly interpolate between two material property values.
- natural_
frequency - Compute the natural frequency of a spring-mass system: omega_n = sqrt(k/m).
- p_
wave_ speed - Longitudinal (P-wave) speed: c_p = sqrt((K + 4G/3) / ρ) [m/s].
- rank_
by_ beam_ stiffness_ index - Rank materials by an Ashby beam-stiffness index E^(1/2)/ρ.
- rayleigh_
wave_ speed - Rayleigh surface wave speed (Viktorov approximation): c_R ≈ c_s · (0.862 + 1.14·ν) / (1 + ν).
- require_
finite - Assert that
valueis finite (not NaN or ±infinity). - require_
in_ range - Assert that
valuelies in the closed interval[lo, hi]. - require_
non_ negative - Assert that
valueis non-negative; returnErrotherwise. - require_
positive - Assert that
valueis strictly positive; returnErrotherwise. - s_
wave_ speed - Shear (S-wave) speed: c_s = sqrt(G / ρ) [m/s].
- standard_
material_ catalogue - Return a small catalogue of extended materials for testing and demonstration.
- thermal_
strain - Free thermal strain: ε_th = α · ΔT (dimensionless).
- thermal_
stress_ constrained - Thermal stress in a fully constrained bar: σ = -E · α · ΔT [Pa].
- velocity_
dependent_ restitution - Compute the effective coefficient of restitution for a collision using the velocity-dependent model: e_eff = e * max(0, 1 - k * |v_rel|)
Type Aliases§
- Result
- Result type alias for the materials module.