https://github.com/rjtavares/BirdsPyView

A streamlit app to convert images to top-down view and get coordinates of objects, built for football data collection
https://github.com/rjtavares/BirdsPyView

Last synced: about 2 months ago
JSON representation

A streamlit app to convert images to top-down view and get coordinates of objects, built for football data collection

• Host: GitHub
• URL: https://github.com/rjtavares/BirdsPyView
• Owner: rjtavares
• License: mit
• Created: 2020-09-01T18:05:00.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2023-11-30T16:03:01.000Z (7 months ago)
• Last Synced: 2024-02-04T11:12:30.715Z (5 months ago)
• Language: Python
• Size: 1.94 MB
• Stars: 68
• Watchers: 6
• Forks: 19
• Open Issues: 4
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Lists

• awesome-soccer-analytics - BirdsPyView - down view by identifying a rectangle on the ground (Open Source Libraries / Visualisation)

README

        
[![Open in Streamlit](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://share.streamlit.io/rjtavares/birdspyview/birdspyview.py)

First alpha version of BirdsPyView, a Streamlit app to transform perspective of an image to a top-down view by identifying a rectangle on the ground, built to collect data on football matches.

# Installation

First make sure you have **Python** installed.

Then install **OpenCV**, **Streamlit** and **Streamlit Drawable Canvas**:

    pip install opencv-python

    pip install streamlit

    pip install streamlit-drawable-canvas

Finally, clone the repo and inside BirdsPyView run:

    streamlit run birdspyview.py

# Getting started

1. Upload an image. All the lines from the Penalty Box must be visible, but the whole line is not necessary.

2. Draw a line over four pitch lines (from the options shown below), two of them vertical and two horizontal. You don't need to cover the whole line. If possible, use the penalty area.

![](BirdsPyView/pitch.png?raw=true)

3. If the converted image is clear, draw lines over each player feet. The output coordinate is the average position of the line.

4. If you need to start over, refresh the page.

# Demo

![](demo.gif?raw=true)