Running AM³ with Docker

Instead of installing it in your local environment, you can install and run AM³ with Docker, which provides platform-independent access.

Prerequisites

Before beginning, ensure you have the following installed:

Docker: Get Docker
Python 3.x: Check if Python 3.x is installed.
Python Libraries: Install matplotlib, numpy, astropy, seaborn via pip.

For the GUI, make sure to have also installed

PyGObject: PyGObject Guide
LaTeX: Ensure basic LaTeX packages are installed.

Setup and Execution

Docker on Linux

Prepare the AM3 Directory: Move AM3_ex_blazars.py, Docker_GUI, GUI_AM3.py, logo.png to the AM\(^3\) base directory.

Docker Configuration:

Grant Docker Sudo Rights:
```
sudo usermod -aG docker <username>
```
Start Docker (if necessary):
```
systemctl start docker
```
Pull Ubuntu Image:
```
docker pull ubuntu:22.04
```

Build and Run Docker Image:

Build:

docker build -f Docker_GUI -t am3_gui .

Run:

docker run -d --rm --name am3_gui am3_gui tail -f /dev/null

Launch the GUI:
```
python3 GUI_AM3.py
```

Docker on Mac

Prepare the AM3 Directory: Move AM3_ex_blazars.py, Docker_GUI, GUI_AM3.py, logo.png to the AM\(^3\) base directory.
Docker Configuration:
- Grant Docker Sudo Rights:
```
sudo usermod -aG docker <username>
```
- Start the Docker App
- Pull Ubuntu Image: For Mac Intel chip:
```
docker pull ubuntu:22.04
```
  For Mac M1/2/3 systems:
```
docker pull arm64v8/ubuntu:22.04
```

Build and Run Docker Image:

Build:

docker build -f Docker_GUI -t am3_gui .

Run:

docker run -d --rm --name am3_gui am3_gui tail -f /dev/null

Launch the GUI:
```
python3 GUI_AM3.py
```

The GUI

The GUI leverages a detailed AGN example with an external photon field. It operates with all speed-optimizing options enabled, evolving the system over XX dynamical timescales to reach a steady state.

Parameters and Running

To execute the code, click on Launch Shell Script. The GUI allows adjustment of the following parameters using sliders:

Source Parameters

R'_blob: Radius of the emitting spherical blob. Slider for log_10(R_blob/cm).
B': Comoving magnetic field strength. Slider for log_10(B/G).
Gamma: Bulk Lorentz factor of the blob.
R_diss: Dissipation radius. Slider for log_10(R_diss/cm).
z: Redshift of the source.

Electron Parameters

gamma'_(e, min): Minimal Lorentz factor of the electrons. Slider for log_10(gamma'_(e, min)).
gamma'_(e, max): Maximal Lorentz factor of the electrons. Slider for log_10(gamma'_(e, max)).
p_e: Powerlaw distribution index.
L'_e: Comoving luminosity in electrons. Slider for log_10(L'_e/erg.cm^-1).

Proton Parameters

gamma'_(p, min): Minimal Lorentz factor of the protons. Slider for log_10(gamma'_(p, min)).
gamma'_(p, max): Maximal Lorentz factor of the protons. Slider for log_10(gamma'_(p, max)).
p_p: Powerlaw distribution index.
L'_p: Comoving luminosity in protons. Slider for log_10(L'_p/erg.cm^-1).

External Fields Parameters

M_BH: Black hole mass. Slider for log_10(M_BH/M_sun).
L_disk: Accretion disk luminosity. Slider for log_10(L_disk/erg.cm^-1).
T_torus: Dust torus temperature. Slider for log_10(T_torus/K).
R_BLR: Broad line region radius. Slider for log_10(R_BLR/cm).
R_torus: Torus radius. Slider for log_10(R_torus/cm).

Options to disable components:

[ ] Turn off protons
[ ] Turn off external fields

Plotting

Running the code generates an output folder in the base directory containing:

Observed spectral energy distribution files
Comoving particle distributions
Cooling timescales

These can be visualized in the GUI under:

SED
Energy Densities
Timescales

The terminal panel (read-only mode) displays the evolution of various processes.