Welcome to SynthPop’s documentation!

SynthPop is an object-oriented, modular Python framework for generating synthetic population models. It generates a star catalog following the specified model and configuration.

Acknowledge Synthpop

If you think SynthPop was useful for you work, please cite Klüter & Huston et al. (2025). Please also include citations for key components of the generation process. These includes, but is not limited, to the used model, isochrone system and extinction map.

Getting in touch

If users encounter any issues while using SynthPop during the development/implementation of new submodules or models, they can reach out to the development team through the GitHub issue tracker. We welcome any feedback, bug reports, or feature requests that can help improve Synthpop.

Contents

• Installation
• Usage
  • Run Synthpop as individual script
  • Import SynthPop to other script
• Configuration
  • Specific and Default Configurations
  • Setting Your Configuration
  • Configuration File Contents
• Output
  • Default basic outputs
  • Outputs from MIST evolution
• Models
  • Model & Population Structure
  • Available Models
• Modules
  • Selecting Modules
  • Implementing New Modules
  • Additional Module Information
• Changelog
  • Version 1
• Contributors
  • Developers
  • Acknowledgements
• API Reference
  • synthpop
  • lum_function
  • calibrate_density
  • demo_compare_to_gaia
  • calibration_parameters
  • _compare_default_config
  • test_charon_interpolator
  • run_sp_galaxia_time_test