Eureka Logo

Welcome to Eureka!’s documentation!

Eureka! is a data reduction and analysis pipeline for exoplanet time-series observations, with a particular focus on James Webb Space Telescope (JWST) data. Eureka! is capable of of reducing JWST time-series data (starting from raw, uncalibrated FITS files) and turning it into precise exoplanet transmission and emission spectra. At the moment the package is under heavy development. The code is not officially associated with JWST or the ERS team.

The code is broken down into six parts or “Stages”, which are as follows (see also Eureka!’s Stages):

  • Stage 1: An optional step that calibrates raw data (converts ramps to slopes for JWST observations). This step can be skipped within Eureka! if you would rather use the Stage 1 outputs from the jwst pipeline.

  • Stage 2: An optional step that further calibrates Stage 1 data (performs flat-fielding, unit conversion, etc. for JWST observations). This step can be skipped within Eureka! if you would rather use the Stage 2 outputs from the jwst pipeline.

  • Stage 3: Using Stage 2 outputs, performs background subtraction and optimal spectral extraction. For spectroscopic observations, this stage generates a time series of 1D spectra. For photometric observations, this stage generates a single light curve of flux versus time.

  • Stage 4: Using Stage 3 outputs, generates spectroscopic light curves by binning the time series of 1D spectra along the wavelength axis. Optionally removes drift/jitter along the dispersion direction and/or sigma clips outliers.

  • Stage 5: Fits the light curves with noise and astrophysical models using different optimization or sampling algorithms.

  • Stage 6: Displays the planet spectrum in figure and table form using results from the Stage 5 fits.

The full code for Eureka! is available on GitHub.

Citing Eureka!

If you wish to cite the use of Eureka! in published work, please use the following citation to the JOSS paper.

@ARTICLE{Bell2022,
      author = {{Bell}, Taylor J. and {Ahrer}, Eva-Maria and {Brande}, Jonathan and {Carter}, Aarynn L. and {Feinstein}, Adina D. and {Guzman Caloca}, Giannina and {Mansfield}, Megan and {Zieba}, Sebastian and {Piaulet}, Caroline and {Benneke}, Bj{\"o}rn and {Filippazzo}, Joseph and {May}, Erin M. and {Roy}, Pierre-Alexis and {Kreidberg}, Laura and {Stevenson}, Kevin B.},
        title = "{Eureka!: An End-to-End Pipeline for JWST Time-Series Observations}",
      journal = {arXiv e-prints},
    keywords = {Astrophysics - Instrumentation and Methods for Astrophysics, Astrophysics - Earth and Planetary Astrophysics},
        year = 2022,
        month = jul,
          eid = {arXiv:2207.03585},
        pages = {arXiv:2207.03585},
archivePrefix = {arXiv},
      eprint = {2207.03585},
primaryClass = {astro-ph.IM},
      adsurl = {https://ui.adsabs.harvard.edu/abs/2022arXiv220703585B},
      adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

Contents:

Indices and tables