Requirements: Blender 4.2 LTS or newer. Scene generation and Cycles renders tested on 4.2 and 5.0.1. EEVEE has not been tested. Uses numpy, which is bundled with Blender. 8 GB RAM recommended.

Quick start (no scripting):

1. Unzip the download.
2. Open BlackHoles_MHDINT.blend.
3. Press F12 to render the current frame, or Ctrl+F12 to render the animation.

Change the camera: go to the Scripting tab (the script is already open inside the .blend), set ONLY_SWITCH_CAMERA = "overview" and press Alt+P. This does not rebuild the scene: it switches the camera and shows the objects that belong to that view. Camera keys: edge_85, tilt_75, tilt_45, m87_17, sky_lens, overview, top, jets, scale.

Rebuild with your own settings:

1. In the Scripting tab, edit the settings at the top of black_holes_v1.0.py. The main ones: TARGET ("M87", "SGRA", "CYGX1" or "CUSTOM" with CUSTOM_MASS_MSUN and CUSTOM_DISTANCE_PC), DISC_COLOR ("eht" or "thermal"), DISC_OUTER_RS, CUSTOM_INCLINATION_DEG (adds a lens camera at your angle), SHOW_JETS, SHOW_LABELS, RESOLUTION.
2. Set ONLY_SWITCH_CAMERA = None and press Alt+P. The scene is rebuilt from scratch.

Read the data: select an object named MHDINT_… and open Object Properties → Custom Properties. Values carry their source and say whether they are measured, computed or illustrative.

Performance: rebuilding takes 10–20 seconds (the ray tracing runs in Python). A Cycles render takes 1–3 minutes on a laptop CPU. The lens cameras are computed for their inclination: to get a new angle, set CUSTOM_INCLINATION_DEG and rebuild.