FIND THE ANGLE BETWEEN THREE TIME-HISTORY POINTS¶
Filters a collection of time-history curves by comparing a selected scalar value (first Y, last Y, max, min, or average) against a user-defined target using a specified condition (equal, greater-than, less-than, or between). Returns only the curves that satisfy the condition. Use this worker to subset large curve sets before downstream processing or plotting.
When to use¶
Classification: process.
Tagged: curve_filter, scalar_comparison, search_by_value, time_history, transformations.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curves | curves | vector | — | Collection of time-history curves to search; accepts multiple curve objects — leave empty to pass an upstream curve vector directly. | |
| Value Type | value_type | string | eq | Scalar extracted from each curve for comparison: ‘yfirst’ (first Y sample), ‘ylast’ (last Y sample), ‘ymax’ (peak Y), ‘ymin’ (trough Y), or ‘yaverage’ (mean Y); defaults to ‘eq’ placeholder — set explicitly before running. | |
| Target Condition | target_condition | string | eq | Comparison operator applied between the extracted scalar and target_value: ‘eq’ (equal), ‘gt’ (greater than), ‘lt’ (less than), or ‘between’ (inclusive range expecting two comma-separated values in target_value); defaults to ‘eq’. | |
| Target Value | target_value | string | — | Numeric threshold or range to compare against; supply a single number for ‘eq’/’gt’/’lt’ conditions, or two comma-separated numbers (e.g. ‘0.5,1.5’) when target_condition is ‘between’. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_search_by_value_output_1 | curves_search_by_value_output_1 | vector | Subset of the input curves whose extracted scalar value satisfies the specified condition; returns a vector of curve objects in the same format as the input. |
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_search_by_value
Auto-generated from transformation schema. Worker id: curves_search_by_value. Schema hash: 1bbd4a5489e6. Hand-curated docs in workerexamples/ override this page when present.