.. _auto_responsetemplate_binout_matcher:

*MATCH RESPONSETEMPLATE BINOUT RESPONSES TO BINOUTS*
====================================================

Matches binout-based response template entries to actual binout channels extracted from a simulation, optionally applying scale factors and filters. Use this worker to populate a response template's binout responses from LS-DYNA simulation binout data before downstream KPI extraction or reporting.

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

Tagged: ``binout``, ``binout_matcher``, ``channel_mapping``, ``kpi``, ``ls-dyna``, ``response_template``, ``simulation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Responsetemplate
     - rt_id
     - remote_lookup
     - —
     - ✓
     - Remote lookup ID of the response template whose binout-based responses are to be matched; must reference a template with at least one response whose data source is set to 'dyna_binout'.
   * - Simulation with Binouts
     - sim_id
     - remote_lookup
     - —
     - ✓
     - Remote lookup ID of the simulation whose binout files will be scanned and used as the source channels for matching against the response template entries.
   * - Map Information
     - map_info
     - mapper
     - —
     - ✓
     - Mapper widget that pairs each response template response (left/to column: response name) with a binout channel path from the selected simulation (right/from column: binout path); populated dynamically once both rt_id and sim_id are selected.
   * - Scale factors
     - scale_def
     - textarea
     - —
     - 
     - Optional comma-separated scale factor overrides in the format 'name/xsf/ysf' (e.g. 'accel_head/1.0/9.81,force_knee/1.0/0.001'); leave blank to apply no scaling.
   * - Filter Definitions
     - filter_def
     - textarea
     - —
     - 
     - Optional comma-separated SAE/Butterworth filter definitions in the format 'name/filter_type/cutoff_freq_Hz' (e.g. 'accel_head/SAE/180,force_sill/CFC/60'); leave blank to apply no filtering.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Responses
     - responses
     - dataset
     - Dataset of matched response records (dataType: responses) linking each response template entry to its corresponding binout time-history channel, with any requested scale factors and filters applied.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- data.correlation

.. raw:: html

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