Component reference

Every model registered in tengri, as the package itself reports it. The tables below are generated from the live registries at build time, so they cannot drift from what SEDModel.build will accept.

Read the status column before choosing a model:

  • production: validated, and the right choice unless you have a reason to pick another.

  • unvalidated: registered, but not yet verified against the DSPS forward path. Selecting one raises an error rather than returning an untrusted number.

  • experimental: runs, but not validated for science.

  • broken: known to fail. Asking for it by name raises an error deliberately.

  • deprecated: an old spelling kept working for backward compatibility.

  • comparison / demo: present for cross-code parity or teaching, not for science.

The use column is the exact call. Copy it.

Anything here can also be reached from Python. tengri.list_all() returns every registry at once, and tengri.describe("calzetti") explains one entry including its parameters. Discovering the menu walks through that interactively, with this page providing the same information for reading rather than running.

components

tengri.list_components()

name

status

short_doc

use

stellar

production

SSP integration over SFH (DSPS), metallicity history, mass remaining

tengri.stellar

dust

production

Two-component attenuation (BC + diffuse); see list_dust_laws()

tengri.dust  (see list_dust_models() / list_dust_laws() / list_dust_emission_models() for alternatives)

agn

production

Disc + torus + polar dust + BLR/NLR; see list_agn_models / list_agn_blocks

tengri.agn  (see list_agn_models() / list_agn_blocks() for alternatives)

nebular

production

Emission lines + continuum: BakedIn / CUE / CloudyGrid / CB19

tengri.nebular  (see list_nebular_backends() for alternatives)

radio

production

SF synchrotron + AGN jets + free-free continuum

tengri.radio  (see list_radio_models() / list_radio_blocks() for alternatives)

igm

production

IGM transmission (Inoue+2014) + DLA absorption

tengri.igm  (see list_igm_models() for alternatives)

xray

production

X-ray binaries + AGN corona

tengri.xray  (see list_xray_models() for alternatives)

recipes

tengri.list_recipes()

name

short_doc

use

ssp_requirement

data

agn_panchromatic

Recipe for AGN-dominated galaxies with multi-wavelength data.

recipes.agn_panchromatic() → SEDModel.build(ssp_data=ssp, **recipe)

bare-stellar (Cue nebular backend; see star_forming_photometry for details).

ready

composable_agn

Fully composable AGN: all slots switchable on committed data.

recipes.composable_agn() → SEDModel.build(ssp_data=ssp, **recipe)

bare-stellar (Cue nebular backend; see star_forming_photometry for details).

ready

dust_demo

Recipe for forward-only dust attenuation gallery sweeps.

recipes.dust_demo() → SEDModel.build(ssp_data=ssp, **recipe)

