GET A CURVE BY SORTING THE COLLECTION OF CURVES BY VALUE TYPE AND RETURN THE CURVES BY FROM A COLLECTION OF CURVES BY VALUE¶
Sorts a collection of curves by a chosen scalar value extracted from each curve (e.g. Ymax, Xmin, Ylast) and returns the single curve ranked first under the specified sort order. Use this worker to quickly isolate the extreme or boundary curve from a group based on any key endpoint metric.
When to use¶
Classification: process.
Tagged: collection, curve_group, curves, extremum, getbyvalue, ranking, sort, xmin.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve Group | curvegroup | vector | — | Collection of input curves (curve group / vector of curves) to be sorted and filtered; accepts multiple curves. | |
| Value Type | valuetype | text | ymax | Scalar metric used to rank the curves before selection — one of: xmin, ymin, xmax, ymax, xfirst, yfirst, xlast, ylast; defaults to ‘ymax’. | |
| Order | order | string | asc | Sort direction applied to the chosen value type: ‘asc’ returns the curve with the smallest value first, ‘desc’ returns the curve with the largest value first; defaults to ‘asc’. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_getbyvalue_output_1 | curves_getbyvalue_output_1 | vector | The single curve from the input group that ranks first after sorting by the specified value type and order (e.g. the curve with the highest Ymax when valuetype=’ymax’ and order=’desc’). |
Disciplines¶
- data.curve.pair
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curves_getbyvalue
Auto-generated from transformation schema. Worker id: curves_getbyvalue. Schema hash: 7fca215ea344. Hand-curated docs in workerexamples/ override this page when present.