# RBFL SPARC Reproducibility Quickstart

This package is intended to let an outside reader reproduce the core SPARC phase-diagnostic result with minimal friction.

## What this package tests

It tests one narrow claim:

> A derived radial phase-drift statistic from SPARC rotation curves is correlated with observable baryonic structure.

This is not a claim that RBFL is complete cosmology, and it is not a claim that dark matter is fully replaced. It is a reproducibility entry point for the SPARC-facing part of the RBFL/RBFT workflow.

## Fastest path

### macOS / Linux

```bash
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
bash run_minimal_sparc_phase_test.sh
python run_quick_check.py
```

### Windows PowerShell

```powershell
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
.\run_minimal_sparc_phase_test.bat
python run_quick_check.py
```

## Expected headline result

The package should regenerate the cleaned SPARC tables, compute the phase detector outputs, and reproduce the phase-structure correlation table.

Expected key output from the included pipeline is approximately:

```text
SPARC galaxies parsed: 175
SPARC radial rows parsed: 3391
Phase-tuner galaxies analyzed: 165
Inside chi2 <= 1: 143
Inside chi2 <= 1.5: 154
Median chi2/dof: about 0.49
Top structural correlation: Psi_bar vs B_y_outer_minus_inner_lnPhi
Spearman rho: about 0.49-0.50
p-value: ~1e-10 to ~1e-11 depending on exact table/filter version
```

The important point is not the last decimal place. The reproducible claim is that the radial phase-drift statistic is not random with respect to baryonic structure under the stated pipeline.

## Main files to inspect

```text
scripts/01_make_clean_sparc.py
scripts/02_run_phase_tuner.py
scripts/03_run_phase_correlations.py
outputs/03_phase_correlations/phase_structure_correlations.csv
figures/phase_structure_Psi_bar_vs_By.png
```

## Scientific limits

This quickstart does not reproduce full Bullet convergence-map fitting, observed arc inversion, or cosmological tests. Those are explicitly left as later falsification gates.

## Validation status

This PRO package was test-run after packaging. See `VALIDATION_REPORT.md` for the exact environment, included data files, commands tested, and headline outputs.
## Recommended one-command reviewer run

```bash
python reproduce_sparc_phase.py
```

This runs the minimal SPARC reproduction from the included raw SPARC tables and prints the headline numbers.

