FIND OPTIMUM VALUE FROM THE CURVE¶
Scans a curve and returns the x-value at which the y-value is minimized or maximized, using a convergence factor to handle near-flat optima. Use this worker whenever you need to locate the optimal operating point or design parameter from a response curve.
When to use¶
Classification: process.
Tagged: convergence, curve_transform, get_optimum_x, maximize, minimize, optimum.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve | curve | vector | — | Input curve (x/y vector pair) to search for the optimum; must contain at least two points spanning a measurable y-range. | |
| Curve | objective | list | minimize | Optimization direction: ‘minimize’ to find the x at the lowest y-value or ‘maximize’ to find the x at the highest y-value; defaults to ‘minimize’. | |
| Convergence Factor | convergence_factor | scalar | 0.001 | Fraction of the total y-range used as a flatness/tolerance threshold (dimensionless, defaults to 0.001). In ‘Legacy (first flat region)’ mode this is applied to the derivative — the first x whose slope falls inside ±threshold×derivative-range is returned. In ‘True Optimum’ mode it is applied to the y-values — the first x whose y falls within threshold×y-range of the true min or max is returned. Set higher when the curve is noisy near the optimum so a near-flat plateau still counts. | |
| Optimum Mode | optimum_mode | select | legacy_flat | Selection algorithm. ‘Legacy (first flat region)’ (default, preserved for backward compatibility) returns the x at the first point where the derivative drops into a near-zero band; this is where the curve first becomes flat, not necessarily where it reaches the minimum or maximum. ‘True Optimum’ finds the actual minimum or maximum y value, then walks left to right and returns the first x within the convergence threshold of that value — this is the option that matches most users’ intuition. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_get_optimum_x_output_1 | curve_get_optimum_x_output_1 | scalar | Scalar x-value at which the curve reaches its minimum or maximum y-value according to the chosen objective, in the same units as the input curve’s x-axis. |
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_optimum_x
Auto-generated from transformation schema. Worker id: curve_get_optimum_x. Schema hash: f49ba09b9f87. Hand-curated docs in workerexamples/ override this page when present.