BIN VALUES OF CURVE¶
Bins the Y-values of one or more curves into a fixed number of intervals and summarises each bin using a selected aggregation method (average, max, first, or last Y value). Use this worker to reduce curve data into histogram-style datasets for statistical analysis or visualisation.
When to use¶
Classification: process.
Tagged: aggregation, bin, binning, curve, histogram, transformations, yavg, yfirst.
Inputs¶
| Label | ID | Type | Default | Required | Description |
|---|---|---|---|---|---|
| Curves To Bin | curves | vector | — | One or more input curves whose Y-values will be binned; accepts the standard d3VIEW curve vector format — leave empty only if curves are supplied dynamically upstream. | |
| Bin Type | bin_type | string | yavg | Aggregation method applied within each bin: ‘yavg’ (mean), ‘ymax’ (maximum), ‘yfirst’ (first sample), or ‘ylast’ (last sample); defaults to ‘yavg’. | |
| Number Of Bins | numberofbins | scalar | 10 | Integer number of equal-width bins to divide the Y-value range into; defaults to 10 — increase for finer resolution, decrease for coarser grouping. | |
| Postfix | prefix | scalar | — | Optional string prepended to the output curve/column label to distinguish the binned result; leave blank (default) to use no prefix. | |
| Postfix | postfix | scalar | — | Optional string appended to the output curve/column label to distinguish the binned result; leave blank (default) to use no postfix. |
Outputs¶
| Label | ID | Type | Description |
|---|---|---|---|
| curves_bin_values_output_1 | curves_bin_values_output_1 | dataset | Dataset containing the binned curve data — one row per bin with bin-boundary X coordinates and the aggregated Y value computed according to the selected bin_type. |
Disciplines¶
- data.curve.transform
- data.statistics
Runnable example¶
A runnable example is registered for this worker. Open the example workflow on the d3VIEW canvas: /api/workflow/example?id=curves_bin_values
Auto-generated from transformation schema. Worker id: curves_bin_values. Schema hash: 538218d4fe1a. Hand-curated docs in workerexamples/ override this page when present.