.. _auto_curves_sync_units:

*SYNC UNITS IF THE CURVES ARE OF DIFFERENT SCALE*
=================================================

Synchronises a collection of curves that share the same physical axis but differ in unit scale by applying a common scale-up or scale-down factor to the selected axis (X or Y). The reference magnitude is sampled at a user-chosen measurement location (start, mid, or end) and independent scale factors are applied in each direction. Use this worker when combining curves from different unit systems (e.g. mm vs. m, kN vs. N) before comparison or further processing.

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

Classification: **process**.

Tagged: ``"``, ``]``, ``_``, ``a``, ``c``, ``e``, ``f``, ``i``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves To Be Synced For Units
     - curvestobesyncedforunits
     - vector
     - —
     - 
     - Collection of two or more curves (vector of curve objects) whose axis values need to be brought to a common unit scale; supply all curves that should be synchronised together.
   * - Axis To Sync
     - axis
     - scalar
     - y
     - 
     - Axis to which the unit-sync scale factor is applied — choose 'x' for the time/displacement axis or 'y' (default) for the response/force axis.
   * - Measurement Location
     - location
     - scalar
     - mid
     - 
     - Point along each curve at which the representative magnitude is sampled to determine the scaling direction — 'start', 'mid' (default), or 'end'.
   * - Scale Up Down
     - scale_up_down
     - scalar
     - up
     - 
     - Direction of the unit conversion: 'up' (default) multiplies values by the scale factor (e.g. m → mm), 'down' divides them (e.g. mm → m).
   * - X Sf Up
     - x_sf_up
     - integer
     - 1
     - 
     - Integer multiplier applied to the X axis when scaling up (default 1); e.g. set to 1000 to convert seconds to milliseconds.
   * - X Sf Down
     - x_sf_down
     - integer
     - 1
     - 
     - Integer divisor applied to the X axis when scaling down (default 1); e.g. set to 1000 to convert milliseconds to seconds.
   * - Y Sf Up
     - y_sf_up
     - integer
     - 1
     - 
     - Y Scale Up value
   * - Y Sf Down
     - y_sf_down
     - integer
     - 1
     - 
     - Y Scale Down value

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_sync_units_output_1
     - curves_sync_units_output_1
     - vector
     - Collection of unit-synchronised curves with the selected axis rescaled by the appropriate scale factor; the curve count and structure match the input collection.

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

- data.curve.pair
- data.curve.transform
- data.units

Runnable example
----------------

A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: `/api/workflow/example?id=curves_sync_units <https://www.d3view.com/api/workflow/example?id=curves_sync_units>`_

.. raw:: html

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