.. _auto_curve_unloading_from_loading:

*SCALE THE Y-VALUES BY THE FACTOR TO CREATE THE UNLOADING*
==========================================================

Generates an unloading curve from a loading curve by scaling all y-values by a given factor. Use this worker when you need to derive a corresponding unloading path from an existing loading curve, e.g. for elastic-plastic material characterization or cyclic loading workflows.

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

Classification: **process**.

Tagged: ``curve-transform``, ``cyclic``, ``loading``, ``material``, ``scale``, ``unloading``, ``y-scale``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve To Be Scaled
     - curvetobescaled
     - vector
     - —
     - 
     - The input loading curve (x–y vector) whose y-values will be multiplied by the scale factor to produce the unloading curve; provide as a paired x/y vector.
   * - Scale Factor
     - scalefactor
     - scalar
     - 1.0
     - 
     - Multiplicative factor applied to every y-value of the loading curve to derive the unloading curve; defaults to 1.0 (no scaling), typically set to a negative or fractional value to represent the unloading path.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_unloading_from_loading_output_1
     - curve_unloading_from_loading_output_1
     - vector
     - Resulting unloading curve as an x–y vector, with x-values unchanged from the input and y-values scaled by the specified factor.

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

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

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