Skip to content
Historical revision — this record as it stood on 3 July 2026, not the current version. View the current record →

Regional market definition

The Woodfine location intelligence map organises co-location clusters into two spatial containers: the settlement with co-location presence (a coverage statistic) and the Regional Market (a tighter object reserved for settlements with meaningful concentrations of co-located retail). A third, coarser container — the Metro Market — provides context at the major-metropolitan level. This article defines each object, states the rule that produces it, and distinguishes between what each count measures and what it does not.

The two objects currently called Regional Markets

The pipeline resolves each co-location cluster to an incorporated municipal or CSD polygon using RegionEngine.resolve_market() — a point-in-polygon assignment against TIGER 2023 places for the US, GISCO LAU 2021 plus GADM GBR for the EU and UK, with rural co-locations resolving to their containing municipality. A settlement becomes a Regional Market object the moment one co-location falls inside its polygon.

Under this permissive rule, the count of Regional Market objects approximates the count of distinct settlements that contain any co-location at all. At the 2026-05-22 build, the pipeline produces approximately 3,011 settlements (North America and EU/UK) with co-location presence, of which 2,986 are published in the gateway's regional-markets.json and 2,942 carry the high-confidence geocoding flag.

That is a coverage statistic. It records how widely the tracked anchor chains are observed. It does not identify where retail demand actually concentrates, because a floor of one co-location admits every town with a single qualifying co-location on exactly the same terms as a metropolitan area with dozens.

The distinction: coverage versus market

Two failure modes follow from conflating coverage with market:

Single-anchor settlements dominate the population. A town with one qualifying co-location is, under the current rule, the same object class as a metro holding many. The label "Regional Market" implies concentrated retail demand; the rule admits the single-anchor case. The headline count is therefore inflated by exactly the cases that carry the least decision value for site selection or investment.

The count reads as an artefact of the floor, not the geography. A reviewer can move the count up or down simply by arguing the floor, which is the classic sign that the threshold — not the data — is doing the work. This is the same failure class as the DBSCAN parameter sensitivity documented in the co-location tiering and scoring methodology, where parameter sweeps move the North American cluster count across a wide range without any change to the underlying retailer data.

mkt_conf does not resolve this. It is geocoding precision — specifically the quality of the boundary assignment — not market quality, and must not be presented as a ranking or a quality signal.

Recommendation, corrected: composition floors mean anchor composition, not count

This section originally proposed a count-based floor — "a minimum number of co-locations within a polygon" — as the cheap, defensible fix. That recommendation was wrong, and is retracted here rather than left standing. The error: a settlement can clear a count floor of one and still be a genuinely strong market, if its single co-location cluster is itself a convergence of multiple independent anchor categories — a hypermarket, a hardware retailer, and a warehouse club within one tight cluster is a T1 by the tier system's own definition (see "Regional Markets Intelligence System" on the projects wiki), and a T1 is exactly the concentrated-demand signal the term "market" is supposed to carry. Conversely, a settlement that clears a count floor of two by holding two separate, single-anchor (T3) clusters is not obviously stronger than the single-T1 case a count floor would exclude. Counting how many co-location events a settlement has and counting how strong each one is are different questions, and only the second one is what "Regional Market" should mean. Composition — the anchor-category mix within a cluster — is already captured correctly by the T1/T2/T3 tier classification; a floor built on cluster count instead of cluster tier repeats the exact coverage-versus-market conflation this article set out to fix.

The object split below still holds — a permissive coverage catalog is a legitimate, honestly-labelled thing to publish, separate from a claim about market strength — but the tighter object's floor should be tier-based (e.g., "contains at least one T1 cluster, or clears a stated aggregate tier score"), not count-based.

Settlement with co-location presence

  • Definition. Any incorporated municipal or CSD polygon that contains at least one co-location.
  • Count. The full approximately 3,011 (NA plus EU/UK). Stated as a coverage statistic with the honest gloss: "3,011 settlements across 13 countries contain at least one observed retail co-location."
  • Role. Coverage map, footprint claim, and the base set from which the tighter object is drawn. Not the headline market count.

Regional Market

A settlement is promoted to Regional Market when its co-location clusters clear a stated tier-based floor, not a count floor — for example, "contains at least one T1 cluster" or "the aggregate tier score (T1×4 + T2×2 + T3×1) meets a stated minimum." This ties the term to cluster strength rather than cluster count, correctly admitting the single-strong-cluster case and correctly excluding the many-weak-clusters case that a count floor would get backwards.

An alternative, and analytically stronger, floor is a demand threshold: a Regional Market clears a stated catchment population or estimated annual spend threshold, tying the term to demand rather than supply density. This depends on the catchment and spend surfaces being trustworthy first (see the spend and population provenance and trade-area methodology write-ups); adoption is appropriate once those surfaces carry their uncertainty framing.

Whichever floor is chosen, the resulting Regional Market count must be re-derived and published alongside the floor and the rule that produced it — the count is not meaningful without both printed next to it.

If no floor is adopted, the minimum acceptable change is renaming: dropping "Regional Market" for the permissive object and calling it "settlements with co-location presence" on the map face, in the Method modal, and in this TOPIC. The term "market" carries an implied claim of concentrated demand that the one-co-location rule does not support on its own — though, per the correction above, a single co-location can support that claim if its tier is high enough.

The Top-400 co-locations — ranking-variable recommendation: adopted

The Top-400 is a list of co-locations (not Regional Markets) produced per region — North America as one region, Europe (UK, Nordics, Continental) as another — cut at 400. Each row carries a Regional Market column for context. It is the spine of the BentoBox detail view, where the rank shown is a continental-cutoff position.

