.. _auto_dataset_sync_curve_columns:

*SYNC X VALUES FOR THE SELECTED COLUMNS*
========================================

Synchronises the X-axis values across one or more curve columns in a dataset, with optional monotonicity enforcement and digitisation. Use it to align time/frequency axes before cross-column curve comparisons or batch post-processing.

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

Classification: **process**.

Tagged: ``align``, ``columns``, ``curve``, ``dataset``, ``digitize``, ``monotonic``, ``sync``, ``x_axis``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Dataset
     - dataset_1
     - dataset
     - —
     - 
     - Input dataset containing the curve columns to be synchronised; each selected column must hold (x, y) curve data.
   * - Choose Column
     - target_column
     - text
     - —
     - 
     - One or more column names from dataset_1 whose X values will be synchronised; populated dynamically from the chosen dataset.
   * - Sync Type
     - sync_type
     - scalar
     - first_last
     - 
     - Synchronisation strategy: 'first_last' (default) aligns curves to a shared first/last X range; 'yes' forces full sync across all X points; 'yes_min_zero' same as yes but pins the minimum X to zero; 'no' skips X synchronisation.
   * - Monotonic
     - monotonic
     - scalar
     - no
     - 
     - Enforces monotonic ordering after sync — 'no' (default) skips enforcement; 'x' enforces monotone X; 'y' enforces monotone Y; 'xy' enforces both axes simultaneously.
   * - Digitize
     - digitize
     - scalar
     - 0
     - 
     - Uniform re-sampling step size (positive number); when > 0 all selected curves are digitised (re-sampled) at this X interval after syncing; leave at default 0 to skip digitisation.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Synced Dataset
     - synced_dataset
     - dataset
     - A copy of the input dataset with the selected curve columns replaced by their X-synchronised (and optionally monotonised/digitised) counterparts; all other columns are preserved unchanged.

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

- data.curve.pair
- data.curve.transform
- 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_sync_curve_columns <https://www.d3view.com/api/workflow/example?id=dataset_sync_curve_columns>`_

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