.. _auto_curves_weighted_average:

*AVERAGE TWO OR MORE CURVES*
============================

Computes a weighted average of two or more X-Y curves, resampling them onto a common uniform grid before blending. Use this worker when you need to combine simulation or test curves with configurable relative weighting rather than a simple arithmetic mean.

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

Classification: **process**.

Tagged: ``averaging``, ``curve_blend``, ``resampling``, ``transformations``, ``weighted_average``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Base Curve
     - base_curve
     - vector
     - —
     - 
     - Primary input curve (X-Y vector); accepts multiple curves — this is the first operand in the weighted blend and acts as the reference for domain alignment.
   * - Curve to be added
     - curvetobeadded
     - vector
     - —
     - 
     - Secondary input curve (X-Y vector) to be blended with the base curve; this is the second operand in the weighted average.
   * - Num Dig
     - num_dig
     - scalar
     - 100
     - 
     - Number of equally-spaced resampling points placed over [x_min, XMAX], computed as (XMAX−XMIN)/num_dig; default 100 — increase for higher resolution output.
   * - x_min
     - x_min
     - scalar
     - 0.0
     - 
     - Lower bound of the resampling domain (same units as the curve X-axis); default 0.0 — override when the region of interest does not start at zero.
   * - weight_first
     - weight_first
     - scalar
     - 0.5
     - 
     - Weight applied to the base curve in the blend (0.0–1.0); the complementary weight (1 − weight_first) is applied to the second curve — default 0.5 produces a straight arithmetic mean.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_weighted_average_output_1
     - curves_weighted_average_output_1
     - vector
     - Resulting weighted-average curve (X-Y vector) resampled onto the uniform grid defined by x_min and num_dig, with Y-values equal to weight_first·Y₁ + (1−weight_first)·Y₂.

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

- data.curve.pair
- data.curve.transform

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

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

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