Metadata-Version: 2.4
Name: blackholeCalc
Version: 1.1.1
Summary: A scientific Python library for analytical modeling, thermodynamic analysis, visualization, and gravitational wave synthesis of relativistic black hole systems.
Author: Yashasvi Sharma, Aditya Sharma
License: MIT
Keywords: black hole,general relativity,kerr metric,schwarzschild,gravitational waves,hawking radiation,astrophysics,relativity,scientific computing
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Education
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: scipy
Requires-Dist: matplotlib
Dynamic: license-file

# BlackHoleCalc

BlackHoleCalc is a scientific Python library for analytical modeling, thermodynamic analysis, visualization, and gravitational wave synthesis of relativistic black hole systems.

It provides physically consistent implementations of key solutions from General Relativity and exposes them through a clean, educational, and research-friendly API.

---

## Features

### 1. General Relativity Metrics

Analytical implementations of:

- Schwarzschild (non-rotating, neutral)
- Kerr (rotating, neutral)
- Reissner–Nordström (charged, non-rotating)
- Kerr–Newman (rotating, charged)

Available calculations include:

- Event horizon radius
- Inner/outer horizons
- ISCO (Innermost Stable Circular Orbit)
- Gravitational redshift
- Effective orbital potential
- Ergosphere geometry (rotating cases)

---

### 2. Black Hole Thermodynamics

Implements semi-classical thermodynamic analysis:

- Hawking temperature
- Bekenstein–Hawking entropy
- Luminosity (Stefan–Boltzmann approximation)
- Peak wavelength (Wien’s law)
- Evaporation lifetime scaling

---

### 3. Visualization Engine

Includes:

- Ray-traced black hole shadow rendering
- Event horizon and ergosphere structure plots
- Effective orbital potential graphs

Designed for both research demonstrations and education.

---

### 4. Gravitational Wave Synthesis

Generates inspiral–merger–ringdown chirp signals using analytical approximations.

Returns:

- Time array
- Strain signal
- Chirp mass

Useful for educational simulations and waveform demonstrations.

---

## Installation

Clone the repository and install in development mode:

```bash
pip install blackholeCalc .
