.. _auto_dataset_regression_build:

*DATASET REGRESSION BUILD*
==========================

Fits a polynomial regression model on a tabular dataset, mapping one independent column to one or more dependent columns. Use this worker to build regression curves (by specifying polynomial order) for downstream surrogate modelling, correlation analysis, or data-driven response fitting.

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

Classification: **process**.

Tagged: ``curve_fitting``, ``dataset``, ``polynomial``, ``regression``, ``regression_build``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Dataset
     - dataset
     - dataset
     - —
     - 
     - Input tabular dataset (d3VIEW dataset object) containing the columns to be regressed; leave unconnected only if the dataset is supplied by an upstream worker.
   * - Independent Column
     - independent_column
     - text
     - unclassified
     - 
     - Name of the column to treat as the independent (predictor) variable X; defaults to 'unclassified' — replace with the exact column header string from the dataset.
   * - Dependent Columns
     - dependent_columns
     - text
     - —
     - 
     - Comma-separated list of column names to treat as dependent (response) variables Y; leave blank to target all non-independent columns.
   * - Order
     - order
     - scalar
     - —
     - 
     - Polynomial order (integer ≥ 1) for the regression fit, e.g. 1 = linear, 2 = quadratic; leave blank to apply a default order (typically 1).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - dataset_regression_build_output_1
     - dataset_regression_build_output_1
     - keyvalue
     - Key-value result object containing the fitted regression coefficients and goodness-of-fit metrics (e.g. R², polynomial coefficients) for each dependent column.

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

- ai_ml.supervised.regression
- ai_ml.surrogate
- 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_regression_build <https://www.d3view.com/api/workflow/example?id=dataset_regression_build>`_

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