Update README.md

README.md

@@ -8,5 +8,21 @@ sdk_version: 5.49.1
 app_file: app.py
 pinned: false
 ---
+# Particle Shape QC — ISO 9276-6 / ASTM F1877 (with Image Pre-check)
+
+This Space analyzes particle shapes from SEM/optical micrographs. It now includes an **Image Quality Pre-check** enforcing the following **Must** items:
+
+- Scale bar present (e.g., 100 µm) **or** user-provided µm/px; bar width ≥ 30 px.
+- Orthographic view (no perspective skew).
+- Touching/aggregate ratio ≤ 30% (estimated via distance-transform peaks).
+- Clean background and sufficient contrast.
+- Minimum particle ECD ≥ 20 px.
+
+Workflow:
+1. Upload an image → Click **Quality pre-check** (get pass/fail & hints).
+2. Adjust thresholds/scale if needed.
+3. **Run analysis** to compute ISO/ASTM circularity, aspect ratio, pass rates, CSV export, and failing-particle overlay.
+
+See `app.py` for details.
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference