Update app.py

app.py

@@ -1,6 +1,6 @@
-# app.py
+
 # ===============================================================
-# Rendered Frame Theory — Live Prediction Console
+# Rendered Frame Theory — Live Prediction Console (Open Method)
 # Domains: Atmospheric / Seismic / Magnetic / Solar
 # Full transparency: exact inputs + computed z, τ_eff, Ω_obs, α_R, index, and decision rule.
 # Single-file.
@@ -14,20 +14,14 @@ import httpx
 import numpy as np
 import pandas as pd
 
-APP_NAME = "Rendered Frame Theory — Live Prediction Console"
+APP_NAME = "Rendered Frame Theory — Live Prediction Console (Open Method)"
 UA = {"User-Agent": "RFTSystems/LivePredictionConsole"}
 
-# ---------------------------
-# Core constants
-# ---------------------------
 T_EARTH = 365.2422 * 24 * 3600.0
 OMEGA_OBS = 2.0 * math.pi / T_EARTH
 K_TAU = 1.38
 ALPHA_R = 1.02
 
-# ---------------------------
-# Regions
-# ---------------------------
 REGION_BBOX = {
     "Global": None,
     "EMEA": (-35.0, -20.0, 70.0, 60.0),
@@ -40,30 +34,30 @@ RING_OF_FIRE_BBOXES = [
     (10.0, -90.0, 60.0, -60.0),
 ]
 
-# ---------------------------
-# Helpers
-# ---------------------------
+
 def utc_now_iso() -> str:
     return datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
 
+
 def clamp(x: float, a: float, b: float) -> float:
     return max(a, min(b, x))
 
+
 def tau_eff_from_z(z: float) -> float:
     z = max(0.0, float(z))
     return K_TAU * math.log(1.0 + z)
 
+
 def stable_log_ratio(x: float, x0: float) -> float:
     x = max(float(x), 1e-30)
     x0 = max(float(x0), 1e-30)
     return math.log(x / x0)
 
+
 def index_from_tau(tau: float) -> float:
     return float(OMEGA_OBS * float(tau) * ALPHA_R)
 
-# ---------------------------
-# Live adapters
-# ---------------------------
+
 def geocode_location(q: str):
     q = (q or "").strip()
     if not q:
@@ -82,6 +76,7 @@ def geocode_location(q: str):
     display = f"{top.get('name','')}, {top.get('country_code','')}".strip().strip(",")
     return lat, lon, display
 
+
 def fetch_openmeteo_hourly(lat: float, lon: float, past_days: int = 1):
     url = "https://api.open-meteo.com/v1/forecast"
     params = {
@@ -104,6 +99,7 @@ def fetch_openmeteo_hourly(lat: float, lon: float, past_days: int = 1):
         "wind": hourly.get("wind_speed_10m") or [],
     }
 
+
 def fetch_kp_last_24h():
     url = "https://services.swpc.noaa.gov/json/planetary_k_index_1m.json"
     r = httpx.get(url, headers=UA, timeout=15)
@@ -122,6 +118,7 @@ def fetch_kp_last_24h():
             pass
     return vals[-1440:]
 
+
 def fetch_goes_xray_1day():
     url = "https://services.swpc.noaa.gov/json/goes/primary/xrays-1-day.json"
     r = httpx.get(url, headers=UA, timeout=15)
@@ -140,6 +137,7 @@ def fetch_goes_xray_1day():
             pass
     return out
 
+
 def fetch_usgs_quakes(hours: int, minmag: float, bbox=None):
     url = "https://earthquake.usgs.gov/fdsnws/event/1/query"
     end = datetime.now(timezone.utc)
@@ -173,9 +171,7 @@ def fetch_usgs_quakes(hours: int, minmag: float, bbox=None):
         out.append({"id": f.get("id"), "mag": props.get("mag"), "place": props.get("place"), "time": props.get("time")})
     return out
 
-# ---------------------------
-# Agents
-# ---------------------------
+
 def magnetic_agent():
     kp = fetch_kp_last_24h()
     if len(kp) < 30:
@@ -216,10 +212,15 @@ def magnetic_agent():
         "live_status": live,
         "truth_source": "NOAA SWPC planetary_k_index_1m (global)",
         "inputs_used": {"kp_last": last, "kp_drift": drift, "kp_slope": slope, "tail_len": len(tail)},
+        "location_effect": "Location input does not change Magnetic. Kp is a global index.",
+        "do": "Use this to track global geomagnetic storm regime shifts.",
+        "dont": "Do not treat this as a city-level magnetometer or outage predictor.",
+        "what_it_is_not": "Not a local geomagnetic forecast. Not a power-grid impact model.",
         "why": "z_mag compresses magnitude+variability into a bounded stress coordinate; τ_eff rises as ln(1+z).",
         "how": "Fetch Kp → compute last/variability/slope → z_mag → τ_eff=1.38 ln(1+z) → Index=Ω_obs·τ_eff·α_R → label via fixed thresholds.",
     }
 
