Skip to main content

Enrichment

Groups dealers into spatial clusters used as coarser-geography dimensions. Computed columns on inventory and models (sold date, days on lot, base_model_id, feature-id resolution, …) are configured directly on ConsolidatedComponent's inventory and models specs rather than as a separate tier — see Derived Fields, Foreign-Key Resolution, and Base Model ID.

The one step that does own a tier is package binding on a vehicle's feature references, which has to run before consolidated resolves them to feature IDs — see EnrichedInventoryComponent.

Dealer Classification

Groups dealers into spatial clusters ("neighborhoods") so coarser-geography statistics can be computed without using administrative boundaries like state or region. The component uses a grid-based spatial partitioning approach driven entirely by dealer latitude/longitude from consolidated dealers.

The output is a single <oem>/dealers/<name> asset — one row per dealer with a cluster label column.

Configuration

type: ai_dagster.components.DealerClassificationComponent
attributes:
oem: mb
name: neighborhoods
label: neighborhood
grid_size: 5
start_date: "2025-01-01"
FieldDescription
nameAsset key segment under <oem>/dealers/<name> and Dagster group name
labelColumn name for the cluster label in the output asset
grid_sizeGrid cell size in degrees. Smaller values produce finer-grained clusters

Output schema

[dealer_id, <label>, _partition_date]

The <label> column (e.g. neighborhood) contains a string identifier for each cluster.

Downstream usage

The classification asset is joined into Inventory Statistics, Take Rates, and Days on Lot via joins entries keyed on dealer_id. This lets those components group or fan out statistics by neighborhood without storing the cluster label on each vehicle row.