.. _auto_vector_scale:

*VECTOR SCALE*
==============

Multiplies every element of an input vector by a scalar scale factor, returning a new scaled vector. Use this worker whenever a signal, force, displacement, or any numeric vector needs uniform amplitude adjustment within a workflow.

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

Classification: **process**.

Tagged: ``amplitude``, ``scalar_multiplication``, ``scale``, ``signal``, ``transform``, ``vector``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - V1TBS
     - vector1tobescaled
     - vector
     - —
     - 
     - The input vector whose elements will each be multiplied by the scale factor; accepts any numeric vector (e.g. time-history, force, displacement array) — connect the upstream vector output here.
   * - Scale Factor
     - scale_factor
     - scalar
     - —
     - 
     - Dimensionless scalar multiplier applied uniformly to every element of the input vector (e.g. 1.0 leaves the vector unchanged, 2.0 doubles it, -1.0 inverts it).

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - vector_scale_output_1
     - vector_scale_output_1
     - vector
     - Resulting vector of the same length as the input, with every element equal to the original value multiplied by the provided scale factor.

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

- data.curve.transform

.. raw:: html

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