.. _auto_curve_get_regularization_error:

*GET REGULARIZATION ERROR*
==========================

Computes the regularization error between a base curve and a digitized curve. Use this worker to quantify how closely a digitized or approximated curve matches the original reference, returning a scalar error metric as a key-value result.

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

Classification: **process**.

Tagged: ``curve_comparison``, ``curve_error``, ``digitization``, ``error_metric``, ``regularization``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Base Curve
     - base_curve
     - vector
     - —
     - ✓
     - The reference (ground-truth) curve against which the digitized curve is compared; accepts a single curve or the first curve of a CurveGroup (x/y vector pairs).
   * - Digitized Curve
     - digitized_curve
     - vector
     - —
     - ✓
     - The digitized or approximated curve to be evaluated; accepts a single curve or the first curve of a CurveGroup, matched point-wise against the base curve.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Error
     - cgre
     - keyvalue
     - Key-value map containing the computed regularization error scalar(s) quantifying the deviation of the digitized curve from the base curve.

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

- data.correlation
- data.curve.pair
- 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_get_regularization_error <https://www.d3view.com/api/workflow/example?id=curve_get_regularization_error>`_

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