GREASYPOP-CO

GREASYPOP-CO stands for Geographically REAlistic SYnthetic POPulation using Combinatorial Optimization.¹ It builds a synthetic population of people and households for any chosen area of the United States, at the level of the census block group.¹ It then places people in schools and workplaces and connects them into a contact network: a list of who is in regular contact with whom at home, at school, at work and in group quarters.¹ Disease models use networks like this to decide who can infect whom.²

The authors are Alexander Tulchinsky, Fardad Haghpanah, Alisa Hamilton, Nodar Kipshidze and Eili Klein, and the code is published under the GitHub account CDDEP-DC.^1,2 Their 2024 preprint describes the method and tests it on two census regions. It reports that the synthetic populations match the source data, and that networks built this way spread disease at different rates in a simulation from networks built without a synthetic population.²

First it chooses real households from the census microdata sample (PUMS) so that each block group matches its American Community Survey tables.^1,2 Workers go to workplaces, grouped by industry, using commuting data (LODES) and employer-size counts.^1,2 Students go to public schools using national school location and enrolment data.^1,2 The network is generated last.^1,2 Some inputs download automatically with a Census API key, others by hand.¹ It needs R, Python and Julia, and writes people and households to CSV and the network as a sparse matrix.¹

The README is plain about limits. The network covers only household, school, workplace and group-quarters contacts, so other kinds of contact must be added for most uses.¹ The manual data route works only with 2010 to 2019 census formats.¹ The code is AGPL-3.0, released as v0.2 in June 2024, and has had no commits since September 2024.¹