.. _auto_curves_scale_based_on_ratios:

*DIVIDE PAIRS OF CURVES*
========================

Scales each curve in a target group by the point-wise ratio (Group 1 ÷ Group 2) of two reference curve groups. Use this worker when you need to normalize or correct a set of curves by a factor derived from paired reference curves; the number of curves in the target group must match the number of ratio pairs.

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

Classification: **process**.

Tagged: ``batch``, ``curve_pairs``, ``divide``, ``normalization``, ``ratio``, ``scale``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves To Be Scaled
     - curve_to_be_scaled
     - vector
     - —
     - 
     - One or more curves to be scaled; each curve is multiplied by the ratio derived from the corresponding pair in Group 1 and Group 2 — the count must equal the number of curve pairs supplied to those groups.
   * - Curves Group 1
     - curve_group1
     - vector
     - —
     - 
     - Numerator reference curves (Group 1); each curve is paired with the corresponding curve in Group 2 to compute the scaling ratio (Group 1 ÷ Group 2).
   * - Curves Group 2
     - curve_group2
     - vector
     - —
     - 
     - Denominator reference curves (Group 2); paired element-wise with Group 1 to form the divisor of the scaling ratio — must contain the same number of curves as Group 1.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Scaled Curves
     - curves_scale_based_on_ratios
     - vector
     - Resulting scaled curves, one per input target curve, each multiplied by the corresponding Group 1 ÷ Group 2 ratio curve; output count and x-axis discretization match the input target curves.

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_based_on_ratios <https://www.d3view.com/api/workflow/example?id=curves_scale_based_on_ratios>`_

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