Skip to content

incremental_linear_elasticity: hypoelastic update with the stress as history - #134

Draft
petlenz wants to merge 1 commit into
feature/short-fibre-compositefrom
feature/incremental-elasticity
Draft

petlenz wants to merge 1 commit into
feature/short-fibre-compositefrom
feature/incremental-elasticity

Conversation

@petlenz

@petlenz petlenz commented Oct 16, 2026 •

Copy link
Copy Markdown
Member

Closes #111. Part of the uvwmaterial port (#94); stacked on #133.

materials/incremental_linear_elasticity.h (incremental_linear_elasticity): σₙ₊₁ = σₙ + C : (εₙ₊₁ − εₙ) with stress as a history property and the tangent read from tangent_source (any material providing one), so a tangent that changes along the path — cure, damage, the linear-comparison composites to come — integrates incrementally. Outputs stress, tangent. Replaces incremental_linear_elasticity and incremental_solid_material; the finite-strain incremental_saint_venant_kirchhoff is left for the Hencky/finite-strain items.

Driver fix found by the report: under stress control the stress passes exactly through zero at a load reversal, and the hypoelastic sum leaves 1e-13 of round-off there; the drivers' purely relative criterion (|P:(σ − σ*)| ≤ tol·max(|σ|, |P:σ*|)) could then never be met. Both drivers now also scale with the step's own stress scale, |C|·|ε − εₙ| (|A|·|F − Fₙ| at finite strain). Covered by UniaxialStressCycleThroughZeroConverges.

Tests (test_incremental_elasticity, 4): equals the total form at every step of a load–unload path with shear and closes the cycle, with one history tensor in STATEV; the uniaxial-stress cycle through zero converges; a repeated trial from the same state does not accumulate; creation from JSON.

Report docs/materials/incremental_linear_elasticity/report.json: the standard cases plus a closed tension–shear–unload path; checks: equals linear_elasticity on every path, E under uniaxial stress, zero stress after the closed path; a step-size study showing the update exact for any step with a constant tangent.

754/754 tests pass (GCC 14, reports on).

JSON input

New material types: incremental_linear_elasticity. A json_model document that loads (the FromJson test of the PR):

{"materials": [
  {"type": "external_strain_source", "name": "strain"},
  {"type": "linear_elasticity", "name": "total", "strain_producer_name": "strain", "K": 100.0, "G": 40.0},
  {"type": "incremental_linear_elasticity", "name": "inc", "strain_source": "strain", "tangent_source": "total"}
]}

tangent_source is any producer of a tangent (here a constant one; a cure- or damage-dependent stiffness is the point of the material); outputs stress (history) and tangent.

@petlenz

petlenz commented Oct 17, 2026

Copy link
Copy Markdown
Member Author

Review findings (design, tmech expressions instead of component loops, modern C++, comments, tests, correctness). Severity: must = wrong result, hang, build break or unreachable feature; should = design, duplication, accuracy; nit = style.

incremental_linear_elasticity — needs changes (small)

  • [should] tangent reported as C_{n+1} only; for strain-dependent C the consistent tangent needs (∂C/∂ε):Δε. State "exact for strain-independent C" and add a case where tangent_source actually varies — currently the feature is exercised nowhere (report uses constant total::tangent, test compares against a constant tangent).
  • [should] F-driver convergence-scale hunk untested.
  • [nit] void update() silently overrides the dead virtual without override (others use compute); unnecessary tensor2{…} temporary; no graph-level revert() test.

@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from 2e38cdd to 3805b49 Compare October 17, 2026 14:09
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch 2 times, most recently from 865a597 to ab93cbb Compare October 17, 2026 14:31
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from 3805b49 to 7208e62 Compare October 17, 2026 15:48
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from ab93cbb to 0f0130a Compare October 17, 2026 15:48
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from 7208e62 to 90289e1 Compare October 17, 2026 16:48
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from 0f0130a to b110fb5 Compare October 17, 2026 16:48
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from 90289e1 to f444ebe Compare October 17, 2026 21:19
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from b110fb5 to 5e03c07 Compare October 17, 2026 21:26
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from f444ebe to ef6e567 Compare October 17, 2026 22:46
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from 5e03c07 to 40a9c01 Compare October 17, 2026 22:46
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch 2 times, most recently from 5b014b8 to 7058b57 Compare October 18, 2026 12:02
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from 40a9c01 to 78698ad Compare October 18, 2026 12:13
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from 7058b57 to 557b163 Compare October 18, 2026 13:38
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from 78698ad to 3a67d63 Compare October 18, 2026 13:38
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from 557b163 to 40204f6 Compare October 18, 2026 20:03
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from 3a67d63 to 81931b5 Compare October 18, 2026 20:03
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from 40204f6 to d65215c Compare October 18, 2026 20:22
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from 81931b5 to 9bb4ac2 Compare October 18, 2026 20:22
…history

sigma_{n+1} = sigma_n + C : (eps_{n+1} - eps_n) with the tangent read from
another material, for path-dependent tangents. Report: equals the total
form on every path, a closed path returns to zero, exact for any step.
Drivers: the convergence test also scales with |C| |d eps| (|A| |dF|), so
a hypoelastic stress crossing zero under stress control converges.
@petlenz
petlenz force-pushed the feature/short-fibre-composite branch from d65215c to 02524f8 Compare October 19, 2026 04:06
@petlenz
petlenz force-pushed the feature/incremental-elasticity branch from 9bb4ac2 to 108389e Compare October 19, 2026 04:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant