A range is a set of decisions, and each one needs its own grain

How many options a class carries is a decision at class and cluster. Which styles earn their place is a decision at style and colour. How deep each size runs is a decision at size. Which stores carry which options is a decision at store. A private label style is a decision about a blank. An assortment dataset that stores only the outcome, the SKU list, can report what was ranged and nothing about why.

The Cybex Assortment Planning dataset is five facts, one per decision, on one product hierarchy and one store cluster model. All five read the same item master, the same sales facts and the same demand rate the planning, allocation and buying datasets use. Nothing on this page is specific to one retailer: hierarchy levels, attribute names, cluster schemes, size tables and the private-label family convention are mapped to generic values at load time.

Architecture
Options and depth
How many choices at each price band and attribute, per class and cluster, and how deep each runs.
Performance
Earn the place
Sell-through, margin, turn and ABC per style and colour, dated and scoped, with lifecycle stage.
Curves
Size and store
Size and store indices that sum to one per style, so a class total and a size tile reconcile.
Item master is truth
Ranged, not sold
Which colours and sizes a style has comes from the item master, never from what happened to sell.

Five facts, one product hierarchy

FactGrainQuestion it answersLoaded from
Range architectureOne row per class, cluster, season and price band or attributeHow many options, at what depth, to hit the class plan in this cluster?Merchandise plan targets, last-season option counts and productivity, planner input
Style performanceOne row per style and colour per period; store beneath itDid this option earn its place, and where is it in its life?Sales fact, movement history, receipts, markdowns, item master
Size and colour curvesOne row per style (or model or blank), colour and sizeWhat share of demand does each size and colour take, and where is the run broken?A year of sales at SKU grain, ranged sizes from the item master, size tables, store index
Store rangeOne row per store, cluster and styleWhich stores carry which options, how well does each conform, and where is the white space?Store cluster model, location stock, sales by store, range architecture
Product familyOne row per blank and private label style, with colour and size rows beneathWhich private label styles hang on which blank, do their colours and sizes match, and what does the family need?Item master family code, blank and private label stock, work orders, family sales
Item master and hierarchy style · colour · size · size table · family · hierarchy · clusters · sales · stock one identity: class → style → colour → size, and store → cluster Architectureclass × clusteroptions, depth Performancestyle × colourABC, sell-through Curvesstyle × colour × sizesize, store index Store rangestore × styleranged, white space Familyblank → private label stylescut vs buy BI: range grid, size matrix options, curves, white space AI: cluster, score, learn options, size runs, exits

Figure: the five facts share the product hierarchy and the cluster model, so an option count, a size run and a store's white space all resolve to the same styles.

Generic dataset attributes

Attributes are grouped by role. BI marks the ones the range grid, size matrix and performance reports aggregate; AI marks the ones the clustering, scoring and range-recommendation models consume. Most are both.

Range architecture

GroupAttributesNotesUsed by
IdentityDivision, Department, Class, Subclass, Category (clothing, souvenirs, blanks, other), Season, Cluster, Price band, Attribute set (fabric, fit, colour family, theme), Plan versionCategory names the non-retail groups: blanks are a supply category and never a store range. The hierarchy is the same one the plan and the buy use.BIAI
TargetsSales plan, Margin plan, Units plan, Option count target, Depth target (units per option), Choice count per price band, Core, fashion and seasonal mixTargets come from the merchandise plan at class and period; the architecture distributes them across options and clusters.BIAI
Last seasonOptions carried, Options that sold through, Sales per option, Margin per option, Average depth, Sell-through, TurnProductivity per option is the number that sizes the next range, not total sales.BIAI
DerivedPlanned sales per option, Planned depth, Breadth index (options ÷ last season), Depth index, Option gap (target − ranged), White space valueWhite space = seasonal potential minus planned or actual, at attribute or price band, valued at retail.BIAI

Style performance

GroupAttributesNotesUsed by
IdentityStyle, Colour, Class, Vendor, Season code, Price, Regular price, Cost, Attributes, First received, Last received, First sale, Last sale, Weeks in stock, Lifecycle stage (launch, growth, maturity, decline, exit)Lifecycle is derived from weeks in stock and the sales curve, not entered; first received caps every rate calculation.BIAI
FlowUnits sold, Sales, Gross margin, Markdown units, Markdown value, Returns, Received units, Received value; each by period and trailing 4, 13, 26, 52 weeksAdditive across periods; sourced from the sales fact and movement history the other datasets use.BIAI
PositionOn hand (stores), On hand (DC), On order, Stock at retail, Stock at cost, Weeks of supply, Stores stocking, Stores sellingStock is a snapshot; stores stocking and stores selling separate a slow style from an unranged one.BIAI
ProductivitySell-through (units sold ÷ units received), Turn (12-month), GMROI, Margin rate, Full-price share, Rank within class (units, sales, margin), ABC code, ABC scope, ABC dateABC is computed within a scope (class, category, chain) and dated; a style's code carries the scope it was ranked in.BIAI
RateDe-seasonalised weekly rate, Seasonality index, Forecast 4, 13, 26 and 52 weeksThe same demand feature the planning and allocation datasets read; never re-derived here.AI

Size and colour curves

GroupAttributesNotesUsed by
IdentityCurve basis (model, style, colour, blank), Style, Colour, Size, Size table, Size sequence, Ranged flag, Curve dateThe curve basis is a choice the planner makes; the sizes come from the size table the item master assigns, and a size the style is not ranged for is absent, not zero.BIAI
Size curveUnits in the last year at SKU, Size share, Size index (sums to one per style), Reference curve share, Deviation from reference (points), Divergence score, Skew (runs large, runs small, on curve, mixed)Shares use a full year of sales at SKU grain so short windows do not distort the run. The reference curve is the model or blank curve the colour is compared against.BIAI
Colour curveColour share of style, Colour index, Colour rank, Colour count carried, Colours with no sales, Name-drop flagName-drop and seasonal colours are flagged so a colour dropped by design is not read as a failure.BIAI
Store curveStore index per style (sums to one), Cluster index, Store size profileStore index apportions a chain rate to a store; a store's own size profile localises the size curve where the store has enough history.AI
Run healthSizes in stock, Sizes out of stock, Broken-run flag, Core sizes missing, Fringe sizes overstocked, Size fill from DC possibleA run is broken when a core size is out while fringe sizes remain; the flag feeds allocation and markdown.BIAI

Store range

GroupAttributesNotesUsed by
IdentityStore, Cluster, Cluster method (volume, climate, demographic, behavioural), Region, Store type and grade, Floor capacity, Category mix allowedCluster membership is dated and versioned; a store can move between seasons.BIAI
Range membershipStyle, Colour, Ranged flag (planned), Stocked flag (actual), Stocking since, Delisted date, Range reason (core, cluster, local, test)Ranged and stocked are different columns: a style can be ranged and empty, or stocked and never ranged (a stray).BIAI
Performance at storeUnits, Sales, Margin, Weeks of supply, Rate at store, Sell-through at store, Rank in store, Share of cluster averageRate at store uses the store index; comparisons are against the cluster, not the chain.BIAI
ConformanceOptions ranged versus architecture, Depth versus target, Missing options, Extra options, Conformance %, White space at store (attribute or price band), Cannibalisation flagConformance is measured against the cluster's architecture, and white space at store is the local gap the range should close.BIAI

Product family (private label)

