.. _auto_curve_engstress_scale_by_scales:

*COMPUTE VARIANCE BASED ON SCALES*
==================================

Scales an engineering stress-strain curve by applying deviation scales to key parameters (slope/elastic modulus and yield offset) to generate a variance curve. Use this worker when exploring material property scatter or building upper/lower bound stress-strain curves from a nominal baseline.

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

Classification: **process**.

Tagged: ``elastic_modulus``, ``engstress``, ``material_curve``, ``necking``, ``scaling``, ``stress_strain``, ``variance``, ``yield_offset``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Eng Stress Strain Curve
     - eng_stress_strain_curve
     - vector
     - —
     - 
     - Nominal engineering stress-strain curve (vector of strain-stress pairs) to be scaled; serves as the baseline from which the variance curve is derived.
   * - Scales
     - scales
     - keyvalue
     - 0
     - 
     - Key-value map of deviation scale factors applied to material parameters (e.g., stress scale, strain scale); leave at default 0 for no scaling.
   * - Slope
     - slope
     - scalar
     - 0
     - 
     - Elastic modulus (slope of the linear elastic region, e.g. in MPa or GPa); used to anchor the scaled curve's initial stiffness — leave at 0 to inherit slope from the input curve.
   * - Offset
     - offset
     - scalar
     - 0
     - 
     - Yield offset value (dimensionless strain, typically 0.002 for 0.2% proof stress); used to shift the yield point when generating the variance curve — leave at 0 for no offset.
   * - Scale After Necking
     - scale_after_necking
     - scalae
     - yes
     - 
     - Flag ('yes'/'no') controlling whether scaling is applied to the post-necking region of the curve; default 'yes' allows full-curve variance generation.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_engstress_scale_by_scales_output_1
     - curve_engstress_scale_by_scales_output_1
     - vector
     - Scaled engineering stress-strain variance curve (vector of strain-stress pairs) generated by applying the specified deviation scales, slope, and offset to the input baseline 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_scale_by_scales <https://www.d3view.com/api/workflow/example?id=curve_engstress_scale_by_scales>`_

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