.. _auto_curve_check_tolerance:

*CURVE CHECK TOLERANCE*
=======================

Evaluates every Y-value of a curve against a configurable tolerance band and returns a same-length output curve whose values are set to either the pass or fail scalar. Use this worker to gate downstream logic on whether a signal stays within acceptable bounds (e.g. residual checks, convergence monitors).

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

Classification: **process**.

Tagged: ``abs``, ``check``, ``curve``, ``derivative``, ``moving_average``, ``pass_fail``, ``quality_gate``, ``signal_check``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - Input curve (X/Y vector) whose Y-values will be tested against the tolerance band; must be provided before the worker can execute.
   * - Tolerance Type
     - tolerance_type
     - scalar
     - abs
     - 
     - Method used to evaluate each Y sample: 'abs' takes the absolute value of Y, 'raw' uses the signed value, 'raw_mean_diff' / 'sq_mean_diff' measure deviation from the mean, and 'derivative_mean_abs_dist' operates on the first derivative; defaults to 'abs'.
   * - Tolerance
     - min_tolerance
     - scalar
     - 0.001
     - 
     - Lower bound of the acceptable tolerance band (same units as the evaluated Y metric); a sample at or above this value is considered passing; defaults to 0.001.
   * - Tolerance
     - max_tolerance
     - scalar
     - 0.01
     - 
     - Upper bound of the acceptable tolerance band (same units as the evaluated Y metric); a sample above this value is considered failing; defaults to 0.01.
   * - Pass Value
     - pass_value
     - scalar
     - 1
     - 
     - Scalar written to the output curve at positions where the tolerance check passes; defaults to 1 (boolean-style flag).
   * - Fail Value
     - fail_value
     - scalar
     - 0
     - 
     - Scalar written to the output curve at positions where the tolerance check fails; defaults to 0 (boolean-style flag).
   * - Number Of Points
     - number_points
     - scalar
     - 1
     - 
     - Size of the moving window (number of consecutive points) used when computing a smoothed/aggregated value before the tolerance check; defaults to 1 (no smoothing).
   * - Moving Window Value Type To Check
     - moving_window_value_type_to_check
     - scalar
     - abs
     - 
     - Moving window value type

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_check_tolerance_output_1
     - curve_check_tolerance_output_1
     - vector
     - Output curve with the same X-axis as the input; each Y-value is replaced by pass_value or fail_value depending on whether the corresponding sample satisfied the tolerance condition.

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

- data.curve.transform
- data.statistics

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

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curve_check_tolerance <https://www.d3view.com/api/workflow/example?id=curve_check_tolerance>`_

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