.. _auto_curve_adjust_yield:

*ADJUST YIELD TO THIS VALUE*
============================

Shifts an effective stress–strain curve so that its yield point matches a user-specified target stress value. The adjustment can be applied in strain-based or stress-based mode, with an optional maximum allowable deviation from the raw curve. Use this worker when recalibrating a material card to a measured or nominal yield stress.

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

Classification: **process**.

Tagged: ``MAT_24``, ``curve_transform``, ``eng_stress``, ``material_calibration``, ``strain_based``, ``stress_based``, ``stress_strain``, ``true_stress``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Effective Stress Vs Strain Curve
     - effectivestressvs_strain_curve
     - vector
     - —
     - ✓
     - Input effective stress vs. strain curve (vector of paired values) that will be shifted to the new yield point; must be a valid SS curve in either engineering or true stress/strain convention.
   * - New Yield
     - new_yield
     - scalar
     - —
     - ✓
     - Target yield stress value (scalar, same stress units as the input curve — e.g. MPa) to which the curve's yield point will be adjusted.
   * - Type Of Yield
     - typeof_yield
     - text
     - eng
     - 
     - Convention of the target yield stress: 'eng' for engineering (nominal) stress or 'true' for true stress; defaults to 'eng' — must match the convention of the input curve.
   * - Adjust Type
     - adjust_type
     - list
     - strain-based
     - 
     - Algorithm used to relocate the yield point: 'strain-based' shifts along the strain axis while preserving stress values, 'stress-based' scales stress values; defaults to 'strain-based'.
   * - Max Percentage
     - max_percentage
     - scalar
     - 0.0
     - 
     - Maximum allowable deviation (%) from the original raw curve after adjustment; set to 0.0 (default) to apply no deviation cap.
   * - Strain Range
     - strain_range
     - scalar
     - 0.0
     - 
     - Reserved strain-range parameter — currently unused by the adjustment algorithm; leave at its default value of 0.0.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_adjust_yield_output_1
     - curve_adjust_yield_output_1
     - vector
     - Adjusted effective stress vs. strain curve (vector) with the yield point relocated to the specified target stress, in the same format and units as the 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_adjust_yield <https://www.d3view.com/api/workflow/example?id=curve_adjust_yield>`_

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