File size: 4,591 Bytes
2379054 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 | """
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
|