+
 def solar_agent():
     flux = fetch_goes_xray_1day()
     if len(flux) < 50:
@@ -260,10 +261,15 @@ def solar_agent():
         "live_status": live,
         "truth_source": "NOAA SWPC GOES primary xrays-1-day (global)",
         "inputs_used": {"flux_mean": f_mean, "flux_peak": f_peak, "tail_len": len(tail)},
+        "location_effect": "Location input does not change Solar. GOES flux is global.",
+        "do": "Use this to track global solar radiative regime changes.",
+        "dont": "Do not treat this as a flare time predictor or CME trajectory forecast.",
+        "what_it_is_not": "Not a flare timing model. Not a CME arrival model.",
         "why": "z_solar is derived from flux relative to baseline via a log ratio; τ_eff rises as ln(1+z).",
         "how": "Fetch GOES flux → mean/peak → z_solar=clamp(ln(F_mean/1e-8)/10) → τ_eff → Index → label via fixed thresholds.",
     }
 
+
 def atmospheric_agent(lat: float, lon: float, display: str):
     wx = fetch_openmeteo_hourly(lat, lon, past_days=1)
     temp = wx["temp"]
@@ -325,10 +331,15 @@ def atmospheric_agent(lat: float, lon: float, display: str):
         "live_status": live,
         "truth_source": "Open-Meteo hourly (location-based)",
         "inputs_used": {"dT_12h": dT, "dP_12h": dp, "wind_mean": w_mean, "lat": lat, "lon": lon},
+        "location_effect": "Location input changes Atmospheric because it queries the selected lat/lon.",
+        "do": "Use this as a short-term stability detector from temperature swing and pressure change.",
+        "dont": "Do not treat this as a rain/snow probability forecast or a full numerical weather model.",
+        "what_it_is_not": "Not a precipitation forecast. Not a synoptic model. Not a radar nowcast.",
         "why": "z_atm is derived from thermal swing and pressure change as a bounded stress coordinate; τ_eff rises as ln(1+z).",
         "how": "Geocode → fetch hourly series → compute ΔT and ΔP (last ~12h) → z_atm → τ_eff → Index → label via fixed thresholds.",
     }
 
+
 def seismic_agent(region: str):
     if region == "RingOfFire":
         seen = set()
@@ -391,13 +402,15 @@ def seismic_agent(region: str):
         "live_status": live,
         "truth_source": "USGS FDSN event feed (region-filtered)",
         "inputs_used": {"count_24h": N, "max_mag_24h": Mmax, "region": region},
+        "location_effect": "Location input does not change Seismic in region mode. It filters by selected region, not by city.",
+        "do": "Use this as a regional seismic stress monitor (regime detection).",
+        "dont": "Do not treat this as a time-and-epicenter earthquake prediction system.",
+        "what_it_is_not": "Not an earthquake time predictor. Not a rupture location predictor.",
         "why": "z_seis compresses activity density and severity into a bounded stress coordinate; τ_eff rises as ln(1+z).",
         "how": "Fetch USGS in region → count + max magnitude → z_seis → τ_eff → Index → label via fixed thresholds.",
     }
 
-# ---------------------------
-# Orchestrator
-# ---------------------------
+
 def run_forecast(location_text: str, seismic_region: str):
     try:
         lat, lon, display = geocode_location(location_text)
@@ -459,72 +472,132 @@ def run_forecast(location_text: str, seismic_region: str):
     header = f"**Location:** {display} (lat {lat:.3f}, lon {lon:.3f}) | **UTC:** {ts}"
     return header, df, atm, sei, mag, sol
 
