.. _auto_curves_intersect:

* COMPUTE THE INTERSECTION OF TWO CURVES*
=========================================

Computes the intersection point(s) of two XY curves and returns a scalar result derived from the crossing point. Use this worker to extract intersection-based KPIs such as the first, last, average, min, max, or extreme-coordinate values where two curves cross.

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

Classification: **process**.

Tagged: ``crossover``, ``curve_intersection``, ``intersection``, ``scalar_extraction``, ``xy_curves``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve 1
     - curve1
     - vector
     - —
     - 
     - First input XY curve (vector); the primary curve against which the intersection with Curve 2 is computed.
   * - Curve 2
     - curve2
     - vector
     - —
     - 
     - Second input XY curve (vector); the curve intersected with Curve 1 to find crossing point(s).
   * - Type of Intersection
     - intersecttype
     - float
     - y
     - 
     - Scalar quantity to extract from the intersection(s): options include xfirst/yfirst (first crossing), xlast/ylast (last crossing), xavg/yavg (average crossing), xmin/ymin, xmax/ymax, values (all crossings), or xatymax (X-value at maximum Y crossing); defaults to 'y' (yfirst).
   * - Number of Digitize Points
     - num_dig
     - scalar
     - -1
     - 
     - Number of digitization points used to resample curves before intersection; use -1 (default) to skip resampling and operate on the curves as provided.
   * - Use monotonically increasing intersections
     - monotonic
     - select
     - no
     - 
     - When set to 'yes', restricts the intersection search to monotonically increasing crossing points only; defaults to 'no' (all crossings considered).
   * - After X
     - after_x
     - scalar
     - 0
     - 
     - 

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_intersect_output_1
     - curves_intersect_output_1
     - scalar
     - Scalar value derived from the intersection of the two input curves, representing the coordinate or aggregate quantity specified by intersecttype (e.g. the Y-value at the first crossing); returns 0.0 if no intersection is found.

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

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