.. _auto_dataset_add_curves_to_column:

*ADD CURVES TO A COLUMN*
========================

Adds a list of curves as a new column in an existing dataset. Each curve is stored as a cell value in the specified column, enabling downstream workers to access curve objects directly from dataset rows. Use this worker when you need to associate curve data with tabular records.

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

Classification: **process**.

Tagged: ``add_column``, ``curve_column``, ``curves``, ``dataset``, ``transformations``.

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 (tabular) to which the new curve column will be appended; must be a valid d3VIEW dataset object.
   * - Column Name
     - new_column_name
     - scalar
     - —
     - 
     - String name for the new column that will hold the curves; must be unique within the dataset (e.g. 'force_displacement_curves').
   * - Curves
     - curves
     - vector
     - —
     - 
     - Ordered list (vector) of curve objects to be inserted into the new column, one curve per row of the dataset.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - dataset_add_curves_to_column_output_1
     - dataset_add_curves_to_column_output_1
     - dataset
     - Updated dataset identical to the input but with the new column appended, where each cell in that column holds the corresponding input curve object.

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

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

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