wNE (with-nebular-emission), i.e. the default load_ssp() (mist_c3k_hr_chabrier_wNE). Uses the BakedIn nebular path bundled with the SSP, so optical emission lines render in the SED plots. A recipe that asks for Cue or CLOUDY nebular emission is built on the bare twin of the default instead (#3465).

ready

high_z

Recipe for high-redshift galaxies (z > 3.5, young starburst).

recipes.high_z() → SEDModel.build(ssp_data=ssp, **recipe)

with-nebular-emission (wNE) SSP grids; the ssp nebular backend reads line and continuum emission baked into the SSP file itself, so a bare-stellar grid would silently drop the nebular contribution.

ready

mock_recovery_minimal

Recipe for mock data recovery and benchmarking (minimal model).

recipes.mock_recovery_minimal() → SEDModel.build(ssp_data=ssp, **recipe)

any. Nebular emission is disabled, so this recipe works with both bare-stellar and wNE SSP files.

ready

photoz

Recipe for photometric-redshift fits (redshift-unconstrained surveys).

recipes.photoz() → SEDModel.build(ssp_data=ssp, **recipe)

any (nebular emission is off).

ready

quiescent_z0

Recipe for quiescent galaxies at low redshift (z ~ 0.05).

recipes.quiescent_z0() → SEDModel.build(ssp_data=ssp, **recipe)

bare-stellar (Cue nebular backend; see star_forming_photometry for details).

ready

star_forming_photometry

Recipe for star-forming galaxies with broadband photometry (0 < z < 6).

recipes.star_forming_photometry() → SEDModel.build(ssp_data=ssp, **recipe)

the default grid (load_ssp(), nebular-baked mist_c3k_hr_chabrier_wNE) or any bare-stellar grid. Cue and CLOUDY need the bare stellar grid: a model on the default is built on its bare twin (mist_c3k_hr_chabrier_noNE) automatically (#3465). Naming a wNE grid explicitly with the Cue backend raises CueWNESSPError.

ready

stochastic_sfh_jwst

Recipe for JWST high-redshift galaxies with stochastic SFH.

recipes.stochastic_sfh_jwst() → SEDModel.build(ssp_data=ssp, **recipe)

bare-stellar (Cue nebular backend; see star_forming_photometry for details).

ready

unified_agn

Synthesizer UnifiedAGN reproduction (disc + NLR/BLR grids).

recipes.unified_agn() → SEDModel.build(ssp_data=ssp, **recipe)

bare-stellar (Cue nebular backend; see star_forming_photometry for details). Synthesizer grids cannot be paired with wNE SSP files.

needs Synthesizer AGN NLR grid (synthesizer-download –agn-test-grids)

sfh models

tengri.list_sfh_models()

name

status

citation

short_doc

use

param_details

buat08

production

Buat et al. 2008

Velocity-parameterized SFH (Buat et al.)

SEDModel.build(…, sfh={‘type’: ‘buat08’})

[{'name': 'sfh_buat08_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_buat08_velocity_km_s', 'default': 'Uniform(80.0, 360.0)', 'description': 'Rotational velocity (km/s), range [40, 360]'}, {'name': 'sfh_buat08_age_gyr', 'default': 'Uniform(0.5, 13.787)', 'description': 'Galaxy age / lookback to formation (Gyr)'}]

burst

production

Triweight burst kernel (Zacharegkas+2025)

SEDModel.build(…, sfh={‘type’: [‘const’, ‘burst’]})

[{'name': 'sfh_burst_log_fburst', 'default': 'Uniform(-3.0, -0.1)', 'description': 'log10 burst mass fraction'}, {'name': 'sfh_burst_log_tpeak_myr', 'default': 'Uniform(0.0, 3.0)', 'description': 'log10 burst peak time (Myr)'}, {'name': 'sfh_burst_log_tmax_myr', 'default': 'Uniform(1.0, 4.0)', 'description': 'log10 burst duration (Myr)'}]

bursty_continuity

unvalidated

Tacchella et al. 2022 (ApJ 926, 134); arXiv:2102.11954

Bursty continuity SFH (Tacchella+22); StudentT df=2 with sigma=1.0 dex on ratios whose younger edge < 1 Gyr and sigma=0.3 dex otherwise [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_burstcont_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_burstcont_ratio_0', 'default': 'StudentT(mu=0.0, sigma=1.0, df=2.0)', 'description': 'log10 SFR ratio bin 0/1 (Tacchella+22 piecewise scale)'}, {'name': 'sfh_burstcont_ratio_1', 'default': 'StudentT(mu=0.0, sigma=1.0, df=2.0)', 'description': 'log10 SFR ratio bin 1/2 (Tacchella+22 piecewise scale)'}, {'name': 'sfh_burstcont_ratio_2', 'default': 'StudentT(mu=0.0, sigma=1.0, df=2.0)', 'description': 'log10 SFR ratio bin 2/3 (Tacchella+22 piecewise scale)'}, {'name': 'sfh_burstcont_ratio_3', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 3/4 (Tacchella+22 piecewise scale)'}, {'name': 'sfh_burstcont_ratio_4', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 4/5 (Tacchella+22 piecewise scale)'}, {'name': 'sfh_burstcont_ratio_5', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 5/6 (Tacchella+22 piecewise scale)'}]

const

production

Constant SFR

SEDModel.build(…, sfh={‘type’: ‘const’})

[{'name': 'sfh_const_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_const_start_gyr', 'default': 'Fixed(14.0)', 'description': 'Lookback to SF onset (Gyr): when did SF start?'}, {'name': 'sfh_const_start_frac', 'default': 'Uniform(0.0007253269356107764, 1.0)', 'description': 'Onset as a fraction of age(z) (formation time)'}, {'name': 'sfh_const_end_gyr', 'default': 'Fixed(0.0)', 'description': 'Lookback to SF cessation (Gyr): when did SF stop? (0 = ongoing)'}]

const_exp

production

Constant SFR then exponential quenching

SEDModel.build(..., sfh={'type': 'const_exp'})

[{'name': 'sfh_cexp_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun] (constant + decline phases)'}, {'name': 'sfh_cexp_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'Post-quench e-folding timescale (Gyr)'}, {'name': 'sfh_cexp_quench_gyr', 'default': 'Uniform(0.01, 10.0)', 'description': 'Lookback time when quenching began (Gyr)'}, {'name': 'sfh_cexp_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback to formation (Gyr)'}, {'name': 'sfh_cexp_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

constant_then_exponential

unvalidated

Constant SFR then exponential quenching [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_cexp_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun] (constant + decline phases)'}, {'name': 'sfh_cexp_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'Post-quench e-folding timescale (Gyr)'}, {'name': 'sfh_cexp_quench_gyr', 'default': 'Uniform(0.01, 10.0)', 'description': 'Lookback time when quenching began (Gyr)'}, {'name': 'sfh_cexp_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback to formation (Gyr)'}, {'name': 'sfh_cexp_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

continuity

production

Leja et al. 2019 (ApJ 876, 39)

Non-parametric piecewise continuity SFH (Leja+19); StudentT(0, 0.3, df=2) on log-SFR ratios

SEDModel.build(…, sfh={‘type’: ‘continuity’})

[{'name': 'sfh_cont_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_cont_ratio_0', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 0/1'}, {'name': 'sfh_cont_ratio_1', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 1/2'}, {'name': 'sfh_cont_ratio_2', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 2/3'}, {'name': 'sfh_cont_ratio_3', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 3/4'}, {'name': 'sfh_cont_ratio_4', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 4/5'}, {'name': 'sfh_cont_ratio_5', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 5/6'}]

continuity_flex

production

Leja et al. 2019 (ApJ 876, 39)

Non-parametric continuity + flexible bin edges (Leja+19); StudentT(0, 0.3, df=2) on log-SFR ratios

SEDModel.build(..., sfh={'type': 'continuity_flex'})

[{'name': 'sfh_cflex_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_cflex_ratio_young', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10(SFR_young / SFR_flex[0])'}, {'name': 'sfh_cflex_flex_0', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 flex bin SFR ratio 0 (controls bin width)'}, {'name': 'sfh_cflex_flex_1', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 flex bin SFR ratio 1 (controls bin width)'}, {'name': 'sfh_cflex_flex_2', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 flex bin SFR ratio 2 (controls bin width)'}, {'name': 'sfh_cflex_ratio_old', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10(SFR_old / SFR_flex[N])'}]

continuity_young_fraction

production

Leja et al. 2019 (ApJ 876, 3)

Continuity SFH (Leja+19) in youngest-first stick-breaking fractions; exact pullback of the StudentT(0, 0.3, df=2) ratio prior

SEDModel.build(..., sfh={'type': 'continuity_young_fraction'})

[{'name': 'sfh_cont_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_cont_young_frac_0', 'default': 'Uniform(0.0, 1.0)', 'description': 'youngest-first stick-breaking fraction of bin 0 (M_0/R_0)'}, {'name': 'sfh_cont_young_frac_1', 'default': 'Uniform(0.0, 1.0)', 'description': 'youngest-first stick-breaking fraction of bin 1 (M_1/R_1)'}, {'name': 'sfh_cont_young_frac_2', 'default': 'Uniform(0.0, 1.0)', 'description': 'youngest-first stick-breaking fraction of bin 2 (M_2/R_2)'}, {'name': 'sfh_cont_young_frac_3', 'default': 'Uniform(0.0, 1.0)', 'description': 'youngest-first stick-breaking fraction of bin 3 (M_3/R_3)'}, {'name': 'sfh_cont_young_frac_4', 'default': 'Uniform(0.0, 1.0)', 'description': 'youngest-first stick-breaking fraction of bin 4 (M_4/R_4)'}, {'name': 'sfh_cont_young_frac_5', 'default': 'Uniform(0.0, 1.0)', 'description': 'youngest-first stick-breaking fraction of bin 5 (M_5/R_5)'}]

db

unvalidated

Dense-basis non-parametric SFH (Iyer+19) [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_db_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_db_log_sfr_inst', 'default': 'Uniform(-2.0, 3.0)', 'description': 'log10 instantaneous SFR at observation (Msun/yr)'}, {'name': 'sfh_db_tx_frac_0', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 25% mass'}, {'name': 'sfh_db_tx_frac_1', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 50% mass'}, {'name': 'sfh_db_tx_frac_2', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 75% mass'}]

dbp

unvalidated

Dense-basis SFH without GP constraints [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_dbp_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_dbp_tx_frac_0', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 25% mass'}, {'name': 'sfh_dbp_tx_frac_1', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 50% mass'}, {'name': 'sfh_dbp_tx_frac_2', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 75% mass'}]

declining_exp

production

Conroy et al. 2009 (FSPS); Carnall et al. 2018 (Bagpipes)

Declining-τ SFH (FSPS sfh=1 / Bagpipes ‘exponential’)

SEDModel.build(..., sfh={'type': 'declining_exp'})

[{'name': 'sfh_declining_exp_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_declining_exp_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'e-folding decline timescale (Gyr): larger τ declines slower'}, {'name': 'sfh_declining_exp_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback time of formation (Gyr)'}, {'name': 'sfh_declining_exp_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

delayed

production

Boquien et al. 2019 (CIGALE); Carnall et al. 2018 (Bagpipes)

τ-delayed SFH (CIGALE sfh_delayed / Bagpipes 'delayed')

SEDModel.build(…, sfh={‘type’: ‘delayed’})

[{'name': 'sfh_delayed_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_delayed_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'Timescale (Gyr): cosmic-time location of SFR peak'}, {'name': 'sfh_delayed_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback time of formation (Gyr); must be > τ'}, {'name': 'sfh_delayed_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

delayed_bq

production

Delayed tau with burst/quench (Ciesla et al.)

SEDModel.build(..., sfh={'type': 'delayed_bq'})

[{'name': 'sfh_delayed_bq_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_delayed_bq_tau_main_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'e-folding timescale of main component (Gyr)'}, {'name': 'sfh_delayed_bq_age_main_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback to formation (Gyr)'}, {'name': 'sfh_delayed_bq_age_main_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}, {'name': 'sfh_delayed_bq_age_bq_gyr', 'default': 'Uniform(0.01, 0.5)', 'description': 'Lookback time of burst/quench onset (Gyr); prior ceiling equals the age_main_gyr floor so quench-before-formation (#2644) is unreachable by default'}, {'name': 'sfh_delayed_bq_r_sfr', 'default': 'Uniform(0.0, 10.0)', 'description': 'SFR ratio after/before burst/quench (0 = full quench, #2623)'}]

dense_basis

production

Dense-basis non-parametric SFH (Iyer+19)

SEDModel.build(..., sfh={'type': 'dense_basis'})

[{'name': 'sfh_db_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_db_log_sfr_inst', 'default': 'Uniform(-2.0, 3.0)', 'description': 'log10 instantaneous SFR at observation (Msun/yr)'}, {'name': 'sfh_db_tx_frac_0', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 25% mass'}, {'name': 'sfh_db_tx_frac_1', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 50% mass'}, {'name': 'sfh_db_tx_frac_2', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 75% mass'}]

dense_basis_pure

production

Dense-basis SFH without GP constraints

SEDModel.build(..., sfh={'type': 'dense_basis_pure'})

[{'name': 'sfh_dbp_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_dbp_tx_frac_0', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 25% mass'}, {'name': 'sfh_dbp_tx_frac_1', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 50% mass'}, {'name': 'sfh_dbp_tx_frac_2', 'default': 'Uniform(0.05, 0.95)', 'description': 'Cosmic time fraction at 75% mass'}]

dexp

production

Delayed exponential SFH

SEDModel.build(…, sfh={‘type’: ‘dexp’})

[{'name': 'sfh_dexp_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_dexp_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'Timescale (Gyr)'}, {'name': 'sfh_dexp_start_gyr', 'default': 'Fixed(5.0)', 'description': 'Start lookback (Gyr)'}, {'name': 'sfh_dexp_start_frac', 'default': 'Uniform(0.036266346780538826, 1.0)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

dirichlet

production

Leja et al. 2017 (ApJ 837, 170)

Non-parametric Dirichlet SFH (Leja+17); Uniform(0,1) aux variables mapped to Beta(1, N-1-i) quantiles, stick-broken into SFR fractions with a symmetric Dirichlet(1,…,1) prior

SEDModel.build(…, sfh={‘type’: ‘dirichlet’})

[{'name': 'sfh_dir_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_dir_z_0', 'default': 'Uniform(0.0, 1.0)', 'description': 'Dirichlet stick-breaking variable 0'}, {'name': 'sfh_dir_z_1', 'default': 'Uniform(0.0, 1.0)', 'description': 'Dirichlet stick-breaking variable 1'}, {'name': 'sfh_dir_z_2', 'default': 'Uniform(0.0, 1.0)', 'description': 'Dirichlet stick-breaking variable 2'}, {'name': 'sfh_dir_z_3', 'default': 'Uniform(0.0, 1.0)', 'description': 'Dirichlet stick-breaking variable 3'}, {'name': 'sfh_dir_z_4', 'default': 'Uniform(0.0, 1.0)', 'description': 'Dirichlet stick-breaking variable 4'}, {'name': 'sfh_dir_z_5', 'default': 'Uniform(0.0, 1.0)', 'description': 'Dirichlet stick-breaking variable 5'}]

dpl

production

Carnall et al. 2018 (MNRAS 480, 4379)

Double power-law SFH

SEDModel.build(…, sfh={‘type’: ‘dpl’})

[{'name': 'sfh_dpl_alpha', 'default': 'Uniform(0.1, 5.0)', 'description': 'DPL falling slope'}, {'name': 'sfh_dpl_beta', 'default': 'Uniform(0.1, 3.0)', 'description': 'DPL rising slope'}, {'name': 'sfh_dpl_tau_gyr', 'default': 'Uniform(0.1, 12.0)', 'description': 'DPL turnover time (Gyr), cosmic time since formation'}, {'name': 'sfh_dpl_age_gyr', 'default': 'Fixed(13.787)', 'description': 'Cosmic time for SF (Gyr) = lookback of formation; set to age_of_universe(z) for BAGPIPES parity'}, {'name': 'sfh_dpl_age_frac', 'default': 'Uniform(0.036266346780538826, 1.0)', 'description': 'Cosmic time for SF as a fraction of age(z) (formation time)'}, {'name': 'sfh_dpl_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}]

dpl_lookback

production

Carnall et al. 2018 (MNRAS 480, 4379)

Double power-law SFH in lookback time (stellar age, not cosmic time since formation); beta carries the Carnall sign, so a positive beta gives an interior peak

SEDModel.build(..., sfh={'type': 'dpl_lookback'})

[{'name': 'sfh_dpl_lookback_alpha', 'default': 'Uniform(0.1, 5.0)', 'description': 'DPL slope on the old side (large lookback)'}, {'name': 'sfh_dpl_lookback_beta', 'default': 'Uniform(0.1, 3.0)', 'description': 'DPL slope on the young side (small lookback)'}, {'name': 'sfh_dpl_lookback_peak_gyr', 'default': 'Uniform(0.01, 12.0)', 'description': 'DPL turnover lookback time (Gyr)'}, {'name': 'sfh_dpl_lookback_age_gyr', 'default': 'Fixed(13.787)', 'description': 'Older truncation lookback time (Gyr); set to age_of_universe(z) for a galaxy forming at the Big Bang'}, {'name': 'sfh_dpl_lookback_age_frac', 'default': 'Uniform(0.036266346780538826, 1.0)', 'description': 'Onset as a fraction of age(z) (formation time)'}, {'name': 'sfh_dpl_lookback_end_gyr', 'default': 'Fixed(0.0)', 'description': 'Younger truncation lookback time (Gyr) (0 = star formation continues to the epoch of observation)'}, {'name': 'sfh_dpl_lookback_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}]

exp

production

Exponential rise SFH

SEDModel.build(…, sfh={‘type’: ‘exp’})

[{'name': 'sfh_exp_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_exp_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'e-folding timescale (Gyr)'}, {'name': 'sfh_exp_start_gyr', 'default': 'Fixed(5.0)', 'description': 'Start lookback (Gyr)'}, {'name': 'sfh_exp_start_frac', 'default': 'Uniform(0.036266346780538826, 1.0)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

field

production

GP field modulator with DRW power spectrum; sampling coordinates selectable via sfh={'field_centering': a}

SEDModel.build(…, sfh={‘type’: [‘const’, ‘field’]})

[{'name': 'sfh_field_psd_sigma', 'default': 'Uniform(0.01, 1.0)', 'description': 'PSD amplitude (dex)'}, {'name': 'sfh_field_psd_tau_myr', 'default': 'Uniform(10.0, 500.0)', 'description': 'PSD timescale (Myr)'}]

gaussian_burst

unvalidated

Robotham et al. 2020 (arXiv:2002.06980) ProSpect

Gaussian-in-age burst (Robotham+2020) [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_gaussian_burst_log_total_mass', 'default': 'Uniform(6.0, 11.0)', 'description': 'log10 total stellar mass formed in burst [Msun]'}, {'name': 'sfh_gaussian_burst_t_peak_gyr', 'default': 'Uniform(0.01, 13.0)', 'description': 'Burst peak age / lookback time (Gyr)'}, {'name': 'sfh_gaussian_burst_sigma_gyr', 'default': 'Uniform(0.01, 5.0)', 'description': 'Gaussian width / standard deviation (Gyr)'}]

lnorm

production

Log-normal SFH

SEDModel.build(…, sfh={‘type’: ‘lnorm’})

[{'name': 'sfh_lnorm_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_lnorm_peak_gyr', 'default': 'Uniform(0.5, 12.0)', 'description': 'Peak in cosmic time since formation (Gyr)'}, {'name': 'sfh_lnorm_width_gyr', 'default': 'Uniform(0.1, 2.0)', 'description': 'Log-space width (dex)'}, {'name': 'sfh_lnorm_age_gyr', 'default': 'Fixed(13.787)', 'description': 'Cosmic time for SF (Gyr) = lookback of formation; set to age_of_universe(z) for BAGPIPES direction'}, {'name': 'sfh_lnorm_age_frac', 'default': 'Uniform(0.036266346780538826, 1.0)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

norm

production

Gaussian SFH

SEDModel.build(…, sfh={‘type’: ‘norm’})

[{'name': 'sfh_norm_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_norm_peak_lbt_gyr', 'default': 'Fixed(5.0)', 'description': 'Peak lookback time (Gyr)'}, {'name': 'sfh_norm_peak_lbt_frac', 'default': 'Uniform(0.036266346780538826, 0.8703923227329318)', 'description': 'Peak lookback time as a fraction of age(z)'}, {'name': 'sfh_norm_width_gyr', 'default': 'Uniform(0.2, 5.0)', 'description': 'Gaussian width (Gyr)'}]

periodic

production

Periodic SF events (Ciesla et al.)

SEDModel.build(…, sfh={‘type’: ‘periodic’})

[{'name': 'sfh_periodic_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_periodic_delta_bursts_gyr', 'default': 'Uniform(0.01, 1.0)', 'description': 'Spacing between burst onsets (Gyr)'}, {'name': 'sfh_periodic_tau_bursts_gyr', 'default': 'Uniform(0.001, 0.5)', 'description': 'Duration/e-folding timescale of each burst (Gyr)'}, {'name': 'sfh_periodic_burst_type', 'default': 'Fixed(0.0)', 'description': 'Burst type: 0=exponential, 1=delayed, 2=rectangular'}, {'name': 'sfh_periodic_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback to formation (Gyr)'}, {'name': 'sfh_periodic_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}]

prospector_beta

unvalidated

Wang et al. 2024 (arXiv:2401.12198); SFH shape from Leja+2019

Prospector-beta: continuity SFH with redshift-aware bin edges from make_agebins_from_zred(zred); StudentT(0, 0.3, df=2) on log-SFR ratios [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_pbeta_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_pbeta_ratio_0', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 0/1'}, {'name': 'sfh_pbeta_ratio_1', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 1/2'}, {'name': 'sfh_pbeta_ratio_2', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 2/3'}, {'name': 'sfh_pbeta_ratio_3', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 3/4'}, {'name': 'sfh_pbeta_ratio_4', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 4/5'}, {'name': 'sfh_pbeta_ratio_5', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio bin 5/6'}]

psb

production

Wild et al. 2020 (MNRAS 494, 529)

Post-starburst SFH (Wild et al.)

SEDModel.build(…, sfh={‘type’: ‘psb’})

[{'name': 'sfh_psb_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_psb_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback to formation (Gyr)'}, {'name': 'sfh_psb_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}, {'name': 'sfh_psb_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'Old-component e-folding timescale (Gyr)'}, {'name': 'sfh_psb_burstage_gyr', 'default': 'Uniform(0.01, 5.0)', 'description': 'Lookback time of burst onset (Gyr)'}, {'name': 'sfh_psb_alpha', 'default': 'Uniform(0.5, 5.0)', 'description': 'DPL burst falling slope'}, {'name': 'sfh_psb_beta', 'default': 'Uniform(0.5, 5.0)', 'description': 'DPL burst rising slope'}, {'name': 'sfh_psb_fburst', 'default': 'Uniform(0.01, 0.99)', 'description': 'Burst mass fraction'}]

psb_flex

production

Suess et al. 2022 (ApJ 935, 146); arXiv:2207.02883

Post-starburst non-parametric SFH with a resolved quenching zone (nflex=5, nfixed=3): youngest bin [0, tlast] + five equal-width flex bins out to tflex + three equal-width fixed old bins out to the age of the universe at this model’s redshift

SEDModel.build(..., sfh={'type': 'psb_flex'})

[{'name': 'sfh_psb_flex_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_psb_flex_tlast_gyr', 'default': 'Fixed(0.2)', 'description': 'Quenching-onset lookback time (Gyr); width of the youngest bin'}, {'name': 'sfh_psb_flex_tlast_frac', 'default': 'Uniform(0.0007253269356107764, 0.07253269356107765)', 'description': 'Quenching-onset lookback time (youngest-bin width) as a fraction of age(z)'}, {'name': 'sfh_psb_flex_tflex_gyr', 'default': 'Fixed(2.0)', 'description': 'Upper boundary of the flexible quenching zone (Gyr); prior floor equals the tlast_gyr ceiling so the zone can never have negative width'}, {'name': 'sfh_psb_flex_tflex_frac', 'default': 'Uniform(0.07253269356107765, 0.3626634678053882)', 'description': 'Upper boundary of the flexible quenching zone as a fraction of age(z)'}, {'name': 'sfh_psb_flex_ratio_young', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10(SFR_young / SFR_flex_0); large positive = recent burst'}, {'name': 'sfh_psb_flex_ratio_flex_0', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio flex bin 0/1'}, {'name': 'sfh_psb_flex_ratio_flex_1', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio flex bin 1/2'}, {'name': 'sfh_psb_flex_ratio_flex_2', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio flex bin 2/3'}, {'name': 'sfh_psb_flex_ratio_flex_3', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio flex bin 3/4'}, {'name': 'sfh_psb_flex_ratio_old_0', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio: oldest flex bin / youngest fixed bin (link)'}, {'name': 'sfh_psb_flex_ratio_old_1', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio old bin 0/1'}, {'name': 'sfh_psb_flex_ratio_old_2', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio old bin 1/2'}]

psb_suess2022

production

Suess et al. 2022 (ApJ 935, 146); arXiv:2207.02883

Post-starburst non-parametric SFH (Suess+22, nflex=1, nfixed=3): youngest bin [0, tlast] + a single flex bin [tlast, tflex] + three equal-width fixed old bins out to the age of the universe at this model’s redshift, with StudentT(0, 0.3, df=2) ratios

SEDModel.build(..., sfh={'type': 'psb_suess2022'})

[{'name': 'sfh_psb2022_log_total_mass', 'default': 'Uniform(8.0, 12.0)', 'description': 'log10 total stellar mass formed (Msun)'}, {'name': 'sfh_psb2022_tlast_gyr', 'default': 'Fixed(0.1)', 'description': 'Quenching-onset lookback time (Gyr); width of the youngest bin'}, {'name': 'sfh_psb2022_tlast_frac', 'default': 'Uniform(0.0007253269356107764, 0.07253269356107765)', 'description': 'Quenching-onset lookback time (youngest-bin width) as a fraction of age(z)'}, {'name': 'sfh_psb2022_tflex_gyr', 'default': 'Fixed(2.0)', 'description': 'Upper boundary of the flexible quenching zone (Gyr); prior floor equals the tlast_gyr ceiling so the zone can never have negative width'}, {'name': 'sfh_psb2022_tflex_frac', 'default': 'Uniform(0.07253269356107765, 0.3626634678053882)', 'description': 'Upper boundary of the flexible quenching zone as a fraction of age(z)'}, {'name': 'sfh_psb2022_ratio_young', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10(SFR_young / SFR_flex); large positive = recent burst'}, {'name': 'sfh_psb2022_ratio_old_0', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio: oldest flex bin / youngest fixed bin (link)'}, {'name': 'sfh_psb2022_ratio_old_1', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio old bin 0/1'}, {'name': 'sfh_psb2022_ratio_old_2', 'default': 'StudentT(mu=0.0, sigma=0.3, df=2.0)', 'description': 'log10 SFR ratio old bin 1/2'}]

psb_wild2020

unvalidated

Wild et al. 2020 (MNRAS 494, 529)

Post-starburst SFH (Wild et al.) [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_psb_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_psb_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback to formation (Gyr)'}, {'name': 'sfh_psb_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}, {'name': 'sfh_psb_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'Old-component e-folding timescale (Gyr)'}, {'name': 'sfh_psb_burstage_gyr', 'default': 'Uniform(0.01, 5.0)', 'description': 'Lookback time of burst onset (Gyr)'}, {'name': 'sfh_psb_alpha', 'default': 'Uniform(0.5, 5.0)', 'description': 'DPL burst falling slope'}, {'name': 'sfh_psb_beta', 'default': 'Uniform(0.5, 5.0)', 'description': 'DPL burst rising slope'}, {'name': 'sfh_psb_fburst', 'default': 'Uniform(0.01, 0.99)', 'description': 'Burst mass fraction'}]

recent

production

Chevallard & Charlot 2016, MNRAS 462, 1415

Constant-SFR current episode over the last Delta t, spliced over a smooth SFH

SEDModel.build(…, sfh={‘type’: [‘delayed’, ‘recent’]})

[{'name': 'sfh_recent_log_sfr', 'default': 'Uniform(-3.0, 3.0)', 'description': 'log10 of the constant star-formation rate over the current episode [Msun/yr]'}, {'name': 'sfh_recent_timescale_myr', 'default': 'Fixed(10.0)', 'description': 'Duration of the current episode, Delta t (Myr)'}]

recent_ssfr

production

Chevallard & Charlot 2016, MNRAS 462, 1415

Current episode set by its specific SFR, spliced over a smooth SFH (BEAGLE)

SEDModel.build(..., sfh={'type': ['delayed', 'recent_ssfr']})

[{'name': 'sfh_recent_ssfr_log_ssfr', 'default': 'Uniform(-12.0, -7.3)', 'description': "log10 of the current episode's specific SFR [yr^-1]"}, {'name': 'sfh_recent_ssfr_timescale_myr', 'default': 'Fixed(10.0)', 'description': 'Duration of the current episode, Delta t (Myr)'}]

sfh2exp

production

Double declining exponential: main + recent burst (CIGALE sfh2exp)

SEDModel.build(…, sfh={‘type’: ‘sfh2exp’})

[{'name': 'sfh_sfh2exp_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_sfh2exp_tau_main_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'e-folding timescale of main population (Gyr)'}, {'name': 'sfh_sfh2exp_tau_burst_gyr', 'default': 'Uniform(0.01, 1.0)', 'description': 'e-folding timescale of the burst (Gyr)'}, {'name': 'sfh_sfh2exp_f_burst', 'default': 'Uniform(0.0, 0.5)', 'description': 'Fraction of stellar mass formed in the burst'}, {'name': 'sfh_sfh2exp_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Age of main population / lookback to formation (Gyr)'}, {'name': 'sfh_sfh2exp_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}, {'name': 'sfh_sfh2exp_burst_age_gyr', 'default': 'Uniform(0.01, 2.0)', 'description': 'Lookback time of burst onset (Gyr)'}]

snorm

production

Bellstedt et al. 2020 (arXiv:2005.11917)

Skew-normal SFH (Bellstedt+2020)

SEDModel.build(…, sfh={‘type’: ‘snorm’})

[{'name': 'sfh_snorm_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_snorm_peak_lbt_gyr', 'default': 'Fixed(5.0)', 'description': 'Peak lookback time (Gyr)'}, {'name': 'sfh_snorm_peak_lbt_frac', 'default': 'Uniform(0.036266346780538826, 0.8703923227329318)', 'description': 'Peak lookback time as a fraction of age(z)'}, {'name': 'sfh_snorm_width_gyr', 'default': 'Uniform(0.2, 5.0)', 'description': 'Gaussian width (Gyr)'}, {'name': 'sfh_snorm_skew', 'default': 'Uniform(-1.0, 1.0)', 'description': 'Skewness'}]

snorm_burst

production

Robotham et al. 2020 (arXiv:2002.06980) ProSpect

Skew-normal + flat recent burst (ProSpect)

SEDModel.build(..., sfh={'type': 'snorm_burst'})

[{'name': 'sfh_snorm_burst_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_snorm_burst_peak_lbt_gyr', 'default': 'Fixed(5.0)', 'description': 'Peak lookback time (Gyr)'}, {'name': 'sfh_snorm_burst_peak_lbt_frac', 'default': 'Uniform(0.036266346780538826, 0.8703923227329318)', 'description': 'Peak lookback time as a fraction of age(z)'}, {'name': 'sfh_snorm_burst_width_gyr', 'default': 'Uniform(0.2, 5.0)', 'description': 'Gaussian width (Gyr)'}, {'name': 'sfh_snorm_burst_skew', 'default': 'Uniform(-1.0, 1.0)', 'description': 'Skewness'}, {'name': 'sfh_snorm_burst_burst_sfr', 'default': 'Fixed(0.0)', 'description': "Burst plateau amplitude relative to the smooth kernel's unit peak [dimensionless]"}, {'name': 'sfh_snorm_burst_burst_age_gyr', 'default': 'Fixed(0.1)', 'description': 'Burst lookback duration (Gyr)'}]

table

production

User-supplied tabulated SFH(t)

SEDModel.build(…, sfh={‘type’: ‘table’})

top_hat

unvalidated

Constant-SFR window with smooth edges (top-hat) [not builder-available: registered, not yet DSPS-validated]

not builder-available: SEDModel.build rejects it; browse the buildable set with list_sfh_models(status='production')

[{'name': 'sfh_top_hat_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed in window [Msun]'}, {'name': 'sfh_top_hat_t_start_gyr', 'default': 'Uniform(0.1, 13.0)', 'description': 'Older lookback boundary / SF onset (Gyr)'}, {'name': 'sfh_top_hat_t_end_gyr', 'default': 'Uniform(0.0, 12.0)', 'description': 'Younger lookback boundary / SF cessation (Gyr)'}, {'name': 'sfh_top_hat_smooth_width_gyr', 'default': 'Fixed(0.1)', 'description': 'Sigmoid transition width (Gyr)'}]

trunc_exp

production

Conroy et al. 2009 (FSPS); Carnall et al. 2018 (Bagpipes)

Exponential SFH truncated at both ends; declining_exp plus a young-end cutoff

SEDModel.build(..., sfh={'type': 'trunc_exp'})

[{'name': 'sfh_trunc_exp_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_trunc_exp_tau_gyr', 'default': 'Uniform(0.1, 10.0)', 'description': 'e-folding timescale (Gyr); positive declines in cosmic time (SFR rises with lookback age), negative rises'}, {'name': 'sfh_trunc_exp_age_gyr', 'default': 'Fixed(5.0)', 'description': 'Galaxy age / lookback time of formation (Gyr)'}, {'name': 'sfh_trunc_exp_age_frac', 'default': 'Uniform(0.036266346780538826, 0.9429250162940094)', 'description': 'Onset as a fraction of age(z) (formation time)'}, {'name': 'sfh_trunc_exp_end_gyr', 'default': 'Fixed(0.0)', 'description': 'Lookback time at which SF ceases (Gyr) (0 = still forming stars)'}]

tsnorm

production

Bellstedt et al. 2020 (arXiv:2005.11917)

Truncated skew-normal SFH (Bellstedt+2020)

SEDModel.build(…, sfh={‘type’: ‘tsnorm’})

[{'name': 'sfh_tsnorm_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_tsnorm_peak_lbt_gyr', 'default': 'Fixed(5.0)', 'description': 'Peak lookback time (Gyr)'}, {'name': 'sfh_tsnorm_peak_lbt_frac', 'default': 'Uniform(0.036266346780538826, 0.8703923227329318)', 'description': 'Peak lookback time as a fraction of age(z)'}, {'name': 'sfh_tsnorm_width_gyr', 'default': 'Uniform(0.2, 5.0)', 'description': 'Gaussian width (Gyr)'}, {'name': 'sfh_tsnorm_skew', 'default': 'Uniform(-1.0, 1.0)', 'description': 'Skewness'}, {'name': 'sfh_tsnorm_trunc', 'default': 'Uniform(1.0, 10.0)', 'description': 'Truncation sharpness'}]

tsnorm_burst

production

Robotham et al. 2020 (arXiv:2002.06980) ProSpect

Truncated skew-normal + flat burst (ProSpect)

SEDModel.build(..., sfh={'type': 'tsnorm_burst'})

[{'name': 'sfh_tsnorm_burst_log_total_mass', 'default': 'Uniform(7.0, 12.5)', 'description': 'log10 total stellar mass formed [Msun]'}, {'name': 'sfh_tsnorm_burst_peak_lbt_gyr', 'default': 'Fixed(5.0)', 'description': 'Peak lookback time (Gyr)'}, {'name': 'sfh_tsnorm_burst_peak_lbt_frac', 'default': 'Uniform(0.036266346780538826, 0.8703923227329318)', 'description': 'Peak lookback time as a fraction of age(z)'}, {'name': 'sfh_tsnorm_burst_width_gyr', 'default': 'Uniform(0.2, 5.0)', 'description': 'Gaussian width (Gyr)'}, {'name': 'sfh_tsnorm_burst_skew', 'default': 'Uniform(-1.0, 1.0)', 'description': 'Skewness'}, {'name': 'sfh_tsnorm_burst_trunc', 'default': 'Uniform(1.0, 10.0)', 'description': 'Truncation sharpness'}, {'name': 'sfh_tsnorm_burst_burst_sfr', 'default': 'Fixed(0.0)', 'description': "Burst plateau amplitude relative to the smooth kernel's unit peak [dimensionless]"}, {'name': 'sfh_tsnorm_burst_burst_age_gyr', 'default': 'Fixed(0.1)', 'description': 'Burst lookback duration (Gyr)'}]

metallicity modes

tengri.list_metallicity_modes()

name

status

citation

short_doc

use

bins

production

Per-bin metallicities (pairs with continuity SFH)

SEDModel.build(…, met={‘type’: ‘bins’})

bins_continuity

production

Cumulative delta-log-Z steps

SEDModel.build(..., met={'type': 'bins_continuity'})

chem_evol

production

Gas-regulator model (Z derived from SFH)

SEDModel.build(..., met={'type': 'chem_evol'})

delta

production

Single metallicity (the default)

SEDModel.build(…, met={‘type’: ‘delta’})

massmap_box

production

Closed-box metallicity tied to cumulative mass formed

SEDModel.build(..., met={'type': 'massmap_box'})

massmap_lin

production

Linear metallicity tied to cumulative mass formed

SEDModel.build(..., met={'type': 'massmap_lin'})

psb_two_step

production

Step at post-starburst burst age

SEDModel.build(..., met={'type': 'psb_two_step'})

ramp

production

Linear evolving metallicity

SEDModel.build(…, met={‘type’: ‘ramp’})

table

experimental

User-provided Z(t) [not builder-available: refuses at build without a Z(t) source]

not builder-available: met={'type': 'table'} needs a Z(t) source; use sfh={'type': 'table'} with params['met_history']

two_step

production

Step function at a lookback time

SEDModel.build(..., met={'type': 'two_step'})

known ssps

tengri.list_known_ssps()

name

filename

amist_c3k_hr_kroupa_afe

amist_c3k_hr_kroupa_afe.h5

amist_c3k_hr_kroupa_afe_totalz

amist_c3k_hr_kroupa_afe_totalz.h5

bc03_pdva_stelib_chabrier

bc03_pdva_stelib_chabrier.h5

bpss_stars_c3k_a_chabrier

bpss_stars_c3k_a_chabrier.h5

bpss_v221_bin_imf100_100

bpss_v221_bin_imf100_100.h5

bpss_v221_bin_imf100_300

bpss_v221_bin_imf100_300.h5

bpss_v221_bin_imf135_100

bpss_v221_bin_imf135_100.h5

bpss_v221_bin_imf135_300

bpss_v221_bin_imf135_300.h5

bpss_v221_bin_imf135all_100

bpss_v221_bin_imf135all_100.h5

bpss_v221_bin_imf170_100

bpss_v221_bin_imf170_100.h5

bpss_v221_bin_imf170_300

bpss_v221_bin_imf170_300.h5

bpss_v221_bin_imf_chab100

bpss_v221_bin_imf_chab100.h5

bpss_v221_bin_imf_chab300

bpss_v221_bin_imf_chab300.h5

bpss_v221_sin_imf100_100

bpss_v221_sin_imf100_100.h5

bpss_v221_sin_imf100_300

bpss_v221_sin_imf100_300.h5

bpss_v221_sin_imf135_100

bpss_v221_sin_imf135_100.h5

bpss_v221_sin_imf135_300

bpss_v221_sin_imf135_300.h5

bpss_v221_sin_imf135all_100

bpss_v221_sin_imf135all_100.h5

bpss_v221_sin_imf170_100

bpss_v221_sin_imf170_100.h5

bpss_v221_sin_imf170_300

bpss_v221_sin_imf170_300.h5

bpss_v221_sin_imf_chab100

bpss_v221_sin_imf_chab100.h5

bpss_v221_sin_imf_chab300

bpss_v221_sin_imf_chab300.h5

bpss_v231_bin_basel_imf135_300

bpss_v231_bin_basel_imf135_300.h5

bpss_v231_sin_basel_imf135_300

bpss_v231_sin_basel_imf135_300.h5

bpss_v23_bin_imf135_300_afe

bpss_v23_bin_imf135_300_afe.h5

bpss_v23_sin_imf135_300_afe

bpss_v23_sin_imf135_300_afe.h5

emiles_bsti_bimodal0.30

emiles_bsti_bimodal0.30.h5

emiles_bsti_bimodal0.50

emiles_bsti_bimodal0.50.h5

emiles_bsti_bimodal0.80

emiles_bsti_bimodal0.80.h5

emiles_bsti_bimodal1.00

emiles_bsti_bimodal1.00.h5

emiles_bsti_bimodal1.30

emiles_bsti_bimodal1.30.h5

emiles_bsti_bimodal1.50

emiles_bsti_bimodal1.50.h5

emiles_bsti_bimodal1.80

emiles_bsti_bimodal1.80.h5

emiles_bsti_bimodal2.00

emiles_bsti_bimodal2.00.h5

emiles_bsti_bimodal2.30

emiles_bsti_bimodal2.30.h5

emiles_bsti_bimodal2.50

emiles_bsti_bimodal2.50.h5

emiles_bsti_bimodal2.80

emiles_bsti_bimodal2.80.h5

emiles_bsti_bimodal3.00

emiles_bsti_bimodal3.00.h5

emiles_bsti_bimodal3.30

emiles_bsti_bimodal3.30.h5

emiles_bsti_bimodal3.50

emiles_bsti_bimodal3.50.h5

emiles_bsti_chabrier

emiles_bsti_chabrier.h5

emiles_bsti_kroupa_revised

emiles_bsti_kroupa_revised.h5

emiles_bsti_unimodal0.30

emiles_bsti_unimodal0.30.h5

emiles_bsti_unimodal0.50

emiles_bsti_unimodal0.50.h5

emiles_bsti_unimodal0.80

emiles_bsti_unimodal0.80.h5

emiles_bsti_unimodal1.00

emiles_bsti_unimodal1.00.h5

emiles_bsti_unimodal1.30

emiles_bsti_unimodal1.30.h5

emiles_bsti_unimodal1.50

emiles_bsti_unimodal1.50.h5

emiles_bsti_unimodal1.80

emiles_bsti_unimodal1.80.h5

emiles_bsti_unimodal2.00

emiles_bsti_unimodal2.00.h5

emiles_bsti_unimodal2.30

emiles_bsti_unimodal2.30.h5

emiles_bsti_unimodal2.50

emiles_bsti_unimodal2.50.h5

emiles_bsti_unimodal2.80

emiles_bsti_unimodal2.80.h5

emiles_bsti_unimodal3.00

emiles_bsti_unimodal3.00.h5

emiles_bsti_unimodal3.30

emiles_bsti_unimodal3.30.h5

emiles_bsti_unimodal3.50

emiles_bsti_unimodal3.50.h5

emiles_pdva_bimodal0.30

emiles_pdva_bimodal0.30.h5

emiles_pdva_bimodal0.50

emiles_pdva_bimodal0.50.h5

emiles_pdva_bimodal0.80

emiles_pdva_bimodal0.80.h5

emiles_pdva_bimodal1.00

emiles_pdva_bimodal1.00.h5

emiles_pdva_bimodal1.30

emiles_pdva_bimodal1.30.h5

emiles_pdva_bimodal1.50

emiles_pdva_bimodal1.50.h5

emiles_pdva_bimodal1.80

emiles_pdva_bimodal1.80.h5

emiles_pdva_bimodal2.00

emiles_pdva_bimodal2.00.h5

emiles_pdva_bimodal2.30

emiles_pdva_bimodal2.30.h5

emiles_pdva_bimodal2.50

emiles_pdva_bimodal2.50.h5

emiles_pdva_bimodal2.80

emiles_pdva_bimodal2.80.h5

emiles_pdva_bimodal3.00

emiles_pdva_bimodal3.00.h5

emiles_pdva_bimodal3.30

emiles_pdva_bimodal3.30.h5

emiles_pdva_bimodal3.50

emiles_pdva_bimodal3.50.h5

emiles_pdva_chabrier

emiles_pdva_chabrier.h5

emiles_pdva_kroupa

emiles_pdva_kroupa.h5

emiles_pdva_kroupa_revised

emiles_pdva_kroupa_revised.h5

emiles_pdva_unimodal0.30

emiles_pdva_unimodal0.30.h5

emiles_pdva_unimodal0.50

emiles_pdva_unimodal0.50.h5

emiles_pdva_unimodal0.80

emiles_pdva_unimodal0.80.h5

emiles_pdva_unimodal1.00

emiles_pdva_unimodal1.00.h5

emiles_pdva_unimodal1.30

emiles_pdva_unimodal1.30.h5

emiles_pdva_unimodal1.50

emiles_pdva_unimodal1.50.h5

emiles_pdva_unimodal1.80

emiles_pdva_unimodal1.80.h5

emiles_pdva_unimodal2.00

emiles_pdva_unimodal2.00.h5

emiles_pdva_unimodal2.30

emiles_pdva_unimodal2.30.h5

emiles_pdva_unimodal2.50

emiles_pdva_unimodal2.50.h5

emiles_pdva_unimodal2.80

emiles_pdva_unimodal2.80.h5

emiles_pdva_unimodal3.00

emiles_pdva_unimodal3.00.h5

emiles_pdva_unimodal3.30

emiles_pdva_unimodal3.30.h5

emiles_pdva_unimodal3.50

emiles_pdva_unimodal3.50.h5

fsps_amist_c3k_lr_afe_chabrier

fsps_amist_c3k_lr_afe_chabrier.h5

fsps_amist_c3k_lr_afe_chabrier_totalz

fsps_amist_c3k_lr_afe_chabrier_totalz.h5

fsps_amist_c3k_lr_afe_kroupa

fsps_amist_c3k_lr_afe_kroupa.h5

fsps_amist_c3k_lr_afe_kroupa_totalz

fsps_amist_c3k_lr_afe_kroupa_totalz.h5

fsps_amist_c3k_lr_afe_salpeter

fsps_amist_c3k_lr_afe_salpeter.h5

fsps_amist_c3k_lr_afe_salpeter_totalz

fsps_amist_c3k_lr_afe_salpeter_totalz.h5

fsps_bsti_basel_chabrier

fsps_bsti_basel_chabrier.h5

fsps_bsti_basel_kroupa

fsps_bsti_basel_kroupa.h5

fsps_bsti_basel_salpeter

fsps_bsti_basel_salpeter.h5

fsps_bsti_c3k_a_chabrier

fsps_bsti_c3k_a_chabrier.h5

fsps_bsti_c3k_a_kroupa

fsps_bsti_c3k_a_kroupa.h5

fsps_bsti_c3k_a_salpeter

fsps_bsti_c3k_a_salpeter.h5

fsps_bsti_miles_chabrier

fsps_bsti_miles_chabrier.h5

fsps_bsti_miles_kroupa

fsps_bsti_miles_kroupa.h5

fsps_bsti_miles_salpeter

fsps_bsti_miles_salpeter.h5

fsps_mist_basel_chabrier

fsps_mist_basel_chabrier.h5

fsps_mist_basel_kroupa

fsps_mist_basel_kroupa.h5

fsps_mist_basel_salpeter

fsps_mist_basel_salpeter.h5

fsps_mist_c3k_a_chabrier

fsps_mist_c3k_a_chabrier.h5

fsps_mist_c3k_a_kroupa

fsps_mist_c3k_a_kroupa.h5

fsps_mist_c3k_a_salpeter

fsps_mist_c3k_a_salpeter.h5

fsps_mist_miles_chabrier

fsps_mist_miles_chabrier.h5

fsps_mist_miles_kroupa

fsps_mist_miles_kroupa.h5

fsps_mist_miles_salpeter

fsps_mist_miles_salpeter.h5

fsps_pdva_basel_chabrier

fsps_pdva_basel_chabrier.h5

fsps_pdva_basel_kroupa

fsps_pdva_basel_kroupa.h5

fsps_pdva_basel_salpeter

fsps_pdva_basel_salpeter.h5

fsps_pdva_c3k_a_chabrier

fsps_pdva_c3k_a_chabrier.h5

fsps_pdva_c3k_a_kroupa

fsps_pdva_c3k_a_kroupa.h5

fsps_pdva_miles_chabrier

fsps_pdva_miles_chabrier.h5

fsps_pdva_miles_kroupa

fsps_pdva_miles_kroupa.h5

fsps_pdva_miles_salpeter

fsps_pdva_miles_salpeter.h5

fsps_prsc_basel_chabrier

fsps_prsc_basel_chabrier.h5

fsps_prsc_basel_kroupa

fsps_prsc_basel_kroupa.h5

fsps_prsc_basel_salpeter

fsps_prsc_basel_salpeter.h5

fsps_prsc_c3k_a_chabrier

fsps_prsc_c3k_a_chabrier.h5

fsps_prsc_c3k_a_kroupa

fsps_prsc_c3k_a_kroupa.h5

fsps_prsc_c3k_a_salpeter

fsps_prsc_c3k_a_salpeter.h5

fsps_prsc_miles_chabrier

fsps_prsc_miles_chabrier.h5

fsps_prsc_miles_kroupa

fsps_prsc_miles_kroupa.h5

fsps_prsc_miles_salpeter

fsps_prsc_miles_salpeter.h5

m05_rhb_kroupa

m05_rhb_kroupa.h5

m05_rhb_salpeter

m05_rhb_salpeter.h5

mastar_v27_salpeter

mastar_v27_salpeter.h5

miles_bsti_bimodal0.30_afe

miles_bsti_bimodal0.30_afe.h5

miles_bsti_bimodal0.50_afe

miles_bsti_bimodal0.50_afe.h5

miles_bsti_bimodal0.80_afe

miles_bsti_bimodal0.80_afe.h5

miles_bsti_bimodal1.00_afe

miles_bsti_bimodal1.00_afe.h5

miles_bsti_bimodal1.30_afe

miles_bsti_bimodal1.30_afe.h5

miles_bsti_bimodal1.50_afe

miles_bsti_bimodal1.50_afe.h5

miles_bsti_bimodal1.80_afe

miles_bsti_bimodal1.80_afe.h5

miles_bsti_bimodal2.00_afe

miles_bsti_bimodal2.00_afe.h5

miles_bsti_bimodal2.30_afe

miles_bsti_bimodal2.30_afe.h5

miles_bsti_bimodal2.50_afe

miles_bsti_bimodal2.50_afe.h5

miles_bsti_bimodal2.80_afe

miles_bsti_bimodal2.80_afe.h5

miles_bsti_bimodal3.00_afe

miles_bsti_bimodal3.00_afe.h5

miles_bsti_bimodal3.30_afe

miles_bsti_bimodal3.30_afe.h5

miles_bsti_bimodal3.50_afe

miles_bsti_bimodal3.50_afe.h5

miles_bsti_chabrier_afe

miles_bsti_chabrier_afe.h5

miles_bsti_kroupa_afe

miles_bsti_kroupa_afe.h5

miles_bsti_kroupa_revised_afe

miles_bsti_kroupa_revised_afe.h5

miles_bsti_unimodal0.30_afe

miles_bsti_unimodal0.30_afe.h5

miles_bsti_unimodal0.50_afe

miles_bsti_unimodal0.50_afe.h5

miles_bsti_unimodal0.80_afe

miles_bsti_unimodal0.80_afe.h5

miles_bsti_unimodal1.00_afe

miles_bsti_unimodal1.00_afe.h5

miles_bsti_unimodal1.30_afe

miles_bsti_unimodal1.30_afe.h5

miles_bsti_unimodal1.50_afe

miles_bsti_unimodal1.50_afe.h5

miles_bsti_unimodal1.80_afe

miles_bsti_unimodal1.80_afe.h5

miles_bsti_unimodal2.00_afe

miles_bsti_unimodal2.00_afe.h5

miles_bsti_unimodal2.30_afe

miles_bsti_unimodal2.30_afe.h5

miles_bsti_unimodal2.50_afe

miles_bsti_unimodal2.50_afe.h5

miles_bsti_unimodal2.80_afe

miles_bsti_unimodal2.80_afe.h5

miles_bsti_unimodal3.00_afe

miles_bsti_unimodal3.00_afe.h5

miles_bsti_unimodal3.30_afe

miles_bsti_unimodal3.30_afe.h5

miles_bsti_unimodal3.50_afe

miles_bsti_unimodal3.50_afe.h5

mist_c3k_hr_chabrier_noNE

ssp_mist_c3k_hr_chabrier_noNE.h5

mist_c3k_hr_chabrier_wNE

ssp_mist_c3k_hr_chabrier_wNE_logGasU-3.0_logGasZ0.0.h5

pgny_mist_c3k_chabrier

pgny_mist_c3k_chabrier.h5

smiles_bsti_bimodal0.30_afe

smiles_bsti_bimodal0.30_afe.h5

smiles_bsti_bimodal0.50_afe

smiles_bsti_bimodal0.50_afe.h5

smiles_bsti_bimodal0.80_afe

smiles_bsti_bimodal0.80_afe.h5

smiles_bsti_bimodal1.30_afe

smiles_bsti_bimodal1.30_afe.h5

smiles_bsti_bimodal1.50_afe

smiles_bsti_bimodal1.50_afe.h5

smiles_bsti_bimodal1.80_afe

smiles_bsti_bimodal1.80_afe.h5

smiles_bsti_bimodal2.00_afe

smiles_bsti_bimodal2.00_afe.h5

smiles_bsti_bimodal2.30_afe

smiles_bsti_bimodal2.30_afe.h5

smiles_bsti_bimodal2.50_afe

smiles_bsti_bimodal2.50_afe.h5

smiles_bsti_bimodal2.80_afe

smiles_bsti_bimodal2.80_afe.h5

smiles_bsti_bimodal3.00_afe

smiles_bsti_bimodal3.00_afe.h5

smiles_bsti_bimodal3.30_afe

smiles_bsti_bimodal3.30_afe.h5

smiles_bsti_bimodal3.50_afe

smiles_bsti_bimodal3.50_afe.h5

smiles_bsti_chabrier_afe

smiles_bsti_chabrier_afe.h5

smiles_bsti_kroupa_afe

smiles_bsti_kroupa_afe.h5

smiles_bsti_kroupa_revised_afe

smiles_bsti_kroupa_revised_afe.h5

smiles_bsti_unimodal0.30_afe

smiles_bsti_unimodal0.30_afe.h5

smiles_bsti_unimodal0.50_afe

smiles_bsti_unimodal0.50_afe.h5

smiles_bsti_unimodal0.80_afe

smiles_bsti_unimodal0.80_afe.h5

smiles_bsti_unimodal1.30_afe

smiles_bsti_unimodal1.30_afe.h5

smiles_bsti_unimodal1.50_afe

smiles_bsti_unimodal1.50_afe.h5

smiles_bsti_unimodal1.80_afe

smiles_bsti_unimodal1.80_afe.h5

smiles_bsti_unimodal2.00_afe

smiles_bsti_unimodal2.00_afe.h5

smiles_bsti_unimodal2.30_afe

smiles_bsti_unimodal2.30_afe.h5

smiles_bsti_unimodal2.50_afe

smiles_bsti_unimodal2.50_afe.h5

smiles_bsti_unimodal2.80_afe

smiles_bsti_unimodal2.80_afe.h5

smiles_bsti_unimodal3.00_afe

smiles_bsti_unimodal3.00_afe.h5

smiles_bsti_unimodal3.30_afe

smiles_bsti_unimodal3.30_afe.h5

smiles_bsti_unimodal3.50_afe

smiles_bsti_unimodal3.50_afe.h5

age kernels

tengri.list_age_kernels()

name

status

citation

short_doc

use

cic

production

Cloud-in-cell on a 16x dense integrand: preserves mass-proportionality to roundoff (#964)

SEDModel.build(..., sfh={'age_kernel': 'cic'})

dsps

comparison

hearin2021

Accepted name for the same dense cloud-in-cell integration (the zeroth-order DSPS histogram is not offered: it mis-places structure narrower than a node spacing, #2683)

SEDModel.build(..., sfh={'age_kernel': 'dsps'})

dust models

tengri.list_dust_models()

name

status

citation

short_doc

use

age_binned

production

Charlot & Fall 2000 (ApJ 539, 718)

N screens, each its own law and exact young/old age window (#2528)

SEDModel.build(..., dust_attenuation={'type': 'age_binned', 'screens': [{'law': 'calzetti', 'window_log_yr': (None, 7.0)}, {'law': 'calzetti', 'window_log_yr': (None, None)}]})

single_component

production

Calzetti et al. 2000 (ApJ 533, 682)

One screen over all stars; `law` sets the curve

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'calzetti'})

two_component

production

Charlot & Fall 2000 (ApJ 539, 718)

Birth-cloud + diffuse screens; young stars see both

SEDModel.build(..., dust_attenuation={'type': 'two_component', 'law': 'calzetti'})

wg00

production

Witt & Gordon 2000 (ApJ 528, 799)

Radiative-transfer grid (geometry/structure/curve selectors)

SEDModel.build(..., dust_attenuation={'type': 'wg00'})

dust laws

tengri.list_dust_laws()

name

status

citation

short_doc

use

calzetti

production

Calzetti et al. 2000 (ApJ 533, 682)

Calzetti et al. starburst attenuation (R_V=4.05)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'calzetti'})

cardelli

production

Cardelli et al. 1989 (ApJ 345, 245) MW extinction

Cardelli et al. MW extinction (parameterized R_V)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'cardelli'})

chevallard13

production

Chevallard et al. 2013 (MNRAS 432, 2061)

Chevallard+13 optical-depth-dependent diffuse ISM curve

SEDModel.build(..., dust_attenuation={'type': 'two_component', 'law_bc': 'calzetti', 'law_diff': 'chevallard13'})

conroy2010

production

Conroy et al. 2010 (ApJ 708, 58)

Conroy+10 CCM89 with scalable 2175 Å bump (FSPS dust_type=1)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'conroy2010'})

d03_mwrv31

production

Draine 2003 (ARA&A 41, 241)

Draine 2003 MW R_V=3.1 grain model attenuation

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'd03_mwrv31'})

fitzpatrick99

production

Fitzpatrick 1999 (PASP 111, 63) MW extinction

Fitzpatrick (1999) Milky Way extinction curve, R_V = 3.1 default; FM90 UV + optical/IR spline

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'fitzpatrick99'})

gordon03_smcbar

production

Gordon et al. 2003 (ApJ 594, 279)

Gordon+2003 SMC Bar average extinction curve

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'gordon03_smcbar'})

hd23_mwrv31

production

Hensley & Draine 2023 (ApJ 948, 55)

Hensley & Draine 2023 astrodust+PAH grain model

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'hd23_mwrv31'})

kriek_conroy

production

Kriek & Conroy 2013 (ApJL 775, L16)

Kriek & Conroy modified Calzetti + bump + slope

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'kriek_conroy'})

leitherer02

production

Leitherer et al. 2002 (ApJS 140, 303)

Leitherer et al. UV starburst attenuation

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'leitherer02'})

li08

production

Li et al. 2008 (ApJ 685, 1046)

Li et al. analytical flexible attenuation curve

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'li08'})

lmc

production

Pei 1992 (ApJ 395, 130) LMC

LMC extinction (Pei 1992, weak bump)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'lmc'})

narayanan_z

production

Narayanan et al. 2018 (ApJ 869, 70)

Narayanan et al. z-dependent attenuation (MUFASA)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'narayanan_z'})

noll09

production

Noll et al. 2009 (A&A 507, 1793)

Noll et al. modified Calzetti + L02 + bump + slope

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'noll09'})

power_law

production

Charlot & Fall 2000 (ApJ 539, 718)

Generic power-law attenuation

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'power_law'})

