开源项目 LaurieOnTracking 使用教程
1. 项目的目录结构及介绍
LaurieOnTracking 项目的目录结构如下:
LaurieOnTracking/
├── EPV_grid.csv
├── LICENSE
├── Metrica_EPV.py
├── Metrica_IO.py
├── Metrica_PitchControl.py
├── Metrica_Velocities.py
├── Metrica_Viz.py
├── README.md
├── Tutorial1_GettingStarted.py
├── Tutorial2_DelvingDeeper.py
├── Tutorial3_PitchControl.py
└── Tutorial4_EPV.py
目录结构介绍:
EPV_grid.csv
: 存储预期进球值(EPV)的网格数据。LICENSE
: 项目许可证文件,采用 MIT 许可证。Metrica_EPV.py
: 处理预期进球值(EPV)的模块。Metrica_IO.py
: 用于读取和写入数据的模块。Metrica_PitchControl.py
: 处理球场控制数据的模块。Metrica_Velocities.py
: 计算球员速度的模块。Metrica_Viz.py
: 用于数据可视化的模块。README.md
: 项目说明文档。Tutorial1_GettingStarted.py
: 入门教程。Tutorial2_DelvingDeeper.py
: 深入教程。Tutorial3_PitchControl.py
: 球场控制教程。Tutorial4_EPV.py
: 预期进球值(EPV)教程。
2. 项目的启动文件介绍
项目的启动文件是 Tutorial1_GettingStarted.py
,该文件是入门教程,指导用户如何开始使用项目。
启动文件内容概述:
- 导入必要的模块:
import Metrica_IO as mio import Metrica_Viz as mviz
- 设置数据路径和游戏 ID:
DATADIR = '/PATH/TO/WHERE/YOU/SAVED/THE/SAMPLE/DATA' game_id = 2
- 读取事件数据和跟踪数据:
events = mio.read_event_data(DATADIR, game_id) tracking_home = mio.tracking_data(DATADIR, game_id, 'Home') tracking_away = mio.tracking_data(DATADIR, game_id, 'Away')
- 将位置数据从 Metrica 单位转换为米:
tracking_home = mio.to_metric_coordinates(tracking_home) tracking_away = mio.to_metric_coordinates(tracking_away)
3. 项目的配置文件介绍
项目中没有明确的配置文件,但可以通过修改 DATADIR
变量来设置数据路径。
配置文件示例:
DATADIR = '/PATH/TO/WHERE/YOU/SAVED/THE/SAMPLE/DATA'
game_id = 2
通过修改 DATADIR
变量,可以指定项目使用的数据路径。
以上是 LaurieOnTracking 项目的使用教程,希望对您有所帮助。