Grids¶
Introduction¶
Most of the functionality of synthesizer is reliant on grid files. These are typically precomputed multi-dimensional arrays of spectra (and lines) from Stellar Population Synthesis (SPS) models for a range of ages and metallicities, and potentially other parameters (see below). Grids can also represent the emission from other sources, e.g. active galactic nuclei.
There is a low-resolution test grid available via the synthesizer-download
command line tool, but for actual projects you will need to download one or more full production grids from dropbox. See details below on where on your system to download these grids and how to load them.
The Grid Directory¶
All synthesizer grids should be stored in a separate directory somewhere on your system. For example, we can create a folder:
mkdir /our/synthesizer/data_directory/synthesizer_data/
Within this we will additionally create another directory to hold our grids:
mkdir /our/synthesizer/data_directory/synthesizer_data/grids
If you wish, you can set this grid directory as an environment variable.
Pre-Computed Grids¶
A goal of synthesizer is to be flexible. With this in mind, we have generated a variety of grids for different SPS models, initial mass functions (IMFs), and photoionisation modelling assumptions.
Grid naming¶
The naming of grids currently follows this specification:
{sps_model}-{sps_version}-{sps_variant}_{imf_type}-{mass_boundaries}-{slopes}_{photoionisation_code}-{photoionisation_code_version}-{photoionisation_parameters}
e.g.
bpass-2.2.1-bin_chabrier03-0.1,300.0_cloudy-c17.03
specifies that the grid is constructed using v2.2.1 of the Binary Population and Spectral Synthesis (BPASS) SPS model for the binary (bin) variant. This grid assumes the Chabrier (2003) IMF between 0.1 and 300 Msol. Photoionisation modelling is performed using v17.03 of the cloudy photoionisation code assuming our default assumptions.
Initial Mass Function¶
Grids are constructed using various initial mass functions (IMFs), often depending on the availability in the specific SPS model. In most cases we recommend using the Chabrier (2003) IMF since this is available for most SPS models, allowing a like-for-like comparison. If you’re interested in exploring the systematic impact of changing the IMF, broken power law (bpl) IMFs may be suitable. These are named e.g.
{imf_type}-{mass_boundaries}-{slopes}
e.g. for a Salpeter (1955) IMF (slope=2.35) between 0.1 and 100 Msol we would have
bpl-0.1,100-2.35
A more complex IMF, for example with two power-laws (2.0, 2.35) separated at 1 Msol, would have
bpl-0.1,1.0,100-2.0,2.35
If an IMF you need is missing, please let us know by raising a feature request through an issue.
Photoionisation modelling¶
All the photoionisation modelling in synthesizer currently uses the cloudy photoionisation code. Our default assumptions are:
log10(U)=-2
Common variants¶
resolution:0.1 outputs the spectra at 10x higher resolution than the cloudy default. Useful for looking at various absorption line indices.
log10U:X assumes a different ionisation parameter.
Higher-dimensionality grids¶
Most SPS grids are two-dimensional, with the dimensions being log10(age) and metallicty. However synthesizer can utlilise grids with higher dimensionality e.g. including varying alpha-abundance, or photoionisation parameters (e.g. U).
Grid list¶
Below is an incomplete list of the pre-computed grids available in the dropbox.
Bruzual & Charlot (2003, BC03)
- Chabrier (2003) IMF
bc03_chabrier03-0.1,100
bc03_chabrier03-0.1,100_cloudy-c17.03
bc03_chabrier03-0.1,100_cloudy-c17.03_resolution:0.1
2016 update of Bruzual & Charlot (2003)
- The BaSel variant
- Chabrier (2003) IMF
bc03-2016-BaSeL_chabrier03-0.1,100
bc03-2016-BaSeL_chabrier03-0.1,100_cloudy-c17.03
bc03-2016-BaSeL_chabrier03-0.1,100_cloudy-c17.03_resolution:0.1
- The Miles variant
- Chabrier (2003) IMF
bc03-2016-Miles_chabrier03-0.1,100
bc03-2016-Miles_chabrier03-0.1,100_cloudy-c17.03
bc03-2016-Miles_chabrier03-0.1,100_cloudy-c17.03_resolution:0.1
- The Stelib variant
- Chabrier (2003) IMF
bc03-2016-Stelib_chabrier03-0.1,100
bc03-2016-Stelib_chabrier03-0.1,100_cloudy-c17.03
bc03-2016-Stelib_chabrier03-0.1,100_cloudy-c17.03_resolution:0.1
Binary Population and Spectral Synthesis (BPASS) v2.2.1
Binary Population and Spectral Synthesis
- Binary variant
- Broken power-law IMF
bpass-2.2.1-bin_bpl-0.1,1.0,100.0-1.3,2.0
bpass-2.2.1-bin_bpl-0.1,1.0,100.0-1.3,2.0_cloudy-c17.03
bpass-2.2.1-bin_bpl-0.1,1.0,100.0-1.3,2.35
bpass-2.2.1-bin_bpl-0.1,1.0,100.0-1.3,2.35_cloudy-c17.03
bpass-2.2.1-bin_bpl-0.1,1.0,100.0-1.3,2.7
bpass-2.2.1-bin_bpl-0.1,1.0,100.0-1.3,2.7_cloudy-c17.03
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.0
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.0_cloudy-c17.03
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.0_cloudy-c17.03_resolution:0.1
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.35
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.35_cloudy-c17.03
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.35_cloudy-c17.03_resolution:0.1
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.7
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.7_cloudy-c17.03
bpass-2.2.1-bin_bpl-0.1,1.0,300.0-1.3,2.7_cloudy-c17.03_resolution:0.1
- Chabrier (2003) IMF
bpass-2.2.1-bin_chabrier03-0.1,100.0
bpass-2.2.1-bin_chabrier03-0.1,100.0_cloudy-c17.03
bpass-2.2.1-bin_chabrier03-0.1,100.0_cloudy-c17.03_resolution:0.1
bpass-2.2.1-bin_chabrier03-0.1,300.0
bpass-2.2.1-bin_chabrier03-0.1,300.0_cloudy-c17.03
bpass-2.2.1-bin_chabrier03-0.1,300.0_cloudy-c17.03_resolution:0.1
- Single star variant variant
- Broken power-law IMF
bpass-2.2.1-sin_bpl-0.1,1.0,100.0-1.3,2.0
bpass-2.2.1-sin_bpl-0.1,1.0,100.0-1.3,2.35
pass-2.2.1-sin_bpl-0.1,1.0,100.0-1.3,2.7
bpass-2.2.1-sin_bpl-0.1,1.0,300.0-1.3,2.0
bpass-2.2.1-sin_bpl-0.1,1.0,300.0-1.3,2.35
bpass-2.2.1-sin_bpl-0.1,1.0,300.0-1.3,2.7
- Chabrier (2003) IMF
bpass-2.2.1-sin_chabrier03-0.1,100.0
bpass-2.2.1-sin_chabrier03-0.1,300.0
Binary Population and Spectral Synthesis (BPASS) v2.3
Binary Population and Spectral Synthesis
- Binary variant
- Chabrier (2003) IMF
bpass-2.3-bin_chabrier03-0.1,300.0
bpass-2.3-bin_chabrier03-0.1,300.0_alpha-0.2
bpass-2.3-bin_chabrier03-0.1,300.0_alpha-0.2_cloudy-c17.03_resolution:0.1
bpass-2.3-bin_chabrier03-0.1,300.0_alpha0.0
bpass-2.3-bin_chabrier03-0.1,300.0_alpha0.2
bpass-2.3-bin_chabrier03-0.1,300.0_alpha0.2_cloudy-c17.03_resolution:0.1
bpass-2.3-bin_chabrier03-0.1,300.0_alpha0.4
bpass-2.3-bin_chabrier03-0.1,300.0_alpha0.4_cloudy-c17.03_resolution:0.1
bpass-2.3-bin_chabrier03-0.1,300.0_alpha0.6
bpass-2.3-bin_chabrier03-0.1,300.0_alpha0.6_cloudy-c17.03_resolution:0.1
Flexible Stellar Population Synthesis (FSPS) v3.2
- Broken power-law IMF - Note: several of these are currently missing.
fsps-3.2_bpl-0.08,0.5,1,120-1.3,2.3,2.3
fsps-3.2_bpl-0.08,0.5,1,120-1.3,2.3,2.3_cloudy-c17.03
fsps-3.2_bpl-0.08,0.5,1,120-1.3,2.3,2.8
fsps-3.2_bpl-0.08,0.5,1,120-1.3,2.3,2.8_cloudy-c17.03
fsps-3.2_bpl-0.08,0.5,1,120-1.3,2.3,2.9
fsps-3.2_bpl-0.08,0.5,1,120-1.3,2.3,3.0
- Chabrier (2003) IMF
fsps-3.2_chabrier03-0.08,1
fsps-3.2_chabrier03-0.08,10
fsps-3.2_chabrier03-0.08,100
fsps-3.2_chabrier03-0.08,100_cloudy-c17.03
fsps-3.2_chabrier03-0.08,120
fsps-3.2_chabrier03-0.08,120_cloudy-c17.03
fsps-3.2_chabrier03-0.08,120_cloudy-c17.03_resolution:0.1
fsps-3.2_chabrier03-0.08,2
fsps-3.2_chabrier03-0.08,20
fsps-3.2_chabrier03-0.08,5
fsps-3.2_chabrier03-0.08,50
fsps-3.2_chabrier03-0.08,50_cloudy-c17.03
fsps-3.2_chabrier03-0.5,120
fsps-3.2_chabrier03-0.5,120_cloudy-c17.03
fsps-3.2_chabrier03-1,120
fsps-3.2_chabrier03-1,120_cloudy-c17.03
fsps-3.2_chabrier03-10,120
fsps-3.2_chabrier03-10,120_cloudy-c17.03
fsps-3.2_chabrier03-2,120
fsps-3.2_chabrier03-2,120_cloudy-c17.03
fsps-3.2_chabrier03-20,120
fsps-3.2_chabrier03-20,120_cloudy-c17.03
fsps-3.2_chabrier03-5,120
fsps-3.2_chabrier03-50,120
fsps-3.2_chabrier03-50,120_cloudy-c17.03
Maraston models
- Broken power-law IMF
maraston-rhb_bpl-0.1,100-2.35
Exploring Grids¶
Once you’ve downloaded a grid you can get started here:
Creating your own grids¶
For advanced users, synthesizer contains scripts for creating your own grids from popular SPS codes, and running these through CLOUDY. We provide scripts for doing this in the synthesizer-grids repository. Details are provided here. You will need a working installation of synthesizer for these scripts to work, as well as other dependencies for specific codes (e.g. CLOUDY, python-FSPS). Please reach out to us if you have questions about the pre-computed grids or grid creation.