prevot_smc

production

Prevot et al. 1984 (A&A 132, 389)

Prevot et al. SMC extinction for AGN

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'prevot_smc'})

reddy15

production

Reddy et al. 2015 (ApJ 806, 259)

Reddy et al. MOSDEF attenuation (R_V=2.505)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'reddy15'})

salim

production

Salim et al. 2018 (ApJ 859, 11)

Salim et al. modified Calzetti (DSPS default)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'salim'})

salim_sbl18

production

Salim et al. 2018 (ApJ 859, 11)

Salim, Boquien & Lee modified Calzetti + L02

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'salim_sbl18'})

smc

production

Pei 1992 (ApJ 395, 130) SMC Bar

SMC extinction (Pei 1992, no 2175 bump)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'smc'})

tea

production

Haskell et al. 2024 (arXiv:2401.11007)

TEA empirical attenuation from NIHAO-SKIRT simulations

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'tea'})

vw07_bc

production

Wild et al. 2007 (MNRAS 381, 543)

Wild+07 birth cloud (n=-1.3, steep UV)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'vw07_bc'})

vw07_diff

production

Wild et al. 2007 (MNRAS 381, 543)

Wild+07 diffuse ISM (n=-0.7, standard)

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'vw07_diff'})

wd01_mwrv31

