.. _auto_physicaltest_validate_body_sensitivity:

*VALIDATE BODY SENSITIVITY TEST DATA*
=====================================

Validates body sensitivity (NVH body characterisation) physical-test data against a configurable set of signal-quality checks including coherence, PSD roll-off/growth, driving-point repeatability, cross-point reciprocity, driving-point symmetry, and driving-point orientation. Use this worker to gate body sensitivity test results before they are consumed by downstream NVH or correlation workflows.

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

Tagged: ``body_sensitivity``, ``coherence``, ``driving_point``, ``nvh``, ``physical_test``, ``psd``, ``reciprocity``, ``repeatability``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Physicaltest
     - input_pt_id
     - remote_lookup
     - —
     - 
     - One or more physical-test records to validate, selected by remote lookup against the platform physicaltests datastore; repeatable to batch-validate multiple tests in a single run.
   * - Choose Checks To Perform
     - checks
     - select
     - all
     - 
     - Multi-select list of validation checks to execute; defaults to 'all', which runs every available check (coherence, psd_roll_off, psd_growth, dr_repeatability, cp_reciprocity, dr_symmetric, dr_orientation).
   * - Min Coherence
     - min_coherence
     - scalar
     - 0.9
     - 
     - Minimum acceptable coherence value (dimensionless, 0–1) over the coherence frequency band; default 0.9 — lower only if the test setup warrants looser acceptance.
   * - Coherence Freq Start
     - min_coherence_freq
     - scalar
     - 50
     - 
     - Lower bound of the coherence check frequency band in Hz; default 50 Hz.
   * - Coherence Freq End
     - max_coherence_freq
     - scalar
     - 800
     - 
     - Upper bound of the coherence check frequency band in Hz; default 800 Hz.
   * - PSD Freq Start
     - min_psd_freq
     - scalar
     - 50
     - 
     - Lower bound of the PSD roll-off and growth check frequency band in Hz; default 50 Hz.
   * - PSD Freq End
     - max_psd_freq
     - scalar
     - 1000
     - 
     - Upper bound of the PSD roll-off and growth check frequency band in Hz; default 1000 Hz.
   * - PSD Rolloff Limit
     - psd_rolloff_limit
     - scalar
     - 6
     - 
     - Maximum allowable PSD roll-off in dB/decade (or equivalent slope unit) before the check flags a failure; default 6.
   * - PSD Growth Limit
     - psd_growth_limit
     - scalar
     - 3
     - 
     - Maximum allowable PSD growth in dB over the defined frequency band before the check flags a failure; default 3.
   * - DPRFS
     - dr_min_repeat_freq
     - scalar
     - 50
     - 
     - Lower bound of the driving-point repeatability check frequency band in Hz (DPRFS); default 50 Hz.
   * - DPRFE
     - dr_max_repeat_freq
     - scalar
     - 80%
     - 
     - Upper bound of the driving-point repeatability check frequency band; accepts a Hz value or a percentage string such as '80%' meaning 80 % of the Nyquist/analysis frequency (DPRFE); default '80%'.
   * - DPRRP
     - dr_repeatability_run_pairs
     - text
     - —
     - 
     - Comma- or space-delimited run-pair identifiers used to compare repeated driving-point measurements for repeatability; depends on input_pt_id — leave blank to use all available run pairs (DPRRP).
   * - DPRET
     - dr_repeatability_error_limit
     - scalar
     - 0.01
     - 
     - Maximum acceptable RMS error (dimensionless ratio) between repeated driving-point runs; default 0.01 (1 %) (DPRET).
   * - DPSFS
     - dr_min_symm_freq
     - scalar
     - 50
     - 
     - Driving Point Symm Freq Start
   * - DPSFE
     - dr_max_symm_freq
     - scalar
     - 80%
     - 
     - Driving Point Symm Freq End
   * - DPSRET
     - dr_symmetric_error_limit
     - scalar
     - 0.01
     - 
     - Driving Point Symmetric Response Error Tolerance
   * - DPOFS
     - dr_min_orien_freq
     - scalar
     - 50
     - 
     - Driving Point Orien Freq Start
   * - DPOFE
     - dr_max_orien_freq
     - scalar
     - 1000
     - 
     - Driving Point Orien Freq End
   * - CRRP
     - cr_reciprocity_run_pairs
     - text
     - —
     - 
     - Cross-Point Reciprocity Run Pairs
   * - CRET
     - cr_reciprocity_error_limit
     - scalar
     - 0.01
     - 
     - Cross-Point Reciprocity Error Tolerance

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Physicaltest Id
     - physicaltest_id
     - integer
     - Integer primary key of the validated physical-test record in the platform physicaltest datastore, enabling downstream workers to reference the result directly.
   * - Failed Report
     - failed_report
     - dataset
     - Editable dataset listing every check that failed — columns include test ID, check name, measured value, limit, and pass/fail status — to support triage and sign-off workflows.

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

- data.correlation
- data.dataset.ingest
- data.signal_processing
- engineering.nvh
- platform.workflow

.. 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_validate_body_sensitivity</code>. Schema hash: <code>b9529a74ee70</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>