.. _auto_curves_offset_scale:

*OFFSET AND SCALE CURVES*
=========================

Applies independent X/Y offset and scale transformations to one or more input curves. Each axis is first shifted by its offset value and then multiplied by its scale factor. Use this worker to perform unit conversions, sign flips, or arbitrary linear rescaling of time-history or XY curves.

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

Classification: **process**.

Tagged: ``curve_transform``, ``linear_transform``, ``offset``, ``scale``, ``unit_conversion``, ``xy_curve``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves To Be Scaled
     - curvestobescaled
     - vector
     - —
     - 
     - One or more XY curves to be transformed; accepts multiple curve objects — leave empty only if chaining output from a prior worker.
   * - X Offset
     - x_offset
     - scalar
     - 0
     - 
     - Scalar added to every X value before X scaling is applied (dimensionless shift in the curve's X units); default 0 means no shift.
   * - Y Offset
     - y_offset
     - scalar
     - 0
     - 
     - Scalar added to every Y value before Y scaling is applied (dimensionless shift in the curve's Y units); default 0 means no shift.
   * - X Scale
     - x_scale
     - scalar
     - 1
     - 
     - Multiplicative factor applied to X values after the X offset; use to convert X-axis units or invert the axis (e.g. 0.001 for ms→s); default 1.0 leaves X unchanged.
   * - Y Scale
     - y_scale
     - scalar
     - 1
     - 
     - Multiplicative factor applied to Y values after the Y offset; use to convert Y-axis units or invert the axis (e.g. -1.0 to negate); default 1.0 leaves Y unchanged.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_offset_scale_output_1
     - curves_offset_scale_output_1
     - vector
     - Transformed XY curve(s) with the offset and scale operations applied to both axes, preserving the original curve count and point count.

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