- THIS FUNCTION LOOKS INTO A COLLECTION OF CURVES AND RETURNS CURVENAME=>LOOKUP VALUE*
Iterates over a collection of curves and extracts a single scalar value from each curve using a specified lookup strategy (e.g., Ymax, Xfirst, first intersection). Use this worker to reduce a curve group into a curveName→scalar mapping for downstream KPI rollup or reporting.
When to use¶
Classification: process.
Tagged: curve_group, intersection, kpi, lookup, reduction, scalar, transformations, xmax.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curve Group | curve_group | vector | — | Collection of named curves (CurveGroup) to scan; each curve will be individually evaluated against the chosen lookup type. Optional — if omitted, no output is produced. | |
| Lookup Type | lookup_type | xfirst | xfirst | Scalar extraction method applied to every curve in the group; choose from point-based picks (xfirst, xlast, yfirst, ylast), extrema (xmin, xmax, ymin, ymax, yabsmax, abs_ymax), intersection queries (intersectx, intersecty, first_intersect_x, first_intersect_y, max_value_intersect), aggregates (ysum, num_points, yrange, xrange), or metadata (name, id, file). Defaults to ‘xfirst’. | |
| Min Or Max | min_or_max | string | max | Tie-breaking direction used when the lookup produces multiple candidate values (e.g., multiple intersections); select ‘max’ to return the largest candidate or ‘min’ to return the smallest. Defaults to ‘max’. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_lookup_scalar_output_1 | curves_lookup_scalar_output_1 | scalar | A scalar value (dimensionless numeric or string, depending on lookup_type) representing the extracted quantity from the curve group — typically the result aggregated across curves according to the min_or_max rule. |
Disciplines¶
- cae.postprocessing.response
- data.curve.pair
- 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=curves_lookup_scalar
Auto-generated from transformation schema. Worker id: curves_lookup_scalar. Schema hash: 2879cdd81f1b. Hand-curated docs in workerexamples/ override this page when present.