.. _auto_curves_scale_up_down:

*ENSURE SECOND CURVE IS HIGHER THAN THE FIRST CURVE BY SCALING UP OR DOWN*
==========================================================================

Scales the second curve up or down relative to the base curve so that it consistently sits above (or below) the base curve by a specified percentage deviation. Use this worker to enforce upper/lower bound corridor curves in pass/fail assessments or envelope checks.

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

Classification: **process**.

Tagged: ``corridor``, ``curve_scaling``, ``envelope``, ``lower_bound``, ``scale``, ``scale_up_down``, ``upper_bound``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Base Curve
     - base_curve
     - vector
     - —
     - 
     - The reference (baseline) curve against which the second curve will be scaled; accepts a vector of (x, y) pairs.
   * - Second Curve
     - second_curve
     - vector
     - —
     - 
     - The curve to be scaled up or down relative to the base curve; accepts a vector of (x, y) pairs.
   * - Scale Type
     - scale_type
     - scalar
     - up
     - 
     - Direction of scaling: 'up' shifts the second curve above the base curve, 'down' shifts it below; defaults to 'up'.
   * - Percentage
     - percentage
     - scalar
     - 5
     - 
     - Percentage deviation from the mean used to determine the magnitude of the scale shift applied to the second curve; dimensionless, defaults to 5 (i.e. 5%).
   * - Digitize
     - digitize
     - scalar
     - -1
     - 
     - Total number of evenly-spaced points in the output curve after re-digitization; set to -1 (default) to retain the original point count.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_scale_up_down_output_1
     - curves_scale_up_down_output_1
     - vector
     - The scaled second curve as a vector of (x, y) pairs, guaranteed to lie above (scale_type='up') or below (scale_type='down') the base curve by the specified percentage.

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

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