.. _auto_curves_search_by_value:

*FIND THE ANGLE BETWEEN THREE TIME-HISTORY POINTS*
==================================================

Filters a collection of time-history curves by comparing a selected scalar value (first Y, last Y, max, min, or average) against a user-defined target using a specified condition (equal, greater-than, less-than, or between). Returns only the curves that satisfy the condition. Use this worker to subset large curve sets before downstream processing or plotting.

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

Classification: **process**.

Tagged: ``curve_filter``, ``scalar_comparison``, ``search_by_value``, ``time_history``, ``transformations``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curves
     - curves
     - vector
     - —
     - 
     - Collection of time-history curves to search; accepts multiple curve objects — leave empty to pass an upstream curve vector directly.
   * - Value Type
     - value_type
     - string
     - eq
     - 
     - Scalar extracted from each curve for comparison: 'yfirst' (first Y sample), 'ylast' (last Y sample), 'ymax' (peak Y), 'ymin' (trough Y), or 'yaverage' (mean Y); defaults to 'eq' placeholder — set explicitly before running.
   * - Target Condition
     - target_condition
     - string
     - eq
     - 
     - Comparison operator applied between the extracted scalar and target_value: 'eq' (equal), 'gt' (greater than), 'lt' (less than), or 'between' (inclusive range expecting two comma-separated values in target_value); defaults to 'eq'.
   * - Target Value
     - target_value
     - string
     - —
     - 
     - Numeric threshold or range to compare against; supply a single number for 'eq'/'gt'/'lt' conditions, or two comma-separated numbers (e.g. '0.5,1.5') when target_condition is 'between'.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_search_by_value_output_1
     - curves_search_by_value_output_1
     - vector
     - Subset of the input curves whose extracted scalar value satisfies the specified condition; returns a vector of curve objects in the same format as the input.

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

- data.curve.pair

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

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

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