Update README with moderated scientific language

Author: matthewsmawfield

README.md

@@ -1,94 +1,153 @@
-# TEP-SLR: Satellite Laser Ranging
+# Global Time Echoes: Optical Validation of the Temporal Equivalence Principle via Satellite Laser Ranging
 
-![TEP-SLR: Satellite Laser Ranging](site/public/twitter-image.jpg)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18064582.svg)](https://doi.org/10.5281/zenodo.18064582)
 
-This repository is the working home for the Satellite Laser Ranging (SLR) paper in the Temporal Equivalence Principle (TEP) research program.
+![TEP-SLR: Satellite Laser Ranging](site/public/twitter-image.jpg)
 
-> Temporal Equivalence Principle: Satellite Laser Ranging (SLR)  \
-> TEP-SLR Paper | v0.1 (Ankara) | DOI: TBD
+**Author:** Matthew Lukin Smawfield  
+**Version:** v0.1 (Mombasa)  
+**Date:** 30 December 2025  
+**DOI:** [10.5281/zenodo.18064582](https://doi.org/10.5281/zenodo.18064582)  
+**Website:** [https://matthewsmawfield.github.io/TEP-SLR/](https://matthewsmawfield.github.io/TEP-SLR/)
 
-Canonical Site: https://mlsmawfield.com/tep/slr/
+## Abstract
 
-GitHub Pages (mirror): https://matthewsmawfield.github.io/TEP-SLR/
+Independent optical-domain validation of the Temporal Equivalence Principle (TEP) is presented using 11 years (2015–2025) of Satellite Laser Ranging (SLR) data from passive ILRS geodetic satellites (LAGEOS-1/2 and Etalon-1/2). This analysis strongly disfavors the clock artifact hypothesis by employing two-way optical ranging to passive retroreflectors—orthogonal to GNSS microwave measurements of active atomic clocks. Analysis of 192,561 high-precision residuals (|Δρ|<0.5 m) reveals three signatures consistent with TEP's conformal sector: (1) **Path-length dependence**—a gap-aware, 5-minute-binned lag-1 residual statistic differs substantially between short-path and long-path geometry, with a low/high-range ratio of 6.58; (2) **Spectral concentration**—station-averaged power in the predicted TEP band (10–500 μHz) exceeds the full-spectrum mean by 2.48× (95% CI: 2.46–2.50) and exceeds the broadband floor (f>1 mHz) by 14.00× (95% CI: 13.53–14.47), confirming structured low-frequency coupling; (3) **Frequency independence**—optical (SLR) and microwave (GNSS) phenomenology remain consistent under the achromatic conformal coupling hypothesis.
 
-**The TEP Research Program:**
-1. [**TEP Theory**](https://doi.org/10.5281/zenodo.16921911) (Foundational framework)
-2. **TEP-SLR** (This work - Satellite Laser Ranging)
+The detection of matching low-frequency structure in a system with no active clocks, no microwave propagation, and purely optical two-way ranging renders receiver electronics, clock steering, and ionospheric modeling errors highly improbable as alternative explanations. This work establishes SLR as an independent validation of conformal TEP phenomenology.
 
-When using this work, please cite the paper and theoretical framework listed below.
+## Key Findings
 
-## Theoretical Framework
+- **Range-Dependent Coherence:** Path-length dependence with 6.58× ratio between low and high elevation (qualitatively robust, quantitatively estimator-sensitive)
+- **Spectral Concentration (TEP Band):** 2.48× vs full-spectrum mean (95% CI: 2.46–2.50), 14.00× vs broadband floor (95% CI: 13.53–14.47)
+- **Methodology Independence:** Confirms the signal exists in two-way optical ranging, ruling out GNSS-specific processing artifacts
 
-This work builds on the Temporal Equivalence Principle (TEP), which proposes:
--   Gravity is geometry; time is a dynamical field.
--   The decomposition of proper time accumulation into "mass" and "time dilation" is gauge-dependent.
--   Sector decoupling: The conformal sector (clock rates) is unconstrained by GW170817, while the disformal sector (speed of transmission) is tightly bound.
--   Vainshtein screening: The "Screening Cliff" objection is addressed; the mechanism is shown to be over-efficient rather than fine-tuned.
+## The TEP Research Program
 
-**TEP Theory Reference:**
-> Smawfield, M. L. (2025). *Temporal Equivalence Principle: Dynamic Time & Emergent Light Speed (v0.6 (Jakarta))*. Zenodo. DOI: [10.5281/zenodo.16921911](https://doi.org/10.5281/zenodo.16921911)
+| Paper | Repository | Title | DOI |
+|-------|-----------|-------|-----|
+| **Paper 0** | [TEP](https://github.com/matthewsmawfield/TEP) | Temporal Equivalence Principle: Theory | [10.5281/zenodo.16921911](https://doi.org/10.5281/zenodo.16921911) |
+| **Paper 5** | **TEP-SLR** (This repo) | SLR Validation | [10.5281/zenodo.18064582](https://doi.org/10.5281/zenodo.18064582) |
 
-## File Structure
+## Repository Structure
 
 ```
 TEP-SLR/
 ├── scripts/
-│   ├── steps/                      # Analysis pipeline
-│   └── utils/                      # Shared utilities
-├── site/                           # Academic manuscript site
-│   ├── components/                 # HTML section files
-│   ├── public/                     # Static assets
-│   └── dist/                       # Built site output
-├── docs/                           # PDF versions
+│   ├── steps/                  # Core analysis pipeline
+│   │   ├── step_1_0...py       # CDDIS Data Downloader
+│   │   ├── step_2_1...py       # Residual Calculation
+│   │   ├── step_2_3...py       # MWPC Analysis (Main)
+│   │   ├── step_2_4...py       # Plotting
+│   │   └── step_3_0_sim_antiecho.py       # Anti-Echo Simulation
+│   └── helpers/                # Utility scripts
+│       ├── download_orbits.py  # SP3 Orbit Downloader
+│       └── process_residuals_yearly.py   # Batch processing helper
+├── data/                       # Input data (GitIgnored)
+│   └── slr/                    # CRD observations & SP3 orbits
 ├── results/
-│   ├── figures/                    # Generated plots
-│   └── outputs/                    # Analysis results
-├── logs/                           # Execution logs
-├── manuscript-tep-slr.md           # Auto-generated markdown
-└── VERSION.json                    # Version metadata
+│   ├── outputs/                # Analysis JSONs & CSVs
+│   └── figures/                # Generated plots
+├── logs/                       # Execution logs
+└── reproduce_analysis.sh       # One-click reproduction script
+```
+
+## Quick Start
+
+### 1. Prerequisites
+- Python 3.10+
+- [CDDIS Account](https://cddis.nasa.gov/) (for data download only)
+
+```bash
+pip install -r requirements.txt
 ```
 
-## Requirements
+### 2. Reproduction
+To run the full analysis pipeline (assuming data is downloaded):
 
-- Python 3.8+
-- NumPy, SciPy, Matplotlib
-- Astropy (for cosmological calculations)
-- Lenstronomy (for lens modeling)
+```bash
+chmod +x reproduce_analysis.sh
+./reproduce_analysis.sh
+```
 
-See `requirements.txt` for complete dependencies.
+### 3. Data Access
 
-## Methodology
+**Option A: Use Pre-Processed Results (Recommended for Verification)**
+All analysis outputs are included in `results/outputs/` and `results/figures/`. You can verify the analysis without downloading raw data:
 
-- **Lens Modeling**: Ray-tracing with temporal field variations
-- **Source Evolution**: Myr-scale evolutionary models for galaxies/AGN
-- **Time Delay Calculation**: Path-dependent proper-time accumulation
-- **Image Reconstruction**: Temporal composite modeling
-- **Statistical Analysis**: Correlation tests with observational data
+```bash
+# View analysis results
+cat results/outputs/step_2_3_mwpc_analysis.json
 
-## Related Work
+# Regenerate figures from existing data
+python scripts/steps/step_2_4_plot_results.py
+```
 
-- [TEP Theory](https://doi.org/10.5281/zenodo.16921911) - Foundational framework
+**Option B: Download Raw Data from CDDIS (For Full Reproduction)**
+To download SLR observations and orbits from NASA CDDIS:
+
+1. **Register for NASA Earthdata Account:**
+   - Visit: https://urs.earthdata.nasa.gov/users/new
+   - Create free account (required for CDDIS access)
+
+2. **Configure Authentication:**
+   
+   Option 1 - Using `.netrc` file (recommended):
+   ```bash
+   echo "machine urs.earthdata.nasa.gov login YOUR_USERNAME password YOUR_PASSWORD" >> ~/.netrc
+   chmod 600 ~/.netrc
+   ```
+   
+   Option 2 - Using environment variables:
+   ```bash
+   export CDDIS_USER="your_username"
+   export CDDIS_PASS="your_password"
+   ```
+
+3. **Download Data:**
+   ```bash
+   # Download SLR observations (2015-2025)
+   python scripts/steps/step_1_0_data_acquisition.py --start 2015-01-01 --end 2025-12-31
+   
+   # Download precise orbits
+   for y in $(seq 2015 2025); do python scripts/helpers/download_orbits.py --year $y; done
+   ```
+
+### 4. Pipeline Steps
+
+1.  **Data Acquisition (`step_1_0`):** Downloads CRD (Normal Point) observation files from CDDIS.
+2.  **Orbit Processing (`download_orbits`):** Fetches precise SP3 orbits for LAGEOS-1 and LAGEOS-2.
+3.  **Residual Calculation (`step_2_1`):** Computes range residuals (Observed - Computed) using rigorous force models.
+4.  **MWPC Analysis (`step_2_3`):** Performs Magnitude-Weighted Phase Correlation analysis to extract spatial decay signatures.
+5.  **Visualization (`step_2_4`):** Generates decay plots and diagnostic figures.
+6.  **Simulation (`step_3_0`):** Runs the "Anti-Echo" Monte Carlo simulation to validate the sign inversion mechanism.
 
 ## License
 
-This project is licensed under Creative Commons Attribution 4.0 International (CC-BY-4.0). See [LICENSE](LICENSE) for details.
+This project is licensed under Creative Commons Attribution 4.0 International (CC-BY-4.0).
 
 ## Citation
 
+If you use this code or data, please cite:
+
 ```bibtex
-@article{smawfield2025tepslr,
-  title={Temporal Equivalence Principle: Satellite Laser Ranging (SLR)},
+@article{smawfield2025slr,
+  title={Global Time Echoes: Optical Validation of the Temporal Equivalence Principle via Satellite Laser Ranging},
   author={Smawfield, Matthew Lukin},
-  journal={Preprint},
+  journal={Zenodo},
   year={2025},
-  note={Preprint v0.1 (Ankara), DOI: TBD}
+  doi={10.5281/zenodo.18064582},
+  note={v0.1 (Mombasa)}
 }
 ```
 
-## Acknowledgments
+---
+
+## Open Science Statement
 
-The author thanks colleagues for valuable discussions. This research made use of NASA's Astrophysics Data System and the arXiv preprint server.
+These are working preprints shared in the spirit of open science—all manuscripts, analysis code, and data products are openly available under Creative Commons Attribution 4.0 International (CC-BY-4.0) to encourage and facilitate replication. Feedback and collaboration are warmly invited and welcome.
 
-## Status
+---
 
-**Version 0.1 (Ankara)** - Initial project scaffold.
+**Contact:** matthewsmawfield@gmail.com  
+**ORCID:** [0009-0003-8219-3159](https://orcid.org/0009-0003-8219-3159)