Skip to content

Join Count Statistic

A categorical spatial summary that tallies neighboring unit pairs by their label combination under a declared adjacency convention.

Version
v1 · 2026-10-03 · History
Domain-specific #
13355
Domain group
Formal Sciences
Origin domain
Experimental Design & Statistics
Subdomains
Spatial Statistics, Categorical Spatial Analysis → Experimental Design & Statistics
Aliases
Join-count statistic

Core Idea

A join count statistic tallies how categorical labels meet across a declared spatial-neighbor relation. For binary black/white labels the three unordered pair types are \(BB\), \(WW\) and \(BW\); the words black and white are just code names. With a fixed simple undirected graph, their counts sum to \(J\), the total number of unique neighbor pairs, so only two category counts are independent once \(J\) is known. A raw count is descriptive; only an added null/reference distribution can justify a claim that like or unlike neighbors occur more often than expected.[ref-b84f85319653][ref-71d4927b422c]

Scope of Application

The spdep authors demonstrate high/low crime-labeled Columbus zones on a binary neighbor graph. The same observed high-high count is evaluated against differing free and nonfree sampling assumptions, showing that reference expectation and variance are not properties of the count alone. Little and Dale instead encode balsam-poplar establishment as binary quadrat-by-year cells and count black-black joins at declared spatial and temporal lags. Both are categorical neighbor-pair summaries, but their graphs and null models differ.[ref-71d4927b422c][ref-5d0248748724]

Clarity

State what makes two units neighbors and whether each undirected pair is counted once. In a symmetric ordered double sum, each edge appears twice; PySAL's unique-edge formulas use one-half, while Anselin's displayed global \(BB\) expression does not. Comparing counts across those conventions without normalization is an error. Also separate the global count vector from a local focal-unit statistic and from Moran's \(I\) for quantitative attributes.[ref-b84f85319653][ref-fa6e7d8c58fe]

Manages Complexity

The statistic compresses a map into a small profile of like and unlike contacts while retaining more structure than label prevalence alone. This loses the locations of those contacts; distinct maps can have the same global counts. It also loses uncertainty until a graph- and assignment-conditioned null is supplied. A large observed \(BB\) count is not, by itself, an inferential verdict or a causal explanation.[ref-b84f85319653][ref-71d4927b422c]

Abstract Reasoning

Label mapped units, declare the neighbor graph and pair-counting convention, tally endpoint-category classes, and check that the classes exhaust the eligible pairs. If inference is desired, separately state what label arrangements were possible under the null, which totals are fixed and how the reference distribution is calculated. The observed statistic belongs to the live Aggregation genus, but its categorical spatial graph roles keep it domain-specific rather than merely generic counting.[ref-b84f85319653][ref-5d0248748724]

Knowledge Transfer

The Columbus crime and poplar-establishment settings preserve the same map/graph/pair-type/tally structure while changing the meaning of labels and of an eligible join. What transfers is the categorical-neighbor counting operation. Neither the crime example's expected moments nor a default \(z\)-score transfers automatically to the space-time ecological lattice, and neither count alone explains a mechanism.[ref-71d4927b422c][ref-5d0248748724]

[^ref-b84f85319653]: PySAL esda maintainers, “Global Spatial Autocorrelation with Join Counts”, original project guide, “Join Counts” and “Inference.” [^ref-71d4927b422c]: Roger Bivand and spdep maintainers, “BB join count statistic for k-coloured factors”, original package reference, introduction, sampling argument, Note and Columbus examples. [^ref-fa6e7d8c58fe]: Luc Anselin, An Introduction to Spatial Data Science with GeoDa, §19.2, original author text, global and local count formulas. [^ref-5d0248748724]: L. R. Little and M. R. T. Dale, “A method for analysing spatio-temporal pattern in plant establishment, tested on a Populus balsamifera clone”, Journal of Ecology 87 (1999), 620–627, original abstract and methods.

Relationships to Other Abstractions

Local relationship map for Join Count StatisticParents appear above the current abstraction, mutual partners to the right, and children below. Node labels state whether each abstraction is prime or domain-specific; colors identify relation types.Join Count StatisticDOMAINPrime abstraction: Aggregation — is a kind ofAggregationPRIME

Current abstraction Join Count Statistic Domain-specific

Parents (1) — more general patterns this builds on

  • Join Count Statistic is a kind of Aggregation Prime

    Summarizes many typed neighbor pairs into a categorical count profile.

Hierarchy path (1) — routes to 1 parentless root

Neighborhood in Abstraction Space

Join Count Statistic sits in a sparse region of the domain-specific corpus (62nd percentile for distinctiveness): few abstractions share its structure, so a faithful description tends to retrieve it precisely.

Family — Codes, Matrices & Combinatorial Problems (30 abstractions)

Nearest neighbors

Computed from structural-signature embeddings · 2026-10-08