.. _auto_curves_smooth:

*SMOOTH THE CURVES*
===================

Applies moving-average smoothing to one or more input curves using forward, backward, forward-backward, or regression passes over a configurable window of points. Use this worker to reduce noise in time-history or signal data before further post-processing or comparison.

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

Classification: **process**.

Tagged: ``curve_smoothing``, ``forward_backward``, ``moving_average``, ``noise_reduction``, ``regression``, ``smooth``, ``time_history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves In
     - curves_in
     - vector
     - —
     - 
     - One or more curves to be smoothed; accepts any X-Y curve vector (e.g. force-displacement, acceleration vs. time) passed from upstream workers.
   * - smoothtype
     - smoothtype
     - string
     - forward_backward
     - 
     - Smoothing algorithm to apply: 'forward_backward' (default, bidirectional moving average), 'forward' (causal), 'backward' (anti-causal), or 'regression' (least-squares local fit).
   * - num_points
     - num_points
     - integer
     - 4
     - 
     - Half-window size (integer, default 4) — number of neighbouring points used on each side for the moving average; larger values produce stronger smoothing.
   * - xmin
     - xmin
     - scalar
     - -100000000000000000000
     - 
     - Lower X-axis bound (same units as the curve X axis) beyond which smoothing is not applied; defaults to −1e20 (effectively no lower limit).
   * - xmax
     - xmax
     - scalar
     - 100000000000000000000
     - 
     - Upper X-axis bound (same units as the curve X axis) beyond which smoothing is not applied; defaults to +1e20 (effectively no upper limit).
   * - limit_type
     - limit_type
     - scalar
     - absolute
     - 
     - Interpretation of xmin/xmax bounds: 'absolute' (default) treats them as raw axis values; 'percentage' treats them as a percentage of the curve's total X range.
   * - Square Tolerance
     - square_tolerance
     - scalar
     - 0.001
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_smooth_output_1
     - curves_smooth_output_1
     - vector
     - Smoothed output curves in the same X-Y vector format as the input, with the same number of curves returned after applying the selected smoothing algorithm within the specified X range.

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