Welcome to ExoSim 2’s documentation!#

ExoSim 2 is an end-to-end, time-domain simulator for exoplanet observations from space telescopes, ground-based observatories, and sub-orbital platforms. It models the full observation chain – astronomical sources, instrument optics, dispersers, detector arrays, and readout electronics – reproducing both the astrophysical signal and the instrumental systematics. Written in Python 3 with a modular, object-oriented design, almost every component can be replaced with a custom implementation without rewriting the rest of the pipeline.

This guide walks through the simulation steps with worked examples and explains how to configure ExoSim 2 for the instrument you want to model.

Installation
_images/install.png
Installation & updates
User Guide
_images/user.png
User guide
Developer Guide
_images/developers.png
Developer guide
API Guide
_images/api.png
exosim
FAQs
_images/faqs.png
FAQs
License
_images/license.png
ExoSim License
Changelog
_images/changelog.png
Changelog

Warning

This documentation is not complete yet. If you find any issue or difficulty, please contact the developers for help.

What can ExoSim 2 do?#

  • Radiometric modelling – fast estimates of signal and noise budgets, aperture photometry, saturation analysis, and multiaccum readout factors for performance prediction and observing-time calculations.

  • Full time-domain simulation – focal-plane evolution, sub-exposures with pointing jitter, and realistic detector readouts (NDRs) to test data reduction pipelines against a known truth.

  • Comprehensive noise budget – photon noise, read noise, dark current, and user-defined noise sources with realistic detector behaviour.

  • Low-frequency systematics – pointing jitter, thermal fluctuations, and detector drifts captured across the full observation timescale.

  • Multi-instrument support – configured out of the box for the Ariel space mission, with community-contributed configurations for JWST and ground-based spectrographs.

  • Flexible configuration and outputs – XML and YAML parameter files with inheritance and full unit handling via Astropy, and structured, self-documenting HDF5 outputs.

Who should use ExoSim 2?#

Mission planners and instrument scientists exploring design trade-offs before hardware is built; observers estimating signal-to-noise ratios and feasibility before proposal submission; data-pipeline developers validating reduction algorithms against known-truth synthetic data; and students gaining hands-on experience of realistic observation scenarios without needing telescope time.

Cite#

If you use this software please cite:

Mugnai et al., 2025, “ExoSim 2: the new exoplanet observation simulator applied to the Ariel space mission”, Exp. Astron, 59, 9. DOI:10.1007/s10686-024-09976-2.

Acknowledgments#

ExoSim 2 has been developed under the umbrella of Ariel Space Mission, with the support of the Ariel Consortium and the members of the Simulator Software, Management and Documentation (S2MD) Working Group.

_images/ariel.png _images/S2MD.png

During the development of the first alpha and beta versions of this software, L. V. Mugnai was affiliated to Sapienza University of Rome and supported by ASI.

We thank Ahmed Al-Refaie for his support during the development and the inspiration provided by his code: TauREx3 .

We believe that our work does not conflict with the legitimate interests of the creator of the artistic icons.

We also edited some of the icon to fit our needs.