.. _auto_curves_integrate:

*INTEGRATE CURVES*
==================

Integrates one or more input curves numerically (area under the curve), with an optional filter to ignore positive or negative values before integration. Use this worker whenever you need cumulative integrals of time-history or signal data within a workflow.

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

Classification: **process**.

Tagged: ``area_under_curve``, ``curves``, ``integrate``, ``numerical_integration``, ``signal``, ``time_history``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Curve 1
     - curve1
     - vector
     - —
     - 
     - One or more input curves (vector) to be integrated; accepts multiple curves simultaneously — leave empty only if curves are provided upstream via a connected node.
   * - Ignore
     - ignore
     - list
     - none
     - 
     - Selects which signed values to zero out before integration: 'none' (default) integrates all values, 'positive' ignores positive values, 'negative' ignores negative values.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - curves_integrate_output_1
     - curves_integrate_output_1
     - vector
     - Resulting integrated curve(s) (vector) representing the cumulative integral of each input curve, with the same x-axis as the input.

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

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