.. _auto_dataset_column_to_curve:

*DATASET COLUMN TO CURVE*
=========================

Extracts a column of comma-separated curve values from a dataset and promotes it into a dedicated curve column with a new name. Use this worker when a dataset field stores raw CSV-encoded numeric series that need to be treated as first-class curve objects downstream.

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

Classification: **process**.

Tagged: ``column``, ``column_to_curve``, ``csv``, ``curve``, ``dataset``, ``transform``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Dataset With Columns
     - dataset_1
     - dataset
     - —
     - 
     - Input dataset (any tabular format) that contains at least one column holding CSV-encoded curve values; leave unconnected only if the column data is supplied another way.
   * - Choose Column
     - col_name
     - scalar
     - —
     - ✓
     - Name of the dataset column whose comma-separated values will be converted into a curve; the dropdown is populated automatically from the columns present in dataset_1.
   * - format
     - format
     - list
     - csv
     - 
     - Encoding format of the column values; currently only 'csv' is supported, so leave at the default unless additional formats are introduced.
   * - New Column Name
     - new_column_name
     - scalar
     - New Column
     - 
     - Label assigned to the resulting curve column in the output dataset; defaults to 'New Column' — override with a meaningful name to keep downstream references clear.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Dataset
     - dataset_col_to_curve_1
     - dataset
     - Output dataset identical to the input but with the selected column replaced or augmented by a properly typed curve column carrying the name specified in new_column_name.

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

- data.curve.transform
- data.dataset.transform
- data.io.csv

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

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

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