ggaction 0.0.24

Published-release documentation · release compatibility

Data

Cars scatterplot with grouped regression lines and confidence bands
Layered points, derived fits, and confidence bands.

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
Safe resource removal removeData Delete one named dataset only after all live consumers are gone
Reusable summaries createSummaryData Materialize grouped multi-aggregate rows with optional members
Reusable bins createBinData Materialize shared one-dimensional bounds, counts, and optional members
Named table lookup createLookupData Copy reference fields while preserving primary rows
Aligned array data createFlattenData Expand parallel array elements into aligned rows
Wide-to-long data createFoldData Materialize selected fields as stable key/value rows
Computed data createComputedData Add numeric, string, boolean, or nullable values using the closed expression grammar
Normalization createNormalizedData Preserve rows while expressing values relative to a group, baseline, or range
Missing keys createCompleteData Add missing key/group rows on an explicit domain
Missing values createImputedData Fill selected values with an explicit method and ordering policy
Empirical distributions createECDFData Reduce observations to ordered support, mass, and probability rows
Stack data createStackData Materialize reusable stack endpoints, values, and shares
Filtering filterData, filterMarks, removeMarkFilter Derive rows or revise and remove one visual-layer filter
Statistical transforms createRegressionData, createIntervalData, createDensityData Materialize fitted, interval, or density rows
Time-unit transforms createTimeUnitData Add calendar buckets with UTC or an explicit IANA zone and calendar policies
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
Derived revisions Focused edit*Data actions Revise one transform and explicitly recompute dependent revisions

Shared invariants

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.

Marks · ChartProgram and immutability · Complete action reference

Documentation provenance

293 actions · sha256:e755591a2e5f5e2b494867583876e28020a478c5220b77bdc6ad469a6224891d