Welcome to the gammaALPs documentation!
gammaALPs is a python package that calculates the oscillation probability between photons and axion-like particles (ALPs) in various astrophysical environments. The focus lies on environments relevant to mixing between gamma rays and ALPs but it can be used for broader applications. The code also implements various models of astrophysical magnetic fields, which can be useful for applications beyond ALP searches.
You also might find the gammaALPsPlot Package useful which aims to facilitate creating plots of the ALP parameter space.
Getting Started
For installing the code, please see the Installation page.
If you want a quick start, take a look at the Tutorials.
Background on how the photon-ALP mixing is calculated is provided on the Photon-ALP conversion probability page. The core modules that are required to run the photon-ALP oscillation computation are described in more detail on the Core Modules page. The page Implemented Astrophysical Environments provides information on the available astrophysical environments which combine magnetic field models described in the Magnetic Field Models section and electron densities described on the Electron Density Models pages.
Getting Help
If you encounter problems or if you have suggestions, please open a GitHub Issue.
Documentation Contents
- Installation
- Tutorials
- Calculate photon-ALP mixing in different environments
- Mixing in a homogeneous magnetic field
- Mixing in Gaussian turbulence field: Perseus cluster and from NGC 1275
- Mixing in the intergalactic magnetic field (IGMF)
- Mixing in AGN jet with simple toroidal magnetic field
- Mixing in the AGN jet with helical and tangled component
- Mixing in the magnetic field of the Milky Way
- Additional features for magnetic-field environments
- Calculate photon-ALP mixing in different environments
- References
- Photon-ALP conversion probability
- Core Modules
- Implemented Astrophysical Environments
- Magnetic Field Models
- Electron Density Models