Update app.py

app.py

@@ -439,6 +439,29 @@ def run_light_auto_test():
 
     return f"Loaded {len(ALL_Y_TRUE)} samples for fairness evaluation."
 
+def explain_fairness_metrics(dpd, dpr, eod):
+    explanation = ""
+
+    # DPD explanation
+    if abs(dpd) < 0.1:
+        explanation += "• DPD (Demographic Parity Difference): Low → Predictions are fairly balanced across groups.\n"
+    else:
+        explanation += "• DPD (Demographic Parity Difference): High → Model may favor one group over another.\n"
+
+    # DPR explanation
+    if 0.8 <= dpr <= 1.25:
+        explanation += "• DPR (Demographic Parity Ratio): Fair range → Outcomes are proportionally similar.\n"
+    else:
+        explanation += "• DPR (Demographic Parity Ratio): Outside fair range → Possible bias in outcomes.\n"
+
+    # EOD explanation
+    if abs(eod) < 0.1:
+        explanation += "• EOD (Equalized Odds Difference): Low → Model treats groups similarly when predicting.\n"
+    else:
+        explanation += "• EOD (Equalized Odds Difference): High → Model performance differs across groups.\n"
+
+    return explanation
+    
 def analyze_response(user_response):
     """Main analysis function for Gradio"""
     
@@ -475,12 +498,17 @@ def analyze_response(user_response):
         eod = equalized_odds_difference(
             ALL_Y_TRUE, ALL_Y_PRED, sensitive_features=ALL_GROUPS
         )
-        fairness_metrics = f"""
+       explanation = explain_fairness_metrics(dpd, dpr, eod)
+
+fairness_metrics = f"""
 === FAIRNESS METRICS ===
 DPD: {dpd:.2f}
 DPR: {dpr:.2f}
 EOD: {eod:.2f}
 Samples collected: {len(ALL_Y_TRUE)}
+
+--- What this means ---
+{explanation}
 """
     else:
         fairness_metrics = "Not enough samples for fairness metrics."