GET VALUES OF X WHEN Y INCREASES¶
Scans each input curve and returns the X value(s) at which Y begins a sustained increase, defined as Y rising above a threshold fraction of Y-max for a minimum X-axis duration. Use this worker to detect onset events such as load pick-up, velocity ramp, or activation points in time-history curves.
When to use¶
Classification: process.
Tagged: curves, event_detection, onset_detection, threshold, time_history, x_when_y_increases.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curves | curves | vector | — | One or more X-Y curves (e.g. force-time, velocity-time) from which the X onset value is extracted; supply as a vector of curve objects — leave empty only if curves are provided dynamically upstream. | |
| Ratio | ratio | scalar | 0.01 | Fractional threshold relative to Y-max (default 0.01); a Y increase is detected only when ΔY > ratio × Y_max — increase this value (e.g. 0.05) to ignore small noise-level fluctuations. | |
| X-Duration | x-duration | scalar | 0 | Minimum span along the X-axis (same units as the curve X-axis, default 0) for which Y must remain above the ratio threshold before the increase is confirmed — set to a positive value to suppress transient spikes. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_get_x_when_y_increases_output_1 | curves_get_x_when_y_increases_output_1 | dataset | Dataset containing one row per input curve with the extracted X value(s) at which the Y increase onset was detected, plus curve identifiers for traceability. |
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_get_x_when_y_increases
Auto-generated from transformation schema. Worker id: curves_get_x_when_y_increases. Schema hash: d130724e4642. Hand-curated docs in workerexamples/ override this page when present.