GET VALUE OF X WHEN Y INCREASES¶
Scans a curve and returns the X value at the first point where Y begins to increase, using a Y-range ratio threshold to filter out noise. An optional X-duration ratio guards against spurious early detections, and a configurable fallback value is returned when no qualifying increase is found.
When to use¶
Classification: process.
Tagged: curve, detection, onset, scalar_output, threshold, transformations, x_when_y_increases.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve | curve | vector | — | Input XY curve (vector) to search for the onset of a Y increase; accepts any curve object from the d3VIEW curve library. | |
| Ratio | ratio | scalar | 0.01 | Y-range sensitivity threshold expressed as a fraction of the total Y range (e.g. 0.01 = 1%); increase this value to ignore small fluctuations and detect only significant rises. Defaults to 0.01. | |
| X-Duration | x-duration | scalar | 0 | Minimum X-span as a fraction of the total X range that the increase must persist before it is accepted; set to 0 (default) to disable the duration guard. | |
| Value if Zero | value_if_zero | scalar | 0.0 | Fallback scalar returned when no qualifying Y increase is detected anywhere in the curve; defaults to 0.0. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_get_x_when_y_increases_output_1 | curve_get_x_when_y_increases_output_1 | scalar | X-axis value (scalar, same units as the curve’s X axis) at the first point where Y increases by more than the specified ratio threshold, or the value_if_zero fallback if no such point exists. |
Disciplines¶
- data.curve.transform
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curve_get_x_when_y_increases
Auto-generated from transformation schema. Worker id: curve_get_x_when_y_increases. Schema hash: 91ac6231028e. Hand-curated docs in workerexamples/ override this page when present.