""" core/rules_engine.py Deterministic engineering rules based on NR/L2/TRK/2500. """ from typing import Dict, List, Any, Tuple import pandas as pd from core.standards_loader import get_limit def check_min_radius(radius: float, track_category: str = "C") -> Tuple[bool, str]: """Check if radius meets minimum requirement.""" min_radius = get_limit("geom_min_radius", 150.0) if radius is None: return False, "Radius data missing" if radius >= min_radius: return True, f"Radius {radius:.1f}m >= minimum {min_radius}m" else: return False, f"Radius {radius:.1f}m < minimum {min_radius}m" def check_max_lift(lift: float) -> Tuple[bool, str]: """Check if lift is within maximum.""" max_lift = get_limit("disp_lift", 30.0) if lift is None: return False, "Lift data missing" abs_lift = abs(lift) if abs_lift <= max_lift: return True, f"Lift {abs_lift:.1f}mm <= maximum {max_lift}mm" else: return False, f"Lift {abs_lift:.1f}mm > maximum {max_lift}mm" def check_max_slue(slue: float) -> Tuple[bool, str]: """Check if slue is within maximum.""" max_slue = get_limit("disp_slue", 50.0) if slue is None: return False, "Slue data missing" abs_slue = abs(slue) if abs_slue <= max_slue: return True, f"Slue {abs_slue:.1f}mm <= maximum {max_slue}mm" else: return False, f"Slue {abs_slue:.1f}mm > maximum {max_slue}mm" def check_cant(cant: float) -> Tuple[bool, str]: """Check if cant is within limits.""" max_cant = get_limit("geom_max_cant", 150.0) if cant is None: return False, "Cant data missing" abs_cant = abs(cant) if abs_cant <= max_cant: return True, f"Cant {abs_cant:.1f}mm <= maximum {max_cant}mm" else: return False, f"Cant {abs_cant:.1f}mm > maximum {max_cant}mm" def check_twist(twist: float, track_category: str = "C") -> Tuple[bool, str]: """Check twist limit using category-specific 3m values where available.""" from core.standards_loader import get_track_category_limits cat = get_track_category_limits(track_category) or {} max_twist = cat.get("twist_3m", 2.5) if twist is None: return False, "Twist data missing" if twist <= max_twist: return True, f"Twist {twist:.2f}mm/m <= {max_twist}mm/m" else: return False, f"Twist {twist:.2f}mm/m > {max_twist}mm/m" def check_psr_compliance(speed: int, radius: float, track_category: str = "C") -> Tuple[bool, str]: """Check if radius meets PSR speed requirement.""" from core.engineering import check_radius_for_speed max_cant_def = get_limit("geom_max_cant_def", 110.0) sufficient, required = check_radius_for_speed(radius, speed, max_cant_def, 0) if sufficient: return True, f"Radius {radius:.1f}m sufficient for speed {speed}mph (required >= {required:.1f}m)" else: return False, f"Radius {radius:.1f}m insufficient for speed {speed}mph (required {required:.1f}m)" def run_all_rules(chainage_data: pd.DataFrame, limits: Dict, track_category: str = "C") -> List[Dict]: """ Run all rules on a DataFrame of chainage data. Returns a list of result dicts with fields: chainage, parameter, status, message. """ results = [] for _, row in chainage_data.iterrows(): ch = row.get('chainage') if 'chainage' in row else row.get('datum_chainage') if ch is None: continue # Radius radius = row.get('radius') if 'radius' in row else row.get('center_radius_m') if radius is not None: ok, msg = check_min_radius(radius, track_category) results.append({"chainage": ch, "parameter": "radius", "status": "PASS" if ok else "FAIL", "message": msg}) # Lift lift = row.get('lift') if 'lift' in row else None if lift is not None: ok, msg = check_max_lift(lift) results.append({"chainage": ch, "parameter": "lift", "status": "PASS" if ok else "FAIL", "message": msg}) # Slue slue = row.get('slue') if 'slue' in row else None if slue is not None: ok, msg = check_max_slue(slue) results.append({"chainage": ch, "parameter": "slue", "status": "PASS" if ok else "FAIL", "message": msg}) # Cant cant = row.get('cant') if 'cant' in row else row.get('center_cant_m') if cant is not None: ok, msg = check_cant(cant) results.append({"chainage": ch, "parameter": "cant", "status": "PASS" if ok else "FAIL", "message": msg}) return results