COMPASS – An open-source software package for creating multi-level representative nested synthetic populations for small areas
Open Access
- 7 October 2026
- journal article
- Published by SAGE Publications in Environment and Planning B: Urban Analytics and City Science
Abstract
Simulation models, such as agent-based or microsimulation models capturing urban contexts, increasingly draw on spatially explicit, attribute-rich synthetic population datasets as real-world data inputs. Despite their growing relevance, the creation of such datasets via simulated annealing still faces significant limitations. Addressing these limitations, we present the open-source software package Combinatorial Optimisation for Microdata Population Assembly and Spatial Synthesis (COMPASS) . The algorithm implemented in COMPASS enables: aggregate-level representativeness at different levels of counts (e.g., households and individuals); the processing of nested input data (e.g., retaining survey household and kinship structures); and systematic monitoring of uncertainty arising at creation stage. We provide COMPASS as a compiled multi-platform software package, suitable for reproducible workflows via R and Python. This paper introduces COMPASS and illustrates one potential workflow using open access data created to reflect an artificial population – transferable to many national contexts.Keywords
Funding Information
- Medical Research Council (MR/Y030656/1)
- Economic and Social Research Council (ES/Z504270/1)
- National Institute for Health and Care Research (NIHR160301)
This publication has 15 references indexed in Scilit:
- Simulating Area‐Level Population Outcomes: Should We Use Multilevel Regression and Poststratification Over Spatial Microsimulation?Geographical Analysis, 2026
- A National Synthetic Populations Dataset for the United StatesScientific Data, 2025
- An activity-based synthetic population of Gothenburg, Sweden: Dataset of residents in neighbourhoodsData in Brief, 2024
- Synthetic population data for small area estimation in the United StatesEnvironment and Planning B: Urban Analytics and City Science, 2023
- A synthetic population of Sweden: datasets of agents, households, and activity-travel patternsData in Brief, 2023
- A synthetic population for agent-based modelling in CanadaScientific Data, 2023
- A deep generative model for feasible and diverse population synthesisTransportation Research Part C: Emerging Technologies, 2023
- An Open‐Source Model for Projecting Small Area Demographic and Land‐Use ChangeGeographical Analysis, 2022
- A dynamic microsimulation model for epidemicsSocial Science & Medicine, 2021
- Gen*: a generic toolkit to generate spatially explicit synthetic populationsInternational Journal of Geographical Information Science, 2018