Update terminology to reflect "traction stress map" instead of "force map". Adjust README.md for clarity on app version and refine comments in download_ckp.py for better understanding of checkpoint downloads.

S2FApp/README.md

@@ -52,8 +52,8 @@ Checkpoints are downloaded automatically from the [Shape2Force model repo](https
 - **Downloads**: map PNG (scale bar + colourbar), CSV with metrics and parameters, and a PDF report that records the
   input file, model, checkpoint SHA-256, substrate setting, pixel size, display and force-region settings and app
   version. Batch mode gives a PDF (summary table + one page per image), a CSV, and a ZIP with, per image, the PNG and a
-  TIFF whose pixel values are traction stress in Pa (for measurements in Fiji/ImageJ). Set `S2F_APP_COMMIT` to add
-  the git commit.
+  TIFF whose pixel values are traction stress in Pa (for measurements in Fiji/ImageJ). Reports record the app version
+  (`APP_VERSION` in `config/constants.py`; bump it and tag the GitHub release on each deploy).
 
 ## Full Project
 

S2FApp/app.py

@@ -229,7 +229,7 @@ with st.sidebar:
             ["single_cell", "spheroid"],
             format_func=lambda x: MODEL_TYPE_LABELS[x],
             horizontal=False,
-            help="Single cell: substrate-aware force prediction. Spheroid: spheroid force maps.",
+            help="Single cell: substrate-aware force prediction. Spheroid: spheroid traction stress maps.",
         )
 
         ckp_folder = get_ckp_folder(ckp_base, model_type)
@@ -362,7 +362,7 @@ with st.sidebar:
             list(COLORMAPS.keys()),
             key="s2f_colormap",
             label_visibility="collapsed",
-            help="Color scheme for the force map. Viridis is often preferred for accessibility.",
+            help="Color scheme for the traction stress map. Viridis is often preferred for accessibility.",
         )
 
 

S2FApp/download_ckp.py

@@ -14,8 +14,8 @@ if not has_any:
         repo = os.environ.get("HF_MODEL_REPO", "Angione-Lab/Shape2Force")
         files = list_repo_files(repo)
         pth_files = [f for f in files if f.startswith("ckp/") and f.endswith(".pth")]
-        # All checkpoints: single cell (S2F), spheroid S2F (ckp_spheroid_GN.pth, the model reported in the paper
-        # and the app default) and the smaller supervised spheroid model (ckp_spheroid_FN.pth).
+        # All checkpoints: single cell (S2F), spheroid S2F (ckp_spheroid_GN.pth, the model reported in the paper)
+        # and the smaller supervised spheroid model (ckp_spheroid_FN.pth, the app default).
         for f in pth_files:
             hf_hub_download(repo_id=repo, filename=f, local_dir="/app")
         print("Downloaded checkpoints from", repo)

S2FApp/ui/measure_tool.py

@@ -214,7 +214,7 @@ def render_region_canvas(display_heatmap, raw_heatmap=None, bf_img=None, origina
         left_col, right_col = st.columns(2, gap=None)
         with left_col:
             draw_mode = st.selectbox("Tool", DRAW_TOOLS, format_func=lambda x: TOOL_LABELS[x], key=f"draw_mode_region_{key_suffix}")
-            st.caption("Left-click add, right-click close.  \nForce map (draw region)")
+            st.caption("Left-click add, right-click close.  \nTraction stress map (draw region)")
             canvas_result = st_canvas(
                 fill_color="rgba(0, 188, 212, 0.25)", stroke_width=2, stroke_color="#00bcd4",
                 background_image=pil_bg, drawing_mode=draw_mode, update_streamlit=True,

S2FApp/utils/report.py

@@ -365,8 +365,8 @@ def create_measure_pdf_report(bf_img, heatmap_labeled_rgb, table_rows, base_name
     Image.fromarray(heatmap_labeled_rgb).save(hm_labeled_buf, format="PNG")
     hm_labeled_buf.seek(0)
     c.drawImage(ImageReader(hm_labeled_buf), hm_x, img_bottom, width=img_w, height=img_h, preserveAspectRatio=True)
-    hm_label_w = c.stringWidth("Force map", "Helvetica", 9)
-    c.drawString(hm_x + (img_w - hm_label_w) / 2, img_bottom - 14, "Force map")
+    hm_label_w = c.stringWidth("Traction stress map", "Helvetica", 9)
+    c.drawString(hm_x + (img_w - hm_label_w) / 2, img_bottom - 14, "Traction stress map")
 
     # Spacing: one line between images/labels and measurements section
     row_height = 14