Package org.episteme.social.sports

package org.episteme.social.sports

Provides classes and interfaces for sports science, athletic performance analysis, and competition modeling.

This package includes tools for:

• Biomechanical simulation of human movement.
• Athlete physiology and training load monitoring (ACWR, CTL/ATL).
• Electoral-style ranking systems (Elo, Glicko-2) and tournament scheduling.
• Tactical analysis, including heatmaps and passing networks.
• Metabolic energy expenditure and nutrition planning.

Since:

1.0

Version:

1.1

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Class	Description
Almanac	A persistent record container for sporting events, competitions, and match results.
AthletePhysiology	Simulates athlete physiology, modeling dynamic states such as fatigue, hydration, and recovery.
AthletePhysiology.PhysiologicalState	Represents a snapshot of an athlete's physiological condition.
BallAerodynamics	Models the aerodynamics of a spherical ball in flight, including Drag and Magnus effects.
BettingOddsCalculator	A utility for calculating betting odds, probabilities, and expected values for sports matches.
BettingOddsCalculator.MatchContext	Contextual factors that influence the outcome of a match.
BettingOddsCalculator.OddsResult	The result of an odds calculation, including probabilities and decimal odds.
BiomechanicsSimulator	Provides mathematical simulations and analysis for sports biomechanics.
BiomechanicsSimulator.BodySegment	Physical properties of a body segment.
BiomechanicsSimulator.DynamicAnalysis	Result of kinetic/dynamic movement analysis.
BiomechanicsSimulator.JointAngle	Represents a joint's angular orientation in 3D space.
BiomechanicsSimulator.KinematicAnalysis	Result of kinematic movement analysis.
BiomechanicsSimulator.MotionFrame	Snapshot of body orientation at a specific timestamp.
Category	Represents a classification for sports activities (e.g., Team, Combat, Extreme).
Competition	Represents a sports competition, such as a tournament, league, or championship.
DraftSimulator	Simulates sports drafts and recruitment processes.
DraftSimulator.DraftPick	Details of a specific draft pick.
DraftSimulator.Prospect	Data model for a draft prospect.
EloRating	Implementation of the Elo rating system for measuring relative skill levels in zero-sum games and sports competitions.
FanEngagementAnalyzer	Analyzes fan engagement levels by aggregating attendance, social media visibility, and qualitative sentiment index.
FatigueRecoveryModel	Provides mathematical models for optimizing athlete recovery and tapering phases.
HistoricalSports	Models ancestral sports and provides a catalog of historical physical activities.
HistoricalSports.HistoricalSport	Data model for a historical sport.
InjuryPredictor	Provides injury risk prediction and training load analysis for athletes.
InjuryPredictor.AthleteProfile	Physiological and historical profile of an athlete.
InjuryPredictor.InjuryRisk	Result of an injury risk assessment.
InjuryPredictor.InjuryType	Categories of common athletic injuries.
InjuryPredictor.TrainingLoad	Detailed data regarding an individual training session.
KinematicAnalyzer	Analyzes human kinematics and calculates metabolic energy expenditure for various sports activities.
Match	Represents a discrete sports match between two teams or individuals.
MatchPredictor	Predicts the statistical outcome and probability of winning for sports events.
MatchStatus	Extensible enumeration for the lifecycle status of a sports match.
NutritionPlanner	Provides mathematical methods for athlete nutrition planning and metabolic analysis.
NutritionPlanner.ActivityLevel	Standard categorical activity levels for metabolic calculations.
NutritionPlanner.AthleteProfile	Physiological data for an athlete.
NutritionPlanner.HydrationPlan	Guidelines for fluid intake.
NutritionPlanner.MacroTargets	Macro-nutrient distribution targets.
NutritionPlanner.MealTiming	Optimized meal schedule relative to training.
NutritionPlanner.TrainingPhase	Training cycle phases for nutrient adjustment.
PerformanceModels	Provides mathematical models for sports performance indicators across endurance and strength disciplines.
PerformanceModels.CriticalPower	Critical Power (CP) and Anaerobic Work Capacity (W') modeling.
PerformanceModels.Strength	Resistance training and strength metrics.
PerformanceModels.VO2Max	Aerobic capacity (VO2 Max) estimation algorithms.
RatingSystems	Implementation of various sports rating systems, including Elo and Glicko-2.
RatingSystems.Glicko2Rating	Data model for a Glicko-2 rating profile.
RecordTracker	Tracks and analyzes world records across various sports disciplines.
RecordTracker.RecordProgression	Analysis of record progression for a discipline.
RecordTracker.WorldRecord	Data model for a world record entry.
SalaryCapOptimizer	Provides algorithms for optimizing sports rosters under financial salary cap constraints.
SalaryCapOptimizer.Player	Data model for a player's performance and salary.
Sport	Represents a specific sport or athletic discipline.
TacticalAnalyzer	Provides tactical analysis of team formations, player heatmaps, and passing networks.
TacticalAnalyzer.Formation	Structured arrangement of player base positions.
TacticalAnalyzer.Pass	Record of a ball transfer between players.
TacticalAnalyzer.PlayerMovement	Temporal trajectory of a player.
TacticalAnalyzer.Position	Geometric coordinate on a sports field.
Team	Represents an organized sports team within a specific discipline.
TournamentSchedulers	Provides mathematical algorithms for scheduling sports competitions, including Round Robin, Single Elimination, and Swiss System pairings.
TournamentSchedulers.ScheduledMatch	Details of a scheduled match within a tournament structure.
TrainingPeriodization	Handles training periodization logic, including cycle generation and load monitoring.
TrainingPeriodization.Macrocycle	Top-level training cycle (typically 3-12 months).
TrainingPeriodization.MesoPhase	Phases of a training period (Macro/Meso cycles).
TrainingPeriodization.TrainingLoad	Descriptive training intensity levels based on functional threshold ratios.
TrainingPeriodization.TrainingWeek	Represents a specific week's training goals and metrics.
TrainingPeriodization.WorkoutSession	Standardized workout configuration.
TrajectoryDataSet	Universal data model for performance tracking and human evolution trajectories.
TrajectoryDataSet.ColorType	Color categories for visualization.
TrajectoryDataSet.DataPoint	Individual data point on a timeline.
TrajectoryDataSet.Series	A labeled series of related data points.
VideoAnalysisMetrics	Extracts performance metrics from video-derived tracking data.
VideoAnalysisMetrics.Shot	Detailed data for a specific scoring attempt.