DataDesigner/docs/code_reference/engine/column_generators.md
Andre Manoel 8b79b21298 Initialize orphan Fern docs website branch
Preserves tree from previous docs-website head: 5e47d33ea8. This branch is a CI-managed publish artifact like gh-pages; source provenance is tracked in commit messages rather than Git ancestry.
2026-05-14 01:17:51 +00:00

3.4 KiB

Column Generators

Column generators execute column generation in the Data Designer engine. A generator receives the upstream data needed for its task, returns row or batch data with generated values added, and reports the generation strategy the scheduler should use.

Related pages: column_configs, Build Your Own, Using Models in Plugins, and Custom Columns.

Configuration

User-facing column configs inherit from SingleColumnConfig and define a unique column_type discriminator. During compilation, the engine may group related configs into multi-column configs for generators that create sampler or seed columns together.

Generation strategy

Column generator base classes return GenerationStrategy values to tell the engine whether they run per row or over a full batch.

Implementation bases

Generators that operate on a full batch can inherit from ColumnGeneratorFullColumn. Row-oriented non-model generators can inherit from ColumnGeneratorCellByCell. Generators that create initial rows use FromScratchColumnGenerator. Model-backed plugin generators should use ColumnGeneratorWithModelRegistry or ColumnGeneratorWithModel; see Using Models in Plugins for authoring guidance.

ColumnGenerator

::: data_designer.engine.column_generators.generators.base.ColumnGenerator options: show_root_toc_entry: false

ColumnGeneratorFullColumn

::: data_designer.engine.column_generators.generators.base.ColumnGeneratorFullColumn options: show_root_toc_entry: false

ColumnGeneratorCellByCell

::: data_designer.engine.column_generators.generators.base.ColumnGeneratorCellByCell options: show_root_toc_entry: false

FromScratchColumnGenerator

::: data_designer.engine.column_generators.generators.base.FromScratchColumnGenerator options: show_root_toc_entry: false

ColumnGeneratorWithModelRegistry

::: data_designer.engine.column_generators.generators.base.ColumnGeneratorWithModelRegistry options: show_root_toc_entry: false

ColumnGeneratorWithModel

::: data_designer.engine.column_generators.generators.base.ColumnGeneratorWithModel options: show_root_toc_entry: false