.. _auto_gissmo_build_lcregd_curve:

*GISSMO BUILD LCREGD REGULARIZATION CURVE*
==========================================

Build a GISSMO LCREGD mesh-size regularization curve (dimensionless factor vs element size mm), normalized to 1.0 at the reference element size. Empirical path fits factor=eps_f(L)/eps_f_ref through 2-3 mesh-size calibration points; the Hillerborg 1/L fallback is a rough constant-fracture-energy approximation for when no multi-mesh data exists.

When to use
-----------

Tagged: ``gissmo``, ``lcregd``, ``regularization``, ``mesh``, ``failure_strain``, ``fracture``, ``materials``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Calibrated Failure Strain
     - failure_strain_calibrated
     - text
     - —
     - 
     - eps_f (equivalent plastic strain to fracture) measured at the reference element size. Dimensionless, > 0.
   * - Reference Element Size (mm)
     - reference_element_size
     - text
     - —
     - 
     - Element size (mm) at which eps_f was measured. The curve is normalized to factor=1.0 at this size. > 0.
   * - Mesh Calibration Points (JSON)
     - mesh_calibration_points
     - text
     - —
     - 
     - JSON array of {"element_size": mm, "failure_strain": eps_f} from coupon runs at 2-3 different mesh sizes. Required for the empirical path. Do NOT include the reference point (implicit at factor=1.0).
   * - Use Hillerborg 1/L Fallback
     - fracture_energy_method
     - text
     - no
     - 
     - 'no' (default) = empirical fit through the calibration points (recommended). 'yes' = analytic 1/L fallback (rough approximation; use only when no calibration data exists).
   * - Fallback Output Points
     - n_output_points
     - text
     - 20
     - 
     - Number of log-spaced points in the output curve (Hillerborg fallback path only; the empirical path uses the calibration points directly).

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - LCREGD Result
     - lcregd_result
     - keyvalue
     - Assoc result: lcregd_curve [[length_mm, factor], ...], reference_element_size, method ('empirical'/'hillerborg_fallback'), normalization_check, validation_note, and (fallback) warning. On bad input, an 'error' key.

Disciplines
-----------

- engineering.material.calibration
- engineering.crash.dynamics
- cae.preprocessing.deck_authoring

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>gissmo_build_lcregd_curve</code>. Schema hash: <code>8476ac9bbfac</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>