.. _auto_curve_auto_clean:

*PERFORM A SERIES OF CHECKS TO AUTO CLEAN A CURVE FOR USE BY MATERIAL LAWS*
===========================================================================

Automatically cleans a raw curve for use in material law definitions by applying a configurable pipeline of digitization, x-monotonicity enforcement, and regression smoothing. Use this worker to prepare experimental stress-strain or force-displacement curves before feeding them into material calibration or parameter-fitting workflows.

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

Classification: **process**.

Tagged: ``auto_clean``, ``curve_cleaning``, ``digitize``, ``material_law``, ``monotonic``, ``preprocessing``, ``regression_smooth``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve 1
     - curve1
     - vector
     - —
     - 
     - Input curve to be cleaned (e.g., a raw experimental stress-strain or force-displacement vector); accepts any XY vector pair.
   * - Digitize Points
     - digitize_points
     - scalar
     - 100
     - 
     - Number of evenly-spaced points to re-sample the curve to after cleaning; default is 100 — increase for higher resolution or decrease to reduce noise sensitivity.
   * - X Monotonic
     - x_monotonic
     - scalar
     - yes
     - 
     - Whether to enforce strictly increasing x-values by removing or collapsing duplicate/reversed x entries; set to 'yes' (default) for material laws that require monotonic strain axes.
   * - Regression Smooth
     - regression_smooth
     - scalar
     - yes
     - 
     - Whether to apply regression-based smoothing to the curve; set to 'yes' (default) to reduce high-frequency noise before material parameter fitting.
   * - Regression Smooth Percentage
     - regression_smooth_percentage
     - scalar
     - 1
     - 
     - Bandwidth for the regression smoother expressed as a percentage of the total curve length (options: 0.1–10.0); default is 1.0 — larger values produce a smoother but less detailed curve.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_auto_clean_output_1
     - curve_auto_clean_output_1
     - vector
     - Cleaned and re-sampled XY curve vector ready for use in material law definitions or downstream calibration workers.

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

- data.curve.transform
- engineering.material.calibration
- engineering.material.characterization

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

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

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