RETURNS THE Y-VALUES AT A CERTAIN X VALUE. USES INTERPOLATION WHEN NEEDED.¶
Extracts the Y-value from one or more curves at a specified X-coordinate, using interpolation when the X-value does not fall exactly on a data point. Use this worker to sample curve responses at a precise instant (e.g. peak time, specific displacement) across a batch of results.
When to use¶
Classification: process.
Tagged: batch_curves, curve_sampling, interpolation, x_lookup, y_value.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curves | curves | vector | — | One or more input curves from which Y-values will be extracted; each curve must carry X/Y data — accepts any curve-compatible vector (time-history, force-displacement, etc.). | |
| X Min | x_value | float | 0.0 | The X-coordinate at which the Y-value is to be read; defaults to 0.0 — linear interpolation is applied when the value falls between two data points. | |
| Attr Name | attr_name | scalar | name | Curve attribute used as the key in the output map; choose from ‘id’, ‘name’, ‘component’, or ‘file’ — defaults to ‘name’ so each result row is labelled by the curve’s display name. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_get_yvalue_at_output_1 | curves_get_yvalue_at_output_1 | keyvalue | Key-value map where each key is the selected curve attribute (id / name / component / file) and the corresponding value is the interpolated Y-value (same units as the curve’s Y-axis) at the requested X-coordinate. |
Disciplines¶
- 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_get_yvalue_at
Auto-generated from transformation schema. Worker id: curves_get_yvalue_at. Schema hash: 2018469e1f32. Hand-curated docs in workerexamples/ override this page when present.