.. _auto_lsopt_combine_compiled_values:

*LS-OPT COMBINE*
================

Merges LS-OPT baseline and iteration compiled-value datasets by joining them on a shared parameters dataset and applying a user-selected arithmetic operation (add, subtract, multiply, or divide) between a baseline objective column and an iteration objective column to produce a new combined column. Use this worker to consolidate multi-iteration LS-OPT optimization results into a single dataset for downstream surrogate training or sensitivity analysis.

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

Tagged: ``baseline``, ``column_math``, ``combine``, ``compiled_values``, ``dataset_merge``, ``iteration``, ``ls-opt``, ``lsopt``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Parameters
     - parameters
     - dataset
     - —
     - ✓
     - Dataset of LS-OPT design parameters (one row per design point) used as the common join key when merging baseline and iteration results.
   * - Baseline Results
     - baseline_results
     - dataset
     - —
     - ✓
     - Dataset of compiled response/objective values from the LS-OPT baseline run; must share parameter identifiers with the parameters dataset.
   * - Iteration Results
     - iteration_results
     - dataset
     - —
     - ✓
     - Dataset of compiled response/objective values from one or more LS-OPT iteration runs; must share parameter identifiers with the parameters dataset.
   * - Baseline Objective
     - baseline_column
     - text
     - —
     - ✓
     - Name of the column in the baseline results dataset that holds the objective or response value to be used in the arithmetic operation.
   * - Baseline Objective
     - iterative_column
     - text
     - —
     - ✓
     - Name of the column in the iteration results dataset that holds the objective or response value to be paired with the baseline column in the arithmetic operation.
   * - New Objective
     - new_column
     - text
     - —
     - ✓
     - Name assigned to the newly computed column in the combined output dataset (result of applying column_math between baseline_column and iterative_column).
   * - Column Math
     - column_math
     - text
     - —
     - ✓
     - Arithmetic operation to apply between baseline_column and iterative_column values; choose one of: add, subtract, multiply, or divide.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Combined dataset
     - combined_dataset
     - dataset
     - Merged dataset containing the original parameters, baseline and iteration response columns, and the newly computed objective column derived from the selected arithmetic operation.

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

- data.dataset.transform
- design_exploration.optimization

.. raw:: html

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