healthsim-populationsim

What problem does it solve?

This Skill provides data-driven population intelligence to support realistic synthetic health data generation across HealthSim products, enabling consistent, provenance-rich outputs.

Core Features & Use Cases

• PopulationProfile & ground-truth grounding: Generate county-, tract-, and metro-level population profiles by aggregating embedded data from Census ACS, CDC PLACES, SVI, and ADI to ground synthetic data in real-world distributions.
• CohortDefinition capabilities: Create CohortSpecification objects that drive patient, member, and trial populations with demographics, clinical profiles, and SDOH parameters.
• Geographic breadth & cross-product flow: Enable generation across counties, tracts, MSAs, and custom regions, feeding PatientSim, MemberSim, and TrialSim with provenance and validation metadata.
• SDOH integration & provenance: Provide SDOH indicators (SVI, ADI, Z-codes) and data-source provenance to ensure reproducibility and auditability of generated outputs.

Quick Start

• Profile a county to obtain a PopulationProfile and review embedded-data provenance.
• Define a CohortSpecification for a targeted population (e.g., diabetics in a region) and validate demographic/SDOH constraints.
• Generate cross-product outputs (patients, members, trials) by feeding PopulationProfile-derived parameters into downstream HealthSim components.