Learn to Use TauREx3
We have gathered the best TauREx3 tutorials for you.
Where to obtain input data
The results of TauREx3 models relies on high-quality input data. These datasets are not bundled with the code and must be obtained externally. TauREx3 is compatible with most dataformat used in the community. Below are links to the primary sources commonly used:
Opacity and Input Data Sources
Official ExoMol Cross-sections (R=15k)
Available from the ExoMol database:
Database Website
Opacity set from Changeat 2025 (R=200k)
Data product from Changeat 2025. Includes xsec, cia, and clouds:
Zenodo Link
HITRAN Collision-Induced Absorption (CIA)
Provided by the HITRAN database:
HITRAN CIA Database
Optimized cloud optical constants for TauREx-PCQ
Available via the TauREx PCQ plugin:
Zenodo Link
⚠️ Important Notes
Data Maintenance Responsibility
The TauREx team does not maintain or distribute opacity databases or input datasets. Users are responsible for ensuring they are using the latest and most appropriate versions of line lists, cross-sections, and opacity sources.Citation Requirements
When using any of these datasets, you must cite the original sources. Additionally, clearly state:- Where the data was obtained
- The version or release used
- Any preprocessing steps applied
Tutorials and Learning Resources
We provide a collection of tutorials to help you get started with TauREx3, from beginner guides to advanced deployment strategies.
📘 Official Documentation
TauREx3 Documentation
https://taurex3.readthedocs.io/en/latest/
The official documentation is the most comprehensive resource available.
What you will find in the documentation
- Installation instructions
- Detailed explanations of model components
- Plugin development guides
- API references
This should be your primary reference when working with TauREx.
🚀 Interactive Tutorial (Google Colab)
TauREx3 Colab Notebook
https://colab.research.google.com/drive/1RppsquYSrQeHdmjDrwgjrO7DuyQTgJ6O?usp=sharing
Run TauREx directly in your browser with no installation required.
Why use this tutorial?
- Ideal for first-time users
- No setup required
- Quickly explore retrieval workflows
- Test configurations interactively
🌱 First Use Tutorial
Getting Started with TauREx
https://taurex.space/blog/learning_taurex/
A beginner-friendly introduction to TauREx.
What this tutorial covers
- Basic concepts of atmospheric retrievals
- Setting up your first TauREx run
- Understanding inputs and outputs
Perfect if you’re new to the field.
🖥️ HPC Deployment Tutorial
TauREx on High-Performance Computing Systems
https://github.com/Mael-Voyer/TauREx-tutorial
Learn how to run TauREx efficiently on HPC clusters.
Topics included
- Job submission workflows
- Parallel execution strategies
- Scaling to large datasets
- Best practices for cluster environments
⚡ GPU Acceleration Tutorial
Using TauREx with GPUs (CuPy support)
https://taurex.space/blog/taurex_cupy/
Accelerate your computations using GPU hardware.
What you will learn
- Setting up GPU environments
- Using CuPy with TauREx
- Performance improvements and benchmarks
Ideal for reducing computation time in large retrievals.
📘 TauREx Playground
TauREx3 collection of playground examples
https://github.com/ucl-exoplanets/taurex-playground
A collection of notebooks, scripts and tools to help you get started with TauREx.
What you will find here
- TauREx Modelling notebook
- TauREx Retrieval notebook
- TauREx Cupy notebook
- Setup for standard HPCs
This should get you started quickly with TauREx in notebooks.
🧪 Conference Practical Tutorial (Exosystèmes II)
Self-contained TauREx Hands-on Practical (2h session)
https://quentchangeat.github.io/teaching/
A hands-on tutorial originally delivered during the Exosystèmes II conference.
What this tutorial includes
- Installation guidance
- Use of Jupyter notebooks
- Configuration via parameter files (parfiles)
- First steps in running atmospheric retrievals
This material is slightly outdated but still provides a very practical and structured introduction to TauREx workflows. Low resolutions opacity sources are also included to ensure a smooth experience
Note: do not use low res cross-sections for production or article-ready runs.
TauREx is designed for flexibility, speed, and precision. Whether you’re just starting or scaling up to large retrieval campaigns, these resources will help you make the most of the framework.