GroupAttributesNotesUsed by
IdentityBlank style, Private label style, Family code, Family role (blank, private label, other), Colour, Size, Size table match flag, Colour subset flagA private label style's colours must be a subset of its blank's and its size table must equal the blank's; violations are integrity exceptions, not range decisions.BIAI
Family demandPrivate label units and sales, Family units and sales (consolidated to the blank), Private label forecast per horizon, Family rate, Colour and size demand rolled to the blankDemand rolls up from private label styles to the blank by colour and size, since the blank is what gets bought and the private label style is what gets sold.BIAI
Family supplyBlank on hand, Blank on order, Private label on hand (finished), Private label on order (work orders), Blank supply available (blank stock + finished private label styles + blank on order − production work orders)Finished private label styles count as supply; work orders in progress consume blank stock.BIAI
Family decisionsPrivate label requirement (cut), Blank requirement (buy), Private label styles per blank, Blank size curve by colour, Colour divergence from the blank curve, Name-drop candidatesThe blank curve applied to every colour is the reference; a colour that diverges is a private label decision, not a blank decision.BIAI
SellThrough = UnitsSold ÷ UnitsReceived  ·  SalesPerOption = ClassSales ÷ OptionsCarried
SizeIndex(size) = Units(size, last year) ÷ Units(style, last year)  ·  Σ SizeIndex = 1 per style
WhiteSpace = SeasonalPotential − Planned (or Actual), by attribute or price band, at retail

Functional areas and what each reads

Functional areaReadsDeciding attributesBI outputAI output
Range architectureArchitecture, PerformanceOption count and depth targets, sales per option, price-band mix, core and fashion mixRange grid by class, cluster and price band with last season beside it; option gapRecommended option count and depth per class and cluster from productivity and the plan
Style and colour reviewPerformanceSell-through, margin, turn, ABC, lifecycle, colour shareTop sellers, style rank, price analysis, vendor sales, unit sales received, ABC tree maps by category and vendorKeep, grow, reduce and exit scoring per option; colour recommendations for the next season
Size curve and size modelCurvesSize share, reference curve, divergence, skew, ranged sizesSize curve by blank, colour and model; size matrix drill from any style; broken-run listSize model refresh; detection of colours whose curve diverges from the reference; size fill suggestions
Store clustering and localisationStore range, CurvesCluster method, store index, store size profile, category mixCluster membership and profile; store range conformance; missing and extra options by storeCluster assignment; local option recommendations where a store's profile diverges from its cluster
White space and cannibalisationArchitecture, Performance, Store rangeSeasonal potential, planned and actual by attribute and price band, overlap between optionsWhite-space heat map by category, class and retail month; gaps ranked by valueAttribute-level demand estimates for gaps; cannibalisation detection between overlapping options
Private-label family planningProduct family, CurvesFamily demand, blank supply, size table and colour subset, blank size curveFamily card: private label styles per blank, family sales, cut versus buy, blank curve versus each colourPrivate label portfolio suggestions per blank; blank curve recommendations by colour
Range integrityCurves, Store range, Product familyRanged versus stocked, size table membership, colour subset, strays in non-retail categoriesIntegrity exceptions: sizes outside the size table, orphan colours, blanks in stores, stocked but unrangedPrioritised corrections by units and value affected
In-season review and exitPerformance, Store rangeSell-through versus plan, weeks of supply, lifecycle stage, full-price shareSell-through tracker; exit and markdown candidates; range delist listExit timing and markdown depth per option from the lifecycle curve

Rules the dataset carries

Item master and integrity

  • The item master is the truth for what exists. Which colours and sizes a style has comes from the item master and its size table; sales roll-ups are for ranking, never for deciding what a style is.
  • Every size belongs to the style's size table. A size outside the table is an integrity exception; a size inside the table with no sales is a ranged size with zero, and is shown as such.
  • Private label styles inherit from their blank. A private label style's colours are a subset of the blank's and its size table equals the blank's; the family join uses the family code, trimmed, with the blank excluded from its own prints.
  • Blanks are a supply category, not a store range. Store-facing ranges exclude the blank category by category, not by list; a blank found in a store is a stray to correct.

Curves and scoring

  • Indices sum to one. Size and store indices are normalised per style, so a class total, a store rate and a size tile always reconcile.
  • A year at SKU grain for the curve. Size shares use a full year of SKU sales so a short window and a broken run do not shape the model.
  • ABC and rank are scoped and dated. A code carries the scope it was computed in and the date, so last season's A is comparable with this season's.
  • Ranged and stocked are different facts. Conformance measures the plan; strays and gaps measure the shelf; neither is inferred from the other.

