.. _auto_curve_project_tolerance:

*PROJECT POINTS FOUND WITHIN A TOLERANCE TO A SPECIFIED VALUE*
==============================================================

Scans a curve and projects any Y-values that fall within a specified tolerance band [Min Value, Max Value] to a fixed New Value. An optional look-ahead mode inspects a configurable number of future points before deciding whether to project, useful for smoothing transient spikes near the tolerance boundary.

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

Classification: **process**.

Tagged: ``clamp``, ``curve``, ``look_ahead``, ``projection``, ``snap``, ``tolerance``, ``transformations``.

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 evaluated against the tolerance band; connect any time-history or generic curve.
   * - Min Value
     - min_value
     - scalar
     - -1
     - 
     - Lower bound of the tolerance band (same units as the curve Y-axis); Y-values at or above this threshold are candidates for projection. Default: -1.
   * - Max Value
     - max_value
     - scalar
     - 1
     - 
     - Upper bound of the tolerance band (same units as the curve Y-axis); Y-values at or below this threshold are candidates for projection. Default: 1.
   * - New Value
     - new_value
     - scalar
     - 0
     - 
     - The value to which qualifying Y-points are snapped when they fall within [min_value, max_value]. Default: 0.
   * - Look Ahead
     - look_ahead
     - list
     - no
     - 
     - When set to 'yes', the worker inspects upcoming points before projecting, preventing premature snapping at the edge of a real feature; leave as 'no' for standard point-by-point projection. Default: 'no'.
   * - Look Ahead Number Of Points
     - lookaheadnumberofpoints
     - scalar
     - 10
     - 
     - Number of future points to inspect when look_ahead is 'yes'; larger values reduce false projections but increase latency. Default: 10.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_project_tolerance_output_1
     - curve_project_tolerance_output_1
     - vector
     - Transformed curve identical in length and X-values to the input, with Y-values that fell within the tolerance band replaced by new_value.

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