production

Weingartner & Draine 2001 (ApJ 548, 296)

WD01 MW R_V=3.1 grain model attenuation

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'wd01_mwrv31'})

wd01_smcbar

production

Weingartner & Draine 2001 (ApJ 548, 296)

WD01 SMC Bar grain model attenuation

SEDModel.build(..., dust_attenuation={'type': 'single_component', 'law': 'wd01_smcbar'})

dust emission models

tengri.list_dust_emission_models()

name

status

citation

short_doc

use

astrodust

experimental

Hensley & Draine 2023 (ApJ 948, 55)

Astrodust + PAH unified grain model

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'astrodust'})

bosa

experimental

Boquien et al. 2019 (CIGALE BOSA grids)

BOSA dust SED templates

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'bosa'})

casey2012

production

Casey 2012 (MNRAS 425, 3094)

Modified blackbody + mid-IR power law (analytic)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'casey2012'})

dale2014

production

Dale et al. 2014 (ApJ 784, 83)

SFR-driven empirical IR template family (alpha_sf)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'dale2014'})

dale2014_cigale

production

Dale et al. 2014 (ApJ 784, 83)

Dale+2014 IR templates, CIGALE alpha_sf + fracAGN parameterization

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'dale2014_cigale'})

dh02_ce01

production

Dale & Helou 2002 (ApJ 576, 159); Chary & Elbaz 2001 (ApJ 556, 562)

Cold-dust template library on a single log10(L_IR) axis

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'dh02_ce01'})

dl07

production

Draine & Li 2007 (ApJ 657, 810)

Diffuse + PAH grain mixture, Umin/Umax/qpah (alias of draine_li2007)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'dl07'})

dl07_tabulated

deprecated

Draine & Li 2007 (ApJ 657, 810)

Deprecated spelling of draine_li2007: use that name instead

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'dl07_tabulated'})

dl14

production

Draine et al. 2014 (ApJ 780, 172)

Updated DL with extended PAH/silicate features (alias of draine_li2014)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'dl14'})

draine2021_pah

production

Draine et al. 2021 (ApJ 917, 3)

PAHspec grid: size distribution, ionization and starlight spectrum

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'draine2021_pah'})

draine_li2007

production

Draine & Li 2007 (ApJ 657, 810)

Diffuse + PAH grain mixture, Umin/Umax/qpah

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'draine_li2007'})

draine_li2014

production

Draine et al. 2014 (ApJ 780, 172)

Updated DL with extended PAH and silicate features

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'draine_li2014'})

energy_balance_split

experimental

Kokorev et al. 2021 (ApJ 921, 40)

Two-temperature (warm+cold) + AGN-IR emission; f_cold, L_agn_ir

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'energy_balance_split'})

graybody

production

