.. _auto_simulation_response_extractor:

*CREATES RESPONSES FROM A SIMULATION*
=====================================

Extracts named responses (KPIs, time-histories, scalars) from a simulation record and packages them as a dataset for downstream processing. Use this worker whenever a workflow needs to pull structured response data from an existing simulation without re-running the solver.

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

Tagged: ``kpi``, ``post_processing``, ``response_extraction``, ``simulation``, ``user``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - simulation_id
     - remote_lookup
     - —
     - ✓
     - Remote lookup reference to the target simulation record; select the simulation whose responses are to be extracted — required, no default.
   * - Responses
     - responses
     - dataset
     - —
     - 
     - Dataset definition specifying which responses to extract from the simulation (e.g. peak acceleration, intrusion, force-deflection curves); configure via the 'Extract Response' modal — required, no default.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulation
     - sim_id
     - integer
     - Integer identifier of the source simulation record from which responses were extracted.
   * - Extracted Responses
     - responses
     - dataset
     - Dataset containing the extracted simulation responses (scalars, curves, or KPI values) keyed by response name.
   * - Logs
     - logs
     - dataset
     - Dataset of extraction log messages, warnings, and error details for auditing or debugging the response extraction run.

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

- cae.postprocessing.extraction
- cae.postprocessing.response

.. raw:: html

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