COMPUTE THE TIME AT WHICH THE Y REACHES A GIVEN VALUE FOR A SUSTAINED PERIOD¶
Scans a curve and finds the first time the y-value exceeds a specified threshold for a sustained duration (time window), returning either the x-value or y-value at that failure point. Use this worker to detect onset of failure or exceedance events in time-history signals.
When to use¶
Classification: process.
Tagged: curve_analysis, failure_point, sustained_exceedance, threshold, time_history, ymax.
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, y = signal value) to be scanned for a sustained exceedance event; supply as a two-column vector. | |
| Maximum Y-value | y-max | scalar | — | The y-value threshold (in the same units as the curve’s y-axis); the curve must exceed this value continuously for at least the specified time window to register a failure point. | |
| Time Window | timewindow | scalar | — | Minimum duration (in the same time units as the curve’s x-axis) for which the y-value must remain above the threshold before the point is classified as a failure onset. | |
| Return Type | return_type | string | count | Controls what value is returned at the detected failure point: ‘xval’ returns the time (x-axis value) of onset, ‘yval’ returns the corresponding signal magnitude; defaults to ‘count’. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_failurepoint_ymax_output_1 | curve_failurepoint_ymax_output_1 | scalar | Scalar result at the detected failure point — either the x-axis time of onset or the y-axis signal value, depending on the selected Return Type. |
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_failurepoint_ymax
Auto-generated from transformation schema. Worker id: curve_failurepoint_ymax. Schema hash: 9598cf02772b. Hand-curated docs in workerexamples/ override this page when present.