.. _auto_dataset_crossplotcolumns:

*CROSSPLOT TWO COLUMNS FROM A DATASET*
======================================

Extracts two named columns from a dataset and pairs them as an (X, Y) curve, optionally sorting by the X values. Use this worker to produce a crossplot vector from any tabular dataset for downstream curve analysis or visualization.

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

Classification: **process**.

Tagged: ``column_extract``, ``crossplot``, ``curve_pair``, ``dataset``, ``scatter``, ``xy_curve``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Src Dataset
     - src_dataset
     - dataset
     - —
     - 
     - Tabular dataset (d3VIEW dataset object) from which the two columns will be extracted; must contain at least the columns named in X-Column and Y-Column.
   * - X-Column
     - x-column
     - scalar
     - —
     - 
     - Name of the dataset column to use as the X axis of the crossplot; must exactly match a column header in src_dataset.
   * - Y-Column
     - y-column
     - scalar
     - —
     - 
     - Name of the dataset column to use as the Y axis of the crossplot; must exactly match a column header in src_dataset.
   * - Sort X Values
     - sort_x_values
     - strain
     - asc
     - 
     - Sort direction for the X-axis values before pairing — 'asc' (ascending, default) or 'desc' (descending); leave as 'asc' for standard monotonically-increasing curves.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - dataset_crossplotcolumns_output_1
     - dataset_crossplotcolumns_output_1
     - vector
     - XY curve vector produced by pairing the selected X and Y columns, sorted according to sort_x_values; suitable for direct use in curve-comparison or visualization workers.

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

- cae.postprocessing.visualization
- data.curve.pair
- data.dataset.transform

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

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

.. raw:: html

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