Examples gallery¶

120+ standalone scripts demonstrating tengri’s physics components, fitting workflows, and end-to-end use cases. Each card below links to a per-script page with the rendered figure, the full source, and a downloadable Jupyter notebook.

Browse by category. Cards are organised into sections — quickstart and workflows for end-to-end recipes, physics components for one-knob sweeps, inference for fitter behaviour, and use cases for paper-style figures.

How to run an example locally¶

Each script is a normal Python program:

python examples/quickstart/plot_first_fit.py

Most physics examples (dust curves, SFH shapes, AGN spectra) need only tengri’s core dependencies. Fitting examples additionally require an SSP grid — fetch one with:

import tengri
tengri.download_ssp()  # default fsps_prsc_miles_chabrier; see list_known_ssps()

Advanced Topics¶

Hierarchical inference, gradient sensitivity, batch fitting, panchromatic SED with radio and X-ray components, and joint photometry + spectroscopy fitting.

Age-Dust-Metallicity Degeneracy: Fisher Analysis

Gradient Sensitivity Heatmap

Hierarchical PSD Inference

Joint Photometry + Spectroscopy Fit

Component orchestrator end-to-end

Panchromatic SED: UV to Radio

AGN Models¶

AGN disc and torus SED templates.

X-ray Corona: Spectral Index vs Bolometric Luminosity 2D Sweep

SKIRTOR Torus: Viewing Angle Sweep

AGN SEDModel Hierarchy

QSOgen Disc Continuum: Bolometric Luminosity

SKIRTOR Torus: Opening Angle Sweep

Polar Dust: Temperature Sweep in AGN Torus

QSOgen Dust Reddening: Intrinsic AGN Obscuration

QSOgen Emission Line Scaling: Rest-UV to Optical SED

SKIRTOR Torus: Radial Dust Power-Law Sweep

SKIRTOR Torus: Optical Depth Sweep

AGN SED Templates

Type 1 vs Type 2 AGN: Geometric Unification

Narrow and Broad Line Region Emission

Polar Dust in AGN: IR Bump from Polar Dust Torus

QSOgen Empirical Quasar Template

RELAGN Spin Sweep

SKIRTOR Clumpy Torus: Inclination and Optical Depth

Torus Models Comparison: Nenkova vs Silva04

Hensley & Draine 2023 Astrodust+PAH¶

Reproductions of every figure from the upstream brandonshensley/Astrodust/notebooks/model_file_tutorial.ipynb notebook, using tengri’s DustEmissionSEDComponent (template "astrodust") and the canonical FITS file at doi:10.7910/DVN/3B6E6S.

Build the data with:

python scripts/build_astrodust_hdf5.py --output data/astrodust_templates.h5 --download

Reference: Hensley & Draine 2023, ApJ 948, 55 (arXiv:2208.12365).

Astrodust+PAH size distribution

Astrodust+PAH emission vs log U

Astrodust+PAH per-component decomposition

DustEmissionSEDComponent — swap MBB / PAHspec / Astrodust

Astrodust+PAH ionization fraction and alignment

Astrodust+PAH extinction, scattering, and albedo

Astrodust+PAH spinning-dust microwave emission

Astrodust+PAH polarized emission and polarization fraction

Dust Models¶

Attenuation laws, two-component dust, and IR emission.

Hensley & Draine 2023 Astrodust+PAH: log U sweep

Attenuation Law Comparison

BOSA: log L_TIR sweep at fixed log sSFR

BOSA: log sSFR sweep at fixed log L_TIR

Modified Blackbody Dust Temperature

Dust Attenuation Curves

Dust Emission Models: Overview

Dust Geometry: Screen vs Mixed vs Clumpy

Dust IR SED: q_PAH × U_min Grid

Attenuation Curve Slope (δ)

Draine+2021 PAHspec: log U sweep at fixed (starlight, ion, size)

Draine+2021 PAHspec: starlight-spectrum sweep at fixed log U

PAH Mass Fraction (q_PAH)

Birth Cloud Optical Depth (τ_BC)

Diffuse ISM Optical Depth (τ_diff)

THEMIS: q_HAC sweep at fixed U_min

THEMIS: U_min sweep at fixed q_HAC

Two-Component Dust SEDModel

Draine & Li Minimum Radiation Field (U_min)

UV Bump Strength (dust_bump_strength)

IGM¶

Intergalactic medium absorption and Lyman-forest effects on observed SEDs.

Damped Lyman-Alpha (DLA) Absorption

IGM Transmission Model Comparison

IGM Transmission vs Redshift

IGM Absorption Evolution with Redshift

Inference Methods¶

Comparing inference methods and convergence diagnostics.

Convergence Diagnostics

Corner Plot with Truth Overlay

Population PSD Recovery: 1/√N Convergence

MAP vs geoVI Posterior Comparison

Population VI scaling: time, memory, and convergence

Prior vs Posterior: Parameter Constraints from Inference

Metallicity¶

Stellar metallicity Z and α-element enhancement effects on the SED.

α/Fe Enhancement (met_alpha_fe)

Metallicity Sweep: Panchromatic SED

Stellar Metallicity (log Z/Z_⊙)

Stellar Continuum: Metallicity × Age Grid

Chemical Evolution: Model Comparison

Multiwavelength¶

Panchromatic SED examples spanning X-ray to radio.

These short scripts complement the main tutorial notebooks — each produces a single figure. For full narrative walkthroughs, see the notebooks/ spine.