Grid Flux Units¶
A grid stores one of three kinds of flux:
- Surface flux, \(F_\lambda\)
erg s-1 cm-2 Å-1, the flux leaving the stellar surface. The flux observed at distance \(d\) from a star of radius \(R\) is \(F_\lambda (R/d)^2\).
- Luminosity density, \(L_\lambda = 4 \pi R^2 F_\lambda\)
erg s-1 Å-1. The observed flux is \(L_\lambda / (4 \pi d^2)\). The radius is then fixed for each model by the grid.
- Continuum-normalized flux
Dimensionless. It has no absolute flux scale.
The flux_unit entry of the grid metadata should say which, but for many
grids it does not (see Reliability of the flux unit label). Check a grid
with check_flux_scale before using it for absolute fluxes.
Operations that need absolute fluxes¶
DistanceDivides the flux by \(4 \pi d^2\), which is correct only for luminosity density. With a grid labeled as surface flux it stops with a
UnitConversionError. With a grid of surface flux labeled as luminosity density it runs, but the flux it returns is too low by \(4 \pi R^2\), with \(R\) in cm: 57.0 mag for \(R = R_\odot\).PhotometryComputes magnitudes assuming that the flux is in erg s-1 cm-2 Å-1 at the observer. Without a scaling to the observer, the magnitudes of a surface-flux grid are those of the stellar surface. Colors do not depend on the flux scale.
RelativePhotometryLikelihoodCompares magnitudes, so it needs absolute fluxes.
PhotometryColorLikelihoodcompares colors and does not.
Spectral fits that normalize the model to the observed spectrum
(normalize_npol in assemble_model) do not depend on the flux scale.
Reliability of the flux unit label¶
From December 2017 (commit ff2c6dc) to January 2025 (commit 8c5fc1f), StarKit labeled every grid it wrote
erg/s/angstrom, whatever the fluxes were. Since January 2025 it labels every griderg/s/cm^2/angstrom, also whatever the fluxes are; a grid of telluric transmission, for example, is labeled as surface flux.PHOENIX grids built with StarKit code older than 2018-10-19 (commit 5566c62) hold luminosity density: that code multiplied by \(4 \pi R^2\), with the radius
PHXREFFof each PHOENIX model. Grids built with later code hold surface flux.BOSZ grids built with code older than 2018-05-29 (commit 1e65adb) hold surface flux divided by \(\pi\); later ones hold surface flux.
The date of a grid file does not show which code built it.
Grids built outside StarKit can carry any label. A grid of continuum-normalized spectra labeled
erg/s/angstromhas been seen.
The test grid phoenix_t4000_10000_w3000_9000_r3000.h5 in
docs/examples holds surface flux and is labeled erg/s/angstrom.
Checking a grid¶
check_flux_scale integrates a few model spectra of a grid over its
wavelength range and divides the result by the integral of the surface flux
of a blackbody at the same effective temperature,
\(\pi B_\lambda(T_\mathrm{eff})\). It reads only the spectra it checks,
by default three spread from the lowest to the highest
\(T_\mathrm{eff}\) of the grid:
>>> from starkit.gridkit.flux_check import (check_flux_scale,
... format_flux_scale_check)
>>> check = check_flux_scale('phoenix_t4000_10000_w3000_9000_r3000.h5')
>>> print(format_flux_scale_check(check))
Grid: phoenix_t4000_10000_w3000_9000_r3000.h5
Flux unit label: erg/s/angstrom (luminosity density)
Wavelength range: 3000.0 to 8999.7 Angstrom
Grid flux / blackbody surface flux, integrated over the wavelength range:
teff=4000, logg=4, mh=-0.5: ratio 0.833, surface flux
teff=6200, logg=4, mh=-0.5: ratio 0.989, surface flux
teff=10000, logg=4, mh=-0.5: ratio 0.901, surface flux
Fluxes: surface flux
The fluxes do not agree with the flux unit label. Operations that need absolute fluxes, such as Distance and the magnitudes from Photometry, give wrong results with this grid.
The ratio is computed in the unit of the label, converted to erg s-1 cm-2 Å-1 or erg s-1 Å-1, and identifies the fluxes:
Ratio |
Fluxes |
|---|---|
0.5 to 2 |
Surface flux. |
0.2 to 0.5 |
Surface flux divided by \(\pi\). |
0.05 to 0.2 |
Eddington flux, surface flux divided by \(4 \pi\). |
above \(10^{15}\) |
Luminosity density; the ratio is \(4 \pi R^2\) in cm2, and the report gives the implied radius \(R\), which is about 6 × 1022 cm2 for \(R_\odot\). |
any, with a median flux between 0.3 and 1.5 and no flux above 2 |
Continuum-normalized. |
Model spectra differ from a blackbody by tens of percent, more so over a
narrow wavelength range: for the surface-flux grids checked so far the
ratios were 0.75 to 1.38, and for grids of surface flux divided by
\(\pi\) 0.23 to 0.44. A model with non-finite or negative fluxes is reported as invalid and is
not used to classify the grid. check.models holds the ratio and the
interpretation of each model checked, check.interpretation the result for
the grid, and check.consistent_with_label whether it agrees with the
label (None when that cannot be decided). n_models sets the number of
models checked, and teff_column the index column that holds
\(T_\mathrm{eff}\).
Absolute fluxes from a surface-flux grid¶
StarKit has no operation with a radius parameter yet. A surface flux can be
scaled to the observer with astropy’s Scale model, applied to the flux
output while the wavelengths pass through Identity:
>>> import numpy as np
>>> from astropy import units as u
>>> from astropy.modeling.models import Identity, Scale
>>> from starkit import assemble_model
>>> from starkit.gridkit import load_grid
>>> grid = load_grid('phoenix_t4000_10000_w3000_9000_r3000.h5',
... wavelength_type='vacuum')
>>> grid.teff, grid.logg, grid.mh = 5780., 4.4, 0.0
>>> radius, distance = 1.0 * u.R_sun, 10 * u.pc
>>> dilution = Scale(float((radius / distance).to(1) ** 2))
>>> model = assemble_model(grid, vrad=0.) | (Identity(1) & dilution)
>>> model.param_names
('teff_0', 'logg_0', 'mh_0', 'vrad_1', 'factor_3')
>>> wavelength, flux = model()
>>> float(np.interp(5500., wavelength, flux))
4.376138505982197e-11
For the Sun at 10 pc, this is 4.38 × 10-11 erg s-1 cm-2 Å-1 at 5500 Å, about V = 4.8 with a V-band zero point of 3.6 × 10-9 erg s-1 cm-2 Å-1; the absolute V magnitude of the Sun is 4.81. The factor \((R/d)^2\) is a parameter of the model, but \(R\) and \(d\) cannot be fitted separately from it.