Boquien et al. 2019 (A&A 622, A103) / Casey 2012 (MNRAS 425, 3094)

General-opacity graybody with free pivot (Synthesizer Greybody optically_thin=False; CIGALE mbb)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'graybody'})

mbb

production

Casey 2012 (MNRAS 425, 3094)

Single-temperature modified blackbody (alias of modified_blackbody)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'mbb'})

modified_blackbody

production

Casey 2012 (MNRAS 425, 3094)

Single-temperature modified blackbody (analytic)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'modified_blackbody'})

pah_drude

unvalidated

Smith et al. 2007 (ApJ 656, 770) Drude profiles

[not builder-available: PAH building block; composes through the dust-emission grid API] Drude-profile PAH emission features

tengri.components.dust.dust_analytic_precompute.precompute(model='pah_drude', ...)

schreiber2016

production

Schreiber et al. 2018 (A&A 609, A30)

Tabulated Schreiber+2018 library (CIGALE); (T_dust, PAH mass fraction)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'schreiber2016'})

schreiber2018

experimental

Schreiber et al. 2018 (A&A 609, A30)

Tabulated Schreiber+2018 library, AGNfitter-rX packaging; (T_dust, f_PAH)

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'schreiber2018'})

themis

experimental

Jones et al. 2017 (A&A 602, A46)

THEMIS amorphous-carbon grain model

SEDModel.build(..., dust_attenuation={'law': 'calzetti'}, dust_emission={'type': 'themis'})

nebular backends

tengri.list_nebular_backends()

name

status

citation

short_doc

use

cb19

production

Charlot & Bruzual 2019 / Martinez-Paredes+2023 (3MdB_17)

6D CB19 lines-only nebular grid (CB19Backend)

SEDModel.build(…, neb={‘type’: ‘cb19’})

cloudy

production

Byler+2017 / Cloudy grids

Trilinear interp on Cloudy photoionization grid (CloudyGridBackend)

SEDModel.build(…, neb={‘type’: ‘cloudy’, ‘grid’: ‘grid.h5’})

cue

production

Li et al. 2025 (CUE neural emulator)

Neural-network Cloudy emulator with 12 free params (CueBackend)

SEDModel.build(…, neb={‘type’: ‘cue’})

gutkin16

production

Gutkin, Charlot & Bruzual 2016 (MNRAS 462, 1757)

Gutkin+2016 NEOGAL CLOUDY c13.03 line table (BEAGLE’s nebular model) per ionizing photon

SEDModel.build(…, neb={‘type’: ‘gutkin16’})

mappings

experimental

Flury et al. 2024 (MAPPINGS V stellar grids, Zenodo 14140949)

Stellar: refuses until #2082 (grid 51% NaN)

SEDModel.build(…, neb={‘type’: ‘mappings’})

mappings_agn

experimental

Flury et al. 2024 (MAPPINGS V AGN grids, Zenodo 14140949)

AGN: refuses until #2082 (model protocol incomplete)

SEDModel.build(..., neb={'type': 'mappings_agn'})

none

production

Disable nebular emission (continuum + lines)

SEDModel.build(…, neb={‘type’: ‘none’})

ssp

production

DSPS / FSPS SSP-internal

Emission baked into SSP grid; zero free params (BakedInBackend)

SEDModel.build(…, neb={‘type’: ‘ssp’})

shock models

tengri.list_shock_models()

name

status

citation

short_doc

use

mappings

production

Allen+2008 (ApJS 178, 20); Sutherland & Dopita 2017 (ApJS 229, 34)

MAPPINGS shock + precursor emission, additive to any neb backend

SEDModel.build(…, shock={‘type’: ‘mappings’})

none

production

No shock component

SEDModel.build(…, shock={‘type’: ‘none’})

agn models

tengri.list_agn_models()

name

status

citation

short_doc

use

adaf

deprecated

Mahadevan 1997, ApJ, 477, 585; Silva et al. 2004, MNRAS, 355, 973

disc=adaf + torus=silva04

SEDModel.build(…, agn={‘type’: ‘adaf’})

cat3d_wind

deprecated

Hönig & Kishimoto 2017, ApJL, 838, L20

disc=powerlaw + torus=cat3d_wind

SEDModel.build(..., agn={'type': 'cat3d_wind'})

composable

production

(no single paper: block recipe of registered tengri AGN blocks)

Composable AGN: pick one block per stage (disc/nlr/blr/feii/torus/atten)

SEDModel.build(…, agn={‘type’: ‘composable’})

grahsp

deprecated

Buchner et al. 2024, A&A, 692, A161 (GRAHSP)

self-contained GRAHSP AGN model (torus_model/disc_model selectors)

SEDModel.build(…, agn={‘type’: ‘grahsp’})

kubota_done

deprecated

Kubota & Done 2018, MNRAS, 480, 1247; Silva et al. 2004, MNRAS, 355, 973

disc=kubota_done + torus=silva04

SEDModel.build(..., agn={'type': 'kubota_done'})

kubota_done_full

deprecated

Kubota & Done 2018, MNRAS, 480, 1247; Silva et al. 2004, MNRAS, 355, 973

disc=kubota_done + torus=silva04

SEDModel.build(..., agn={'type': 'kubota_done_full'})

multicolor_agn

deprecated

Shakura & Sunyaev 1973, A&A, 24, 337; Silva et al. 2004, MNRAS, 355, 973

disc=multicolor + torus=silva04

SEDModel.build(..., agn={'type': 'multicolor_agn'})

qsogen

deprecated

Temple et al. 2021, MNRAS, 508, 737

disc=qsogen + blr=qsogen + feii=qsogen_balmer + torus=qsogen + atten=qsogen_smc

SEDModel.build(…, agn={‘type’: ‘qsogen’})

relagn

deprecated

Hagen & Done 2023, MNRAS, 521, 251; Silva et al. 2004, MNRAS, 355, 973

disc=relagn + torus=silva04

SEDModel.build(…, agn={‘type’: ‘relagn’})

richards2006

deprecated

Richards et al. 2006, ApJS, 166, 470

disc=richards2006

SEDModel.build(…, agn={‘type’: ‘richards2006’})

silva04

deprecated

Silva et al. 2004, MNRAS, 355, 973

disc=powerlaw + torus=silva04

SEDModel.build(…, agn={‘type’: ‘silva04’})

skirtor

deprecated

Stalevski et al. 2016, MNRAS, 458, 2288

disc=powerlaw + torus=skirtor

SEDModel.build(…, agn={‘type’: ‘skirtor’})

skirtor_stalevski

deprecated

Stalevski et al. 2016, MNRAS, 458, 2288

raw SKIRTOR radiative-transfer total (disc + torus + scattering)

SEDModel.build(..., agn={'type': 'skirtor_stalevski'})

unified_nlr_blr

deprecated

Shakura & Sunyaev 1973, A&A, 24, 337; Richardson et al. 2014, MNRAS, 437, 2376; Krawczyk et al. 2013, ApJS, 206, 4; Silva et al. 2004, MNRAS, 355, 973

disc=multicolor + nlr=analytic + blr=analytic + torus=silva04

SEDModel.build(..., agn={'type': 'unified_nlr_blr'})

agn blocks

tengri.list_agn_blocks()

name

status

citation

short_doc

use

category

param_details

grahsp_biatten

production

Buchner et al. 2024, arXiv:2405.19297

GRAHSP SMC-like broken power-law bi-attenuation

SEDModel.build(..., agn={'atten': {'type': 'grahsp_biatten'}})

attenuation

[{‘name’: ‘agn_grahsp_ebv’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: ‘GRAHSP baseline E(B-V) [mag] applied to the AGN bi-attenuation (paper E(B-V)). In the upstream CIGALE pipeline this is also the galaxy E(B-V); in tengri it parameterizes only the AGN-side attenuation: galaxy attenuation is handled by the standard tengri ``dust_*`` component (configure them consistently).’}, {‘name’: ‘agn_grahsp_ebv_agn’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: ‘GRAHSP additional AGN-only E(B-V) [mag] (paper E(B-V)-AGN). Stacks with agn_grahsp_ebv to attenuate the AGN spectrum.’}]

none

production

SEDModel.build(…, agn={‘atten’: {‘type’: ‘none’}})

attenuation

polar_dust

production

Pei 1992, ApJ, 395, 130

Polar-dust extinction with Type-1-only screen

SEDModel.build(..., agn={'atten': {'type': 'polar_dust'}})

attenuation

[{'name': 'agn_polar_T', 'default': 'Uniform(50.0, 150.0)', 'description': 'Polar dust temperature [K] (CIGALE skirtor2016 default 100 K).'}, {'name': 'agn_polar_beta', 'default': 'Uniform(1.0, 2.0)', 'description': 'Polar dust emissivity index beta (CIGALE skirtor2016 default 1.6).'}, {'name': 'agn_polar_ebv', 'default': 'Uniform(0.0, 0.5)', 'description': 'Polar dust reddening E(B-V) applied to AGN disc (SMC law); default 0.03 matches CIGALE skirtor2016. Set 0 to disable.'}, {'name': 'agn_polar_oa', 'default': 'Fixed(0.0)', 'description': "Polar dust half-opening angle override [degrees, from the equatorial plane]: sets the cone and its Type-1/2 boundary; 0 (default) follows the torus's own opening angle"}]

qsogen

production

Temple, Hewett & Banerji 2021, MNRAS, 508, 737

Temple+2021 empirical quasar extinction curve

SEDModel.build(…, agn={‘atten’: {‘type’: ‘qsogen’}})

attenuation

[{‘name’: ‘agn_ebv’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: ‘QSOgen SMC reddening E(B-V) attenuation coefficient. Applied by the ``qsogen_smc`` attenuation block. Range [0, 1.0] matches SMC/Magellanic Cloud dust opacity. Default 0.0 is no reddening.’}]

qsogen_smc

production

Temple et al. 2021, MNRAS, 508, 737

Temple et al. 2021 QSOgen SMC reddening factor

SEDModel.build(..., agn={'atten': {'type': 'qsogen_smc'}})

attenuation

[{‘name’: ‘agn_ebv’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: ‘QSOgen SMC reddening E(B-V) attenuation coefficient. Applied by the ``qsogen_smc`` attenuation block. Range [0, 1.0] matches SMC/Magellanic Cloud dust opacity. Default 0.0 is no reddening.’}]

smc_prevot

production

Prevot et al. 1984, A&A, 132, 389

Prevot et al. 1984 SMC extinction curve

SEDModel.build(..., agn={'atten': {'law': 'prevot_smc'}})

attenuation

[{‘name’: ‘agn_ebv’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: ‘QSOgen SMC reddening E(B-V) attenuation coefficient. Applied by the ``qsogen_smc`` attenuation block. Range [0, 1.0] matches SMC/Magellanic Cloud dust opacity. Default 0.0 is no reddening.’}]

analytic

production

Krawczyk et al. 2013, ApJS, 206, 4

Analytic broad-line region with Gaussian broadening

SEDModel.build(…, agn={‘blr’: {‘type’: ‘analytic’}})

blr

