.. _auto_nvh_compute_vector_sum:

*COMPUTE VECTOR SUM*
====================

Computes the vector sum (resultant magnitude) of multi-axis velocity or acceleration channel groups for NVH physical-test records. Use this worker when you need to derive a single resultant signal from X/Y/Z component channels stored in a d3VIEW physical-test database.

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

Tagged: ``acceleration``, ``channel``, ``mapping_database``, ``nvh``, ``physical_test``, ``resultant``, ``vector_sum``, ``velocity``.

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 source physical-test records whose channel data will be used to compute the vector sum; leave empty if supplying data via a mapping database instead.
   * - Mapping Database
     - input_database_id
     - remote_lookup
     - —
     - 
     - One or more d3VIEW mapping databases that define channel-to-axis groupings for the vector-sum calculation; leave empty if channel mappings are already embedded in the selected physical tests.
   * - Specify Locations
     - locations
     - text
     - —
     - 
     - Comma- or newline-separated list of sensor/node location labels (e.g. 'Rocker_LH, B-Pillar_RH') that scope which channel groups are processed; leave blank to process all available locations.
   * - Create New Test
     - create_new_test
     - select
     - no
     - 
     - Set to 'yes' to store the computed resultant channels in a new physical-test record; defaults to 'no', which writes results back into the source test.
   * - Test Post-fix
     - new_test_name
     - text
     - no-name
     - 
     - Post-fix string appended to the auto-generated name of the newly created physical-test record (e.g. 'VectorSum'); only used when create_new_test is 'yes'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Physical test
     - physicaltest_id
     - integer
     - Integer ID of the physical-test record containing the computed vector-sum channels — either the newly created test (when create_new_test = 'yes') or the updated source test.

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

- data.dataset.ingest
- data.dataset.transform
- data.signal_processing
- engineering.nvh

.. raw:: html

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