.. _auto_curves_normalize_to_first:

*NORMALIZE THE CURVES BY DIVIDING THE Y-VALUES BY THE Y-MAX FROM THE FIRST CURVE*
=================================================================================

Normalizes one or more curves by dividing their y-values by the maximum y-value found in the first curve. Use this worker to bring a batch of curves onto a common [0, 1] scale relative to the first curve's peak, enabling direct shape comparison.

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

Classification: **process**.

Tagged: ``batch-curves``, ``curves``, ``first-curve-reference``, ``normalize``, ``scale``, ``y-normalization``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve To Be Normalized
     - curvetobenormalized
     - vector
     - —
     - 
     - One or more input curves (x/y vector pairs) to be normalized; the first curve supplies the reference y-max used as the divisor for all curves in the batch.
   * - Type
     - type
     - scalar
     - x
     - 
     - Axis or axes to normalize: 'x' normalizes x-values, 'y' normalizes y-values, 'xy' normalizes both; defaults to 'x' — set to 'y' for the most common amplitude-normalization use case.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_normalize_to_first_output_1
     - curves_normalize_to_first_output_1
     - vector
     - Collection of normalized curves with the selected axis (or axes) divided by the first curve's corresponding maximum value, preserving the original x/y vector format.

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

- data.curve.transform

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

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

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