Update README.md

README.md

@@ -6,8 +6,85 @@ colorTo: purple
 sdk: gradio
 sdk_version: 6.1.0
 app_file: app.py
-pinned: false
+pinned: true
 short_description: RFTs Weather phenomena live forecasts
+license: other
+thumbnail: >-
+  https://cdn-uploads.huggingface.co/production/uploads/685edcb04796127b024b4805/6Hp-B0MSDCUoC8dsijWJg.png
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Rendered Frame Theory — Live Prediction Console (Open Method)
+
+This Space runs **live, transparent, recomputed-from-scratch** signals for four domains:
+
+- Atmospheric (location-based)
+- Seismic (region-based)
+- Magnetic (global)
+- Solar (global)
+
+No hidden steps. The app prints the exact values it computes: **z, τ_eff, Ω_obs, α_R, index, and the decision rule used**.
+
+## What changes with location (and what does not)
+
+### Location input
+- **Used for Atmospheric** (Open-Meteo hourly at the geocoded lat/lon).
+- **Not used for Solar** (GOES X-ray flux is global).
+- **Not used for Magnetic** (Kp index is global).
+- **Not used for Seismic in this build** (Seismic is filtered by the selected region, not by city/radius).
+
+If you type a different city and see Solar/Magnetic/Seismic unchanged: that is expected.
+
+### Seismic region selector
+The Seismic tab is a **regional stress monitor**. It counts earthquakes in the selected region for the last 24 hours (M≥2.5). It is **not** a “near your city” counter unless a radius mode is implemented.
+
+## What this is / what this is not
+
+### This is
+- A live multi-domain “regime detector” that turns raw public feeds into an explicit RFT-style stress coordinate **z**, then maps it to **τ_eff** and an **index**, then labels states using fixed thresholds.
+
+### This is not
+- A guaranteed prediction engine.
+- A precipitation model, radar nowcast, or full NWP weather model.
+- An earthquake time + epicenter predictor.
+- A CME arrival model or flare timing predictor.
+- A local magnetometer or grid impact model.
+
+When live data is missing or too short, the domain is **DISABLED** instead of guessed.
+
+## Instant verification links (sources)
+
+Use these to falsify the live status immediately:
+
+### Atmospheric (Open-Meteo)
+- Open-Meteo API docs: https://open-meteo.com/en/docs
+- Geocoding (Open-Meteo): https://open-meteo.com/en/docs/geocoding-api
+
+### Seismic (USGS)
+- USGS Earthquake API: https://earthquake.usgs.gov/fdsnws/event/1/
+
+### Magnetic (NOAA SWPC Kp)
+- NOAA SWPC Kp JSON feed: https://services.swpc.noaa.gov/json/planetary_k_index_1m.json
+- SWPC data services index: https://services.swpc.noaa.gov/
+
+### Solar (NOAA SWPC GOES X-ray)
+- GOES X-ray 1-day JSON: https://services.swpc.noaa.gov/json/goes/primary/xrays-1-day.json
+- SWPC data services index: https://services.swpc.noaa.gov/
+
+## Open method (equations used in-app)
+
+Shared core:
+- τ_eff = 1.38 · ln(1 + z)
+- Ω_obs = 2π / T_earth  (T_earth = 365.2422 days)
+- α_R = 1.02
+- Index = Ω_obs · τ_eff · α_R
+
+z definitions:
+- Atmospheric: z_atm = clamp( clamp(ΔT/10,0..2) + clamp(|ΔP|/12,0..1.5), 0..3 )
+- Seismic:     z_seis = clamp( clamp(N/60,0..1.5) + clamp(max(0,Mmax-4)/2.5,0..1.5), 0..3 )
+- Magnetic:    z_mag  = clamp( (Kp_last/9) + (drift/2) + 2·|slope|, 0..3 )
+- Solar:       z_solar= clamp( ln(F_mean/1e-8)/10, 0..3 )
+
+Decision thresholds are printed in the agent output as `rule_fired`.
+
+## Practical note (why London shows “38 events”)
+That number is **not London earthquakes**. In this build, Seismic counts **all quakes in the selected region** (e.g., EMEA) over the last 24 hours at M≥2.5. Change the region selector to see different counts.