Crate oxiphysics_materials

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 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.
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.
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§

ExtendedMaterial: Extended material with full physical, mechanical, thermal, acoustic, and optical properties for simulation of complex multi-physics problems.
Material: Physical material properties.
MaterialIndex: Multi-criterion material selection index (Ashby-type).
MaterialLibrary: A library of named materials.
MaterialMixture: 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 ExtendedMaterial by 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 value is finite (not NaN or ±infinity).
require_in_range: Assert that value lies in the closed interval [lo, hi].
require_non_negative: Assert that value is non-negative; return Err otherwise.
require_positive: Assert that value is strictly positive; return Err otherwise.
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.

Crate oxiphysics_materials

Crate oxiphysics_materials Copy item path

Re-exports§

Modules§

Structs§

Enums§

Functions§

Type Aliases§

Crate oxiphysics_materials