.. _auto_simulation_physicaltest_binout_matcher:

*MATCH PHYSICALTEST TO BINOUT DATA EXTRACTION*
==============================================

Maps physical-test responses to matching binout channels extracted from a simulation, then applies user-defined scale factors, filters, and clip/transform operations before returning a unified response dataset. Use this worker to align test and simulation time-histories in preparation for correlation or overlay analysis.

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

Tagged: ``binout``, ``clip``, ``correlation_prep``, ``filter``, ``physical_test``, ``response_matching``, ``scale``, ``sim_vs_test``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Physicaltest
     - pt_id
     - remote_lookup
     - —
     - ✓
     - Remote lookup key identifying the physical test record whose responses will be matched; must resolve to a valid physical-test entry containing named response channels.
   * - Simulation with Binouts
     - sim_id
     - remote_lookup
     - —
     - ✓
     - Remote lookup key identifying the simulation whose binout files will supply the matching channels; the worker queries the binout menu for available paths and labels.
   * - Map Information
     - map_info
     - mapper
     - —
     - ✓
     - Column-to-column mapper that pairs each physical-test response name (left/to) with its corresponding binout channel path (right/from); all unmapped rows are ignored during extraction.
   * - Scale factors
     - scale_def
     - textarea
     - —
     - 
     - Optional comma-separated list of per-channel scale factors in the format name/xsf/ysf (e.g. ch1/1.0/9810); leave blank to apply no scaling.
   * - Filter Definitions
     - filter_def
     - textarea
     - —
     - 
     - Optional comma-separated filter specifications in the format name/filter_type/filter_freq/time_sf/acc_sf (e.g. ch1/CFC60/60/1.0/1.0); leave blank to skip filtering.
   * - Clip Definitions
     - clip_def
     - textarea
     - —
     - 
     - Optional comma-separated clip windows in the format name/xmin/xmax/ymin/ymax (e.g. ch1/0.0/0.1/-500/500); leave blank to retain full curve extents.
   * - Transformations Definitions
     - transform_def
     - dataset
     - —
     - 
     - Optional dataset table (columns: name, xsf, ysf, xoffset, yoffset, xmin, ymin, filter_type, filter_freq) that consolidates all per-channel transformations; operations are applied in SCALE → CLIP → FILTER order and supersedes the individual scale/filter/clip text fields when provided.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Responses
     - responses
     - dataset
     - Dataset of matched and transformed response channels (dataType: responses) containing both the physical-test and binout time-histories aligned by the user-defined mapping, ready for downstream correlation or visualisation workers.

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

- cae.postprocessing.extraction
- cae.postprocessing.response
- data.correlation
- data.curve.pair
- data.curve.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>simulation_physicaltest_binout_matcher</code>. Schema hash: <code>ffd989d2d9dc</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>