Tuning the factors
The weighting panel (FactorWeights.tsx) lets you re-score the entire map and rankings by changing how much each of the 5 scored themes matters to the match. This is scenario exploration, not learned importance — it shows how the neighborhood fit shifts under different assumptions about which themes matter.
How weights work
Section titled “How weights work”Each of the 5 themes — Income, wealth & housing cost; Education; Density & transportation; Age & household type; and Retail & dining context — has a slider from 0× to 2×.
- 0× turns that theme entirely off; it will not contribute to the fit score or appear in feature contributions.
- 1× (default, “balanced”) is the fitted presence model.
- 2× doubles the theme’s contribution.
The score for each tract recalculates immediately and the map re-colors live. Dragging is smooth; the map update is deferred so the interface stays responsive.
Reading the presets
Section titled “Reading the presets”Four built-in presets show how weighting shapes discovery:
- Balanced (1× all themes): the fitted model.
- Affluence-led: emphasizes income and education. Use this to find analogs that share high household income and education.
- Urbanism-led: emphasizes density and transportation. Use this to find dense, walkable, transit-served neighborhoods.
- Household-led: emphasizes age and household type. Use this to find tracts with similar household composition.
Click any preset to apply it. Your custom adjustments override the presets. Click ↺ Reset to balanced (visible when you have custom weights) to return to the fitted model.
What weighting does NOT do
Section titled “What weighting does NOT do”Weights are your assumptions about which themes matter, not:
- Learned importance — the tool has not analyzed which features actually predict the brand’s success.
- Causal relationships — weighting a group higher does not mean it causes a good match; it is your choice to prioritize it.
- Sales prediction — even with weighted scenarios, this tool measures neighborhood resemblance only. A high-scoring neighborhood under Affluence-led weighting is not forecast to be profitable; it resembles the brand’s current footprint on those dimensions.
Interaction with the 5 themes
Section titled “Interaction with the 5 themes”The 5 scored themes are:
- Income, wealth & housing cost — median household income, per-capita income, median home value, median gross rent, poverty rate.
- Education — bachelor’s degree or higher (%).
- Density & transportation — population density, households without a vehicle, walk/bike/transit commute, renter-occupied housing.
- Age & household type — median age, average household size, households with children.
- Retail & dining context — points of interest, grocery stores, restaurants, cafés, shopping/apparel (all per km²).
When you weight a theme, you scale that theme’s contribution to the fit score before the contributions are summed. At 1× the score is the fitted model. Setting a theme to 0 excludes it entirely. Setting it to 2 doubles its contribution.
Advanced: per-feature weighting
Section titled “Advanced: per-feature weighting”Each theme’s slider also opens an advanced per-feature layer (the “Advanced” toggle under the theme). It exposes one slider per feature within that theme, so you can, for example, keep the Income theme at 1× overall but push median home value up and poverty down inside it.
The effective weight of a feature is its theme weight multiplied by its per-feature weight, applied to that feature’s contribution. A small dot appears on the “Advanced” toggle when any feature in that theme is off its default, so you can see at a glance which themes you have tuned below the surface.
With every per-feature slider left at its default of 1, the scores are exactly the theme-weighted scores described above — the advanced layer only changes results when you deliberately move a per-feature slider. Like the theme weights, per-feature weights are scenario assumptions, not learned or causal importance.
Robustness and weighting sensitivity
Section titled “Robustness and weighting sensitivity”When you click a tract in the detail panel, you’ll see a robustness badge reporting whether the tract’s high rank is:
- Robust — the rank holds across all weighting scenarios (equal, each theme removed individually).
- Fairly robust — the rank is solid but shifts noticeably under some scenarios.
- Weighting-sensitive — the high rank depends on one or two themes you are emphasizing.
A weighting-sensitive tract is not “invalid” — it simply means that neighborhood resemblance is contingent on your assumptions. If you have changed the weights, compare its rank under the balanced (default) weighting to understand whether it is a universally strong match or scenario-dependent.
Why this matters
Section titled “Why this matters”A brand like Trader Joe’s has a very tight profile (stores in dense, educated, affluent, urban neighborhoods). Its store tracts cluster on several features at once. Under balanced weighting, it scores high in neighborhoods that pack multiple similarities. Under Urbanism-led, you discover urban tracts that may be less affluent but are highly walkable. Under Affluence-led, you find wealthy tracts that may be less dense but are similarly educated.
None of these scenarios predicts success. Each is a different definition of resemblance — a different answer to the question “which neighborhoods look like Trader Joe’s in the ways I think matter?” You are the expert; the tool shows you the data.
Sharing weighted explorations
Section titled “Sharing weighted explorations”Your weights are encoded in the URL hash. Share a link to send someone your specific scenario — brand, map filters, weights, and selected tract.