Data
Data actions own immutable source rows, explicit derivation provenance, and statistical result datasets. Choose the focused page that matches the data operation; marks and renderers never mutate source values.
At a glance
| Family | Actions | Use |
|---|---|---|
| Source and derived data | createData, createDerivedData |
Store source rows or explicit transform provenance |
| Filtering | filterData, filterMarks |
Derive rows or rebind one visual layer from a selector |
| Statistical transforms | createRegressionData, createIntervalData, createDensityData |
Materialize fitted, interval, or density rows |
| Window transforms | createWindowData |
Compute ordered values within partitions while preserving source row order |
| Rectangular 2D bins | createBin2DData |
Aggregate two quantitative fields into immutable ranged cells |
Shared invariants
- Every dataset is immutable after creation.
- Omitted sources resolve only from the current or unique compatible dataset.
- Derived datasets retain their source and transform provenance.
- Ambiguous sources require an explicit ID; the library never selects the first of several candidates silently.
Errors and limitations
Values must be arrays of plain row objects. Dataset IDs are unique. Filters and statistical transforms validate their complete option combination before creating state, and a failed action leaves the earlier program unchanged.
Related
Marks · ChartProgram and immutability · Complete action reference