https://github.com/acmiyaguchi/judo-footage-analysis
https://github.com/acmiyaguchi/judo-footage-analysis
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/acmiyaguchi/judo-footage-analysis
- Owner: acmiyaguchi
- Created: 2024-04-05T10:36:27.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-13T09:47:25.000Z (about 1 year ago)
- Last Synced: 2024-04-13T23:52:44.613Z (about 1 year ago)
- Language: Jupyter Notebook
- Homepage: https://judo-footage-analysis.acmiyaguchi.me/
- Size: 1.59 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# judo-footage-analysis
This repository is work supporting "Semi-Supervised Extraction and Analysis of Judo Combat Phases
from Recorded Live-Streamed Tournament Footage".
The goal of the project is to automate live-stream recording segmentation into individual matches, extract combat phases from matches, and to gather statistics at the tournament level.
This project was done as part of CS8813 Introduction to Research at Georgia Tech Europe during the Spring 2024 semester.
## quickstart
Checkout the repo and install any dependencies you may need to a virtual environment:
```bash
git checkout ${repo}
cd ${repo_name}
python -m venv .venv
pip install -r requirements.txt
pip install -e .
```
Install any of the relevant tools for running workflows:
- ffmpeg
- b2-tools
- google-cloud-sdk
### running a workflow
Most of the data processing workflows are written as [luigi](https://github.com/spotify/luigi) scripts under the [judo_footage_analysis/workflow](./judo_footage_analysis/workflow) module.
These can be run as follows:
```bash
# in a terminal session
luigid
# in a separate session
python -m judo_footage_analysis.workflow.{module_name}
```
You can watch the progress of a job in the terminal or from the luigi web-ui at http://localhost:8082.