pitsidev5 0.1.0

A VEX Robotics scouting and analytics library for offline match analysis

pitsidev5

A Python library for VEX Robotics scouting and advanced match analytics.

pitsidev5 provides tools to fetch data from the RobotEvents API and compute performance metrics like OPR, DPR, ELO, and more — all computed offline from match data.

---

Features

Data Collection

• Client for the RobotEvents API
• Built-in caching to reduce API calls and rate limits
• Batch team data fetching

Event Analytics

• OPR (Offensive Power Rating)
• DPR (Defensive Power Rating)
• TrueOPR / TrueDPR
• EPR / APR (Adjusted Power Rating)
• ELO ratings (currently in the works)
• Strength of schedule (SOS)
• Alliance synergy and partner strength

Team Analytics

• Win/loss/tie record and win rate
• Average match score and performance margin
• Carry power and defensive power
• Robot scoring capability (peak performance)
• Alliance independence and consistency rating
• Clutch performance and close-match analysis
• Autonomous win point (AWP) tracking

Match Prediction

• Win probability using ELO
• Score prediction using OPR

Utilities

• CSV and JSON export
• Score normalization
• Batch team analysis
• Tournament simulation (Monte Carlo)

---

Installation

pip install pitsidev5

---

Quick Example

from pitsidev5 import RobotEvents, TeamAnalyzer, EventAnalyzer

re = RobotEvents(api_key="YOUR_API_KEY")

# Fetch team data
team_data = re.fetch_team_data("1234A")

# Analyze team
ta = TeamAnalyzer("1234A", team_data)
print(ta.summary())

# Analyze event
matches = re.get_event_matches(event_id=12345)
ea = EventAnalyzer(matches)

print(ea.opr())
print(ea.elo_ratings())

---

Notes

• All analytics are computed offline from match data you provide.
• Requires a RobotEvents API key.
• Early release and not yet tested in live competition environments.

---

License

MIT License

---