Scene (esc_etc.scene)

Observable scene for the ESC ETC: host star, planet, zodi, exozodi.

Planet flux model (issue #13): planet.spectrum is a spectral shape, normalized planet.deltamag magnitudes fainter than the host in planet.deltamag_band (None = the ESC sensor bandpass; a synphot filter name such as "johnson_v"; or a SpectralElement), in the host’s magnitude system, then observed through the ESC bandpass. With the default flat shape and ESC-band reference this reduces to R_host * 10**(-0.4 * deltamag). planet.mag is unused – the planet’s brightness is always host + deltamag.

Reference bands (issue #14): every magnitude carries the band it is quoted in. band is None for the ESC sensor bandpass, a synphot filter name such as "johnson_v" for catalog photometry, or a SpectralElement. Spectra are normalized in that band, then observed through the ESC bandpass. Defaults: host and exozodi in the ESC band, zodi surface brightness in Johnson V.

Backgrounds use the zodi profile file from the telescope config.

esc_etc.scene.mag_units(mag_system)[source]

Vega or AB magnitude unit for a mag_system spelling; loud otherwise.

class esc_etc.scene.SceneElement(name, spectrum, mag, mag_system='vega', deltamag=None, deltamag_band=None, band=None)[source]

Bases: _MetaHolder_

class esc_etc.scene.Scene(star, planet, zodi, exozodi)[source]

Bases: _MetaHolder_

The host star, the planet, and the zodi / exozodi backgrounds, each a SceneElement.

plot_spectra(**kw)[source]

See esc_etc.plotting.plot_spectra().

esc_etc.scene.get_scene(telescope, hoststarmag=-0.353, planetdeltamag=20.0, bg_flux=22.5, exobg_flux=21.0, mag_system='vega', background_file=None, hoststar_band=None)[source]

Build a Scene from magnitudes.

  • hoststarmag: host magnitude in hoststar_band (None = ESC band; "johnson_v" for a catalog V magnitude).

  • planetdeltamag: planet fainter than the host by this much in the ESC band (change via planet.deltamag_band).

  • bg_flux: zodi surface brightness, mag/arcsec^2 in Johnson V.

  • exobg_flux: exozodi DELTA magnitude; surface brightness is hoststarmag + exobg_flux mag/arcsec^2 in the ESC band.

  • mag_system: "vega" or "AB", applied to every magnitude above.