.. _auto_curve_math:

*RUN MATH FUNCTIONS ON Y VALUES*
================================

Applies a mathematical or trigonometric function (e.g. cos, sin, log10, sqrt, exp, rad2deg) to the Y values of an input curve, leaving X values unchanged. Use this worker whenever a single-curve element-wise math transform is needed as part of a signal-processing or data-preparation pipeline.

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

Classification: **process**.

Tagged: ``cos``, ``curve``, ``deg2rad``, ``elementwise``, ``exp``, ``log``, ``math``, ``rad2deg``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - curve
     - vector
     - —
     - 
     - Input curve (X/Y vector) whose Y values will be transformed; must be a valid d3VIEW curve object — see Glossary for accepted formats.
   * - Trig Function
     - trig_function
     - list
     - cos
     - 
     - Math function to apply element-wise to all Y values; choose from cos, sin, tan, tanh, atan, acos, asin, sinh, rad2deg, deg2rad, log10, sqrt, or exp (exponent of e) — defaults to 'cos' if omitted.
   * - Args based on Function
     - args
     - textarea
     - —
     - 
     - Optional extra arguments required by the selected function (e.g. scaling factors or offsets); leave blank for standard single-argument math functions.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_fft_output_1
     - curve_fft_output_1
     - vector
     - Output curve with the same X values as the input and Y values replaced by the result of the selected math function.

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

- data.curve.transform
- data.signal_processing

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

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

.. raw:: html

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