Includes:
- A routine to generate single reflection and emission spectrum with and without noise and errorbars;
- A routine to generate datasets of reflection/emission spectra using Sobol or random sequencing;
- A retrieval routine based on nested sampling (i.e. MultiNest).
- Mario Damiano (Jet Propulsion Laboratory, California Institute of Technology)
- Renyu Hu (Penn State University)
- Armen Tokadjian (Jet Propulsion Laboratory, California Institute of Technology)
- Zachary Burr (ETH Zurich - Jet Propulsion Laboratory, California Institute of Technology)
Navigate to the desired location for the ExoReL folder. Therefore clone the code via git:
git clone https://github.com/MDamiano/ExoReL.git
Navigate into the downloaded ExoReL folder. Activate yout preferred python environment. Install python packages dependency:
pip install -r requirements.txt
Do not forget to make the folder reachable by python in your .bash_profile or .bashrc depending on your system
export PYTHONPATH="$PYTHONPATH:/full/path/of/folder/containing/ExoReL:"
After installation, upon the first import of the package, ExoReL will automaticaly download required files from GDrive. It generally teke less than a minute.
It will download the folders "PHO_STELLAR_MODEL" and "forward_mod" from the following link : Google Drive. The required folders will be placed inside the ExoReL folder.
You have to prepare the "retrieval_example.dat" and "forward_example.dat" parameters files before running ExoReL.
You can generate a transmission spectrum by typing in a python instance or script.py file the following lines:
import ExoReL
spec = ExoReL.CREATE_SPECTRUM()
spec.run_forward('forward_example.dat')
You can run a retrieval by typing in a python instance or script.py file the following lines:
import ExoReL
ret = ExoReL.RETRIEVAL()
ret.run_retrieval('retrieval_example.json')
To run the retrieval mode you need to have the MultiNest libraries installed in your system as well as pymultinest (v2.11).
pymultinest is MPI compatible, therefore, you can run ExoReL to perform the sampling of the retrieval in parallel (you will need to install mpi4py):
mpirun -np 10 python exorel_retrieval.py
The plotting of the retrieval results can be automatic when chosen in the input parameter file and will produce the following graphs:
- Chemistry of the atmosphere versus the atmospheric pressure;
- Mean molecular mass versus the atmospheric pressure;
- The input spectral data and the best fit model calculated by the Bayesian sampling;
- The spectral contribution plot;
- The traces of the fitted free parameters;
- The posterior distribution corner plot;
- Expected log-pointwise probability (elpd) statistics abd leave-one-out (loo) analysis.
In case pymultinest finds multiple solutions, ExoReL will automatically plot the aforementioned graphs for each of the solutions.
- Hu 2019, Information in the Reflected-light Spectra of Widely Separated Giant Exoplanets, ApJ, 887, 166.
- Damiano & Hu 2020, ExoReLR: A Bayesian Inverse Retrieval Framework for Exoplanetary Reflected Light Spectra, AJ, 159, 175.
- Damiano et al. 2020, Multi-orbital-phase and Multiband Characterization of Exoplanetary Atmospheres with Reflected Light Spectra, AJ, 160, 206.
- Damiano & Hu 2021, Reflected Spectroscopy of Small Exoplanets I: Determining the Atmospheric Composition of Sub-Neptunes Planets, AJ, 162, 200.
- Damiano & Hu 2022, Reflected Spectroscopy of Small Exoplanets II: Characterization of Terrestrial Exoplanets, AJ, 163, 299.
- Damiano et al. 2023, Reflected Spectroscopy of Small Exoplanets III: probing the UV band to measure biosignature gasses, AJ, 166, 157.
- Tokadjian et al. 2024, The Detectability of CH4/CO2/CO and N2O Biosignatures Through Reflection Spectroscopy of Terrestrial Exoplanets, AJ, 168, 292.
- Damiano et al. 2025, Effects of planetary mass uncertainties on the interpretation of the reflectance spectra of Earth-like exoplanets, AJ, 169, 97.
The research was carried out at the Jet Propulsion Laboratory, California Institute of Technology, under a contract with the National Aeronautics and Space Administration (80NM0018D0004). The High Performance Computing resources used in this investigation were provided by funding from the JPL Information and Technology Solutions Directorate.
Copyright © 2026, by the California Institute of Technology. ALL RIGHTS RESERVED. United States Government Sponsorship acknowledged. Any commercial use must be negotiated with the Office of Technology Transfer at the California Institute of Technology.
This software may be subject to U.S. export control laws. By accepting this software, the user agrees to comply with all applicable U.S. export laws and regulations. User has the responsibility to obtain export licenses, or other export authority as may be required before exporting such information to foreign countries or providing access to foreign persons.
Licensed under the Apache License, Version 2.0 (the "Licence"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Please refer to the CITATION file. It contains the specific citations to reference the ExoReL framework in your publication.
For any issues and bugs please send an e-mail at mario.damiano@jpl.nasa.gov, or submit an issue through the GitHub system.