# Data Dictionary

## Original SPARC package

Path:

```text
original_package/RBFL_SPARC_Reproducibility_Verified_PRO/
```

Contains the original SPARC-derived raw and processed tables, original scripts, phase tuner results, and pilot lensing/Bullet proxy data.

Important files:

| File | Meaning |
|---|---|
| `data/raw/Table1.mrt.txt` | SPARC galaxy table source used by original package |
| `data/raw/Table2.mrt.txt` | SPARC radial rotation-curve/mass-model table source used by original package |
| `outputs/01_clean_sparc/sparc_merged_clean.csv` | Clean merged radial data; expected 3391 rows |
| `outputs/01_clean_sparc/sparc_galaxy_summary_clean.csv` | Clean galaxy-level summary; expected 175 galaxies |
| `outputs/02_phase_tuner/phase_tuner_results.csv` | Original phase-tuner galaxy-level results |
| `outputs/02_phase_tuner/phase_tuner_point_residuals.csv` | Original point-level phase residuals |
| `outputs/02_phase_tuner/reference_gauge_robustness.csv` | Alternate reference-gauge comparison; NGC7331 is main reference |
| `outputs/03_phase_correlations/phase_structure_correlations.csv` | Baryonic phase-structure correlations |
| `outputs/03_phase_correlations/phase_structure_cv_models.csv` | Cross-validated phase prediction summary |
| `outputs/05_real_lensing_pilots/weak_lensing_btfr_summary.csv` | Weak-lensing BTFR pilot summary |
| `outputs/05_real_lensing_pilots/strong_lensing_pilot_correlations.csv` | Strong-lensing pilot correlations |
| `outputs/06_bullet/bullet_deflection_field_metrics.csv` | Bullet-style deflection proxy metrics |

## Current detector tables

Path:

```text
data/current_detector/
```

Important files:

| File | Meaning |
|---|---|
| `reference_gauge_multichannel/reference_gauge_multichannel_galaxy_detection.csv` | Current NGC7331 zero-gauge, multi-channel galaxy detector table |
| `reference_gauge_multichannel/reference_gauge_detector_summary_by_split.csv` | Current reference-gauge detector split summary |
| `lensing_detection_channel/galaxy_lensing_detection_metrics.csv` | Lensing/event projection diagnostic metrics |
| `lambda_event_band/rbfl_lambda_band_detector_results.csv` | Latest adjustable event-band detector result table |
| `lambda_event_band/rbfl_lambda_band_sweep_results.csv` | Sweep over event-band center/sigma/model |
| `lambda_event_band/rbfl_lambda_band_summary.json` | Latest event-band summary numbers |

## Key columns

| Column | Meaning |
|---|---|
| `Galaxy` | Galaxy identifier |
| `split` | `train` or `holdout` split |
| `MAPE_pct` | Median absolute percentage velocity error |
| `velocity_pass_15pct` | Whether MAPE <= 15% |
| `observed_dominant_state` | Dominant phase state from observed residual detector |
| `detector_state_multichannel` | Prior multi-channel detector state |
| `detector_state_lambda_band` | Latest adjustable event-band detector state |
| `match_lambda_band` | Whether latest detector state matches observed diagnostic state |
| `combined_pass` | Velocity pass and phase-state match both true |
| `Lambda_phase_median` | Median phase ratio A_phi_obs / A_b |
| `Lambda_phase_outer_median` | Outer-region phase ratio |
| `lambda_event_score_band` | Score for adjustable event-band detector |
| `lambda_event_flag_band` | Event band flag |
| `lambda4_score` | Prior factor-4 event projection score |
| `zero_gauge_score` | NGC7331 zero-gauge score |

