.. _auto_responses_matcher:

*RESPONSES MATCHER*
===================

Matches responses between two datasets (a "from" set and a "to" set) using configurable name mappings and returns a unified, updated response list. Use this worker when you need to reconcile or align response identifiers across two simulation or test result collections before downstream processing.

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

Tagged: ``dataset``, ``mapping``, ``matcher``, ``reconciliation``, ``responses``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Responses From
     - responses_from
     - dataset
     - —
     - 
     - Source response dataset whose entries will be matched against the target; expects a tabular dataset with at least a 'name' column identifying each response.
   * - Responses To
     - responses_to
     - dataset
     - —
     - 
     - Target response dataset that the source responses are matched against; must share a comparable 'name' column with responses_from.
   * - Map Definitions
     - map_data
     - mapper
     - —
     - 
     - Optional mapper defining explicit name-to-name correspondence rules between responses_from and responses_to; leave empty to rely on exact name matching.
   * - Update Responses Name
     - update_responses
     - select
     - no
     - ✓
     - Controls whether matched response names in the output are overwritten with the target names ('yes') or kept as-is from the source ('no', default).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Responses
     - responses
     - dataset
     - Merged and matched response dataset containing the reconciled list of responses from both input sets, with names optionally updated per the update_responses setting.

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

- cae.postprocessing.response
- data.dataset.transform

.. raw:: html

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