Binary-Star Population Synthesis with POSYDON

Embark on a journey into the fascinating world of binary-star population synthesis with POSYDON! Whether you are a budding astrophysicist or a seasoned researcher, our tutorials guide you every step of the way. From simulating your first binaries to running large-scale populations and diving deep into data analysis, POSYDON offers you a seamless experience.

Getting Started Tutorials

Warning

The tutorials are designed to be followed in order, as some depend on the outputs of the previous tutorials.

These tutorials are created to get started with POSYDON on your local machine and on a HPC facility.

I. Your First Binary Simulations with POSYDON 🌠

Simulate your first 10 binaries and experience the power of POSYDON.

• Your First Binary Simulations with POSYDON 🌠
  • Creating the Initialisation File
  • Running the Population Synthesis Model
  • Exploring the Simulation Output
    • Local MPI runs

Now that you know how to run your first simulations, explore the different customization options reading the population prameters documentation.

II. Large-Scale Population Synthesis on HPC Facilities 🚀

In this tutorial, you’ll learn to run massive simulations of 1 million binaries across 8 different metallicities.

Note

Ensure you’ve installed mpi4py to use this tutorial. If not, follow our installation guide.

• Large-Scale Population Synthesis on HPC Facilities 🚀
  • Creating the Initialization File to Rub the Binary Population Synthesis Model
  • Running the Population Synthesis Model
• Combining runs into single metallicity files
  • Parsing the Population Synthesis Model Output

III. Analyzing Merging DCO Populations: Rates & Observations 🔍

Delve into the results of your simulations learning how to analyze the results of your simulations and compute rates and observational properties of merging double compact object (DCO) populations.

• Analyzing Merging BBH Populations: Rates & Observations 🔍
  • Creating the Synthetic Poupulation DataFrame
  • Compute the BBH Merger Efficiency, the Merger Rate Desity and the Detection Rate
  • Visualize the BBH Intrisic and Observable Property Distributions
  • Visualize the BBH Population on the 2D MESA Grid Plot Slices

Advanced Tutorials

Computing Long-Duration Gamma-Ray Bursts from Double Compact Object Populations 🌌

In this tutorial, you will learn how to compute long-duration gamma-ray bursts rates associated to the formation of merging binary black holes

• Computing Long-Duration Gamma-Ray Bursts from Double Compact Object Populations 🌌
  • Creating the Synthetic Poupulation DataFrame
  • Compute the BBH and LGRB rates
  • Visualize the LGRB Population Property Distributions

Explore the assumption of star-formation history and compute DCO rates for one single metallicity 📖

In this tutorial, you will learn how to change the assumption of star-formation history and how to analysise and compute rates for a population synthesis model consisting of one single metallicity.

• Explore the assumption of star-formation history and DCO compute rates at one single metallicity 📖
  • Creating the Synthetic Poupulation DataFrame
  • Compute the BBH Merger Rates for \(Z\in [0.5Z_\odot,2Z_\odot]\)
  • Visaulize the BBH Population Properties

X-ray binaries: computing the X-ray luminosity function 🩻

TODO: bring v1 tutorial to v2 leveraging the SyntheticPopulation class

Debugging the Evolution of a Single Binary saved in a POSYDON Population model 🐞

This notebook shows you how to run the BinaryPopulation class in debug mode, which allows you to follow the evolution of a single binary through the population synthesis code. This is useful for debugging purposes, or for understanding the evolution of a single binary in detail, e.g. by changing the natal kicks.

• Debugging POSYDON Binary Population Synthesis 🐞
  • Re-evolving a Binary Star
  • Re-evolving a Binary Star with a different kick
  • Debugging a Binary Star from a population h5 file
  • Evolving a Binary Star starting from an arbitrary state
  • Mapping a MESA step to the detached_step
  • Crating your own step

Advanced Visualization with Van den Heuvel Diagrams 🎨

Dive deeper into POSYDON’s visualization capabilities. This tutorial explores the intricacies of the Van den Heuvel diagrams, allowing users to intuitively visualize and analyze individual or multiple binaries from the population synthesis models. Discover multiple visualization modes, interactive features, and binary analysis tools to enhance your understanding of the synthesized data. Perfect for those looking to gain a richer visual perspective on their simulations.

• Van den Heuvel Diagrams
  • Visualizing a Specific Binary
    • Simple Usage
    • Predefined Views
    • Display Modes
  • Advanced Visualization Techniques
    • Visualizing Multiple Binaries
    • Hierarchical Visualization
  • Binary Analysis Tools
    • Counting Binaries
    • Sorting Binaries

Deep Dive: Behind the Scenes Customizations

Dive into the nitty-gritty of POSYDON’s inner workings. Customize, extend, and tweak the system to fit your unique requirements:

Customizing the Population Synthesis Class 🛠️

• Understand the foundational class driving our binary-star population synthesis. Learn to modify and adapt it to your needs.

• 🔗 [Delve into class customizations](link-to-customization-notebook1)

(Add other in-depth customization tutorials here…)

Remember, mastering POSYDON is a journey, not a destination. As you progress through these tutorials, you’ll uncover layers of capabilities and functionalities. Keep exploring and happy simulating!