.. _auto_curve_effective_variance:

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

Generates a family of effective stress–strain curves by applying standard variance bounds on yield stress, ultimate stress, and failure (elongation) strain to a reference effective stress–strain curve. Provide min/max scatter values for each key mechanical property along with the elastic modulus and optional level/label settings; the worker returns the resulting variance curve(s). Use this worker to propagate material scatter for robustness or reliability studies.

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

Classification: **process**.

Tagged: ``curve_generation``, ``effective_stress_strain``, ``elastic_modulus``, ``elongation``, ``failure_strain``, ``mat_24``, ``material_scatter``, ``min_max``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Effective Stress Strain Curve
     - effective_stress_strain_curve
     - vector
     - —
     - 
     - Reference effective stress–strain curve (vector of [strain, stress] pairs, typically in consistent units, e.g. mm/mm and MPa) used as the baseline from which variance curves are derived.
   * - Yield Stress Min
     - yield_stress_min
     - scalar
     - 0
     - 
     - Lower bound of the yield stress scatter range (same stress units as the reference curve, e.g. MPa); default 0 means no downward shift is applied.
   * - Yield Stress Max
     - yield_stress_max
     - scalar
     - 0
     - 
     - Upper bound of the yield stress scatter range (same stress units as the reference curve, e.g. MPa); default 0 means no upward shift is applied.
   * - Ultimate Stress Min
     - ultimate_stress_min
     - scalar
     - 0
     - 
     - Lower bound of the ultimate (tensile) stress scatter range (same stress units as the reference curve, e.g. MPa); default 0 disables the lower variance.
   * - Ultimate Stress Max
     - ultimate_stress_max
     - scalar
     - 0
     - 
     - Upper bound of the ultimate (tensile) stress scatter range (same stress units as the reference curve, e.g. MPa); default 0 disables the upper variance.
   * - Elongation Strain Min
     - elongation_strain_min
     - scalar
     - 0
     - 
     - Lower bound of the failure (elongation) strain scatter range (dimensionless or %, consistent with the reference curve); default 0 disables the lower failure-strain variance.
   * - Elongation Strain Max
     - elongation_strain_max
     - scalar
     - 0
     - 
     - Upper bound of the failure (elongation) strain scatter range (dimensionless or %, consistent with the reference curve); default 0 disables the upper failure-strain variance.
   * - Elastic Modulus
     - elastic_modulus
     - scalar
     - 0
     - 
     - Elastic (Young's) modulus used to define the initial linear slope of the generated curves (same stress/strain units as the reference curve, e.g. MPa); default 0 inherits the slope from the reference curve.
   * - Yield Offset
     - yield_offset
     - scalar
     - 0.002
     - 
     - 
   * - Levels to generate
     - levelstogenerate
     - scalar
     - 3
     - 
     - 
   * - Level Names
     - level_names
     - scalar
     - min,mean,max
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_eff_variance_output_1
     - curve_eff_variance_output_1
     - vector
     - Output effective stress–strain variance curve (or family of curves) constructed from the min/max property bounds applied to the reference curve, returned as a vector suitable for downstream material card authoring or reliability analysis.

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

- data.curve.transform
- design_exploration.reliability
- 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_effective_variance <https://www.d3view.com/api/workflow/example?id=curve_effective_variance>`_

.. 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_effective_variance</code>. Schema hash: <code>626bedf842a6</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>