This article originally flagged that the Top-400 ranking variable was not stated anywhere, and recommended publishing a composite explainable score as the most defensible long-term fix. That recommendation has since been adopted: the ranking now runs on a published composite score, tier_score × civic_multiplier × confidence_factor — tier_score weighting T1/T2/T3 cluster strength (4/2/1), a civic multiplier for medical or higher-education anchor presence, and a confidence factor for chain-data quality — with every driver visible, not a black box. See "Regional Markets Intelligence System" on the projects wiki for the full formula and its rationale. No further action is needed on this point; it is recorded here only so the history of the recommendation is legible.

Metro Market

The Metro Market is a coarser, contextual container: a major metropolitan area on a published reference list (US MSA/CBSA, Canadian CMA). A Regional Market nests inside at most one Metro Market and is never dissolved into it. Metro Market is context only — it is never the co-location or ring zoom level and never a breadcrumb level. Raising the Regional Market floor does not affect the Metro Market layer.

What does not change

The boundary resolution rule — Sherwood Park resolves to its containing polygon (Strathcona County) under the uniform "one rule, no exceptions" boundary policy confirmed 2026-05-22 — is not altered by any floor change. The deleted Nominatim override for that settlement is not reinstated.

One wiki TOPIC per Regional Market (on projects.woodfinegroup.com) remains the article unit, with a section per co-location inside it. Raising the Regional Market floor reduces the number of stub TOPICs — single-anchor settlements no longer generate a thin market article — which is a content-quality improvement.

Counts stated honestly

Every count below is reported with the rule that produced it. Figures are as of the most recent build referenced in the artifact registry and must be re-derived whenever the floor or the boundary set changes.

Object Rule Count What it measures
Settlements with co-location presence ≥1 co-location in polygon ~3,011 (NA + EU/UK, 2026-05-22 build) Coverage and footprint
Regional Markets (tier-based floor, corrected recommendation) ≥1 T1 cluster, or a stated aggregate tier score To be re-derived on adoption Concentrated co-location, correctly admitting single-strong-cluster markets
Published RM objects (gateway, later build) Permissive rule (≥1 co-location), unchanged 4,436 (2026-05-30 build, 18 countries — see "Regional Markets Intelligence System" on the projects wiki) Coverage; grown by dataset expansion, not by a floor change
Top-400 co-locations (per region) Composite score — tier × civic × confidence, published 400 NA + 400 EU Ranked candidate sites; adopted per the recommendation above
NA co-locations (DBSCAN) eps/minPts/IoU — sensitive 226–476 across parameter sweep Cluster count (descriptive)

Two honesty notes belong in the Method modal alongside this table:

  • The Regional Market count under a tier-based floor will differ from the raw settlement count in both directions — it drops many weak, low-tier settlements but keeps every single-cluster T1 settlement a naive count floor would have excluded. Neither direction is a regression; a tier-based count is simply a different, more defensible measurement than either the raw coverage count or a count-based floor.
  • mkt_conf is geocoding precision, not market quality, and is not a ranking variable.

See also

  • co-location tiering and scoring — how tiers and the planned strength score are computed for each co-location inside a Regional Market
  • trade-area methodology — how the trade area for each co-location is defined
  • spend and population provenance — the estimation chain for population and spend figures attributed to each co-location
  • app-orchestration-gis — the orchestration layer that resolves co-locations to Regional Markets
Important Information

Important Information

Corporate structure. PointSav Digital Systems ("PointSav") is a trade name of Woodfine Capital Projects Inc. ("Woodfine"). PointSav does not itself offer, sell, or solicit any security. Any securities offering associated with Woodfine's real-property direct-hold solutions is made exclusively by Woodfine, and only by means of the applicable Private Placement Memorandum.

No investment advice. This wiki's content is provided for engineering, operational, research, and development purposes. Nothing on this wiki constitutes investment advice or a solicitation to invest in any Woodfine partnership or direct-hold solution.

Intellectual property. The PointSav name, trade name, wordmark, and marks, together with all current and future PointSav- and Totebox-branded products, services, and offerings — and the software, source code, documentation, design system, and all related materials — are proprietary to Woodfine and its affiliates, except for components identified as open source. No rights are granted except as expressly set out in a written license or agreement. See TRADEMARK.md in this repository for the full trademark notice.

Open source components. Portions of the platform are made available under permissive open-source licenses identified in the accompanying repository. Use of those components is governed by their respective license terms.

No warranty; informational use. Content on this wiki is provided for general informational purposes only and does not constitute a representation, warranty, or commitment with respect to product functionality, availability, pricing, or roadmap. Some articles describe planned or intended features, capabilities, and milestones — language such as "planned," "intended," "targeted," "may," and "expected" marks this forward-looking content, which is subject to change and does not constitute a commitment regarding future performance.

Confidentiality. Where an article describes an operational or deployment detail that is not intended for public disclosure, that article is not published on this wiki. Content here is general-purpose engineering documentation, not customer-specific configuration.

Jurisdiction. Woodfine Capital Projects Inc. is organized in British Columbia, Canada. References to the Sovereign Data Foundation on this wiki describe a planned or intended initiative only, not a current equity holder or active governance body.

Changes to this notice. PointSav may update this notice from time to time; the version posted on this page governs.

Not a filing system. This wiki is not a securities filing system, an electronic disclosure repository, or a substitute for SEDAR+ or any other regulatory filing system. Formal securities filings are made through the applicable regulatory filing system, not through this wiki.

Full disclaimer. This notice supplements, and does not replace, the full Disclaimers article. In the event of any conflict, the full Disclaimers article governs.

Read the full disclaimer →