Synthesizer is an open-source python package for generating synthetic astrophysical observables. It is modular, flexible and fast.

This documentation provides a broad overview of the various components in synthesizer and how they interact. To get started please take a look at the getting started guide, which contains download and installation instructions, as well as an overview of the code.

For detailed examples of what synthesizer can do, take a look at the examples page. Check out the API for exhaustive details on all synthesizer functionality.

Contents

• Getting Started
  • Installation
  • Downloading Grids
  • Overview
  • Getting Help
• Grids
  • Introduction
  • Pre-Computed Grids
  • Grid list
  • Exploring Grids
  • Creating your own grids
• Galaxy
  • Particle vs Parametric
  • Global galaxy properties
• Components
  • Stars
  • Gas
  • Blackholes
• Sed
  • The Sed object
• Emission models
  • Overview
  • Named spectra
  • Working with EmissionModels
• Attenuation
  • Dust Attenuation Curves
  • Intergalactic Medium Absortion
• Generating spectra
  • Integrated vs Particle
• Emission Lines
  • Contents
• Filters
  • Filters example
• Working with Instruments
  • Creating an Instrument
  • Combining Instruments
  • Working with InstrumentCollections
  • Instrument Use Cases
• Photometry
  • Generating Photometry
  • Generating photometry from a Galaxy
• Imaging
  • Images From Galaxy Particle distributions
  • Images From Parametric Galaxies
  • Spectral Data Cubes from Galaxy Particle distributions
  • Spectral Data Cubes from a Parametric Galaxy
  • Property maps
• The Pipeline
  • Setting up a Pipeline object
  • Adding analysis functions
  • Running the pipeline
  • Writing out the data
  • Putting it all together
• Hybrid parallelism with MPI
  • Instatiating a Pipeline when using MPI
  • Adding galaxies with MPI
  • Writing out results with MPI
• Parallelism
  • Shared Memory Parallelism (OpenMP)
• Advanced
  • Contents
• Cookbook
  • Generate active galaxy
  • Generate composite galaxy
• Examples
  • Cosmological simulation examples
  • General examples
  • Grid examples
  • Imaging examples
  • Parametric galaxy examples
  • Particle galaxy examples
• API Reference
  • synthesizer

Citation & Acknowledgement

A code paper is currently in preparation. For now please cite Vijayan et al. 2021 if you use the functionality for producing photometry, and Wilkins et al. 2020 if you use the line emission functionality.

@article{10.1093/mnras/staa3715,
  author = {Vijayan, Aswin P and Lovell, Christopher C and Wilkins, Stephen M and Thomas, Peter A and Barnes, David J and Irodotou, Dimitrios and Kuusisto, Jussi and Roper, William J},
  title = "{First Light And Reionization Epoch Simulations (FLARES) -- II: The photometric properties of high-redshift galaxies}",
  journal = {Monthly Notices of the Royal Astronomical Society},
  volume = {501},
  number = {3},
  pages = {3289-3308},
  year = {2020},
  month = {11},
  issn = {0035-8711},
  doi = {10.1093/mnras/staa3715},
  url = {https://doi.org/10.1093/mnras/staa3715},
  eprint = {https://academic.oup.com/mnras/article-pdf/501/3/3289/35651856/staa3715.pdf},
}

@article{10.1093/mnras/staa649,
  author = {Wilkins, Stephen M and Lovell, Christopher C and Fairhurst, Ciaran and Feng, Yu and Matteo, Tiziana Di and Croft, Rupert and Kuusisto, Jussi and Vijayan, Aswin P and Thomas, Peter},
  title = "{Nebular-line emission during the Epoch of Reionization}",
  journal = {Monthly Notices of the Royal Astronomical Society},
  volume = {493},
  number = {4},
  pages = {6079-6094},
  year = {2020},
  month = {03},
  issn = {0035-8711},
  doi = {10.1093/mnras/staa649},
  url = {https://doi.org/10.1093/mnras/staa649},
  eprint = {https://academic.oup.com/mnras/article-pdf/493/4/6079/32980291/staa649.pdf},
}

Contributing

Please see here for contribution guidelines.

Primary Contributors

Author:

• Christopher Lovell

• Will Roper

• Aswin Vijayan

• Stephen Wilkins

License

Synthesizer is free software made available under the GNU General Public License v3.0. For details see the LICENSE.