.. _auto_physicaltest_merge_responses:

*MERGES RESPONSES FROM DIFFERENT TESTS TO PROVIDE A COMBINED ONE*
=================================================================

Merges responses from multiple physical tests into a single combined test record, with configurable time-offset alignment and ordering. Use this worker to consolidate repeated or complementary test runs into one unified response dataset for downstream analysis or reporting.

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

Tagged: ``cross-correlation``, ``merge``, ``offset``, ``physical_test``, ``responses``, ``simulation``, ``test_consolidation``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Choose Physicaltests
     - pt_ids
     - remote_lookup
     - —
     - ✓
     - One or more physical-test IDs to merge; select from the platform's physical-test registry — at least two tests are required.
   * - Order Tests By
     - order_tests_by
     - select
     - as_provided
     - ✓
     - Sort order applied to the selected tests before merging; defaults to 'as_provided' to preserve the user-supplied sequence, or choose a creation-date or ID ordering.
   * - Response Names
     - response_names
     - textarea
     - —
     - 
     - Newline- or comma-separated list of response channel names to include in the merge; leave blank to automatically use the intersection of channels common to all selected tests.
   * - Offset Calculation Type
     - offset_calculation_type
     - select
     - auto
     - ✓
     - Method used to align time axes before appending: 'auto' detects offsets automatically, 'manual' uses the values in manual_offsets, 'cross-correlation-lag' computes lag via signal cross-correlation, and 'no_offsets' skips alignment entirely.
   * - Manual Offsets
     - manual_offsets
     - textarea
     - —
     - 
     - Comma-separated numeric time-offset values (one per test, same units as the test time axis); the first test typically uses 0.0 — only active when offset_calculation_type is set to 'manual'.
   * - Merge Type
     - merge_type
     - select
     - append
     - ✓
     - Strategy for combining responses; currently only 'append' is supported, which concatenates response data sequentially along the time axis.
   * - Destination Type
     - destination_type
     - select
     - create_new_test
     - ✓
     - Specifies where the merged result is stored: 'create_new_test' writes to a new physical-test record, or 'save_to_baseline' overwrites responses in an existing baseline test.
   * - New Test Name
     - new_test_name
     - text
     - Merged test<%DATE%>
     - 
     - Name assigned to the newly created merged test; supports the <%DATE%> token for automatic date stamping — only used when destination_type is 'create_new_test'.
   * - Use Sample Tests
     - use_sample_tests
     - select
     - no
     - ✓
     - When set to 'yes', the worker generates internal synthetic tests for merge validation/testing; leave at the default 'no' for production use with real test data.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Offsets Info
     - offsets_info
     - dataset
     - Tabular dataset reporting the computed or applied time-offset value for each input test, useful for auditing alignment decisions (columns: test ID, offset value, method used).

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

- data.curve.pair
- data.dataset.ingest
- data.dataset.transform
- data.signal_processing

.. raw:: html

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