.. _auto_simulation_responses:

*GET RESPONSES FROM SIMULATION*
===============================

Retrieves named responses (KPIs/time-history results) from one or more existing simulations by matching on response name or ID. Use this worker to pull structured simulation outputs into a workflow for downstream processing or reporting.

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

Tagged: ``kpi``, ``remote_lookup``, ``response_lookup``, ``responses``, ``simulation``.

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
     - —
     - ✓
     - One or more simulation records to query; select from the platform simulation registry (remote lookup, repeatable — provide at least one simulation ID).
   * - Response Names
     - input_response_names
     - text
     - —
     - 
     - Comma-separated list of response names to filter by (e.g. 'Peak_Force,Intrusion'); leave blank to skip name-based filtering.
   * - Response IDs
     - input_response_ids
     - text
     - —
     - 
     - Comma-separated list of integer response IDs to filter by; leave blank to skip ID-based filtering.
   * - Match Type
     - match_type
     - select
     - contains
     - 
     - String-matching strategy applied to response names/IDs: 'exact', 'contains' (default), 'starts_with', or 'ends_with'.
   * - Return
     - limit
     - select
     - -1
     - 
     - Maximum number of responses to return per simulation: -1 (default) returns all matches; 1 returns only the first match.

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

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