RAiSE: simulation-based analytical model of AGN jets and lobes

Radio AGN in Semi-Analytic Environments (RAiSE) model for the expansion and evolution of the jets and lobes emanating from extraglactic supermassive black holes. The RAiSE HD (hydrodynamics) version of this model adapts Lagrangian particles from a hydrodynamical simulation to the dynamics from the analytical theory, yielding a physically-based magnetic field structure on both large and local scales. This code release enables the user to generate radio-frequency and X-ray wavelength surface brigtness images of Fanaroff-Riley Type-II radio AGNs across their evolutionary history, including for the jet, active lobe and remnant lobe. Parallised code can be run to generate a catalogue of mock radio AGNs to, for example: run parameter inversions to measure the energetics of observed objects; or produce high-resolution animations for data visualisations. The code is written in Python 2/3 and has detailed documentation and worked examples available on GitHub (https://github.com/rossjturner/RAiSEHD).

Installation

This package can either be installed using pip or from a .zip file downloaded from the GitHub repository using the standard Python package distutils.

Install using pip

The following command will install the latest version of the RAiSE HD code from the Python Packaging Index (PyPI):

pip install RAiSEHD

Install from GitHub repository

The package can be downloaded from the GitHub repository at https://github.com/rossjturner/RAiSEHD, or cloned with git using:

git clone https://github.com/rossjturner/RAiSEHD.git

The package is installed by running the following command as an administrative user:

python setup.py install

Documentation and Examples

Full documentation of the functions included in the RAiSE HD package, in addition to worked examples, is included in RAiSEHD_user.pdf on the GitHub repository. The worked examples are additionally included in the following Jupyter notebook: RAiSEHD_example.ipynb.

Contact

Ross Turner <turner.rj@icloud.com>