explaingit

dooodlad/kerr-newman-black-hole-visualizer

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 2/5Setup · easy

TLDR

An interactive Python tool that plots a spinning, charged black hole in 3D, showing its horizons, ergosphere, and frame dragging effects for educational exploration.

Mindmap

mindmap
  root((Kerr-Newman visualizer))
    What it does
      3D black hole plot
      Inner and outer horizons
      Ergosphere and singularity
    Adjustable
      Mass
      Spin
      Charge
    Extras
      Schwarzschild 2D sim
      Schwarzschild 3D sim
    Tech Stack
      Python
      NumPy
      Matplotlib

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Visualize how a black hole's horizons and ergosphere change shape as you adjust its mass, spin, and charge.

USE CASE 2

Use as a teaching aid to build intuition for frame dragging around a rotating black hole.

USE CASE 3

Explore a simpler non-rotating Schwarzschild black hole and white hole simulation in 2D or 3D.

What is it built with?

PythonNumPyMatplotlib

How does it compare?

dooodlad/kerr-newman-black-hole-visualizer0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultyeasymoderatehard
Complexity2/54/51/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Only needs Python with numpy and matplotlib installed, no geodesic paths are included in the simulation.

No license information is stated in the README.

In plain English

Kerr-Newman-black-hole-visualizer is an interactive tool for exploring the physics of a Kerr-Newman black hole, which is the mathematical description of a black hole that is both spinning and electrically charged. It renders this in both two and three dimensions using a coordinate system called Boyer-Lindquist coordinates, and it does not include the path a falling object would trace, known as a geodesic. The tool calculates the actual physical quantities of the black hole's spacetime exactly, using real world units for gravity and the speed of light rather than the simplified units physicists often use where those constants are just set to one. In the interactive 3D plot you can see grid lines marking out the coordinate system, the black hole's inner and outer horizons, the ergosphere, which is the region around a spinning black hole where nothing can stay still, arrows showing how spacetime itself gets dragged around by the rotation, and the ring shaped singularity at the center. You can adjust the black hole's mass, spin, and electric charge, along with how large an area is shown and how thick or transparent the plotted lines appear. The author notes that while the underlying physics values are computed exactly, the visual lines on the grid are exaggerated somewhat to make the shapes easier to see and more visually clear, so the picture is not meant to be a perfectly accurate geometric embedding. The project states plainly that it is meant for educational purposes, to help people build an intuitive sense of what a rotating, charged black hole looks like, rather than to serve as a precise research tool. Beyond the core Kerr-Newman visualizer, the README mentions two additional updates: a two dimensional simulation of a simpler black hole and white hole pair, called a Schwarzschild black hole, and a three dimensional version of that same simulation. To run any of this, you need Python along with the NumPy and Matplotlib libraries installed. The README does not mention a license for this project.

Copy-paste prompts

Prompt 1
I installed numpy and matplotlib. Walk me through running the Kerr-Newman black hole visualizer for the first time.
Prompt 2
Explain what the ergosphere and frame-dragging arrows shown in this visualizer actually represent physically.
Prompt 3
How do I adjust the mass, spin, and charge parameters in this tool to see an extreme Kerr-Newman black hole?
Prompt 4
Compare the Schwarzschild black hole simulation included here to the main Kerr-Newman visualization.

Frequently asked questions

What is kerr-newman-black-hole-visualizer?

An interactive Python tool that plots a spinning, charged black hole in 3D, showing its horizons, ergosphere, and frame dragging effects for educational exploration.

What language is kerr-newman-black-hole-visualizer written in?

Mainly Python. The stack also includes Python, NumPy, Matplotlib.

What license does kerr-newman-black-hole-visualizer use?

No license information is stated in the README.

How hard is kerr-newman-black-hole-visualizer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is kerr-newman-black-hole-visualizer for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.