SSP Library Shootout: Comparing Spectral Predictions at 5 Gyr, Z=0

Stellar population synthesis templates differ across stellar evolution codes and isochrone libraries, producing measurable offsets in predicted spectra even at fixed age and metallicity. This gallery script loads four representative SSP libraries shipped with tengri (BC03, FSPS MILES, FSPS C3K, BPASS, ProGeny), constructs minimal SEDModel instances at age = 5 Gyr and Z = 0 (solar), and overlays rest-frame SED predictions (νL_ν) on log-log axes to reveal template-dependent uncertainties and continuum shape differences.

References:

  • Bruzual & Charlot 2003 (BC03): ApJ 405, 538

  • Conroy et al. 2009 (FSPS): ApJ 699, 486

  • Vazdekis et al. 2010 (MILES): MNRAS 404, 1639

plot ssp library shootout
import os

os.environ["TF_CPP_MIN_LOG_LEVEL"] = "2"  # suppress XLA/PjRt C++ INFO+WARNING logs

import warnings

import matplotlib.pyplot as plt
import numpy as np

import tengri
from tengri.plot import setup_style

setup_style()
warnings.filterwarnings("ignore", message=".*BakedInBackend.*")

# Representative subset of shipped SSP libraries: BC03, FSPS (MILES + C3K), BPASS, ProGeny
ssp_names = [
    "bc03_pdva_stelib_chabrier",  # BC03 with Padova 1994 isochrones
    "fsps_prsc_miles_chabrier",  # FSPS + Padova 2000 + MILES library
    "fsps_mist_c3k_a_chabrier",  # FSPS + MIST + C3K
    "bpss_stars_c3k_a_chabrier",  # BPASS binary star synthesis
    "pgny_mist_c3k_chabrier",  # ProGeny + MIST
]

# Target age (Gyr) for cross-section and Z (log10 absolute)
target_age_gyr = 5.0
target_log10_z = 0.0  # solar

# Load SSPs, extract rest-frame SED at fixed age/Z for each
colors = plt.cm.tab10(np.linspace(0, 0.9, len(ssp_names)))
fig, ax = plt.subplots(figsize=(6.5, 4.5))

plotted = 0
first_failure: Exception | None = None

for ssp_name, color in zip(ssp_names, colors):
    try:
        # Load SSP library
        # Only the spectra are plotted and the surviving mass is not used, so every
        # grid takes the explicit DSPS fit for its surviving mass.
        ssp = tengri.load_ssp(ssp_name, mass_remaining="dsps_fit")

        # Extract wavelength grid (rest-frame, Angstrom)
        wave = np.array(ssp.ssp_wave)

        # Find nearest age and metallicity grid points
        age_gyr = 10.0 ** np.array(ssp.ssp_lg_age_gyr)
        log_z = np.array(ssp.ssp_lgmet)

        age_idx = np.argmin(np.abs(age_gyr - target_age_gyr))
        z_idx = np.argmin(np.abs(log_z - target_log10_z))

        # Extract SSP flux at (age, Z) — shape (n_wave,)
        # ssp.ssp_flux has shape (n_met, n_age, n_wave)
        flux = np.array(ssp.ssp_flux[z_idx, age_idx, :])

        # Compute νL_ν = λ × F_λ (rest-frame, erg/s/Hz)
        nu_lnu = wave * flux

        # Normalize to max for comparison of continuum shapes
        nu_lnu_norm = nu_lnu / np.nanmax(nu_lnu)

        # Trim to valid range (avoid NaNs, negatives)
        mask = (nu_lnu_norm > 0) & np.isfinite(nu_lnu_norm)
        ax.loglog(
            (wave[mask] / 1e4),
            nu_lnu_norm[mask],
            lw=1.5,
            color=color,
            label=ssp_name.replace("_chabrier", "").replace("_", " "),
        )
        plotted += 1

    except Exception as e:
        # Was `except (FileNotFoundError, Exception)` with a bare `pass`. The
        # tuple's second member subsumes the first, so this caught every error
        # in a ~30-line body — the grid lookup, the normalization, the plot call
        # — and discarded all of them.
        if first_failure is None:
            first_failure = e

if plotted == 0:
    raise RuntimeError(
        f"none of the {len(ssp_names)} SSP libraries produced a curve, so the "
        f"shootout is empty. First failure: "
        f"{type(first_failure).__name__}: {first_failure}"
    ) from first_failure

ax.set_xlim(0.05, 5.0)
ax.set_ylim(1e-3, 2.0)
ax.set_xlabel(r"Rest-frame wavelength $\lambda$ [$\mu$m]")
ax.set_ylabel(r"$\nu L_\nu$ (peak-normalized)")

ax.legend(fontsize=7.5, frameon=False, loc="lower right", ncol=1)

fig.tight_layout()
plt.savefig("plot_ssp_library_shootout.png", dpi=150, bbox_inches="tight")

Gallery generated by Sphinx-Gallery