Architecture and white space

  • Productivity per option sizes the range. Option counts are set from sales and margin per option against the class plan, not from last season's count.
  • White space is measured against seasonal potential. The gap is planned or actual versus the potential for that attribute in that retail month, valued at retail, on flow measures only; stock snapshots are never summed into it.
  • Localise from the cluster. A store's range is its cluster's architecture plus documented local exceptions; the exception carries its reason.

Process workflow

The assortment cycle runs by season with a monthly review. The Hub keeps the performance, curve and store-range facts current; planners and buyers build and localise the range; the AI layer clusters, scores and recommends, then learns from sell-through.

01
Set targets
Class sales, margin and stock targets by cluster and season arrive from the merchandise plan.
02
Load and score
Nightly: style performance, size and colour curves, store range and family facts refreshed; ABC, lifecycle and integrity exceptions computed.
03
Cluster
Stores grouped by the chosen method; membership dated; store and size profiles derived per cluster.
04
Architect
Option count and depth recommended per class, cluster and price band from productivity and the plan; white space ranked.
05
Build the range
Planners select options, colours and sizes in the range grid and size matrix; family cut-versus-buy set for private label.
06
Localise and commit
Store ranges assigned from the cluster with local exceptions; the range posts to the buy and to allocation.
07
Review and learn
Sell-through, broken runs and white space tracked in season; exits timed; curves and clusters refreshed for the next cycle.

Cadence

WhenStepOutputOwner
By seasonSet targets, cluster, architect, build, localiseRange architecture, store ranges, size and colour plan, family planMerchandise planning, buying
NightlyLoad and scorePerformance, curves, store range, integrity exceptionsAI Data Hub
WeeklyIn-season reviewSell-through versus plan, broken runs, exit candidates, straysBuyers, planners
MonthlyWhite space and conformanceWhite-space heat map, store conformance, local exceptionsMerchandise planning, store operations
SeasonallyLearn and tuneCluster refresh, size model refresh, productivity benchmarksPlanning, data science

Where BI ends and AI begins

BI on the assortment dataset

QuestionWhat is ranged, how did it sell, where are the gaps
UnitOptions, curves, conformance, white space
SurfaceRange grid, size matrix, ABC tree map, family card
RulesItem master, indices, scoped ABC
OutputA range a buyer commits to

AI on the same dataset

QuestionHow many options, which ones, where, in what sizes
UnitClusters, scores, recommendations
SurfaceRange proposals, size fills, insight pages
RulesLearned from sell-through and margin per option
OutputA proposed range with its expected productivity

Both read the same five facts. The option a buyer keeps in the range grid is the option the scoring model ranked, and the size run the matrix shows broken is the run the allocation engine is asked to fill.

What a conforming dataset delivers

Target outcomes from an Assortment Planning dataset deployment

Ranges sized by productivity. Option counts and depth come from sales and margin per option against the plan, per cluster, with the white space ranked beside them.

Curves that reconcile. Size, colour and store indices sum to one per style, come from a year at SKU grain, and respect the item master, so the size matrix, the buy and the allocation agree.

Private label planned as a family. Demand rolls up to the blank, supply counts finished private label styles, and cut-versus-buy is decided per colour and size.

5
Facts on one product hierarchy
Σ = 1
Size and store indices per style
Ranged ≠ stocked
Plan and shelf kept as separate facts

Deployment approach

01
Map the hierarchy and item master · Week 1

Confirm hierarchy levels, category roles, attributes and price bands; validate the item master against its size tables and the family code; run the integrity checks and fix strays before any curve is built.

02
Performance and curves · Weeks 2–3

Build style performance with ABC and lifecycle, size and colour curves from a year at SKU grain, and store indices. Publish top sellers, size matrix, size model and ABC tree maps.

03
Cluster, architect and localise · Week 4

Cluster stores, load last season's option productivity, derive the range architecture from the class plan, and publish the range grid, conformance and white-space heat map.

04
Family and learning · Weeks 5–6

Add the private-label family fact and cut-versus-buy, connect the range to the buy and to allocation, switch on option scoring and size-fill recommendations, and start the seasonal cluster and curve refresh.