COMPUTE THE VIOLATIONS BASED ON MIN/MAX THRESHOLD CURVES¶
Compares a baseline curve against optional lower and upper threshold curves to identify regions where the signal violates the prescribed limits. Returns a dataset summarising all detected violations, respecting a configurable maximum-violation count and an optional scale factor or State-of-Charge (SOC) curve for battery-related contexts.
When to use¶
Classification: process.
Tagged: battery, curve_comparison, envelope, limit_check, min_max, soc, threshold, violations.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| C1-B | curve_1 | vector | — | Baseline curve (C1-B) to be checked against the threshold envelopes; provide as a time–value vector in consistent physical units. | |
| Lower Limit Curve | lower_limit_curve | vector | — | Minimum allowable threshold curve; points on curve_1 that fall below this envelope are flagged as lower-limit violations. | |
| Upper Limit Curve | upper_limit_curve | vector | — | Maximum allowable threshold curve; points on curve_1 that exceed this envelope are flagged as upper-limit violations. | |
| Max Violations | max_violations | scalar | 1 | Integer scalar setting the maximum number of violations to report before the check is considered failed; defaults to 1 (any single crossing triggers a violation). | |
| Scale Factor | scale_factor | scalar | 1 | Multiplicative scalar applied to curve_1 values before threshold comparison; leave at default 1.0 when no rescaling is needed. | |
| SOC Curve | soc_curve | vector | — | Optional State-of-Charge (SOC) curve (time–SOC vector, 0–100 %) used for battery-specific violation analysis; omit when the worker is used outside battery contexts. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curve_get_violations_from_thresholds_output_1 | curve_get_violations_from_thresholds_output_1 | dataset | Tabular dataset listing each detected threshold violation, including the violated limit (lower/upper), the x-axis location, the offending curve value, and the corresponding threshold value. |
Disciplines¶
- data.curve.pair
- data.curve.transform
- data.statistics
- engineering.battery
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curve_get_violations_from_thresholds
Auto-generated from transformation schema. Worker id: curve_get_violations_from_thresholds. Schema hash: db317434e2c9. Hand-curated docs in workerexamples/ override this page when present.