Metadata-Version: 2.4
Name: dupliter
Version: 0.1.0
Summary: Retro BBS-style terminal simulator for the Dupliter gravitational-temporal anchor hypothesis
Project-URL: Homepage, https://pypi.org/project/dupliter/
Project-URL: Bug Tracker, https://pypi.org/project/dupliter/
Author: Ashlan Chidester
License: MIT
License-File: LICENSE
Keywords: bbs,dupliter,educational,physics,relativity,simulation,terminal
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# dupliter 🪐

**A retro BBS-style terminal simulator for the Dupliter hypothesis** — an exploratory, educational tool that computes the relativistic/classical kinetic-energy ratio and a pedagogical *Dupliter Stability Index* (DSI).

```
   ____  _   _  _     _ _ _  _   _  ___  _   _  _____
  |  _ \| | | || |   (_) | \| | | |/ _ \| \ | ||_   _|
  | | | | |_| || |    _| | .` | | | | | |  \| |  | |
  | |_| |  _  || |___| | | |\  |_| | |_| | |\  |  | |
  |____/|_| |_||_____|_|_|_| \_(_) |\___/|_| \_|  |_|
```

## Install

```bash
pip install dupliter
```

## Run

```bash
# Console command
dupliter

# Or as a module
python -m dupliter
```

## What it does

The simulator asks for three parameters and computes two metrics:

| Parameter | Description |
|---|---|
| **β (v/c)** | Fractional velocity as a fraction of light speed (0 – 0.9999) |
| **Dark-matter potential** | Dimensionless toy factor representing local DM density |
| **Anchor strength** | Dimensionless toy factor for gravitational anchor magnitude |

### Relativistic / Classical KE ratio

```
ratio = 2 * (1/√(1−β²) − 1) / β²
```

This converges to 1.0 at low speeds (classical limit) and diverges as β → 1.

### Dupliter Stability Index (DSI)

A heuristic, log-compressed composite score (0–100):

```
DSI ≈ [ log₁₀(ratio+1)·0.60
      + log₁₀(dm+1)·0.25
      + log₁₀(anchor+1)·0.15 ] / log₁₀(1e6+1) × 100
```

| DSI range | Verdict |
|---|---|
| ≥ 60 | High — plausible Dupliter regime |
| 30–59 | Moderate — marginal potential |
| 1–29 | Low — unstable |
| 0 | None |

> **Note:** DSI is an exploratory, educational metric — not a peer-reviewed physical quantity. It is designed for learning and hypothesis exploration.

## Python API

```python
from dupliter import relativistic_to_classical_ratio, dupliter_stability_index, verdict

ratio = relativistic_to_classical_ratio(0.5)   # β = 0.5c
dsi   = dupliter_stability_index(ratio, dm_factor=2.0, anchor_strength=3.0)
level, message = verdict(dsi)

print(f"Ratio : {ratio:.4f}")
print(f"DSI   : {dsi:.2f}  [{level}] — {message}")
```

## Project structure

```
src/dupliter/
├── __init__.py    # public API
├── __main__.py    # python -m dupliter entry point
├── core.py        # pure-math functions (no I/O)
└── bbs.py         # retro BBS terminal UI
```

## License

MIT © Ashlan Chidester
