Upload 5 files

app.py

@@ -0,0 +1,398 @@
+
+import io, json, os
+from pathlib import Path
+import streamlit as st
+import pandas as pd
+import numpy as np
+import joblib
+import matplotlib.pyplot as plt
+from sklearn.metrics import r2_score, mean_squared_error, mean_absolute_error
+
+# =========================
+# Defaults (overridden by models/meta.json or model.feature_names_in_)
+# =========================
+FEATURES = ["Q, gpm", "SPP(psi)", "T (kft.lbf)", "WOB (klbf)", "ROP (ft/h)"]
+TARGET = "UCS"
+MODELS_DIR = Path("models")
+DEFAULT_MODEL = MODELS_DIR / "ucs_rf.joblib"
+MODEL_FALLBACKS = [MODELS_DIR / "model.joblib", MODELS_DIR / "model.pkl"]
+
+# =========================
+# Page / Theme
+# =========================
+st.set_page_config(page_title="ST_GeoMech_UCS", page_icon="🛠️", layout="wide")
+st.markdown("<style>header, footer{visibility:hidden !important;}</style>", unsafe_allow_html=True)
+st.markdown("""
+
+<style>
+.stApp { background: #FFFFFF; }
+section[data-testid="stSidebar"] { background: #F6F9FC; }
+.sidebar-card{ border:1px solid #E5E7EB; border-radius:12px; background:#FFFFFF;
+  padding:10px 12px; margin:8px 0; box-shadow:0 1px 3px rgba(0,0,0,.06); display:inline-block; }
+.sidebar-card h3{ margin:0; font-size:1rem; line-height:1.2; text-align:center; }
+.stButton>button{ background:#007bff; color:#fff; font-weight:bold; border-radius:8px; border:none; padding:10px 24px; }
+.stButton>button:hover{ background:#0056b3; }
+.pill { display:inline-block; padding:2px 10px; border-radius:999px; border:1px solid #e5e7eb; margin:2px; background:#fff; font-size:.9rem; }
+</style>
+""", unsafe_allow_html=True)
+
+# =========================
+# Helpers
+# =========================
+def rmse(y_true, y_pred): 
+    return float(np.sqrt(mean_squared_error(y_true, y_pred)))
+
+def ensure_cols(df, cols):
+    miss = [c for c in cols if c not in df.columns]
+    if miss:
+        st.error(f"Missing columns: {miss}\nFound: {list(df.columns)}")
+        return False
+    return True
+
+@st.cache_resource(show_spinner=False)
+def load_model(model_path: str):
+    return joblib.load(model_path)
+
+@st.cache_data(show_spinner=False)
+def parse_excel(data_bytes: bytes):
+    bio = io.BytesIO(data_bytes)
+    xl = pd.ExcelFile(bio)
+    return {sh: xl.parse(sh) for sh in xl.sheet_names}
+
+def read_book(upload):
+    if upload is None:
+        return {}
+    try:
+        return parse_excel(upload.getvalue())
+    except Exception as e:
+        st.error(f"Failed to read Excel: {e}")
+        return {}
+
+def find_sheet(book, names):
+    low2orig = {k.lower(): k for k in book.keys()}
+    for nm in names:
+        if nm.lower() in low2orig:
+            return low2orig[nm.lower()]
+    return None
+
+def cross_plot(actual, pred, title, size=(5.6,5.6)):
+    fig, ax = plt.subplots(figsize=size)
+    ax.scatter(actual, pred, s=16, alpha=0.7)
+    lo = float(np.nanmin([actual.min(), pred.min()]))
+    hi = float(np.nanmax([actual.max(), pred.max()]))
+    ax.plot([lo,hi], [lo,hi], '--')
+    ax.set_xlabel("Actual UCS"); ax.set_ylabel("Predicted UCS"); ax.set_title(title)
+    ax.grid(True, ls=":", alpha=0.4)
+    return fig
+
+def depth_or_index_track(df, title, include_actual=True):
+    # If a depth-like column exists, plot UCS vs Depth (depth downward); else index track
+    depth_col = None
+    for c in df.columns:
+        if 'depth' in str(c).lower():
+            depth_col = c; break
+    fig, ax = plt.subplots(figsize=(5.8, 7.5))
+    if depth_col is not None:
+        ax.plot(df["UCS_Pred"], df[depth_col], label="UCS_Pred")
+        if include_actual and TARGET in df.columns:
+            ax.plot(df[TARGET], df[depth_col], alpha=0.7, label="UCS (actual)")
+        ax.set_ylabel(depth_col); ax.set_xlabel("UCS")
+        ax.xaxis.set_label_position('top'); ax.xaxis.tick_top(); ax.invert_yaxis()
+    else:
+        idx = np.arange(1, len(df) + 1)
+        ax.plot(df["UCS_Pred"], idx, label="UCS_Pred")
+        if include_actual and TARGET in df.columns:
+            ax.plot(df[TARGET], idx, alpha=0.7, label="UCS (actual)")
+        ax.set_ylabel("Point Index"); ax.set_xlabel("UCS")
+        ax.xaxis.set_label_position('top'); ax.xaxis.tick_top(); ax.invert_yaxis()
+    ax.grid(True, linestyle=":", alpha=0.4); ax.set_title(title, pad=12); ax.legend()
+    return fig
+
+def export_workbook(sheets_dict, summary_df=None):
+    try:
+        import openpyxl  # ensure engine available
+    except Exception:
+        raise RuntimeError("Export requires openpyxl. Please add it to requirements or install it.")
+    buf = io.BytesIO()
+    with pd.ExcelWriter(buf, engine="openpyxl") as xw:
+        for name, frame in sheets_dict.items():
+            frame.to_excel(xw, sheet_name=name[:31], index=False)
+        if summary_df is not None:
+            summary_df.to_excel(xw, sheet_name="Summary", index=False)
+    return buf.getvalue()
+
+def toast(msg):
+    try: st.toast(msg)
+    except Exception: st.info(msg)
+
+def infer_features_from_model(m):
+    # Attempt to get feature names from model or last pipeline step
+    try:
+        if hasattr(m, "feature_names_in_") and len(getattr(m, "feature_names_in_")):
+            return [str(x) for x in m.feature_names_in_]
+    except Exception:
+        pass
+    try:
+        if hasattr(m, "steps") and len(m.steps):
+            last = m.steps[-1][1]
+            if hasattr(last, "feature_names_in_") and len(last.feature_names_in_):
+                return [str(x) for x in last.feature_names_in_]
+    except Exception:
+        pass
+    return None
+
+# =========================
+# Model availability (download on cloud if needed)
+# =========================
+MODEL_URL = st.secrets.get("MODEL_URL", os.environ.get("MODEL_URL", "")).strip()
+
+def ensure_model_present() -> Path:
+    # Check local paths first
+    for p in [DEFAULT_MODEL, *MODEL_FALLBACKS]:
+        if p.exists():
+            return p
+    # Download if MODEL_URL provided
+    if MODEL_URL:
+        try:
+            import requests
+        except Exception:
+            st.error("requests is required to download the model. Add 'requests' to requirements.txt.")
+            return None
+        try:
+            DEFAULT_MODEL.parent.mkdir(parents=True, exist_ok=True)
+            with requests.get(MODEL_URL, stream=True) as r:
+                r.raise_for_status()
+                with open(DEFAULT_MODEL, "wb") as f:
+                    for chunk in r.iter_content(chunk_size=1<<20):
+                        f.write(chunk)
+            return DEFAULT_MODEL
+        except Exception as e:
+            st.error(f"Failed to download model from MODEL_URL. {e}")
+    return None
+
+model_path = ensure_model_present()
+if not model_path:
+    st.error("Model not found. Upload models/ucs_rf.joblib (or set MODEL_URL in Secrets).")
+    st.stop()
+
+# Load model
+try:
+    model = load_model(str(model_path))
+except Exception as e:
+    st.error(f"Failed to load model: {model_path}\n{e}")
+    st.stop()
+
+# Meta overrides
+meta_path = MODELS_DIR / "meta.json"
+if meta_path.exists():
+    try:
+        meta = json.loads(meta_path.read_text(encoding="utf-8"))
+        FEATURES = meta.get("features", FEATURES)
+        TARGET = meta.get("target", TARGET)
+    except Exception:
+        pass
+else:
+    infer = infer_features_from_model(model)
+    if infer:
+        FEATURES = infer
+
+# =========================
+# Session state
+# =========================
+if "app_step" not in st.session_state: st.session_state.app_step = "intro"
+if "results" not in st.session_state: st.session_state.results = {}
+if "train_ranges" not in st.session_state: st.session_state.train_ranges = None
+
+# =========================
+# Sidebar: Model & schema
+# =========================
+st.sidebar.markdown('<div class="sidebar-card"><h3>Model</h3>', unsafe_allow_html=True)
+st.sidebar.write(f"**Loaded:** `{Path(model_path).name}`")
+st.sidebar.write("**Target:**", TARGET)
+st.sidebar.write("**Features:**")
+for f in FEATURES:
+    st.sidebar.markdown(f"<span class='pill'>{f}</span>", unsafe_allow_html=True)
+st.sidebar.markdown('</div>', unsafe_allow_html=True)
+
+# =========================
+# Intro
+# =========================
+st.title("ST_GeoMech_UCS")
+st.caption("Real-Time UCS Tracking While Drilling — Cloud Ready")
+if st.session_state.app_step == "intro":
+    st.header("Welcome!")
+    st.write("Upload Train/Test data, run the model, then go to Prediction.")
+    if st.button("Start ▶", type="primary"):
+        st.session_state.app_step = "dev"; st.rerun()
+
+# =========================
+# Development (Train/Test)
+# =========================
+if st.session_state.app_step == "dev":
+    st.sidebar.markdown('<div class="sidebar-card"><h3>Model Development Data</h3>', unsafe_allow_html=True)
+    train_test_file = st.sidebar.file_uploader("Upload Train/Test Excel", type=["xlsx","xls"], key="dev_upload")
+    run_btn = st.sidebar.button("Run Model", type="primary", use_container_width=True)
+    if "Train" in st.session_state.results or "Test" in st.session_state.results:
+        st.sidebar.button("Go to Prediction ▶", use_container_width=True, on_click=lambda: st.session_state.update(app_step="predict"))
+    st.sidebar.markdown('</div>', unsafe_allow_html=True)
+
+    if run_btn and train_test_file is not None:
+        with st.status("Processing…", expanded=False) as status:
+            book = read_book(train_test_file)
+            if not book: status.update(label="Failed to read workbook.", state="error"); st.stop()
+            status.update(label="Workbook read ✓")
+
+            sh_train = find_sheet(book, ["Train","Training","training2","train","training"])
+            sh_test  = find_sheet(book, ["Test","Testing","testing2","test","testing"])
+            if sh_train is None or sh_test is None:
+                status.update(label="Workbook must include Train/Training/training2 and Test/Testing/testing2.", state="error"); st.stop()
+
+            df_tr = book[sh_train].copy(); df_te = book[sh_test].copy()
+            if not (ensure_cols(df_tr, FEATURES + [TARGET]) and ensure_cols(df_te, FEATURES + [TARGET])):
+                status.update(label="Missing required columns.", state="error"); st.stop()
+            status.update(label="Columns validated ✓")
+            status.update(label="Predicting…")
+
+            df_tr["UCS_Pred"] = model.predict(df_tr[FEATURES])
+            df_te["UCS_Pred"] = model.predict(df_te[FEATURES])
+            st.session_state.results["Train"] = df_tr; st.session_state.results["Test"] = df_te
+
+            st.session_state.results["metrics_train"] = {
+                "R2": r2_score(df_tr[TARGET], df_tr["UCS_Pred"]),
+                "RMSE": rmse(df_tr[TARGET], df_tr["UCS_Pred"]),
+                "MAE": mean_absolute_error(df_tr[TARGET], df_tr["UCS_Pred"]),
+            }
+            st.session_state.results["metrics_test"]  = {
+                "R2": r2_score(df_te[TARGET], df_te["UCS_Pred"]),
+                "RMSE": rmse(df_te[TARGET], df_te["UCS_Pred"]),
+                "MAE": mean_absolute_error(df_te[TARGET], df_te["UCS_Pred"]),
+            }
+
+            tr_min = df_tr[FEATURES].min().to_dict(); tr_max = df_tr[FEATURES].max().to_dict()
+            st.session_state.train_ranges = {f:(float(tr_min[f]), float(tr_max[f])) for f in FEATURES}
+
+            status.update(label="Done ✓", state="complete"); toast("Model run complete 🚀")
+
+    if "Train" in st.session_state.results or "Test" in st.session_state.results:
+        tab1, tab2 = st.tabs(["Training", "Testing"])
+        if "Train" in st.session_state.results:
+            with tab1:
+                df = st.session_state.results["Train"]; m = st.session_state.results["metrics_train"]
+                c1,c2,c3 = st.columns(3); c1.metric("R²", f"{m['R2']:.4f}"); c2.metric("RMSE", f"{m['RMSE']:.4f}"); c3.metric("MAE", f"{m['MAE']:.4f}")
+                left,right = st.columns(2)
+                with left: st.pyplot(cross_plot(df[TARGET], df["UCS_Pred"], "Training: Actual vs Predicted"), use_container_width=True)
+                with right: st.pyplot(depth_or_index_track(df, "Training: Depth/Index Track", include_actual=True), use_container_width=True)
+        if "Test" in st.session_state.results:
+            with tab2:
+                df = st.session_state.results["Test"]; m = st.session_state.results["metrics_test"]
+                c1,c2,c3 = st.columns(3); c1.metric("R²", f"{m['R2']:.4f}"); c2.metric("RMSE", f"{m['RMSE']:.4f}"); c3.metric("MAE", f"{m['MAE']:.4f}")
+                left,right = st.columns(2)
+                with left: st.pyplot(cross_plot(df[TARGET], df["UCS_Pred"], "Testing: Actual vs Predicted"), use_container_width=True)
+                with right: st.pyplot(depth_or_index_track(df, "Testing: Depth/Index Track", include_actual=True), use_container_width=True)
+
+        # Export Dev results
+        st.markdown("---")
+        sheets = {}; rows = []
+        if "Train" in st.session_state.results:
+            sheets["Train_with_pred"] = st.session_state.results["Train"]
+            rows.append({"Split":"Train", **{k:round(v,6) for k,v in st.session_state.results["metrics_train"].items()}})
+        if "Test" in st.session_state.results:
+            sheets["Test_with_pred"] = st.session_state.results["Test"]
+            rows.append({"Split":"Test", **{k:round(v,6) for k,v in st.session_state.results["metrics_test"].items()}})
+        summary_df = pd.DataFrame(rows) if rows else None
+        try:
+            data_bytes = export_workbook(sheets, summary_df)
+            st.download_button("Export Train/Test Results to Excel",
+                data=data_bytes, file_name="UCS_Dev_Results.xlsx",
+                mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
+        except RuntimeError as e:
+            st.warning(str(e))
+
+# =========================
+# Prediction (Validation)
+# =========================
+if st.session_state.app_step == "predict":
+    st.sidebar.markdown('<div class="sidebar-card"><h3>Prediction (Validation)</h3>', unsafe_allow_html=True)
+    validation_file = st.sidebar.file_uploader("Upload Validation Excel", type=["xlsx","xls"], key="val_upload")
+    predict_btn = st.sidebar.button("Predict", type="primary", use_container_width=True)
+    st.sidebar.button("⬅ Back", on_click=lambda: st.session_state.update(app_step="dev"), use_container_width=True)
+    st.sidebar.markdown('</div>', unsafe_allow_html=True)
+
+    if predict_btn and validation_file is not None:
+        with st.status("Predicting…", expanded=False) as status:
+            vbook = read_book(validation_file)
+            if not vbook: status.update(label="Could not read the Validation Excel.", state="error"); st.stop()
+            status.update(label="Workbook read ✓")
+            vname = find_sheet(vbook, ["Validation","Validate","validation2","Val","val"]) or list(vbook.keys())[0]
+            df_val = vbook[vname].copy()
+            if not ensure_cols(df_val, FEATURES): status.update(label="Missing required columns.", state="error"); st.stop()
+            status.update(label="Columns validated ✓")
+            df_val["UCS_Pred"] = model.predict(df_val[FEATURES])
+            st.session_state.results["Validate"] = df_val
+
+            # OOR check: min–max vs training
+            ranges = st.session_state.train_ranges; oor_table = None; oor_pct = 0.0
+            if ranges:
+                viol = {f: (df_val[f] < ranges[f][0]) | (df_val[f] > ranges[f][1]) for f in FEATURES}
+                any_viol = pd.DataFrame(viol).any(axis=1); oor_pct = float(any_viol.mean()*100.0)
+                if any_viol.any():
+                    offenders = df_val.loc[any_viol, FEATURES].copy()
+                    offenders["Violations"] = pd.DataFrame(viol).loc[any_viol].apply(lambda r: ", ".join([c for c,v in r.items() if v]), axis=1)
+                    offenders.index = offenders.index + 1; oor_table = offenders
+
+            metrics_val = None
+            if TARGET in df_val.columns:
+                metrics_val = {
+                    "R2": r2_score(df_val[TARGET], df_val["UCS_Pred"]),
+                    "RMSE": rmse(df_val[TARGET], df_val["UCS_Pred"]),
+                    "MAE": mean_absolute_error(df_val[TARGET], df_val["UCS_Pred"])
+                }
+            st.session_state.results["metrics_val"] = metrics_val
+            st.session_state.results["summary_val"] = {
+                "n_points": len(df_val),
+                "pred_min": float(df_val["UCS_Pred"].min()),
+                "pred_max": float(df_val["UCS_Pred"].max()),
+                "oor_pct": oor_pct
+            }
+            st.session_state.results["oor_table"] = oor_table
+            status.update(label="Predictions ready ✓", state="complete")
+
+    if "Validate" in st.session_state.results:
+        st.subheader("Validation Results")
+        sv = st.session_state.results["summary_val"]; oor_table = st.session_state.results.get("oor_table")
+        c1,c2,c3,c4 = st.columns(4)
+        c1.metric("# points", f"{sv['n_points']}"); c2.metric("Pred min", f"{sv['pred_min']:.2f}")
+        c3.metric("Pred max", f"{sv['pred_max']:.2f}"); c4.metric("OOR %", f"{sv['oor_pct']:.1f}%")
+        left,right = st.columns(2)
+        with left:
+            if TARGET in st.session_state.results["Validate"].columns:
+                st.pyplot(cross_plot(st.session_state.results["Validate"][TARGET], st.session_state.results["Validate"]["UCS_Pred"], "Validation: Actual vs Predicted"), use_container_width=True)
+            else:
+                st.info("Actual UCS values are not available in the validation data. Cross-plot cannot be generated.")
+        with right:
+            st.pyplot(depth_or_index_track(st.session_state.results["Validate"], "Validation: Depth/Index Track", include_actual=(TARGET in st.session_state.results["Validate"].columns)), use_container_width=True)
+        if oor_table is not None:
+            st.write("*Out-of-range rows (vs. Training min–max):*")
+            st.dataframe(oor_table, use_container_width=True)
+
+        # Export
+        st.markdown("---")
+        sheets = {"Validate_with_pred": st.session_state.results["Validate"]}
+        rows = []
+        for name, key in [("Train","metrics_train"), ("Test","metrics_test"), ("Validate","metrics_val")]:
+            m = st.session_state.results.get(key)
+            if m: rows.append({"Split": name, **{k: round(v,6) for k,v in m.items()}})
+        summary_df = pd.DataFrame(rows) if rows else None
+        try:
+            data_bytes = export_workbook(sheets, summary_df)
+            st.download_button("Export Validation Results to Excel",
+                data=data_bytes, file_name="UCS_Validation_Results.xlsx",
+                mime="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
+        except RuntimeError as e:
+            st.warning(str(e))
+
+# =========================
+# Footer
+# =========================
+st.markdown("---")
+st.markdown("<div style='text-align:center; color:#6b7280;'>ST_GeoMech_UCS • © Smart Thinking</div>", unsafe_allow_html=True)

models/meta.json

@@ -0,0 +1,17 @@
+{
+  "features": [
+    "Q, gpm",
+    "SPP(psi)",
+    "T (kft.lbf)",
+    "WOB (klbf)",
+    "ROP (ft/h)"
+  ],
+  "target": "UCS",
+  "best_params": {
+    "n_estimators": 150,
+    "max_depth": 21,
+    "max_features": "log2",
+    "random_state": 10
+  },
+  "depth_col": "Depth (ft)"
+}

models/ucs_rf.joblib

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e8cbfb44765b8c142c71d28a7fe1adda8baefd7da627943255a6ac04531ea65c
+size 24344513

requirements.txt

@@ -1,3 +1,8 @@
-altair
-pandas
-streamlit
+streamlit>=1.33
+pandas>=2.0
+numpy>=1.24
+scikit-learn>=1.3
+matplotlib>=3.7
+joblib>=1.3
+openpyxl>=3.1
+requests>=2.31