.. _auto_curve_engstress_variance_dynamic:

*CREATE A CURVE USING THE STANDARD VARIANCE OF YIELD, ULTIMATE AND FAILURE STRESS*
==================================================================================

Generates a dynamic engineering stress–strain curve by applying standard variance bounds (min/max) on yield stress, ultimate stress, and failure strain to a reference quasi-static curve, optionally blended with a dynamic reference curve. Use this worker when building material scatter bands or worst-case/best-case dynamic stress–strain curves for crash material calibration.

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

Classification: **process**.

Tagged: ``dynamic``, ``engstress``, ``failure``, ``mat_24``, ``material-curve``, ``quasi-static``, ``scatter-band``, ``stress-strain``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Dynamic Eng Stress Strain Curve
     - dynamic_eng_stress_strain_curve
     - vector
     - —
     - 
     - Reference dynamic engineering stress–strain curve (vector of strain–stress pairs); provides the high-rate backbone shape when blending with the quasi-static curve.
   * - QS Eng Stress Strain Curve
     - qs_eng_stress_strain_curve
     - vector
     - —
     - 
     - Reference quasi-static engineering stress–strain curve (vector of strain–stress pairs); serves as the baseline from which variance-shifted curves are generated.
   * - QS Yield Stress Min
     - qs_yield_stress_min
     - scalar
     - 0
     - 
     - Minimum allowable quasi-static yield stress (scalar, stress units consistent with the input curves, default 0); defines the lower bound of the yield stress scatter band.
   * - QS Yield Stress Max
     - qs_yield_stress_max
     - scalar
     - 0
     - 
     - Maximum allowable quasi-static yield stress (scalar, same stress units as input curves, default 0); defines the upper bound of the yield stress scatter band.
   * - QS Ultimate Stress Min
     - qs_ultimate_stress_min
     - scalar
     - 0
     - 
     - Minimum allowable quasi-static ultimate tensile stress (scalar, same stress units as input curves, default 0); sets the lower bound for the UTS variance.
   * - QS Ultimate Stress Max
     - qs_ultimate_stress_max
     - scalar
     - 0
     - 
     - Maximum allowable quasi-static ultimate tensile stress (scalar, same stress units as input curves, default 0); sets the upper bound for the UTS variance.
   * - QS Elongation Strain Min
     - qs_elongation_strain_min
     - scalar
     - 0
     - 
     - Minimum allowable quasi-static elongation (failure) strain (scalar, dimensionless or %, default 0); defines the lower bound of the failure-strain scatter band.
   * - QS Elongation Strain Max
     - qs_elongation_strain_max
     - scalar
     - 0
     - 
     - Maximum allowable quasi-static elongation (failure) strain (scalar, dimensionless or %, default 0); defines the upper bound of the failure-strain scatter band.
   * - Elastic Modulus
     - elastic_modulus
     - scalar
     - 0
     - 
     - 
   * - Yield Offset
     - yield_offset
     - scalar
     - 0.002
     - 
     - Stress offset applied at the yield point during dynamic curve construction (scalar, same stress units as input curves); shifts the yield knee to account for dynamic strengthening.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_engstress_variance_dynamic_output_1
     - curve_engstress_variance_dynamic_output_1
     - vector
     - Resulting dynamic engineering stress–strain curve (vector of strain–stress pairs) constructed by applying the specified yield, ultimate, and failure-strain variance bounds to the quasi-static reference, blended with the dynamic input curve.

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

- data.curve.transform
- engineering.material.calibration
- engineering.material.characterization

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curve_engstress_variance_dynamic <https://www.d3view.com/api/workflow/example?id=curve_engstress_variance_dynamic>`_

.. raw:: html

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