.. _auto_simulation_add_responses:

*ADD RESPONSES TO SIMULATION*
=============================

Attaches one or more responses (curves, scalars, or views) to an existing simulation record in the d3VIEW platform. Use this worker when a workflow needs to persist computed KPIs or post-processing results back to a simulation, optionally broadcasting the same responses to every simulation in a parent study.

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

Tagged: ``kpi``, ``platform``, ``postprocessing``, ``responses``, ``simulation``, ``study``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Simulation
     - input_sim_id
     - remote_lookup
     - —
     - ✓
     - Platform simulation ID (remote lookup against the simulations registry) that will receive the new responses; required — select the target simulation from the dropdown.
   * - Responses
     - responses
     - dataset
     - —
     - ✓
     - Dataset containing the responses to attach; each row must conform to the d3VIEW response dataset schema (curve, scalar, or view entries) — see linked glossary for column requirements.
   * - Replace Existing Responses
     - replace_existing_responses
     - select
     - yes
     - 
     - Controls whether responses with matching names already attached to the simulation are overwritten ('yes', default) or left untouched ('no'); leave as 'yes' to keep results idempotent across re-runs.
   * - Study
     - input_study_id
     - remote_lookup
     - —
     - 
     - Optional platform study ID; when supplied, the same responses are also saved to every simulation belonging to this study — leave blank to target only the single simulation above.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Simulatiion
     - sim_id
     - integer
     - Integer platform ID of the simulation to which the responses were successfully attached; can be wired into downstream workers that require a simulation reference.
   * - Responses
     - responses
     - dataset
     - Dataset of the responses that were written, containing curve, scalar, and/or view entries — mirrors the input responses after any replacement logic has been applied.

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

- cae.postprocessing.response
- platform.workflow

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