.. _auto_complexcurves_match:

*COMPUTE COMPLEX CURVE DIFFERENCE USING THE AMPLITUDE*
======================================================

Computes the amplitude-based difference between two complex curves using a selectable distance metric (raw, absolute, Euclidean, Fréchet, DTW, or overlap). Use this worker to quantify how closely a candidate curve matches a baseline, with optional digitization, normalization, and x-range clipping.

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

Classification: **process**.

Tagged: ``amplitude``, ``baseline``, ``candidate``, ``complex_curves``, ``curve_difference``, ``curve_match``, ``digitize``, ``distance``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve 1
     - curve1
     - vector
     - —
     - 
     - Baseline curve (vector/CurveGroup); the reference against which Curve 2 is compared — accepts multiple curves but the first is used as the baseline.
   * - Curve 2
     - curve2
     - vector
     - —
     - 
     - Candidate curve (vector) to compare against the baseline; should share the same x-axis domain as Curve 1 for meaningful results.
   * - Math Type
     - match_type
     - list
     - raw
     - 
     - Distance metric used to compute the curve difference: 'raw' (signed difference), 'abs' (absolute difference), 'euclidean-distance', 'frechet', 'dynamic-time-warping', or 'overlap'; defaults to 'raw'.
   * - Digitize
     - digitize
     - list
     - 0
     - 
     - Number of evenly-spaced points to re-sample both curves onto before comparison; '0' disables re-sampling and uses the original data points — increase (e.g. 100–1000) when the two curves have different sampling densities.
   * - Normalize
     - normalize
     - list
     - no
     - 
     - Whether to normalize both curves by their respective amplitudes before computing the distance ('yes'/'no'); set to 'yes' when comparing curves with different magnitude scales; defaults to 'no'.
   * - Xmin
     - xmin
     - scalar
     - 0
     - 
     - 
   * - Xmax
     - xmax
     - scalar
     - 0
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - complexcurves_match_output_1
     - complexcurves_match_output_1
     - scalar
     - Scalar distance value quantifying the amplitude-based difference between Curve 1 and Curve 2 under the chosen metric; lower values indicate closer agreement.

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

- data.correlation
- data.curve.pair
- data.statistics

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>transformation</code> schema. Worker id: <code>complexcurves_match</code>. Schema hash: <code>b643ee75ccf1</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>