COMPUTES THE INTEGRAL BETWEEN TWO X-VALUES¶
Computes the definite integral of a curve between two specified x-values using numerical integration. Use this worker whenever you need the area under a curve over a bounded interval.
When to use¶
Classification: process.
Tagged: area_under_curve, curve_transform, definite_integral, integral, interval, numerical_integration.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve | curve | vector | — | The input curve (x-y vector pairs) whose definite integral is to be computed; must span at least the [xs, xe] interval. | |
| X-Start | xs | scalar | — | Start x-value of the integration interval (same units as the curve’s x-axis); defaults to the curve’s minimum x if left blank. | |
| X-End | xe | scalar | — | End x-value of the integration interval (same units as the curve’s x-axis); defaults to the curve’s maximum x if left blank. | |
| Baseline Mode | baseline_mode | select | y_zero | Baseline that the curve is integrated against. ‘Y=0’ is the original behavior (definite integral of the curve over [xs, xe]). ‘Endpoints (chord)’ draws a straight line from (xs, y(xs)) to (xe, y(xe)) and integrates (curve - chord), which is the chord / hysteresis / DSC peak-energy convention. ‘Horizontal’ uses a constant Y value set in ‘Y Baseline’. | |
| Y Baseline | y_baseline | string | 0 | Constant Y value used as the baseline when Baseline Mode is ‘Horizontal’. Ignored otherwise. | |
| Area Mode | area_mode | select | signed | ‘Signed’ returns the net trapezoidal integral; regions where the curve dips below the baseline subtract from the total. ‘Absolute’ returns the integral of the absolute difference; sign changes within a segment are handled by splitting that segment at the zero crossing so the answer matches a fine-grained hand calculation. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| integral_between | integral_between | scalar | Scalar result of the definite integral of the curve from xs to xe (units are the product of the curve’s x- and y-axis units). |
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=curve_integral_between
Auto-generated from transformation schema. Worker id: curve_integral_between. Schema hash: 6c4d04669bb1. Hand-curated docs in workerexamples/ override this page when present.