.. _auto_curves_engstress_scale_by_scales:

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

Scales one or more engineering stress-strain curves by a set of deviation scale factors, using a specified elastic modulus (slope) and yield-offset strain. Optionally extends the scaling into the post-necking region. Use this worker to apply per-curve variance/deviation scales when building scatter bands or performing material characterisation studies.

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

Classification: **process**.

Tagged: ``curve-scaling``, ``deviation``, ``elastic-modulus``, ``engstress``, ``material``, ``necking``, ``scaling``, ``stress-strain``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Eng Stress Strain Curves
     - eng_stress_strain_curves
     - vector
     - —
     - 
     - One or more engineering stress-strain curves (X = engineering strain, Y = engineering stress) that will be scaled; accepts multiple curve objects.
   * - Scales
     - scales
     - keyvalue
     - 0
     - 
     - Key-value map supplying the deviation scale factors to apply to each curve; keys should correspond to curve identifiers and values are the numeric scale multipliers (dimensionless).
   * - Slope
     - slope
     - scalar
     - 0
     - 
     - Elastic modulus of the material (stress/strain units consistent with the input curves, e.g. MPa); used to define the linear-elastic region during scaling; default 0 disables slope-based correction.
   * - Offset
     - offset
     - scalar
     - 0
     - 
     - Yield offset strain (dimensionless, e.g. 0.002 for 0.2 % offset); locates the yield point on the curve before applying scale factors; default 0 uses the origin.
   * - Scale After Necking
     - scale_after_necking
     - scalae
     - yes
     - 
     - Toggle ('yes' / 'no') controlling whether the scale factors are also applied to the post-necking portion of the curve; defaults to 'yes'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_engstress_scale_by_scales_output_1
     - curves_engstress_scale_by_scales_output_1
     - vector
     - Scaled engineering stress-strain curve(s) produced after applying the deviation scale factors, slope, offset, and optional post-necking scaling to the input curves.

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=curves_engstress_scale_by_scales <https://www.d3view.com/api/workflow/example?id=curves_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>curves_engstress_scale_by_scales</code>. Schema hash: <code>80eb9d86c1e9</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>