.. _auto_lsopt_results_importer:

*LS-OPT RESULTS IMPORTER*
=========================

Imports and consolidates LS-OPT optimization results by pairing a design-parameter dataset with a corresponding response/results dataset. Use this worker to ingest completed LS-OPT study data into a d3VIEW workflow and identify the optimal design point according to a specified objective.

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

Tagged: ``design_exploration``, ``lsopt``, ``optimization``, ``parameter_study``, ``results_import``.

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 variables (one row per simulation run, one column per design parameter); must match the row count of the results dataset.
   * - Results
     - results
     - dataset
     - —
     - ✓
     - Dataset of LS-OPT simulation responses or KPIs (one row per run, one column per response quantity); row order must align with the parameters dataset.
   * - Objective
     - objective
     - input
     - —
     - ✓
     - Name of the response column (from the results dataset) to be used as the optimization objective, e.g. 'intrusion_mm' or 'mass_kg'.
   * - Objective Type
     - objective_type
     - select
     - minimize
     - ✓
     - Direction of optimization for the objective column; select 'minimize' (default) to find the lowest value or 'maximize' to find the highest value.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - opt variables
     - opt_variables
     - dataset
     - Combined dataset of design parameters and responses annotated with the optimal design point row identified according to the specified objective and direction.

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

- cae.postprocessing.response
- data.dataset.ingest
- 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_results_importer</code>. Schema hash: <code>7844f958f215</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>