src/core/missionbands.js
text
Named wavelength ranges of space-mission spectroscopic modes, for limb darkening (ldspec.js takes any
[nm, nm] range) and for the spectroscopic simulator (spectroscopy.js). No DOM.
Every entry is a TOP-HAT: the published wavelength limits of the mode and nothing else. No throughput curve
is bundled (none was downloaded for this file), so a "band" here weights every wavelength inside its limits
equally, per photon, exactly as the boxcar bands of the bundled 37-band table do. `R` is the nominal
resolving power quoted for the mode, used only as the default channel width of a simulation.
Sources of the limits
JWST: JWST User Documentation (JDox), jwst-docs.stsci.edu, instrument "Observing Modes" pages for
NIRISS SOSS, NIRSpec Bright Object Time Series, NIRCam Grism Time Series and MIRI Low Resolution
Spectroscopy. NIRCam limits are those already used by the 37-band table (src/core/ldest.js).
Ariel: Tinetti et al. 2018, Experimental Astronomy 46, 135 (doi:10.1007/s10686-018-9598-x), Table 1; the
Ariel Definition Study Report ("Red Book"), ESA/SCI(2020)1, Table 4-1.
The limb darkening table (src/data/ld_spectral.js) ends at 5500 nm. Bands that reach beyond it (MIRI LRS,
Ariel AIRS-Ch1 above 5.5 micron) are flagged by `beyondTable`; channelLimbDarkening() in spectroscopy.js
then uses the part inside, or the reddest 200 nm of the table when nothing is inside, and says so.Import: import { … } from './src/core/missionbands.js' — no DOM, runs in Node and the browser.
LD_TABLE_MAX_NM
js
const LD_TABLE_MAX_NMtext
Named wavelength ranges of space-mission spectroscopic modes, for limb darkening (ldspec.js takes any
[nm, nm] range) and for the spectroscopic simulator (spectroscopy.js). No DOM.
Every entry is a TOP-HAT: the published wavelength limits of the mode and nothing else. No throughput curve
is bundled (none was downloaded for this file), so a "band" here weights every wavelength inside its limits
equally, per photon, exactly as the boxcar bands of the bundled 37-band table do. `R` is the nominal
resolving power quoted for the mode, used only as the default channel width of a simulation.
Sources of the limits
JWST: JWST User Documentation (JDox), jwst-docs.stsci.edu, instrument "Observing Modes" pages for
NIRISS SOSS, NIRSpec Bright Object Time Series, NIRCam Grism Time Series and MIRI Low Resolution
Spectroscopy. NIRCam limits are those already used by the 37-band table (src/core/ldest.js).
Ariel: Tinetti et al. 2018, Experimental Astronomy 46, 135 (doi:10.1007/s10686-018-9598-x), Table 1; the
Ariel Definition Study Report ("Red Book"), ESA/SCI(2020)1, Table 4-1.
The limb darkening table (src/data/ld_spectral.js) ends at 5500 nm. Bands that reach beyond it (MIRI LRS,
Ariel AIRS-Ch1 above 5.5 micron) are flagged by `beyondTable`; channelLimbDarkening() in spectroscopy.js
then uses the part inside, or the reddest 200 nm of the table when nothing is inside, and says so.MISSION_BANDS
js
const MISSION_BANDStext
name -> { mission, mode, range [nm, nm], micron [um, um], R, kind: 'spectrometer' | 'photometer', note, beyondTable }bandsOf
js
const bandsOfNo description in the source.
TELESCOPES
js
const TELESCOPEStext
Telescopes for the simulator. `area` is the collecting area in m^2.
Ariel: 1.1 m x 0.73 m elliptical primary, 0.64 m^2 (Tinetti et al. 2018; Red Book section 4).
JWST: 25.4 m^2 (JDox, "JWST Telescope").
`throughput` is ONE number per telescope: the fraction of photons collected by the primary that end up as
detected electrons (optics x detector), the same at every wavelength. It is an assumption for the user to
edit, not a value taken from a mission document. `noiseFloorPpm` likewise.instrumentChannels
js
function instrumentChannels(telescope, bandNames, simR = {})text
Channels of a simulated observation: every photometer is one channel, every spectrometer band is cut into
channels of constant resolving power R = lambda / dlambda (the last channel takes what is left when it is at
least half a channel wide, otherwise it is merged into the one before).
Returns [{ name, band, lo, hi, wl (micron) }].