OFFSET THE CURVE ALONG X WHEN THE INITIAL VALUE CHANGES BASED ON THE RATIO PROVIDED¶
Detects the first significant change point in a curve’s values (using a derivative-based threshold) and shifts all subsequent X-values by the detected offset amount. Use this worker to align time-history or signal curves whose meaningful data starts after an initial transient or delay.
When to use¶
Classification: process.
Tagged: change_detection, curve, derivative, offset, signal_alignment, time_history, x-shift.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve To Be Offset | curvetobeoffset | vector | — | Input XY curve (vector) whose X-axis will be shifted once a significant value change is detected; accepts any d3VIEW curve object. | |
| Ratio | ratio | float | 0.025 | Change-detection threshold expressed as a fraction of the curve’s maximum value (dimensionless float, default 0.025); lower values detect smaller changes, higher values require larger changes before triggering the offset. | |
| Order Of Derivative | order | float | 1 | Order of the derivative used to detect the change point (integer float, default 1 for first-order derivative); increase to detect higher-order inflections. | |
| Offset Scale Factor | scale_factor | float | 1 | Scalar multiplier applied to the X-offset amount (dimensionless float, default 1.0 shifts points to the right; use a negative value to shift to the left). |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_offset_to_change_output_1 | curve_offset_to_change_output_1 | vector | Resulting XY curve with X-values after the detected change point shifted by the computed offset, preserving the original curve shape and Y-values. |
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_offset_to_change
Auto-generated from transformation schema. Worker id: curve_offset_to_change. Schema hash: 35a5781706a9. Hand-curated docs in workerexamples/ override this page when present.