COMPUTE THE DIFFERENCE BETWEEN TWO CURVES

Computes the pairwise difference (match) between two sets of curves using a selectable distance metric such as raw difference, Euclidean distance, Fréchet, or Dynamic Time Warping. Use this worker to quantitatively compare reference and simulation curves or any two curve groups for correlation and validation purposes.

When to use

Classification: process.

Tagged: comparison, correlation, curves, difference, digitize, distance, dtw, dynamic-time-warping.

Inputs

Label ID Type Default Required Description
Reference Curves reference_curves vector   One or more reference (baseline) curves against which the compare curves will be matched; accepts multi-select vector inputs (e.g. physical test or target simulation channels).
Compare Curves compare_curves vector   One or more curves to compare against the reference curves; must correspond positionally to the reference set for pair-wise matching.
Match Type match_type list raw   Distance/difference metric to apply: ‘raw’ (signed difference), ‘abs’ (absolute difference), ‘max’ (peak difference), ‘max-max-dif’ (max-to-max delta), ‘euclidean-distance’, ‘frechet’, or ‘dynamic-time-warping’; defaults to ‘raw’.
Digitize digitize list 0   Number of evenly-spaced points to re-sample (digitize) each curve to before matching (0 = no re-sampling); use higher values such as 100–1000 when curves have inconsistent or sparse point spacing.
Normalize normalize list no   Whether to normalize both curves before computing the match metric (e.g. ‘no’ to skip normalization); leave as ‘no’ when curves are already on the same scale.
Xmin xmin scalar 0   Lower bound of the x-axis window over which the match is computed (same units as the curve x-axis); set to 0.0 to use the full curve range.
Xmax xmax scalar 0   Upper bound of the x-axis window over which the match is computed (same units as the curve x-axis); set to 0.0 to use the full curve range.
Sync sync list yes   Whether to time-synchronize the two curves before matching (‘yes’ / ‘no’); use ‘yes’ when curves may have different start times or offsets.

Outputs

Label ID Type Description
curves_match_pairs_output_1 curves_match_pairs_output_1 scalar Scalar (or array of scalars) representing the computed match/difference metric for each curve pair, in the units implied by the selected match_type (dimensionless for normalized/distance metrics, original y-units for raw/abs).

Disciplines

  • data.correlation
  • data.curve.pair

Runnable example

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curves_match_pairs


Auto-generated from transformation schema. Worker id: curves_match_pairs. Schema hash: 10e2fc7cdd2b. Hand-curated docs in workerexamples/ override this page when present.