.. _auto_physicaltest_sync_timehistories:

*SYNC TIME-HISTORY RESPONSES SO THEY ALL HAVE THE SAME TIME-STAMP*
==================================================================

Synchronises time-history responses across multiple physical tests so that all curves share a common x-axis (timestamp) grid. Supports union of unique values, largest/smallest sampling rates, or a fully custom interpolation range, and can report, create, or replace the resulting responses in the platform.

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

Tagged: ``common-timestep``, ``interpolation``, ``physical-test``, ``resampling``, ``simulation``, ``sync``, ``time-history``, ``x-axis``.

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 records to synchronise; all selected tests must share at least one common response channel.
   * - Sync Type
     - sync_type
     - select
     - unique
     - ✓
     - Strategy for building the shared x-axis: 'unique' merges all distinct time stamps, 'largest_sampling' uses the coarsest grid, 'smallest_resolution' uses the finest grid, and 'custom' applies a user-defined MIN:MAX:STEP range (default: 'unique').
   * - CRNTM
     - response_names
     - textarea
     - —
     - 
     - Newline- or comma-separated list of response channel names (CRNTM) to synchronise; leave blank to automatically use all channels common to every selected test.
   * - Overwrite
     - overwrite
     - select
     - report
     - ✓
     - Disposition for the synchronised curves: 'report' logs results without writing, 'create' saves new response records (using prefix/postfix), and 'replace' overwrites existing responses in-place (default: 'report').
   * - PFNR
     - prefix_for_new_responses
     - text
     - —
     - 
     - String prepended to each new response name when overwrite is set to 'create'; leave empty for no prefix.
   * - PFNR
     - postfix_for_new_responses
     - text
     - —
     - 
     - String appended to each new response name when overwrite is set to 'create'; leave empty for no postfix.
   * - Custom Interpolation Values
     - custom_interpolation
     - text
     - —
     - 
     - Custom x-axis specification in MIN:MAX:STEP format (e.g. '0:1:0.001'); only used when sync_type is 'custom'; leave blank otherwise.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Physicaltests
     - physicaltests
     - dataset
     - Dataset of the physical-test records that were processed, including updated metadata reflecting the synchronisation operation.
   * - Meta Data
     - meta_data
     - dataset
     - Dataset of synchronisation metadata (e.g. chosen x-axis grid, number of responses affected, mode used) for audit and traceability.
   * - Responses
     - responses
     - dataset
     - Dataset of the synchronised response curves, each resampled onto the common x-axis grid; rows correspond to individual channel-time-step observations.

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

- data.curve.pair
- data.curve.transform
- data.dataset.ingest
- 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_sync_timehistories</code>. Schema hash: <code>5e8a26a7db4a</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>