BlackHolesFactory

A Rust black hole factory — create, simulate, and analyze black holes of any mass class. From stellar-mass remnants (Cygnus X-1) to intermediate-mass objects (HLX-1) to supermassive monsters (M87*), with full Kerr physics, accretion, jets, shadows, lensing, and Hawking evaporation.

Features

• Type system — Stellar-mass, intermediate-mass, and supermassive black holes with class-specific formation channels and observables
• Stellar-mass — Core-collapse remnant model, progenitor mass mapping, gravitational wave strain, Cygnus X-1 preset
• Intermediate-mass — Runaway merger, hierarchical merger, Pop III remnant, direct collapse formation channels, ULF QPO, merger recoil
• Supermassive — M-σ relation, Bondi accretion, tidal disruption, jet power estimation, M87* preset
• Kerr spacetime — Metric tensor, geodesic integration, event/Cauchy horizons, ergosphere
• Accretion disk — Temperature profiles, viscous timescale, radiative efficiency, spin-dependent ISCO
• Relativistic jets — Blandford-Znajek power, Doppler boosting, superluminal motion, synchrotron cooling
• Gravitational lensing — Einstein radius, image positions, magnification, Shapiro delay
• Black hole shadow — Critical impact parameter, contour, asymmetry, EHT M87* diameter prediction
• Radiation — Planck radiance, Wien peak, bremsstrahlung, Eddington luminosity
• Hawking evaporation — Temperature, luminosity, lifetime, Page time, mass evolution, peak wavelength
• General relativity — Lorentz factor, time dilation, length contraction, gravitational redshift, gravitational waves

Quick Start

cargo build
cargo run

Examples

cargo run --example stellar_blackhole_sim       # Stellar-mass BH from core collapse
cargo run --example supermassive_blackhole_sim   # M87* simulation
cargo run --example hawking_evaporation          # Hawking radiation and evaporation
cargo run --example lensing_viewer               # Gravitational lensing diagnostics

Testing

cargo test --all-targets

93 integration tests across simulation, types, observables, and physics modules.

Project Structure

src/
├── config/          # Physical constants, mass boundaries, presets (Cygnus X-1, M87*, HLX-1)
├── engine/          # Spacetime geometry, accretion disk, jet dynamics, Hawking evaporation
├── observables/     # Lensing, radiation, shadow computations
├── physics/         # Gravitation, relativity, singularity models
├── types/           # Stellar-mass, intermediate-mass, supermassive black hole types
└── utils/           # Math helpers, I/O

Dependencies

• sciforge — Physical constants, astronomical utilities

License

MIT — see LICENSE.