# RBFL Full Reproducibility Package

**Package date:** 2026-06-13  
**Project:** Radial Baryonic Field Law / Radial Baryonic Field Theory development  
**Purpose:** reproduce the current RBFL locked-law, SPARC benchmark, and improved 3D Phase Field Prediction/Detection Unit results from included data tables and scripts.

This package is a working research bundle.  It does **not** claim that RBFL is established physics.  It provides the data, equations, scripts, and result tables needed to reproduce the current internal benchmark numbers and inspect the assumptions.

## 1. Core idea

The locked RBFL acceleration law is kept unchanged:

```math
g_{\rm RBFL}(r)=g_b(r)+A_b(r)\sqrt{a_\phi g_b(r)}.
```

The Phase Detection Unit is allowed to use observable-derived clues to classify phase state, but only in the detection/diagnostic layer.  Detection channels do **not** change the locked acceleration law.

The current detector combines:

1. baryon-derived phase prediction `A_b`,
2. observed post-test phase diagnostic `A_phi_obs`,
3. NGC7331 zero-phase reference gauge,
4. central-node rotational geometry proxies,
5. switching/boundary indicators,
6. lensing/Bullet-style event-projection band as detection only,
7. benchmark scoring against SPARC-style galaxy samples and pilot lensing tables.

## 2. What is included

```text
RBFL_Full_Reproducibility_Package_2026_06_13/
  README.md
  QUICKSTART.md
  requirements.txt
  environment.yml
  run_all.sh
  run_all.bat
  config/
    reproducibility_config.json
  docs/
    RBFL_EQUATIONS_DICTIONARY.md
    DATA_DICTIONARY.md
    METHOD_AND_LIMITATIONS.md
    RUNBOOK.md
    included white papers and reference PDFs
  original_package/
    RBFL_SPARC_Reproducibility_Verified_PRO/  # original SPARC/lensing pilot package
  data/current_detector/
    benchmark_suite/                 # benchmark summary and pilot figures/tables
    reference_gauge_multichannel/     # NGC7331 gauge detector inputs/results
    lensing_detection_channel/        # lensing/event projection diagnostic tables
    lambda_event_band/                # latest adjustable event-band detector output
  scripts/
    00_environment_check.py
    01_verify_package_integrity.py
    02_reproduce_original_sparc_summary.py
    03_reproduce_lambda_event_band_detector.py
    04_rebuild_summary_figures.py
    05_write_reproduction_report.py
    rbfl_math.py
    rbfl_detector.py
  results/expected/
    expected_summary.json
  outputs/reproduced/                 # created when scripts are run
```

## 3. Quick run

From the package root:

```bash
python -m pip install -r requirements.txt
bash run_all.sh
```

On Windows:

```bat
run_all.bat
```

The combined reproduced report will be written to:

```text
outputs/reproduced/REPRODUCTION_REPORT.md
outputs/reproduced/reproduction_summary.json
```

## 4. Expected headline numbers

The latest package should reproduce these detector-stage numbers from the included tables:

| Quantity | Expected value |
|---|---:|
| Original SPARC clean rows | 3391 radial rows |
| Original SPARC galaxies | 175 galaxies |
| Original strict corridor | 143 / 165 galaxies with chi2 <= 1 |
| Original soft corridor | 154 / 165 galaxies with chi2 <= 1.5 |
| NGC7331 reference gauge | locked zero-phase gauge |
| Prior improved detector holdout phase match | 75% |
| Adjustable lensing/event-band holdout phase match | 95% |
| Locked-law holdout velocity pass, 15% MAPE | 70% |
| Combined velocity + phase tolerance after event band | 70% |
| Best event-band center in current sweep | 2.0 |
| Best event-band sigma in current sweep | 0.25 |

## 5. Reproducibility level

This package has three reproducibility layers:

### Layer A: original SPARC/lensing pilot package

The `original_package/` folder contains the SPARC raw tables, original scripts, clean outputs, phase-tuner results, phase-correlation tests, and pilot lensing/Bullet proxy files.

### Layer B: current detector-stage result reproduction

The scripts in `scripts/` reproduce the current result summaries from included derived tables.  These are the tables generated during the improved detector development, including the NGC7331 reference-gauge detector and the adjustable lensing/event-band detector.

### Layer C: exact future forward reproduction

A future version should recompute every current detector feature directly from raw SPARC tables and full 3D baryonic/lensing data.  This package includes projected/proxy data, not full 3D baryonic reconstructions, raw lensing images, or full convergence maps.  This limitation is part of the record.

## 6. Important scientific boundary

The package is meant to be critic-safe:

- `A_b` is the baryon-derived phase operator used by the locked law.
- `A_phi_obs` is the observed residual phase diagnostic computed only after comparison.
- The lensing/event amplification band is a detection-stage parameter only.
- Wide-binary and timing/beat channels are documented but not run because the necessary datasets are not included.
- The detector can improve phase classification without changing the locked acceleration law.

## 7. How to cite or describe this package

Suggested description:

> This package reproduces the current internal RBFL locked-law and Phase Detection Unit benchmark results using SPARC-derived rotation-curve tables, original phase-tuner outputs, pilot lensing/Bullet proxy data, NGC7331 zero-gauge phase features, and an adjustable detection-stage event-projection band.  The package is a reproducibility bundle for a speculative research programme, not evidence of established physics.

## 8. Main known limitations

1. The current detector estimates a 3D phase field from projected observables.
2. Full 3D baryonic density data are not included.
3. Full raw lensing arcs and convergence maps are not included.
4. Wide-binary and timing datasets are not included.
5. The 95% holdout phase-state match is a detector-stage result, not a locked-law velocity improvement.
6. The locked-law velocity pass remains 70% under the current 15% MAPE tolerance.

See `docs/METHOD_AND_LIMITATIONS.md` for details.