[{'name': 'agn_blr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'BLR covering fraction: fraction of disc luminosity intercepted by BLR. Physical bound [0, 1]; typical values 0.05-0.2.'}, {'name': 'agn_blr_line_efficiency', 'default': 'Uniform(0.0, 1.0)', 'description': 'BLR line radiative efficiency: fraction of intercepted disc luminosity re-emitted as broad-line luminosity. Physical bound [0, 1]; typical values 0.05-0.15.'}]

grahsp

production

Buchner et al. 2024, arXiv:2405.19297

GRAHSP Netzer 1990 broad-line Gaussians

SEDModel.build(…, agn={‘blr’: {‘type’: ‘grahsp’}})

blr

[{'name': 'agn_grahsp_a_bc', 'default': 'Fixed(0.0)', 'description': 'GRAHSP Balmer continuum strength relative to the powerlaw at 5100 Å (510 nm; Grandi 1982, paper ABC). 0 disables; only added for agn_type=1.'}]

none

production

SEDModel.build(…, agn={‘blr’: {‘type’: ‘none’}})

blr

qsogen

production

Temple et al. 2021, MNRAS, 508, 737

Temple et al. 2021 QSOgen empirical broad-line region

SEDModel.build(…, agn={‘blr’: {‘type’: ‘qsogen’}})

blr

synthesizer

production

Lovell et al. 2025 (Open J. Astrophys.); Roper et al. 2026 (JOSS): Synthesizer

Synthesizer Cloudy grid broad-line region

SEDModel.build(…, agn={‘blr’: {‘type’: ‘synthesizer’}})

blr

[{'name': 'agn_blr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'BLR covering fraction: fraction of disc luminosity intercepted by BLR. Physical bound [0, 1]; typical values 0.05-0.2.'}]

synthesizer_spectra

production

Lovell et al. 2025 (Open J. Astrophys.); Roper et al. 2026 (JOSS): Synthesizer

Synthesizer UnifiedAGN BLR reprocessed nebular spectrum

SEDModel.build(..., agn={'blr': {'type': 'synthesizer_spectra'}})

blr

[{'name': 'agn_blr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'BLR covering fraction: fraction of disc luminosity intercepted by BLR. Physical bound [0, 1]; typical values 0.05-0.2.'}]

adaf

production

Mahadevan 1997, ApJ, 477, 585

Faithful Mahadevan-1997 ADAF (synchrotron + Compton + bremsstrahlung)

SEDModel.build(…, agn={‘disc’: {‘type’: ‘adaf’}})

disc

[{'name': 'agn_adaf_alpha', 'default': 'Uniform(0.05, 0.5)', 'description': 'ADAF viscosity parameter alpha'}, {'name': 'agn_adaf_beta', 'default': 'Uniform(0.1, 0.9)', 'description': 'ADAF gas-to-total pressure ratio beta'}, {'name': 'agn_adaf_delta', 'default': 'Uniform(0.001, 0.5)', 'description': 'ADAF electron viscous-heating fraction delta (default 0.1 = modern preference; Mahadevan 1997 fiducial is 1/2000)'}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_log_mbh', 'default': 'Uniform(6.0, 10.0)', 'description': 'AGN black hole mass log10(M_BH/Msun)'}]

adaf_lopez2024

production

Lopez et al. 2024, A&A, 691, A163

CIGALE SKIRTOR2016 ADAF-thin disc blend (disk_type=2)

SEDModel.build(..., agn={'disc': {'type': 'adaf_lopez2024'}})

disc

[{'name': 'agn_cigale_adaf_delta', 'default': 'Uniform(0.0, 1.0)', 'description': "CIGALE skirtor2016 disk_type=2 blend weight (paper delta): 0 = pure ADAF, 1 = pure thin disc (Lopez et al. 2024). Read only by the 'adaf_lopez2024' disc."}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}]

grahsp_netzer

production

Netzer & Trakhtenbrot 2014, MNRAS 438, 672; Buchner et al. 2024, arXiv:2405.19297

GRAHSP Netzer & Trakhtenbrot 2014 disc templates

SEDModel.build(..., agn={'disc': {'type': 'grahsp_netzer'}})

disc

[{'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_grahsp_log_l5100', 'default': 'Uniform(42.0, 47.0)', 'description': 'GRAHSP log10(lambda*L_lambda(5100Å) / (erg/s)) (paper L_AGN). Sets the AGN normalization; typical 42-47 for Sy1 to QSO.'}, {'name': 'agn_grahsp_netzer_log_mbh', 'default': 'Uniform(6.0, 9.0)', 'description': 'GRAHSP Netzer disc black-hole mass log10(M_BH/Msun). Interpolates over the grid support [6, 9] dex; clipped to edges outside this range.'}, {'name': 'agn_grahsp_netzer_log_mdot', 'default': 'Uniform(-1.5228787452803376, -0.5228787452803376)', 'description': 'GRAHSP Netzer disc Eddington ratio log10(Mdot). Grid support [log10(0.03), log10(0.3)], with default 0.3. Interpolates over this range; clipped to edges outside.'}, {'name': 'agn_grahsp_netzer_spin', 'default': 'Uniform(0.0, 0.998)', 'description': 'GRAHSP Netzer disc spin parameter. Interpolates over the grid support [0, 0.998]; clipped to edges outside this range.'}]

grahsp_sbpl

production

Buchner et al. 2024, arXiv:2405.19297

GRAHSP smooth bending power-law BBB continuum

SEDModel.build(..., agn={'disc': {'type': 'grahsp_sbpl'}})

disc

[{'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_grahsp_cutoff_nm', 'default': 'Uniform(5000.0, 20000.0)', 'description': 'GRAHSP BBB IR cutoff [nm]; -1 disables (paper cutoff). Default 1e4.'}, {'name': 'agn_grahsp_log_l5100', 'default': 'Uniform(42.0, 47.0)', 'description': 'GRAHSP log10(lambda*L_lambda(5100Å) / (erg/s)) (paper L_AGN). Sets the AGN normalization; typical 42-47 for Sy1 to QSO.'}, {'name': 'agn_grahsp_plbendloc_nm', 'default': 'Uniform(50.0, 200.0)', 'description': 'GRAHSP BBB bend wavelength lambda_break [nm] (paper plbendloc). Typical 50-200 nm.'}, {'name': 'agn_grahsp_plbendwidth', 'default': 'Uniform(0.01, 100.0)', 'description': 'GRAHSP BBB bend width Lambda (dimensionless; paper plbendwidth). Larger Lambda smooths the bend; shape deviation from a pure power law falls as ~1/Lambda -- 129% (Lambda=1), 12% (10), 1.1% (100) over 50-1000 nm rest frame. Both bounds sit where the shape stops changing: inert above ~100, saturated to a hard break below ~0.005 (and underflowing by 0.003). Brown+2019 Table 4 tabulates W_bend in dex, so Lambda = 10**W_bend; two of its three fits (0.020, 0.010) fell below the old 0.1 floor, which cost up to 5.7% in shape. Upstream declares Lambda in nm, which it is not (it divides a log ratio), and defaults to 10.0 -- the old upper bound (#2159).'}, {'name': 'agn_grahsp_plslope', 'default': 'Uniform(-2.7, -1.0)', 'description': 'GRAHSP BBB optical power-law index alpha_2 (paper plslope). Typical -2.7 to -1; must satisfy uvslope > plslope.'}, {'name': 'agn_grahsp_uvslope', 'default': 'Uniform(-1.0, 1.0)', 'description': 'GRAHSP BBB UV power-law index alpha_1 (paper uvslope). Typical 0; must satisfy uvslope > plslope.'}]

kd18_agnfitter

production

Kubota & Done 2018, MNRAS, 480, 1247; Martinez-Ramirez et al. 2024, A&A, 688, A46

AGNfitter-rX KD18 grid-tabulated disc (log M_BH, log Edd)

SEDModel.build(..., agn={'disc': {'type': 'kd18_agnfitter'}})

disc

[{'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_log_ledd', 'default': 'Uniform(-2.0, 0.5)', 'description': 'AGN Eddington ratio log10(L/L_Edd)'}, {'name': 'agn_log_mbh', 'default': 'Uniform(6.0, 10.0)', 'description': 'AGN black hole mass log10(M_BH/Msun)'}]

kd18_agnfitter_warmindex

production

Kubota & Done 2018, MNRAS, 480, 1247; Martinez-Ramirez et al. 2024, A&A, 688, A46

AGNfitter-rX KD18 grid-tabulated disc (log M_BH, log Edd, warm-zone index)

SEDModel.build(..., agn={'disc': {'type': 'kd18_agnfitter_warmindex'}})

disc

[{'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_gamma_warm', 'default': 'Uniform(2.0, 3.0)', 'description': 'Warm Comptonization photon index (soft X-ray excess)'}, {'name': 'agn_log_ledd', 'default': 'Uniform(-2.0, 0.5)', 'description': 'AGN Eddington ratio log10(L/L_Edd)'}, {'name': 'agn_log_mbh', 'default': 'Uniform(6.0, 10.0)', 'description': 'AGN black hole mass log10(M_BH/Msun)'}]

kubota_done

production

Kubota & Done 2018, MNRAS, 480, 1247

Kubota & Done 2018 three-zone disc and corona

SEDModel.build(..., agn={'disc': {'type': 'kubota_done'}})

disc

[{'name': 'agn_a_spin', 'default': 'Uniform(0.0, 0.998)', 'description': 'BH spin parameter a* in [0, 0.998): controls ISCO and radiative efficiency'}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_f_hard', 'default': 'Uniform(0.0, 0.1)', 'description': 'Coronal luminosity fraction (hot-flow dissipation as a fraction of L_Edd)'}, {'name': 'agn_gamma_hard', 'default': 'Uniform(1.5, 2.5)', 'description': 'Hard X-ray photon index (hot corona power law)'}, {'name': 'agn_gamma_warm', 'default': 'Uniform(2.0, 3.0)', 'description': 'Warm Comptonization photon index (soft X-ray excess)'}, {'name': 'agn_kt_hot', 'default': 'Uniform(50.0, 300.0)', 'description': 'Hot corona electron temperature [keV]'}, {'name': 'agn_kt_warm', 'default': 'Uniform(0.1, 1.0)', 'description': 'Warm Comptonization electron temperature [keV]'}, {'name': 'agn_log_mbh', 'default': 'Uniform(6.0, 10.0)', 'description': 'AGN black hole mass log10(M_BH/Msun)'}, {'name': 'agn_r_warm_ratio', 'default': 'Uniform(1.0, 5.0)', 'description': 'Ratio R_warm / R_hot (warm Comptonization region size)'}]

multicolor

production

Shakura & Sunyaev 1973, A&A, 24, 337

Shakura-Sunyaev multi-color thin-disc

SEDModel.build(…, agn={‘disc’: {‘type’: ‘multicolor’}})

disc

[{'name': 'agn_a_spin', 'default': 'Uniform(0.0, 0.998)', 'description': 'BH spin parameter a* in [0, 0.998): controls ISCO and radiative efficiency'}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_log_mbh', 'default': 'Uniform(6.0, 10.0)', 'description': 'AGN black hole mass log10(M_BH/Msun)'}]

none

production

SEDModel.build(…, agn={‘disc’: {‘type’: ‘none’}})

disc

powerlaw

production

Power-law disc with UV cutoff

SEDModel.build(…, agn={‘disc’: {‘type’: ‘powerlaw’}})

disc

[{'name': 'agn_T_max', 'default': 'Uniform(10000.0, 1000000.0)', 'description': 'UV cutoff temperature'}, {'name': 'agn_alpha', 'default': 'Uniform(-2.0, 0.0)', 'description': 'AGN disc power-law slope'}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}]

qsogen

production

Temple et al. 2021, MNRAS, 508, 737

Temple et al. 2021 QSOgen broken power-law continuum

SEDModel.build(…, agn={‘disc’: {‘type’: ‘qsogen’}})

disc

[{'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}]

relagn

production

Hagen & Done 2023, MNRAS, 521, 251

RELAGN relativistic Kerr accretion disc (grid-backed)

SEDModel.build(…, agn={‘disc’: {‘type’: ‘relagn’}})

disc

[{'name': 'agn_astar', 'default': 'Uniform(0.0, 0.998)', 'description': 'RELAGN black hole spin a* (prograde)'}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_log_mbh', 'default': 'Uniform(6.0, 10.0)', 'description': 'AGN black hole mass log10(M_BH/Msun)'}, {'name': 'agn_log_mdot', 'default': 'Uniform(-1.5, 0.3)', 'description': 'RELAGN Eddington-scaled accretion rate log10(Mdot/Mdot_Edd)'}]

richards2006

production

Richards et al. 2006, ApJS, 166, 470

Richards et al. 2006 mean SDSS quasar composite SED

SEDModel.build(…, agn={‘disc’: {‘type’: ‘richards2006’}})

disc

[{'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}]

schartmann2005

production

Schartmann et al. 2005, A&A, 437, 861

CIGALE SKIRTOR2016 Schartmann 2005 disc (disk_type=1)

SEDModel.build(…, agn={‘disc’: {‘type’: ‘schartmann2005’}})

disc

[{'name': 'agn_cigale_disk_delta', 'default': 'Uniform(-0.5, 0.5)', 'description': "CIGALE skirtor2016 disc slope modulator (paper delta). For 'skirtor'/'schartmann2005' disc blocks: shifts the 100-5000 nm power-law index alpha from its nominal value by -delta (positive delta -> shallower optical slope)."}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}]

schartmann2005_skirtor_atten

production

Stalevski et al. 2016, MNRAS, 458, 2288

Schartmann 2005 disc with SKIRTOR self-attenuation

SEDModel.build(..., agn={'disc': {'type': 'schartmann2005_skirtor_atten'}})

disc

[{'name': 'agn_cigale_disk_delta', 'default': 'Uniform(-0.5, 0.5)', 'description': "CIGALE skirtor2016 disc slope modulator (paper delta). For 'skirtor'/'schartmann2005' disc blocks: shifts the 100-5000 nm power-law index alpha from its nominal value by -delta (positive delta -> shallower optical slope)."}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}]

skirtor

production

Stalevski et al. 2016, MNRAS, 458, 2288

CIGALE SKIRTOR2016 empirical disc (disk_type=0)

SEDModel.build(…, agn={‘disc’: {‘type’: ‘skirtor’}})

disc

[{'name': 'agn_cigale_disk_delta', 'default': 'Uniform(-0.5, 0.5)', 'description': "CIGALE skirtor2016 disc slope modulator (paper delta). For 'skirtor'/'schartmann2005' disc blocks: shifts the 100-5000 nm power-law index alpha from its nominal value by -delta (positive delta -> shallower optical slope)."}, {'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}]

slone_netzer

production

Slone & Netzer 2012, MNRAS, 426, 656

Slone & Netzer 2012 alpha-disc library interpolation

SEDModel.build(..., agn={'disc': {'type': 'slone_netzer'}})

disc

[{'name': 'agn_ebv_disc', 'default': 'Uniform(0.0, 1.0)', 'description': 'AGN disc color excess E(B-V) (Prevot SMC, R_V=2.72; AGNfitter EBVbbb)'}, {'name': 'agn_log_ledd', 'default': 'Uniform(-2.0, 0.5)', 'description': 'AGN Eddington ratio log10(L/L_Edd)'}, {'name': 'agn_log_mbh', 'default': 'Uniform(6.0, 10.0)', 'description': 'AGN black hole mass log10(M_BH/Msun)'}]

boroson_green

production

Boroson & Green 1992, ApJS, 80, 109

Boroson & Green 1992 FeII pseudo-continuum template

SEDModel.build(..., agn={'feii': {'type': 'boroson_green'}})

feii

[{'name': 'agn_fe2_strength', 'default': 'Uniform(0.0, 2.0)', 'description': 'Fe II to H-beta flux ratio R_Fe = F(Fe II 4434-4684)/F(H-beta)'}]

grahsp

production

Buchner et al. 2024, arXiv:2405.19297

GRAHSP Bruhweiler & Verner 2008 FeII forest

SEDModel.build(…, agn={‘feii’: {‘type’: ‘grahsp’}})

feii

[{'name': 'agn_grahsp_a_feii', 'default': 'Uniform(0.0, 10.0)', 'description': 'GRAHSP FeII forest strength relative to broad H-beta (paper AFeII). Typical 2-10.'}]

grahsp_veroncetty

production

Veron-Cetty, Joly & Veron 2004, A&A 417, 515; Buchner et al. 2024, arXiv:2405.19297

GRAHSP Veron-Cetty & Joly 2004 FeII template

SEDModel.build(..., agn={'feii': {'type': 'grahsp_veroncetty'}})

feii

[{'name': 'agn_grahsp_a_feii', 'default': 'Uniform(0.0, 10.0)', 'description': 'GRAHSP FeII forest strength relative to broad H-beta (paper AFeII). Typical 2-10.'}]

none

production

SEDModel.build(…, agn={‘feii’: {‘type’: ‘none’}})

feii

qsogen_balmer

production

Temple et al. 2021, MNRAS, 508, 737

Temple et al. 2021 QSOgen Balmer continuum

SEDModel.build(..., agn={'feii': {'type': 'qsogen_balmer'}})

feii

[{‘name’: ‘agn_bcnorm’, ‘default’: ‘Uniform(0.0, 2.0)’, ‘description’: ‘QSOgen Balmer continuum (Fe II pseudo-continuum) normalization. When > 0, adds the Fe II pseudo-continuum contribution to the emission (``qsogen_balmer`` block). Default 0.0 disables the Balmer continuum. Range [0, 2.0] empirically sensible.’}]

analytic

production

Richardson et al. 2014, MNRAS, 437, 2376

Analytic NLR with Richardson+2014 line ratios and Gaussian broadening

SEDModel.build(…, agn={‘nlr’: {‘type’: ‘analytic’}})

nlr

[{'name': 'agn_nlr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'NLR Gaussian covering fraction: fraction of disc luminosity intercepted by NLR. Physical bound [0, 1]; typical values 0.05-0.2.'}, {'name': 'agn_nlr_line_efficiency', 'default': 'Uniform(0.0, 1.0)', 'description': 'NLR line radiative efficiency: fraction of intercepted disc luminosity re-emitted as emission-line luminosity. Physical bound [0, 1]; typical values 0.01-0.30.'}]

cue

experimental

Li, Y. et al. 2025, ApJ 986, 9 (arXiv:2405.04598), ‘The Cue Nebular Emulator’; disc->Cue->NLR pipeline in the BEAGLE spirit (Feltre, Charlot & Gutkin 2016)

Cue emulator AGN-ionized NLR (fast differentiable, BEAGLE-style)

SEDModel.build(…, agn={‘nlr’: {‘type’: ‘cue’}})

nlr

[{'name': 'agn_nlr_alpha_pl', 'default': 'Uniform(-2.0, -1.2)', 'description': 'AGN EUV ionizing power-law slope alpha (f_nu ~ nu^alpha) driving the Feltre+2016 NLR grid (alpha_axis).'}, {'name': 'agn_nlr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'NLR Gaussian covering fraction: fraction of disc luminosity intercepted by NLR. Physical bound [0, 1]; typical values 0.05-0.2.'}, {'name': 'agn_nlr_logU', 'default': 'Uniform(-5.0, -1.0)', 'description': 'NLR ionization parameter log10(U) (Feltre+2016 logU grid axis).'}, {'name': 'agn_nlr_logZ', 'default': 'Uniform(-4.0, -1.154901959985743)', 'description': 'NLR gas metallicity log10(Z) absolute (Feltre+2016 logZ grid axis; default -1.8477 = solar, IAU 2015 Zsun=0.0142).'}, {'name': 'agn_nlr_logn', 'default': 'Uniform(2.0, 4.0)', 'description': 'NLR gas density log10(n_H / cm^-3) (Feltre+2016 logn grid axis).'}]

feltre

experimental

Feltre, Charlot & Gutkin 2016, MNRAS 456, 3354 (arXiv:1511.08217), ‘Nuclear activity versus star formation: emission-line diagnostics at ultraviolet and optical wavelengths’; BEAGLE NLR parity (Vidal-García et al. 2022, arXiv:2211.13648)

Feltre+2016 CLOUDY photoionization NLR (BEAGLE parity)

SEDModel.build(…, agn={‘nlr’: {‘type’: ‘feltre’}})

nlr

[{'name': 'agn_nlr_alpha_pl', 'default': 'Uniform(-2.0, -1.2)', 'description': 'AGN EUV ionizing power-law slope alpha (f_nu ~ nu^alpha) driving the Feltre+2016 NLR grid (alpha_axis).'}, {'name': 'agn_nlr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'NLR Gaussian covering fraction: fraction of disc luminosity intercepted by NLR. Physical bound [0, 1]; typical values 0.05-0.2.'}, {'name': 'agn_nlr_fwhm_kms', 'default': 'Uniform(100.0, 2000.0)', 'description': 'NLR emission-line FWHM [km/s]. Applied as Gaussian broadening after the grid lookup; typical narrow-line widths 300-1000 km/s.'}, {'name': 'agn_nlr_logU', 'default': 'Uniform(-5.0, -1.0)', 'description': 'NLR ionization parameter log10(U) (Feltre+2016 logU grid axis).'}, {'name': 'agn_nlr_logZ', 'default': 'Uniform(-4.0, -1.154901959985743)', 'description': 'NLR gas metallicity log10(Z) absolute (Feltre+2016 logZ grid axis; default -1.8477 = solar, IAU 2015 Zsun=0.0142).'}, {'name': 'agn_nlr_logn', 'default': 'Uniform(2.0, 4.0)', 'description': 'NLR gas density log10(n_H / cm^-3) (Feltre+2016 logn grid axis).'}, {'name': 'agn_nlr_xi_d', 'default': 'Uniform(0.1, 0.5)', 'description': 'NLR dust-to-metal mass ratio xi_d (Feltre+2016 xi_d grid axis).'}]

grahsp

production

Buchner et al. 2024, arXiv:2405.19297

GRAHSP Netzer 1990 narrow-line Gaussians

SEDModel.build(…, agn={‘nlr’: {‘type’: ‘grahsp’}})

nlr

none

production

SEDModel.build(…, agn={‘nlr’: {‘type’: ‘none’}})

nlr

synthesizer

production

Lovell et al. 2025 (Open J. Astrophys.); Roper et al. 2026 (JOSS): Synthesizer

Synthesizer Cloudy grid narrow-line region

SEDModel.build(…, agn={‘nlr’: {‘type’: ‘synthesizer’}})

nlr

[{'name': 'agn_nlr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'NLR Gaussian covering fraction: fraction of disc luminosity intercepted by NLR. Physical bound [0, 1]; typical values 0.05-0.2.'}]

synthesizer_spectra

production

Lovell et al. 2025 (Open J. Astrophys.); Roper et al. 2026 (JOSS): Synthesizer

Synthesizer UnifiedAGN NLR reprocessed nebular spectrum

SEDModel.build(..., agn={'nlr': {'type': 'synthesizer_spectra'}})

nlr

[{'name': 'agn_nlr_cf', 'default': 'Uniform(0.0, 1.0)', 'description': 'NLR Gaussian covering fraction: fraction of disc luminosity intercepted by NLR. Physical bound [0, 1]; typical values 0.05-0.2.'}]

cat3d_wind

production

Hönig & Kishimoto 2017, ApJL, 838, L20

Hönig & Kishimoto 2017 CAT3D-wind torus

SEDModel.build(..., agn={'torus': {'type': 'cat3d_wind'}})

torus

[{‘name’: ‘agn_a_cat3d’, ‘default’: ‘Uniform(-3.0, -1.5)’, ‘description’: ‘CAT3D-Wind radial cloud-distribution power-law index (grid -3 to -1.5)’}, {‘name’: ‘agn_fwd_cat3d’, ‘default’: ‘Uniform(1.0, 2.25)’, ‘description’: ‘CAT3D-Wind polar-wind mass fraction (grid 1.0 to 2.25, AGNfitter rows-210+ set)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

cat3d_wind_lowfwd

production

Hönig & Kishimoto 2017, ApJL, 838, L20

Hönig & Kishimoto 2017 CAT3D-wind torus, low-wind-fraction reduction

SEDModel.build(..., agn={'torus': {'type': 'cat3d_wind_lowfwd'}})

torus

[{‘name’: ‘agn_a_cat3d_lowfwd’, ‘default’: ‘Uniform(-3.0, -0.5)’, ‘description’: ‘CAT3D-Wind low-fwd radial cloud-distribution power-law index (grid -3 to -0.5, AGNfitter rows 0-209 set; default = grid node -2.0)’}, {‘name’: ‘agn_fwd_cat3d_lowfwd’, ‘default’: ‘Uniform(0.15, 0.75)’, ‘description’: ‘CAT3D-Wind low-fwd polar-wind mass fraction (grid 0.15 to 0.75, AGNfitter rows 0-209 set; default = grid node 0.45)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

fritz

production

Fritz, Franceschini & Hatziminaoglou 2006, MNRAS, 366, 767

Fritz et al. 2006 smooth-dust torus

SEDModel.build(…, agn={‘torus’: {‘type’: ‘fritz’}})

torus

[{‘name’: ‘agn_fritz_beta’, ‘default’: ‘Fixed(-0.5)’, ‘description’: ‘Fritz2006 radial dust density power-law index (grid: -1, -0.75, -0.5, -0.25, 0)’}, {‘name’: ‘agn_fritz_gamma’, ‘default’: ‘Fixed(4.0)’, ‘description’: ‘Fritz2006 polar dust density gradient (grid: 0, 2, 4, 6)’}, {‘name’: ‘agn_fritz_oa’, ‘default’: ‘Fixed(60.0)’, ‘description’: ‘Fritz2006 half-angle of the dust-free polar cone [degrees] (grid: 20, 40, 60; full torus opening angle = 180 - 2 x half; type 1 when inclination < half)’}, {‘name’: ‘agn_fritz_r_ratio’, ‘default’: ‘Fixed(60.0)’, ‘description’: ‘Fritz2006 torus outer/inner radius ratio (grid: 10, 30, 60, 100, 150)’}, {‘name’: ‘agn_fritz_tau’, ‘default’: ‘Fixed(1.0)’, ‘description’: ‘Fritz2006 equatorial optical depth at 9.7 um (grid: 0.1, 0.3, 0.6, 1, 2, 3, 6, 10)’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

grahsp

production

Buchner et al. 2024, arXiv:2405.19297

GRAHSP infrared torus with Si feature

SEDModel.build(…, agn={‘torus’: {‘type’: ‘grahsp’}})

torus

[{'name': 'agn_grahsp_cool_lam_um', 'default': 'Uniform(10.0, 30.0)', 'description': 'GRAHSP cool dust peak wavelength [um] (paper COOLlam). Typical 10-30 um.'}, {'name': 'agn_grahsp_cool_width', 'default': 'Uniform(0.2, 0.65)', 'description': 'GRAHSP cool dust log-Gaussian standard deviation [dex] (paper COOLwidth, W in exp[-x^2/(2 W^2)]). Typical 0.2-0.65.'}, {'name': 'agn_grahsp_fcov', 'default': 'Uniform(0.0, 1.0)', 'description': 'GRAHSP torus covering factor at 12 um (paper fcov). Typical 0.05-0.95; relates to Stalevski+2016 geometric f_cov.'}, {'name': 'agn_grahsp_hot_fcov', 'default': 'Uniform(0.04, 10.0)', 'description': 'GRAHSP hot/cool peak ratio in lambda*L_lambda (paper f_hot). Typical 0.04-10.'}, {'name': 'agn_grahsp_hot_lam_um', 'default': 'Uniform(1.0, 5.5)', 'description': 'GRAHSP hot dust peak wavelength [um] (paper HOTlam). Typical 1-5.5 um.'}, {'name': 'agn_grahsp_hot_width', 'default': 'Uniform(0.2, 0.65)', 'description': 'GRAHSP hot dust log-Gaussian standard deviation [dex] (paper HOTwidth, W in exp[-x^2/(2 W^2)]). Typical 0.2-0.65.'}, {'name': 'agn_grahsp_si', 'default': 'Uniform(-4.0, 4.0)', 'description': 'GRAHSP Si feature strength (paper Si). Negative=absorption, positive=emission. Typical -4 to +4.'}]

grahsp_mn12

production

Mor & Netzer 2012, MNRAS 420, 526; Buchner et al. 2024, arXiv:2405.19297

GRAHSP Mor & Netzer 2012 torus templates

SEDModel.build(..., agn={'torus': {'type': 'grahsp_mn12'}})

torus

[{'name': 'agn_grahsp_fcov', 'default': 'Uniform(0.0, 1.0)', 'description': 'GRAHSP torus covering factor at 12 um (paper fcov). Typical 0.05-0.95; relates to Stalevski+2016 geometric f_cov.'}, {'name': 'agn_grahsp_si', 'default': 'Uniform(-4.0, 4.0)', 'description': 'GRAHSP Si feature strength (paper Si). Negative=absorption, positive=emission. Typical -4 to +4.'}, {'name': 'agn_grahsp_tor_cutoff_um', 'default': 'Fixed(1.2)', 'description': "GRAHSP MN12 template-torus short-wavelength Gaussian cutoff [um] (paper TORcutoff; 1.2 Mor&Netzer, 1.7 Lyu&Rieke). Torus model 'mn12'."}, {'name': 'agn_grahsp_tor_temp', 'default': 'Fixed(0.0)', 'description': "GRAHSP MN12 template-torus temperature blend (paper TORtemp), in [-1, +1]; >0 warms towards the 75th-percentile template, <0 cools towards the 25th. Used only when the torus model is 'mn12'."}]

nenkova

production

Nenkova et al. 2008, ApJ, 685, 147

Nenkova et al. 2008 CLUMPY radiative-transfer torus

SEDModel.build(…, agn={‘torus’: {‘type’: ‘nenkova’}})

torus

[{‘name’: ‘agn_tau’, ‘default’: ‘Uniform(5.0, 150.0)’, ‘description’: ‘Nenkova+2008 CLUMPY torus equatorial optical depth (5-150)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

nenkova_agnfitter

production

Nenkova et al. 2008, ApJ, 685, 160; Martínez-Ramírez et al. 2024, A&A, 688, A46

Nenkova et al. 2008 CLUMPY torus (AGNfitter-rX NK0_mean_1p templates)

SEDModel.build(..., agn={'torus': {'type': 'nenkova_agnfitter'}})

torus

[{‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

nenkova_agnfitter_2p

production

Nenkova et al. 2008, ApJ, 685, 160; Martínez-Ramírez et al. 2024, A&A, 688, A46

Nenkova et al. 2008 CLUMPY torus (AGNfitter-rX NK0_mean_2p templates)

SEDModel.build(..., agn={'torus': {'type': 'nenkova_agnfitter_2p'}})

torus

[{‘name’: ‘agn_oa_nenkova’, ‘default’: ‘Uniform(15.0, 70.0)’, ‘description’: ‘NK0_mean_2p/3p (AGNfitter-rX) CLUMPY torus half-opening angle [degrees] (grid 15-70; default = grid node 40.0)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

nenkova_agnfitter_3p

production

Nenkova et al. 2008, ApJ, 685, 160; Martínez-Ramírez et al. 2024, A&A, 688, A46

Nenkova et al. 2008 CLUMPY torus (AGNfitter-rX NK0_mean_3p templates)

SEDModel.build(..., agn={'torus': {'type': 'nenkova_agnfitter_3p'}})

torus

[{‘name’: ‘agn_oa_nenkova’, ‘default’: ‘Uniform(15.0, 70.0)’, ‘description’: ‘NK0_mean_2p/3p (AGNfitter-rX) CLUMPY torus half-opening angle [degrees] (grid 15-70; default = grid node 40.0)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}, {‘name’: ‘agn_tv_nenkova’, ‘default’: ‘Uniform(10.0, 300.0)’, ‘description’: ‘NK0_mean_3p (AGNfitter-rX) CLUMPY torus equatorial optical depth (grid 10-300; default = grid node 60.0)’}]

none

production

SEDModel.build(…, agn={‘torus’: {‘type’: ‘none’}})

torus

qsogen

production

Temple et al. 2021, MNRAS, 508, 737

Temple et al. 2021 QSOgen hot-dust blackbody

SEDModel.build(…, agn={‘torus’: {‘type’: ‘qsogen’}})

torus

silva04

production

Silva et al. 2004, MNRAS, 355, 973

Silva et al. 2004 smooth torus model

SEDModel.build(…, agn={‘torus’: {‘type’: ‘silva04’}})

torus

[{‘name’: ‘agn_log_nh_silva’, ‘default’: ‘Uniform(21.5, 24.45)’, ‘description’: ‘Silva+04 torus log10(N_H / cm^-2) (grid 21.5 to 24.45)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

simple

production

Single-temperature graybody torus

SEDModel.build(…, agn={‘torus’: {‘type’: ‘simple’}})

torus

[{‘name’: ‘agn_T_torus’, ‘default’: ‘Uniform(100.0, 1500.0)’, ‘description’: ‘AGN torus temperature (K)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

skirtor

production

Stalevski et al. 2016, MNRAS, 458, 2288

Stalevski et al. 2016 SKIRTOR torus

SEDModel.build(…, agn={‘torus’: {‘type’: ‘skirtor’}})

torus

[{‘name’: ‘agn_oa_skirtor’, ‘default’: ‘Uniform(10.0, 80.0)’, ‘description’: ‘SKIRTOR torus half-opening angle [degrees] (10-80)’}, {‘name’: ‘agn_p_skirtor’, ‘default’: ‘Uniform(0.0, 1.5)’, ‘description’: ‘SKIRTOR radial density power-law gradient (0-1.5)’}, {‘name’: ‘agn_q_skirtor’, ‘default’: ‘Uniform(0.0, 1.5)’, ‘description’: ‘SKIRTOR polar density power-law gradient (0-1.5)’}, {‘name’: ‘agn_radius_ratio’, ‘default’: ‘Uniform(10.0, 30.0)’, ‘description’: ‘SKIRTOR torus outer/inner radius ratio R (grid: 10, 20, 30)’}, {‘name’: ‘agn_tau_skirtor’, ‘default’: ‘Uniform(3.0, 11.0)’, ‘description’: ‘SKIRTOR 9.7 um optical depth (3-11)’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

skirtor_agnfitter

production

Stalevski et al. 2016, MNRAS, 458, 2288

Stalevski et al. 2016 SKIRTOR_mean_3p AGNfitter-rX torus

SEDModel.build(..., agn={'torus': {'type': 'skirtor_agnfitter'}})

torus

[{‘name’: ‘agn_oa_skirtor’, ‘default’: ‘Uniform(10.0, 80.0)’, ‘description’: ‘SKIRTOR torus half-opening angle [degrees] (10-80)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}, {‘name’: ‘agn_tv_skirtor’, ‘default’: ‘Uniform(3.0, 11.0)’, ‘description’: ‘SKIRTOR_mean_3p equatorial optical depth tau_V (grid 3-11)’}]

skirtor_agnfitter_1p

production

Stalevski et al. 2016, MNRAS, 458, 2288

Stalevski et al. 2016 SKIRTOR_mean_1p AGNfitter-rX torus

SEDModel.build(..., agn={'torus': {'type': 'skirtor_agnfitter_1p'}})

torus

[{‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

skirtor_agnfitter_2p

production

Stalevski et al. 2016, MNRAS, 458, 2288

Stalevski et al. 2016 SKIRTOR_mean_2p AGNfitter-rX torus

SEDModel.build(..., agn={'torus': {'type': 'skirtor_agnfitter_2p'}})

torus

[{‘name’: ‘agn_oa_skirtor’, ‘default’: ‘Uniform(10.0, 80.0)’, ‘description’: ‘SKIRTOR torus half-opening angle [degrees] (10-80)’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

two_temperature

production

Two-temperature (hot + warm) graybody torus

SEDModel.build(..., agn={'torus': {'type': 'two_temperature'}})

torus

[{‘name’: ‘agn_T_hot’, ‘default’: ‘Uniform(800.0, 1500.0)’, ‘description’: ‘Two-temperature torus: hot dust component temperature [K]’}, {‘name’: ‘agn_T_warm’, ‘default’: ‘Uniform(150.0, 500.0)’, ‘description’: ‘Two-temperature torus: warm dust component temperature [K]’}, {‘name’: ‘agn_frac_hot’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: ‘Two-temperature torus: hot-to-warm dust luminosity fraction [0, 1]’}, {‘name’: ‘agn_theta_torus’, ‘default’: ‘Uniform(0.0, 90.0)’, ‘description’: ‘AGN torus half-opening angle [deg]; sets the Type-1/2 critical inclination’}, {‘name’: ‘agn_torus_frac’, ‘default’: ‘Uniform(0.0, 1.0)’, ‘description’: “AGN torus covering factor: L_AGN / L_total in a configurable band (CIGALE convention). Canonical name (Task 16, R17) – the live kwarg of seven composable torus blocks (fritz, nenkova, cat3d_wind, two_temperature, simple, skirtor_agnfitter, …) and, since R17, SKIRTORTorus’s own attribute too. Distinct from ``agn_ir_frac``, which is the AGN share of the dust *IR* specifically (#1296). ``agn_band_frac`` (SKIRTORTorus’s former, single-consumer name for this exact same quantity – the description above previously called THIS name deprecated in ITS favor, backwards) is retired: nest under ``agn={‘torus’: {‘torus_frac’: …}}``.”}]

xray models

tengri.list_xray_models()

name

status

citation

short_doc

use

agn_xray_corona

production

SEDComponent for AGN X-ray corona emission.

SEDModel.build(..., xray={'type': 'agn_xray_corona'})

lopez24

production

Lopez et al. 2024 (A&A 692, A209); Asmus et al. 2015 (MNRAS 454, 766)

IR-tied AGN corona via alpha_IRX(L_12um) + Fragos+13 XRBs + hot gas

SEDModel.build(…, xray={‘type’: ‘lopez24’})

none

production

Disable X-ray emission

SEDModel.build(…, xray={‘type’: ‘none’})

simple

production

Yang+2020 / X-CIGALE (MNRAS 491, 740)

AGN corona via alpha_ox(L_2500) + Fragos+13 XRBs + thermal hot gas

SEDModel.build(…, xray={‘type’: ‘simple’})

xray_aird

production

SEDComponent for X-ray emission (Fragos+2013 / Yang+2020 canonical).

SEDModel.build(..., xray={'type': 'xray_aird'})

yang20

production

Yang et al. 2020 (MNRAS 491, 740)

Alias of 'simple'; use this name for CIGALE pcigale.sed_modules.xray parity

SEDModel.build(…, xray={‘type’: ‘yang20’})

radio models

tengri.list_radio_models()

name

status

citation

short_doc

use

condon92

unvalidated

Condon 1992 (ARA&A 30, 575) + Yang+2020 (MNRAS 491, 740)

FIR-radio correlation (q_IR) + AGN radio loudness power-law [not builder-available: legacy radio={'type':...} form retired; use the composable form radio={'sf'/'agn': ...} form]

SEDModel.build(…, radio={‘sf’: {‘type’: ‘bell2003’}, ‘agn’: {‘type’: ‘powerlaw’}})

none

unvalidated

Disable radio emission [not builder-available: legacy radio={‘type’:…} form retired; use the composable form radio={‘sf’/’agn’: …} form]

SEDModel.build(…, radio={‘sf’: {‘type’: ‘none’}, ‘agn’: {‘type’: ‘none’}})

radio_dpl

unvalidated

Radio synchrotron + free-free + AGN double-power-law with aging cutoff. [not builder-available: legacy radio={‘type’:…} form retired; use the composable form radio={‘sf’/’agn’: …} form]

SEDModel.build(…, radio={‘sf’: {‘type’: ‘bell2003’}, ‘agn’: {‘type’: ‘dpl’}})

radio_powerlaw

unvalidated

SEDComponent for radio synchrotron (power-law) + thermal emission. [not builder-available: legacy radio={‘type’:…} form retired; use the composable form radio={‘sf’/’agn’: …} form]

SEDModel.build(…, radio={‘sf’: {‘type’: ‘bell2003’}, ‘agn’: {‘type’: ‘powerlaw’}})

radio blocks

tengri.list_radio_blocks()

name

status

citation

short_doc

use

category

dpl

production

Martinez-Ramirez+2024 (A&A 688, A46)

Broken double power-law with exp aging cutoff

SEDModel.build(…, radio={‘agn’: {‘type’: ‘dpl’}})

agn

none

production

No AGN radio (star-forming synchrotron only)

SEDModel.build(…, radio={‘agn’: {‘type’: ‘none’}})

agn

powerlaw

production

Single power-law AGN radio scaled by radio-loudness

SEDModel.build(…, radio={‘agn’: {‘type’: ‘powerlaw’}})

agn

bell2003

production

Bell 2003 (ApJ 586, 794)

Fixed-q FIR-radio correlation

SEDModel.build(…, radio={‘sf’: {‘type’: ‘bell2003’}})

sf

bell2003_split

production

Bell 2003 (ApJ 586, 794); Martinez-Ramirez+2024 (A&A 688, A46)

Bell 2003 total L(1.4 GHz) split 90% non-thermal / 10% thermal

SEDModel.build(..., radio={'sf': {'type': 'bell2003_split'}})

sf

delvecchio2021

production

Delvecchio+2021 total-radio FIRRC (Eq. 5, arXiv:2010.05510)

Mass- and z-dependent q_IR at 1.4 GHz

SEDModel.build(…, radio={‘sf’: {‘type’: ‘delvecchio2021’}})

sf

mccheyne2022

production

McCheyne+2022 FIRRC (A&A 662, A100)

Mass- and z-dependent q_IR at 150 MHz (LOFAR)

SEDModel.build(…, radio={‘sf’: {‘type’: ‘mccheyne2022’}})

sf

none

production

No star-forming synchrotron (AGN radio only)

SEDModel.build(…, radio={‘sf’: {‘type’: ‘none’}})

sf

igm models

tengri.list_igm_models()

name

status

citation

short_doc

use

asada25

production

Asada+2025 (ApJL 983, L2)

Inoue+2014 IGM + Asada+2025 proximate-CGM damping wing (fixes z>7 photo-z bias)

SEDModel.build(…, igm={‘type’: ‘asada25’})

inoue

production

Inoue+2014 (MNRAS 442, 1805)

Alias of ‘inoue14’ kept for backwards compatibility

SEDModel.build(…, igm={‘type’: ‘inoue’})

inoue14

production

Inoue+2014 (MNRAS 442, 1805)

Mean LyC + Lyman-series IGM attenuation; default for z >~ 1

SEDModel.build(…, igm={‘type’: ‘inoue14’})

madau

production

Madau 1995 (ApJ 441, 18)

Original Lyman-forest mean transmission

SEDModel.build(…, igm={‘type’: ‘madau’})

meiksin06

production

Meiksin 2006 (MNRAS 365, 807)

Smooth Ly-alpha forest continuum + LLS damping (matches CIGALE)

SEDModel.build(…, igm={‘type’: ‘meiksin06’})

none

production

Disable IGM attenuation (e.g. low-z fits)

SEDModel.build(…, igm={‘type’: ‘none’})

inference methods

tengri.list_inference_methods()

name

tier

status

short_doc

use

laplace

primary

ok

Laplace approximation around the MAP (cold ~5-9s, warm ~1-2s, ~3 GB)

fitter.run(“laplace”)

map

primary

missing_dep

Adam MAP optimization

fitter.run(“map”)

mcmc

primary

missing_dep

Auto MCMC: NUTS for low-D, raytrace for high-D

fitter.run(“mcmc”)

mcmc_hmc

primary

missing_dep

Hamiltonian Monte Carlo (cold ~21s, ~5 GB on D=6-7). Convergence-validated only with dense_mass_matrix=True, n_warmup≥1000, n_leapfrog_steps≥20 on D=6 DPL (R-hat 1.008, ESS 411). Default n_warmup=300 / dense=True gives R-hat ≫ 1, do not lower the warmup for science.

fitter.run("mcmc_hmc")

mcmc_nuts

primary

missing_dep

No-U-Turn Sampler (cold ~90s at D=6 DPL; warmup blows past 5 min on dense_basis D=7, prefer mcmc_hmc or mcmc_ghmc for dense_basis SFH)

fitter.run("mcmc_nuts")

mcmc_nuts_fast

primary

missing_dep

NUTS photometry recipe: 4 chains x (150 warmup + 300 draws), no burn-in, target 0.8; mass profiled, dense metric, vmapped chains on one device; pmapped when the platform exposes at least n_chains devices

fitter.run("mcmc_nuts_fast")

mcmc_raytrace

primary

ok

Ray-tracing ensemble sampler (high-D)

fitter.run("mcmc_raytrace")

nss

primary

ok

Vectorized nested sampling: returns Bayesian evidence (log Z) and posterior samples. Efficient sampler suitable for model comparison and point estimate inference.

fitter.run(“nss”)

vi

primary

ok

NIFTy geoVI variational inference (cold ~100s, ~20 GB RSS at D=6-7, memory-heavy; consider mcmc_hmc for faster turnaround on D<10)

fitter.run(“vi”)

vi_nonlinear_fast

primary

ok

NIFTy geoVI without Python logging

fitter.run("vi_nonlinear_fast")

hmc_is

experimental

missing_dep

HMC posterior + importance-sampled log-evidence (cold ~30s at D=6; check diagnostics['ess'] and diagnostics['max_weight_frac'] for quality)

fitter.run("hmc_is")

mcmc_adjusted_mclmc

experimental

missing_dep

Adjusted microcanonical Langevin (cold ~60s, ~3x compile premium over mclmc). Requires blackjax >= 1.6.

fitter.run("mcmc_adjusted_mclmc")

mcmc_barker

experimental

missing_dep

Barker-proposal MCMC: one gradient per step, no trajectory, no tree, and no branch anywhere in the compiled program -- two fixed-length lax.scan calls. Its published claim is robustness to a step size that is wrong for one direction's scale, which is this posterior's shape. Metric from precondition=, never estimated. Measured against its own MALA control in bench/reports/2026-08-31_blackjax_sampler_survey.md.

fitter.run("mcmc_barker")

mcmc_chees

experimental

missing_dep

ChEES-HMC: one trajectory length learned from cross-chain statistics, so every chain still takes the same number of leapfrogs (lock-step preserved) while L comes from the posterior rather than from a hand-set constant. Metropolis-corrected dynamic HMC underneath, with the metric supplied analytically (precondition=) rather than estimated from the ensemble. Measured six seeds x four posteriors in bench/reports/2026-08-30_chees_hmc.md.

fitter.run("mcmc_chees")

mcmc_dynamic_hmc

experimental

missing_dep

Dynamic HMC, fast (cold ~19s) but chains under-mix at default settings (R-hat ≈ 1.11-1.25, ESS ≈ 1-30 on D=6-7 mocks, 1000 warmup + 2000 samples). Needs tuning before science use.

fitter.run("mcmc_dynamic_hmc")

mcmc_ess

experimental

missing_dep

Elliptical slice sampling, cheap (cold ~10s, ~2 GB) but assumes a Gaussian prior; bias on uniform/bounded priors not yet validated

fitter.run("mcmc_ess")

mcmc_hmc_lowrank

experimental

missing_dep

Fixed-L HMC whose mass matrix is a rank-k correction to a diagonal, fitted from warmup draws AND gradients by Fisher divergence. The middle term preconditioning.py's docstring says is missing between a diagonal that cannot cover cond 1e5 and a dense one that is noisy and memory-hungry. Sampling kernel and compile cost identical to mcmc_hmc, so a head-to-head isolates the mass matrix.

fitter.run("mcmc_hmc_lowrank")

mcmc_mala

experimental

missing_dep

MALA. Exists as the CONTROL for mcmc_barker -- same code path, same step-size-only dual averaging, same identity mass matrix, differing in the proposal alone -- so Barker's robustness claim is testable rather than asserted. Registered rather than hidden behind an edit because an ablation reachable only from source is one nobody re-runs.

fitter.run("mcmc_mala")

mcmc_smc

experimental

missing_dep

Tempered Sequential Monte Carlo: a particle population annealed from the exact standardized N(0, I) prior to the posterior, so it never starts at the MAP and cannot inherit its basin. Every particle takes the same fixed-length inner-HMC moves at every rung, so a rung is lock-step with no ragged control flow -- but under the adaptive schedule the RUNG COUNT is data-dependent, so the raggedness moves out to the tempering while_loop rather than disappearing (pass fixed_ladder= for the fully lock-step arm). log Z comes free with the weights. NOTE: a resampled particle population is exchangeable, so the autocorrelation ESS is not a convergence count for this backend -- read min_ancestor_ess and the split R-hat across independent populations. Measured in bench/reports/2026-08-31_smc_evaluation.md.

fitter.run("mcmc_smc")

pathfinder

experimental

missing_dep

[NARROW ERROR BARS] Pathfinder reports uncertainties up to 9x too small on a degenerate direction, silently, while looking healthy on every other parameter of the same fit: measured against a converged NUTS reference on D=8 DPL photometry, its marginal widths are 0.11-0.21x on the four degenerate SFH-shape parameters and 0.79-1.07x on the four well-constrained ones. Treat a Pathfinder error bar as a lower bound. The covariance is blackjax's lbfgs_inverse_hessian_formula_1, diag(alpha) + beta @ gamma @ beta.T: a diagonal plus a correction whose rank is however many L-BFGS steps actually ran -- but the cause is NOT the rank. Read out of a real fit, beta comes back FULL rank (8 of 8 at D=8) and 58% of the covariance's norm is off-diagonal, so the Gaussian is genuinely correlated. The cause is the ACCURACY of the quasi-Newton curvature estimate: its condition number is 8.7e3 against the analytic metric's 3.53e4 at the same point, 4x too isotropic. The clinching comparison is laplace, which fits the same family at the same expansion point with the EXACT Hessian and recovers widths at 0.94-1.05x on this fixture -- so neither the Gaussian family nor the MAP expansion point is at fault, only the estimate. Dropping the MAP seed, which blackjax's own page advises, makes it worse on 8 of 8 parameters (median 0.48 -> 0.16), so MAP seeding stays. precondition=True roughly halves the collapse (worst 0.11 -> 0.21) and does not cure it. There is also no R-hat and no divergence count to catch it, and the hierarchical seam OOM-kills it at D=18. What it is good for: a fast approximate CENTER (means within z ~ 1-11 of the same reference) and a NUTS warm start. Left tier='broken' 2026-05-22 to 2026-08-31 under 'segfaults on DPL/dense_basis photometry mocks' (#231) -- a label the harness inferred from 'child died without writing JSON' without ever reading the child's return code; re-measured on that same model family it completes on every run, including at the uncapped 200 ELBO draws that were the pre-2026-07 default. Both real defects were fixed weeks later in PRs about other things (blackjax >= 1.4 API drift, 4c1002ae7; uncapped ELBO draws at 26 GB, 8807c838d). See bench/reports/2026-08-31_vi_speed_evaluation.md.

fitter.run(“pathfinder”)

vi_fullrank

experimental

missing_dep

Full-rank Gaussian VI (BlackJAX fullrank_vi): SGD on the ELBO over a Cholesky factor, so the fitted Gaussian CAN carry the age/dust/met tilt that mean-field cannot. A fixed-length scan, no ragged control flow, so the graph is small. It does not under-disperse -- at 2000 steps on D=8 DPL photometry it went UNSTABLE, returning sfh_dpl_log_total_mass as 10.37 +- 1.61 against a converged NUTS reference's 11.96 +- 0.036: the stellar mass wrong by 1.6 dex with an error bar 45x too wide, and no diagnostic in the family can report it. precondition=True is what makes it behave (worst width ratio 45x -> 1.67x) and is effectively required. Check elbo_history and the width ratios in bench/reports/2026-08-31_vi_speed_evaluation.md before quoting anything from it.

fitter.run("vi_fullrank")

vi_linear

experimental

ok

NIFTy MGVI standard with logging

fitter.run("vi_linear")

vi_linear_fast

experimental

ok

NIFTy MGVI without Python logging

fitter.run("vi_linear_fast")

vi_meanfield

experimental

missing_dep

Mean-field Gaussian VI (BlackJAX meanfield_vi): a DIAGONAL Gaussian, which on a posterior whose defining feature is a tilted degeneracy (cond 1e5-1e8) reports conditional widths rather than marginal ones. Measured against a converged NUTS reference on D=8 DPL photometry, its marginals are 0.07-0.62x the reference's, median 0.24x -- error bars 4x too narrow typically and 14x at worst. That is structural, not a tuning failure, and preconditioning does not fix it (median 0.21x). The cheapest member of the family and the least able to be right about an uncertainty; 'laplace' costs about the same and recovers widths to within 6%. See bench/reports/2026-08-31_vi_speed_evaluation.md.

fitter.run("vi_meanfield")

instruments

tengri.list_instruments()

name

use

n_bands

description

GALEX

tengri.Instrument.GALEX()

2

GALEX FUV + NUV; the canonical low-z UV set.

SDSS

tengri.Instrument.SDSS()

5

SDSS ugriz; the canonical low-z optical photometric set.

2MASS

tengri.Instrument.TWOMASS()

3

2MASS JHKs near-infrared.

UKIDSS

tengri.Instrument.UKIDSS()

5

UKIDSS ZYJHK near-infrared.

WISE

tengri.Instrument.WISE()

4

WISE W1–W4 mid-IR.

Spitzer_IRAC

tengri.Instrument.SPITZER_IRAC()

4

Spitzer IRAC 3.6/4.5/5.8/8.0 µm.

Herschel

tengri.Instrument.HERSCHEL()

5

Herschel PACS 100/160 + SPIRE 250/350/500 µm.

HST_ACS_WFC3

tengri.Instrument.HST_ACS_WFC3()

9

HST ACS optical + WFC3 NIR; the workhorse high-z imaging set.

JWST_NIRCam

tengri.Instrument.JWST_NIRCam()

8

JWST NIRCam wide bands (F070W–F444W); the canonical JADES/CEERS set.

filters

tengri.list_filters()

459 entries — too many to print here. Call tengri.list_filters() for the full table, or narrow it, e.g. tengri.list_filters().filter(survey='SDSS').

plots

tengri.list_plots()

name

status

short_doc

use

plot_sed_fit

production

Plot observed photometry/spectrum + posterior SED + uncertainty band

tengri.plot.plot_sed_fit(wave_eff, flux_obs, noise)

plot_spectrum_fit

production

Plot spectrum + posterior model with calibration polynomial

tengri.plot.plot_spectrum_fit(wave_obs, spec_obs, noise)

plot_sfh

production

Plot single SFH(t) curve from a Parameters / Posterior

tengri.plot.plot_sfh(model, posterior)

plot_sfh_comparison

production

Overlay multiple SFH(t) curves (e.g. truth vs posterior)

tengri.plot.plot_sfh_comparison(model, results)

plot_corner_comparison

production

Two-posterior corner plot (e.g. with truth)

tengri.plot.plot_corner_comparison(posteriors, labels)

safe_corner

production

Corner plot wrapper that handles fixed parameters gracefully

tengri.plot.safe_corner(posterior)

plot_1d_posterior

production

Marginal histogram of one parameter + median/16/84

tengri.plot.plot_1d_posterior(posterior, param_name)

plot_calibration

production

Chebyshev calibration polynomial with 16/84 band

tengri.plot.plot_calibration(posterior)

setup_style

production

Apply tengri matplotlib style (serif, tight, 150 dpi)

tengri.plot.setup_style()

diagnostics_table

production

ESS / R-hat / divergences table for sampling diagnostics

tengri.plot.diagnostics_table(results)