.. _auto_curve_scale:

*SCALE THE X-VALUES AND Y-VALUES BY THE FACTORS PROVIDED BELOW*
===============================================================

Scales the X and/or Y values of a curve by user-supplied multipliers, with optional inversion (1/factor) and a threshold to restrict scaling to values beyond a given X position. Use this worker whenever a curve needs unit conversion, amplitude adjustment, or axis flipping.

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

Classification: **process**.

Tagged: ``amplitude``, ``curve``, ``inverse``, ``scale``, ``transform``, ``unit-conversion``, ``x-scale``, ``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
     - —
     - 
     - Input curve (X/Y vector) to be scaled; must be a valid two-column curve object.
   * - X Scale Value
     - x_scalevalue
     - scalar
     - 1.0
     - 
     - Multiplicative scale factor applied to all X values; dimensionless float, default 1.0 (no change).
   * - Y Scale Value
     - y_scalevalue
     - scalar
     - 1.0
     - 
     - Multiplicative scale factor applied to all Y values; dimensionless float, default 1.0 (no change).
   * - X Inverse
     - x_inverse
     - scalar
     - no
     - 
     - When set to 'yes', inverts the X scale factor before applying it (effective multiplier becomes 1/x_scalevalue); default 'no'.
   * - Y Inverse
     - y_inverse
     - scalar
     - no
     - 
     - When set to 'yes', inverts the Y scale factor before applying it (effective multiplier becomes 1/y_scalevalue); default 'no'.
   * - Scale After X
     - scale_after
     - scalar
     - 0
     - 
     - X-axis threshold beyond which scaling is applied; points at or below this X value are left unchanged; default 0 (scale the entire curve).
   * - Scale along initial Slope
     - slope
     - scalar
     - 0
     - 
     - Designed for use with engineering stress vs strain curves to scale along the slope direction

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_scale_output_1
     - curve_scale_output_1
     - vector
     - Scaled output curve (X/Y vector) with X and Y values multiplied by the resolved scale factors, restricted to the specified X range if scale_after is set.

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

- data.curve.transform

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curve_scale <https://www.d3view.com/api/workflow/example?id=curve_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_scale</code>. Schema hash: <code>0b48302fe9f4</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>