COMPUTE THE FAILURE BY CHECKING FOR A Y-VALUE BETWEEN TWO RANGES OVER A GIVEN DURATION¶
Scans a curve for the first point where the y-value falls within a specified [y-min, y-max] range and remains there for a minimum time window, flagging that point as a failure. Use this worker to detect sustained threshold exceedances in time-history signals such as force, displacement, or voltage curves.
When to use¶
Classification: process.
Tagged: curve_analysis, failure_point, sustained_exceedance, threshold, time_window, y_range.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve From Which The Failure Point Is To Be Extracted | curvefromwhichthefailurepointistobeextracted | vector | — | The input time-history curve (x = time or pseudo-time, y = signal of interest) to be scanned for the failure condition; accepts any numeric curve vector. | |
| Minimum Y-value | y-min | scalar | — | Lower bound of the y-value range (inclusive) that defines the failure band; any y-value strictly below this threshold does not contribute to a failure event. | |
| Maximum Y-value | y-max | scalar | — | Upper bound of the y-value range (inclusive) that defines the failure band; any y-value strictly above this threshold does not contribute to a failure event. | |
| Time Window | timewindow | scalar | — | Minimum continuous duration (in the same time units as the curve x-axis) over which the y-value must remain within [y-min, y-max] before the condition is classified as a failure point. | |
| Return Type | return_type | string | count | Controls what value is returned at the detected failure point: ‘xval’ returns the x-coordinate (time) of the failure onset, ‘yval’ returns the corresponding y-coordinate; defaults to ‘count’. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_failurepoint_yrange_output_1 | curve_failurepoint_yrange_output_1 | scalar | Scalar result at the detected failure point: the x-value (time of onset) or y-value of the curve at that point, depending on the selected return_type; returns null/empty if no failure condition is found. |
Disciplines¶
- data.curve.transform
- data.signal_processing
- engineering.material.failure
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curve_failurepoint_yrange
Auto-generated from transformation schema. Worker id: curve_failurepoint_yrange. Schema hash: 73acef50a637. Hand-curated docs in workerexamples/ override this page when present.