-# ---------------------------
-# Open Method
-# ---------------------------
+
+INSTRUCTIONS_MD = """
+## Use and interpretation
+
+**Location input**
+- Used for Atmospheric.
+- Not used for Solar or Magnetic (global signals).
+- Seismic is region-filtered (not city-level) in this build.
+
+**Seismic region**
+- Filters USGS earthquakes by large tectonic region.
+- Counts are not “near your city” unless a radius mode is implemented.
+
+**Run Forecast**
+- Pulls live data and recomputes from scratch.
+- No auto-refresh. No memory. No smoothing.
+
+**Reading the table**
+- RFT Prediction shows model state + index + z + τ_eff.
+- Live Status shows the raw physical measurements used.
+- DISABLED means missing/insufficient live data; no guessing is performed.
+"""
+
+ATM_MD = """
+## Atmospheric
+- This is a short-term stability detector from temperature swing and pressure change.
+- This is not a precipitation forecast and not a full numerical weather model.
+"""
+
+SEIS_MD = """
+## Seismic
+- This is a regional seismic stress monitor from activity density and peak magnitude.
+- This is not a time/epicenter prediction system.
+"""
+
+MAG_MD = """
+## Magnetic
+- This tracks global geomagnetic storm regime shifts using NOAA Kp.
+- This is not a local magnetometer reading or grid-impact forecast.
+"""
+
+SOL_MD = """
+## Solar
+- This tracks global solar radiative regime shifts using GOES X-ray flux.
+- This is not a flare timing predictor or CME arrival model.
+"""
+
 METHOD_MD = f"""
-## Open method
-
-**Shared core:**
-- `τ_eff = {K_TAU} · ln(1 + z)`
-- `Ω_obs = 2π / T_earth = {OMEGA_OBS:.6e}`
-- `α_R = {ALPHA_R}`
-- `Index = Ω_obs · τ_eff · α_R`
-
-### Atmospheric (Open-Meteo, location)
-- Inputs: hourly temp, pressure, wind (last ~12h).
-- `ΔT = max(T) - min(T)`
-- `ΔP = P_end - P_start` (if available)
-- `z_atm = clamp( clamp(ΔT/10,0..2) + clamp(|ΔP|/12,0..1.5), 0..3 )`
-- Label rule in agent output.
-
-### Seismic (USGS, region)
-- Inputs: USGS events in last 24h (M≥2.5), filtered by region.
-- Count `N`, max magnitude `Mmax`
-- `z_seis = clamp( clamp(N/60,0..1.5) + clamp(max(0,Mmax-4)/2.5,0..1.5), 0..3 )`
-- Label rule in agent output.
-
-### Magnetic (NOAA Kp, global)
-- Inputs: planetary Kp 1-min stream.
-- `z_mag = clamp( (Kp_last/9) + (drift/2) + 2·|slope|, 0..3 )`
-- Label rule in agent output.
-
-### Solar (GOES X-ray, global)
-- Inputs: GOES 1–8Å flux (1-day stream).
-- `z_solar = clamp( ln(F_mean/1e-8) / 10, 0..3 )`
-- Label rule in agent output.
-
-Missing/short feeds show **DISABLED**.
+## Open method equations
+
+Shared core:
+- τ_eff = {K_TAU} · ln(1 + z)
+- Ω_obs = 2π / T_earth = {OMEGA_OBS:.6e}
+- α_R = {ALPHA_R}
+- 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 shown per-domain in the agent output under “rule_fired”.
 """
 
-# ---------------------------
-# UI
-# ---------------------------
+
 with gr.Blocks(title=APP_NAME) as demo:
     gr.Markdown(f"# {APP_NAME}")
 
     with gr.Tab("Live Forecast"):
         with gr.Row():
             loc = gr.Textbox(label="Location", value="London")
+        gr.Markdown(
+            "**Location input**\n\n"
+            "- Used for Atmospheric.\n"
+            "- Not used for Solar or Magnetic (global signals).\n"
+            "- Seismic is region-filtered in this build.\n\n"
+            "If a location cannot be resolved, predictions are disabled instead of guessed."
+        )
+
+        with gr.Row():
             region = gr.Dropdown(["Global", "EMEA", "AMER", "APAC", "RingOfFire"], value="EMEA", label="Seismic Region")
+        gr.Markdown(
+            "**Seismic region selector**\n\n"
+            "- Filters USGS earthquakes by large region.\n"
+            "- Counts are not “near your city” unless radius mode is implemented.\n"
+            "- Not a time/epicenter prediction system."
+        )
 
         btn = gr.Button("Run Forecast", variant="primary")
+        gr.Markdown(
+            "**Run Forecast**\n\n"
+            "- Pulls live data and recomputes from scratch.\n"
+            "- No auto-refresh.\n"
+            "- No stored memory.\n"
+            "- No guessing when data is missing."
+        )
+
         header_md = gr.Markdown()
+        gr.Markdown(
+            "**How to read the table**\n\n"
+            "- RFT Prediction shows model state + index + z + τ_eff.\n"
+            "- Live Status shows the raw physical measurements used.\n"
+            "- DISABLED means missing/insufficient live data; no guessing is performed."
+        )
         table = gr.Dataframe(headers=["Domain", "RFT Prediction", "Live Status"], interactive=False)
 
         with gr.Accordion("Atmospheric details", open=False):
+            gr.Markdown(ATM_MD)
             atm_json = gr.JSON(label="Atmospheric agent output")
         with gr.Accordion("Seismic details", open=False):
+            gr.Markdown(SEIS_MD)
             sei_json = gr.JSON(label="Seismic agent output")
         with gr.Accordion("Magnetic details", open=False):
+            gr.Markdown(MAG_MD)
             mag_json = gr.JSON(label="Magnetic agent output")
         with gr.Accordion("Solar details", open=False):
+            gr.Markdown(SOL_MD)
             sol_json = gr.JSON(label="Solar agent output")
 
         btn.click(run_forecast, inputs=[loc, region], outputs=[header_md, table, atm_json, sei_json, mag_json, sol_json])
 
     with gr.Tab("Method (Open)"):
+        gr.Markdown(INSTRUCTIONS_MD)
         gr.Markdown(METHOD_MD)
 
+
 if __name__ == "__main__":
     demo.launch()