.. _auto_curves_get_yvalue_at:

*RETURNS THE Y-VALUES AT A CERTAIN X VALUE. USES INTERPOLATION WHEN NEEDED.*
============================================================================

Extracts the Y-value from one or more curves at a specified X-coordinate, using interpolation when the X-value does not fall exactly on a data point. Use this worker to sample curve responses at a precise instant (e.g. peak time, specific displacement) across a batch of results.

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

Classification: **process**.

Tagged: ``batch_curves``, ``curve_sampling``, ``interpolation``, ``x_lookup``, ``y_value``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves
     - curves
     - vector
     - —
     - 
     - One or more input curves from which Y-values will be extracted; each curve must carry X/Y data — accepts any curve-compatible vector (time-history, force-displacement, etc.).
   * - X Min
     - x_value
     - float
     - 0.0
     - 
     - The X-coordinate at which the Y-value is to be read; defaults to 0.0 — linear interpolation is applied when the value falls between two data points.
   * - Attr Name
     - attr_name
     - scalar
     - name
     - 
     - Curve attribute used as the key in the output map; choose from 'id', 'name', 'component', or 'file' — defaults to 'name' so each result row is labelled by the curve's display name.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_get_yvalue_at_output_1
     - curves_get_yvalue_at_output_1
     - keyvalue
     - Key-value map where each key is the selected curve attribute (id / name / component / file) and the corresponding value is the interpolated Y-value (same units as the curve's Y-axis) at the requested X-coordinate.

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

- data.curve.pair
- 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_get_yvalue_at <https://www.d3view.com/api/workflow/example?id=curves_get_yvalue_at>`_

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