.. _auto_curves_scale_curve_by_parameters:

*SCALE CURVES IN THE TABLE USING A PARAMETER DATASET*
=====================================================

Scales a collection of curves using per-curve X and Y scale factors sourced from a parameter dataset, where each row corresponds to one input curve. Supports four scaling modes: all values, offset-to-first-point, post-initial-peak, or after a custom X threshold.

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

Classification: **process**.

Tagged: ``batch``, ``curve_scaling``, ``offset``, ``parameter_dataset``, ``peak``, ``scale``, ``scale_factor``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves To Be Scaled
     - curves
     - vector
     - —
     - 
     - Ordered list of curves to be scaled; the row order must match the row order of the parameters dataset — one curve per row.
   * - Parameters
     - parameters
     - dataset
     - —
     - 
     - Dataset (table) containing per-curve scaling parameters; must have the same number of rows as curves, with column names referenced by x_sf and y_sf.
   * - X-Scale Factor Column Name
     - x_sf
     - text
     - —
     - 
     - Name of the column in the parameters dataset that holds the X-axis scale factor for each curve; leave blank if no X scaling is needed.
   * - Y-Scale Factor Column Name
     - y_sf
     - text
     - —
     - 
     - Name of the column in the parameters dataset that holds the Y-axis scale factor for each curve; leave blank if no Y scaling is needed.
   * - Type Of Scaling
     - type_of_scaling
     - scalar
     - all
     - 
     - Scaling mode: 'all' applies the factor to every point; 'offset' shifts the curve to its first point before scaling; 'initial_peak' scales only points after the first peak; 'custom' scales only points after the X value specified in custom_x_after — defaults to 'all'.
   * - Scale After X
     - x_after
     - text
     - —
     - 
     - Values after this value of X will be scaled. Values per curve can be specified by separating them using commas

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Scaled Curves
     - scale_curve_by_parameters_output_1
     - vector
     - Ordered list of scaled curves in the same sequence as the input curves, with X and/or Y values multiplied by the per-row scale factors from the parameters dataset.

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

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

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