footap 1.0

Package d'analyse des touches de balle au football

FootAP

FootAP (FOOTball Analysis Package) is a Python package for analyzing ball touches in football videos.

Installation

pip install footap

Usage

You can use FootAP in two ways:

1. Command Line Interface

The simplest way to use FootAP is through the command line:

# Basic analysis (generates only results file)
footap video.mp4

# Analysis with real-time display
footap video.mp4 --display

# Analysis with video output
footap video.mp4 --save-video

# Full analysis with all options
footap video.mp4 --save-video -o output.mp4 -r results.txt --orientation 90 --display

Available options:

• --save-video: Generate an annotated output video
• --display: Show real-time processing
• -o, --output: Specify output video name (only with --save-video)
• -r, --results: Specify results file name
• --orientation: Video orientation in degrees (0, 90, 180, 270)

2. Python API

from footap import analyze_ball_touch

# Basic analysis
analyze_ball_touch("video.mp4")

# Full analysis with all options
analyze_ball_touch(
    input_video_path="video.mp4",
    display_processing=True,    # Show real-time processing
    generate_video=True,        # Generate output video
    video_orientation=90        # Rotate video if needed
)

Output

The program generates:

1. Results file (always generated):

   Left Foot Touches: 5
   Right Foot Touches: 12
   
   Touch Sequence:
   Touch 1: Right
   Touch 2: Left
   Touch 3: Right
   ...
   

2. Annotated video (optional, with --save-video):

   • Ball detection
   • Feet tracking
   • Real-time touch counter

Dependencies

• OpenCV (opencv-contrib-python)
• MediaPipe
• NumPy
• Ultralytics (YOLO)
• Pillow

License

This project is licensed under the MIT License.