uvex_transients.utils.plotting.plot_band_light_curve#

uvex_transients.utils.plotting.plot_band_light_curve(ax: Axes, band: str, t_obs: Quantity, phot, *, t_theory: Quantity | None = None, theory_mag: Quantity | NDArray | None = None, snr_threshold: float = 5.0, color: str | None = None, err_scale: float = 1.0, marker: str = 's', label: str | None = None) → None[source]#

Draw one photometric band’s theory curve, SNR-detected points, and upper limits onto ax.

This is the light-curve convention shared by every simulated-photometry gallery example: a faint, semi-transparent noiseless theory curve; SNR-detected visits as filled points with symmetric error bars; and fainter visits as downward-pointing open upper limits, from a ~uvex_transients.models.core.base.SpectralModel.simulate_photometry table’s asymmetric mag_lower/mag_upper bounds.

Parameters:

  • ax (matplotlib.axes.Axes) – Axes to draw onto.

  • band (str) – Band name to select from phot’s "band" column, and (absent an explicit color) to look up via get_band_color.

  • t_obs (astropy.units.Quantity) – Observation times, one per row of phot (not necessarily a column of phot itself, e.g. a precomputed “time since explosion”).

  • phot (astropy.table.Table) – A ~uvex_transients.models.core.base.SpectralModel.simulate_photometry-style table with "band", "ab_mag", "snr", and "mag_err" columns; "mag_lower"/"mag_upper" are used for upper limits when present, and upper limits are skipped otherwise.

  • t_theory (astropy.units.Quantity, optional) – Time grid for the noiseless theory curve. Both t_theory and theory_mag must be given to draw it; the curve is omitted otherwise.

  • theory_mag (astropy.units.Quantity or array-like, optional) – Noiseless AB magnitude at t_theory.

  • snr_threshold (float, optional) – SNR above which a visit is drawn as a detection rather than an upper limit. The default is 5.0.

  • color (str, optional) – Overrides get_band_color(band).

  • err_scale (float, optional) – Multiplicative factor applied to phot["mag_err"] for detected points’ error bars (some galleries plot a wider, more conservative bar than the raw 1-sigma value). The default is 1.0.

  • marker (str, optional) – Marker for detected points. The default is "s".

  • label (str, optional) – Legend label for the detected points (upper limits are always unlabeled, since they share the detection’s color and would otherwise duplicate its legend entry).