Skip to content
JiaXu1024 edited this page Nov 13, 2026 · 2 revisions

SANDAG PopulationSim Wiki

Welcome to the SANDAG Population Synthesizer documentation wiki! This system generates synthetic populations for the San Diego region using the ActivitySim PopulationSim framework.

πŸš€ Quick Links

πŸ“– Documentation Sections

For New Users

For Technical Staff

🎯 What is PopulationSim?

SANDAG's PopulationSim creates synthetic households and persons that match regional forecasts:

  • Input: Aggregate demographic forecasts (e.g., "1,000 households in MGRA 12345")
  • Output: Individual synthetic households and persons with detailed attributes
  • Coverage: ~23,000 MGRAs across San Diego County
  • Forecast Years: 2022, 2026, 2029, 2032, 2035, 2040, 2050
flowchart LR
    A[ACS PUMS<br/>Seed Data] --> D[PopulationSim<br/>Engine]
    B[UDM Forecasts<br/>Control Totals] --> D
    C[Economic<br/>Controls] --> D
    D --> E[Synthetic<br/>Households]
    D --> F[Synthetic<br/>Persons]
    E --> G[ABM Model]
    F --> G
Loading

πŸ“Š Key Features

βœ… 56 control variables - Demographics, income, household size, workers, age, race/ethnicity
βœ… Three-level geography - Region β†’ 22 PUMAs β†’ ~23,000 MGRAs
βœ… Parallel processing - 22 simultaneous PUMA processes
βœ… Group quarters - Military, college dorms, other institutional
βœ… Quality assurance - Interactive Streamlit validation dashboard
βœ… Reporting benchmarks - Separate from fitting controls and saved with each run βœ… ABM-ready outputs - Direct integration with activity-based travel model

πŸ”§ Technology Stack

  • PopulationSim: v0.10.0 (ActivitySim framework)
  • Python: 3.9 - 3.12 (3.13+ not yet supported)
  • Package Manager: uv (fast dependency resolution)
  • SQL inputs: Microsoft SQL Server
  • Run export: Optional Azure Data Lake export, controlled by sql.load_to_database
  • Validation: Streamlit report for local output or its database source

πŸ“ Current Version

The active seed vintage, forecast years, and export environment are configured in config.yml.

🀝 Support

For questions or issues:

  1. Check the FAQ and Troubleshooting pages
  2. Review the comprehensive technical documentation
  3. Contact the SANDAG Modeling team

πŸ“‚ Repository Structure

Population-Sim/
β”œβ”€β”€ config.yml                 # Main configuration file
β”œβ”€β”€ main.py                    # Entry point for full workflow
β”œβ”€β”€ pyproject.toml            # Python dependencies
β”œβ”€β”€ data/                     # Input data files
β”œβ”€β”€ documentation/            # Complete technical documentation
β”œβ”€β”€ populationsim/            # PopulationSim execution scripts
β”‚   β”œβ”€β”€ configs/             # PopulationSim settings
β”‚   β”œβ”€β”€ data/                # Geographic crosswalk
β”‚   └── output/              # Synthesis results
β”œβ”€β”€ python/                   # Data preparation modules
β”‚   β”œβ”€β”€ build_controls.py    # Control generation
β”‚   β”œβ”€β”€ build_seed_data.py   # Seed data preparation
β”‚   β”œβ”€β”€ etl.py               # Legacy SQL Server output loading
β”‚   β”œβ”€β”€ datalake_exporter.py # Optional Azure Data Lake export
β”‚   └── outputs.py           # ABM output creation
β”œβ”€β”€ report/                   # Validation dashboard
└── sql/                      # SQL queries for data extraction

Ready to get started? β†’ Installation & Setup

Clone this wiki locally