.. _auto_curves_crossplot_values:

*COMPUTE A CURVE BASED ON THE VALUES FROM A GROUP OF CURVES*
============================================================

Constructs a crossplot curve by extracting a single scalar value (e.g. xfirst, ymax) from each curve in the X-group and each curve in the Y-group, then pairing them point-by-point into a new curve. Use this worker to visualize how a key feature of one set of curves varies against a key feature of another set.

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

Classification: **process**.

Tagged: ``crossplot``, ``curve_values``, ``scalar_extraction``, ``transformations``, ``xy_pair``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves X
     - curves_x
     - vector
     - —
     - 
     - Collection of input curves whose extracted scalar (per X-Value Type) will form the X-coordinates of the output crossplot curve; supply one curve per desired data point.
   * - Curves Y
     - curves_y
     - vector
     - —
     - 
     - Collection of input curves whose extracted scalar (per Y-Value Type) will form the Y-coordinates of the output crossplot curve; must have the same count as Curves X.
   * - X-Value Type
     - x-value_type
     - string
     - xfirst
     - 
     - Scalar extraction rule applied to each curve in Curves X; choose from xfirst, xlast, xmax, yfirst, ylast, ymax, or ymin — defaults to 'xfirst' (first x-value of each curve).
   * - Y-Value Type
     - y-value_type
     - string
     - ymax
     - 
     - Scalar extraction rule applied to each curve in Curves Y; choose from xfirst, xlast, xmax, yfirst, ylast, ymax, or ymin — defaults to 'ymax' (peak y-value of each curve).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_crossplot_values_output_1
     - curves_crossplot_values_output_1
     - vector
     - Single output curve whose N points are the (X-Value Type, Y-Value Type) scalar pairs extracted from the N input curve pairs, forming a crossplot scatter line.

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_crossplot_values <https://www.d3view.com/api/workflow/example?id=curves_crossplot_values>`_

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