TransitionListener

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

TransitionListener

★ 13 Open GitHub ↗

TransitionListener is a python code for computing the gravitational wave background produced in cosmological phase transitions.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# TransitionListener

A framework for analyzing cosmological first-order phase transitions and their gravitational wave signatures.

---

---

## Overview

**TransitionListener** is an open-source Python package designed to compute, analyze, and visualize **first-order phase transitions** and their resulting **stochastic gravitational wave backgrounds**. It implements a full thermal history from microphysical parameters to observable signals, combining precision in the thermodynamic description of the primordial plasma with a large range of possibilities for parameter scans and automatically generated plots. TransitionListener bridges theoretical particle physics and gravitational wave phenomenology, enabling robust parameter inference across twelve orders of magnitude in gravitational wave frequencies.

Please refer to our online manual at [https://tasillo.de/TransitionListener/](https://tasillo.de/TransitionListener/) for detailed information on the installation and implementation details.

---
## Key Features
Our code in version 2 is extends C. Wainwright's ```CosmoTransitions``` (see ```arxiv:1109.4189```) and its original version 1 (used in ```arxiv:2109.06208```) in multiple ways:
- **Precision percolation computation** with self-consistent iteration over the Hubble rate and the true-vacuum fraction
- **Consistent treatment of the transition speed** and the mean bubble separation.  
- **Bubble wall velocity** modeling in local thermal equilibrium based on Ai et al.'s ```arxiv:2303.10171```
- **State-of-the-art gravitational wave spectra** including multiple source contributions, as recommended by the LISA Cosmology Working Group in ```arxiv:2403.03723```
- **Built-in sensitivity curves** for LISA, BBO, DECIGO, muAres and PTA experiments  
- **PTA log-likelihood** evaluation using ```PTArcade``` based on the ```Ceffyl``` backend.
- **UltraNest integration** for scans over large model parameter spaces using nested sampling methods.  
- **Energy density**: Evaluated self-consistently using the user-defined effective potential, going beyond the simple and often-used $\Delta V$ approximation.  
- **Stable at low temperatures** — tested up to extreme supercooling of $\alpha = 10^{10}$  
- **Robust error codes** telling the difference between numerical errors and physics reasons, indicating why a given parameter point does not yield a gravitational wave signal, even if you expected it to do so 
- **First Python code** supporting multi-Higgs potentials and SNR computation simultaneously  
- **Flexible nucleation and percolation criteria** which go far beyond the fixed $S_3/T \simeq 140$ assumption: We take the degrees of freedom of the user-defined SM extension and the amount of vacuum energy into account when checking for the nucleation and percolation of bubbles.
---

## Installation and first use

Good news: TransitionListener is very easy to install! On most machines, it is enough to just clone this repository and ```pip install``` it:

```bash
git clone https://github.com/tasicarl/TransitionListener.git
cd TransitionListener
pip install -e .
```

You're now ready to use TransitionListener on your own favourite model. Alternatively, take one of the models shipped with the package. A minimal working example is

```bash
tl -c examples/example_point.yaml
```

which reads in the YAML file shipped with the repository, computes the full phase-transition history for a benchmark point of a U(1) extension of the Standard Model, predicts the gravitational wave spectrum, and evaluates its observability with LISA, PTAs and other observatories.

More information and many more hands-on use cases of the code can be found in the manual at

[https://tasillo.de/TransitionListener/](https://tasillo.de/TransitionListener/).

## Authors
Please feel free to write us an email in case you identify any bug in the code or still need some further documentation. Enjoy!

- Jonas Matuszak (KIT, jonas.matuszak@kit.edu)
- Carlo Tasillo (IFIC Valencia, carlo.tasillo@ific.uv.es)

## Citation

If you use TransitionListener in your research, please cite the [v2 release](https://arxiv.org/abs/2605.15259) paper, the original [v1 release](https://arxiv.org/abs/2109.06208) and the underlying [```CosmoTransitions``` code](https://arxiv.org/abs/1109.4189). In case you use the LTE wall velocity approximation implemented in ```/src/transitionlistener/hydrodynamics.py```, please also cite [the corresponding work](https://arxiv.org/abs/2303.10171) of Wen-Yuan Ai, Benoit Laurent, and Jorinde van de Vis.

## License

TransitionListener is distributed under the GNU GPL v3.0 license.
You are free to use, modify, and distribute the code — provided that derivative works remain open-source under the same license and credit the original authors.
See the [LICENSE](LICENSE.txt) file for full details.

© 2026 J. Matuszak & C. Tasillo: TransitionListener v2.0 – Robust gravitational wave predictions for cosmological phase transitions.

TransitionListener

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README