Example notebooks

We have a set of notebooks that explain and show the usage of the SSPC features. The notebooks are also stored in the examples directory in the repository

GW merger rate notebook

LISA double white-dwarf population notebook

Contents:

• Tutorial: Star-formation convolution
  • Background on convolution
  • Convolution with Synthetic Stellar Pop Convolve (SSPC)
  • Construction of the output file
  • Supported data formats and storing data
  • Configuration of the convolution
  • Configuring convolution bins
  • Running the convolution
  • Reading and understanding the output
  • Descriptions of convolution configuration options and convolution instruction options
  • Complete convolution script
• Tutorial: Setting Up Star Formation-Rate Dictionary
  • Configuring the Global Star Formation Rate
  • Adding Metallicity Dependence (Optional)
  • Some important general things to note:
• Example: Use-cases of convolution
  • Convolving data with Lgalaxies merger-tree info
  • Surface density of binary objects in the SMC
  • Orbit integration of stellar systems in a galaxy (including kicks!) using Agama
• Convolution background
• Tutorial: using persistant data and accessing previous convolution steps
  • Future functionality
• Tutorial: Convolution by sampling
  • Background
  • Sampling Systems
• Tutorial: Convolution by integration
• Tutorial: convolution on the fly
  • example implementation: binary_c-python
• Tutorial: inflating ensembles (pre-binned data format)
• Convolution of binned data
  • Loading up binned data
  • Post-processing binned data
  • Convolution-by-sampling of binned data
  • filtering of data TODO: CHANGE
  • Assigning new values to initially binned quantities
• example use-case: Convolving BinCodex Data
• Example use-case: One-zone chemical evolution model.
  • Further ideas
• Example use-case: Cosmological gravitational-wave merger rate density
  • Readout and plotting
• Example use-case: LISA UCB convolution of double white-dwarf binaries at current-day
  • Advanced steps
• Example use-case: Orbit integration and supernova kicks
• Example use-case: predicting GAIA-observable populations of star systems
  • post-convolution function