.. _auto_curve_yfunction:

*COMPUTE THE Y VALUES BASED ON THE FUNCTION THAT USES BOTH Y AND X*
===================================================================

Recomputes the y-values of an input curve by evaluating a user-supplied mathematical expression that may reference both `y` (current y-value) and `x` (current x-value) at each data point. Use this worker whenever you need a custom, formula-driven transformation of a curve that depends on both axes — for example `sqrt(y)*x` or `y/x + 2`.

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

Classification: **process**.

Tagged: ``curve``, ``custom_function``, ``expression``, ``formula``, ``math``, ``transform``, ``xy``, ``yfunction``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve
     - input_curve
     - vector
     - —
     - 
     - The source curve (x/y vector pair) whose y-values will be recomputed; must be provided as a standard d3VIEW curve object — optional only if the expression is self-contained, but typically required.
   * - Function
     - function
     - textarea
     - —
     - 
     - Mathematical expression string that defines the new y-value at each point, with `y` and `x` as reserved variables (e.g. `sqrt(y)*x`); leave blank to perform no transformation.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curve_yfunction_output_1
     - curve_yfunction_output_1
     - vector
     - Output curve with the same x-values as the input but with y-values replaced by the result of evaluating the supplied expression at every data point.

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=curve_yfunction <https://www.d3view.com/api/workflow/example?id=curve_yfunction>`_

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