.. _auto_curve_smooth:

*SMOOTH THE CURVE*
==================

Applies a moving-average smoothing filter to a single input curve, supporting forward, backward, or forward-backward passes over a configurable x-range. Use this worker to reduce noise in time-history or force-displacement curves before downstream KPI extraction or correlation.

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

Classification: **process**.

Tagged: ``curve_filter``, ``forward_backward``, ``moving_average``, ``noise_reduction``, ``signal_smoothing``, ``smooth``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve In
     - curve_in
     - vector
     - —
     - 
     - Input curve (x/y vector) to be smoothed; accepts any unit-consistent curve object from a prior worker or file read.
   * - Smoothtype
     - smoothtype
     - string
     - forward_backward
     - 
     - Smoothing pass direction: 'forward_backward' (default, symmetric, recommended for most cases), 'forward' (causal), or 'backward' (anti-causal).
   * - Num Points
     - num_points
     - integer
     - 4
     - 
     - Half-window size (integer, default 4) controlling the number of neighbouring points used in each averaging step; larger values produce heavier smoothing.
   * - Xmin
     - xmin
     - scalar
     - -100000000000000000000
     - 
     - Lower x-axis bound at which smoothing begins; defaults to −1e20 (effectively the start of the curve) — leave at default to smooth the full range.
   * - Xmax
     - xmax
     - scalar
     - 100000000000000000000
     - 
     - Upper x-axis bound at which smoothing ends; defaults to +1e20 (effectively the end of the curve) — leave at default to smooth the full range.
   * - Limit Type
     - limit_type
     - scalar
     - absolute
     - 
     - Interpretation of the smoothing tolerance: 'absolute' (default) treats the tolerance as a fixed y-unit value; 'percentage' treats it as a fraction of the local y magnitude.
   * - Square Tolerance
     - square_tolerance
     - scalar
     - 0.001
     - 
     - 
   * - Number of Iterations
     - numberof_iterations
     - scalar
     - 1
     - 
     - 
   * - Add Shadow Points At Boundaries
     - add_shadow_points
     - scalar
     - yes
     - 
     - At boundary points(x=first and x=last), shadow points are added

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_smooth_output_1
     - curve_smooth_output_1
     - vector
     - Smoothed output curve (x/y vector) with the same x-axis as the input but noise-reduced y-values, ready for plotting, correlation, or further transformation.

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

- data.curve.transform
- data.signal_processing

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

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

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