.. _auto_curve_engstress_scale:

*CREATE A CURVE BY SCALING TO THE YIELD, ULTIMATE AND FAILURE STRAIN*
=====================================================================

Scales an engineering stress-strain curve to match target yield stress, ultimate stress, and failure (elongation) strain by applying stress and strain deviations. Use this worker to adapt a reference coupon curve to a new material lot or grade without re-running physical tests.

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

Classification: **process**.

Tagged: ``deviation``, ``elongation``, ``engineering_curve``, ``engstress``, ``material_scaling``, ``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 Curve
     - eng_stress_strain_curve
     - vector
     - —
     - 
     - Reference engineering stress-strain curve (XY vector, stress in MPa vs. engineering strain) to be scaled; serves as the baseline shape for the transformation.
   * - New Yield Stress
     - new_yield_stress
     - scalar
     - 0
     - 
     - Target yield stress (MPa, scalar) for the scaled curve; set to 0 to derive it from the curve and elastic modulus using the offset method.
   * - New Ultimate Stress
     - new_ultimate_stress
     - scalar
     - 0
     - 
     - Target ultimate (peak) stress (MPa, scalar) for the scaled curve; set to 0 to preserve the original ultimate stress.
   * - New Elongation Strain
     - new_elongation_strain
     - scalar
     - 0
     - 
     - Target failure (elongation at break) engineering strain (dimensionless, scalar) for the scaled curve; set to 0 to preserve the original failure strain.
   * - Elastic Modulus
     - elastic_modulus
     - scalar
     - 0
     - 
     - Elastic modulus (MPa, scalar) used to compute the 0.2 % offset yield point when new_yield_stress is 0; set to 0 only if yield stress is supplied directly.
   * - Yield Offset
     - yield_offset
     - scalar
     - 0.002
     - 
     - Strain offset used in the offset-yield method (dimensionless, default 0.002 = 0.2 %); change only when a non-standard offset convention is required.
   * - New Necking Strain
     - new_necking_strain
     - scalar
     - 0
     - 
     - Target engineering strain at the onset of necking (dimensionless, scalar) for the scaled curve; set to 0 to preserve the original necking strain or when necking is not separately controlled.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_engstress_scale_output_1
     - curve_engstress_scale_output_1
     - vector
     - Scaled engineering stress-strain curve (XY vector, same units as input) with stress and strain axes adjusted to match the specified yield, ultimate, and failure strain targets.

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 <https://www.d3view.com/api/workflow/example?id=curve_engstress_scale>`_

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