# Quickstart for Reviewers

This is the shortest reproducibility route.

## 1. Install dependencies

```bash
python -m venv .venv
source .venv/bin/activate        # macOS/Linux
pip install -r requirements.txt
```

Windows:

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

## 2. Run the minimal SPARC phase test

macOS/Linux:

```bash
bash run_minimal_sparc_phase_test.sh
```

Windows:

```cmd
run_minimal_sparc_phase_test.bat
```

## 3. Check the reproduced numbers

```bash
python run_quick_check.py
```

This reads the generated outputs and prints the headline metrics.

## 4. Inspect the core output

Open:

```text
figures/phase_structure_Psi_bar_vs_By.png
outputs/03_phase_correlations/phase_structure_correlations.csv
```

The central check is whether `Psi_bar` correlates with `B_y_outer_minus_inner_lnPhi`.

## 5. Optional full workflow

To run everything, including lensing pilots and Bullet proxy summaries:

```bash
bash run_all.sh
python run_quick_check.py
```

Full-map Bullet convergence fitting and real observed arc inversion are not included in this package.
## 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.

