How mcmc1906/penalty-biomechanics works
Penalty Biomechanics is a research workflow that turns penalty videos into clips and body-relative measurements, then tests whether those measurements explain kick behavior. The principal path runs from video extraction through pose and kinematics to statistical analysis and predictive models. The README also documents interpretation, practical/anticipation analyses, and deep-learning comparisons. Some links are based on README descriptions or import references rather than inspected call sites; those limits are reflected in the evidence.
Main entry points: clips_master_sample.csv Clip Metadata · run_biomechanics.py Biomechanics Pipeline · reg_cross_analysis.py Natural-Crossed Modeling · statistical_tests_fase1.py Feature Tests
Components 24
Video Capture
- Clip Extraction
01_extraction/clips_creator.py - Clip Master Builder
02_biomechanics/build_clips_master.py - Clip Metadata
data/sample/clips_master_sample.csv
Biomechanics
- Pose Estimation
02_biomechanics/pose_extractor.py - Signal Filtering
02_biomechanics/signal_filter.py - Kinematics
02_biomechanics/kinematics.py - Biomechanics Pipeline
02_biomechanics/run_biomechanics.py - Frame Measurements
data/sample/dataset_sample.csv
Statistical Analysis
- Feature Tests
03_statistical_analysis/statistical_tests_fase1.py - Phase Two Tests
03_statistical_analysis/statistical_tests_fase2.py - Phase Three Tests
03_statistical_analysis/statistical_tests_fase3.py - Natural-Crossed Tests
03_statistical_analysis/reg_cros.py - Biomechanics Analysis
03_statistical_analysis/bio_analysis.py - Practical Insights
03_statistical_analysis/practical_insights.py - Statistical Utilities
03_statistical_analysis/stats_utils.py
Modeling and Interpretation
- Tabular Models
04_models/tabular_models.py - Deep Learning
04_models/deep_learning_models.py - Model Comparison
04_models/model_comparison.py - Evaluation Utilities
04_models/eval_utils.py - Interpretable Models
04_models/interpretable_model.py - Natural-Crossed Modeling
04_models/reg_cross_analysis.py - Model Statistics
04_models/stats_utils.py
Other components
- Penalty Videos
- Researcher
Connections 32
- Penalty Videos → Clip Extraction: provides video
README.md - Clip Extraction → Clip Master Builder: feeds clips
- Clip Master Builder → Clip Metadata: builds metadata
- Clip Metadata → Biomechanics Pipeline: supplies clip metadata
02_biomechanics/run_biomechanics.py - Biomechanics Pipeline → Pose Estimation: extracts landmarks
02_biomechanics/run_biomechanics.py - Biomechanics Pipeline → Signal Filtering: filters landmarks
02_biomechanics/run_biomechanics.py - Biomechanics Pipeline → Kinematics: computes measures
02_biomechanics/run_biomechanics.py - Kinematics → Pose Estimation: uses keypoint map
02_biomechanics/kinematics.py - Biomechanics Pipeline → Frame Measurements: writes measurements
- Clip Metadata → Feature Tests: supplies analysis data
03_statistical_analysis/statistical_tests_fase1.py - Clip Metadata → Phase Two Tests: supplies analysis data
- Clip Metadata → Phase Three Tests: supplies analysis data
03_statistical_analysis/statistical_tests_fase3.py - Clip Metadata → Natural-Crossed Tests: supplies analysis data
03_statistical_analysis/reg_cros.py - Clip Metadata → Biomechanics Analysis: supplies analysis data
03_statistical_analysis/bio_analysis.py - Clip Metadata → Practical Insights: supplies analysis data
03_statistical_analysis/practical_insights.py - Feature Tests → Statistical Utilities: uses shared tests
03_statistical_analysis/statistical_tests_fase1.py - Phase Two Tests → Statistical Utilities: uses shared tests
03_statistical_analysis/statistical_tests_fase2.py - Phase Three Tests → Statistical Utilities: uses shared tests
03_statistical_analysis/statistical_tests_fase3.py - Natural-Crossed Tests → Model Statistics: uses shared definitions
03_statistical_analysis/reg_cros.py - Practical Insights → Model Statistics: uses shared definitions
03_statistical_analysis/practical_insights.py - Clip Metadata → Tabular Models: supplies model features
- Clip Metadata → Deep Learning: supplies model features
- Clip Metadata → Model Comparison: supplies model features
- Tabular Models → Evaluation Utilities: uses evaluation
04_models/tabular_models.py - Interpretable Models → Evaluation Utilities: uses evaluation
04_models/interpretable_model.py - Natural-Crossed Modeling → Evaluation Utilities: uses evaluation
04_models/reg_cross_analysis.py - Natural-Crossed Modeling → Model Statistics: uses statistics
04_models/reg_cross_analysis.py - Clip Metadata → Interpretable Models: supplies model features
04_models/interpretable_model.py - Clip Metadata → Natural-Crossed Modeling: supplies analysis data
04_models/reg_cross_analysis.py - Researcher → Biomechanics Pipeline: runs pipeline
- Researcher → Feature Tests: runs analyses
- Researcher → Tabular Models: runs models