开源项目 `passing-networks-in-python` 使用教程

开源项目 passing-networks-in-python 使用教程

passing-networks-in-pythonSergio Llana's passing network plots with eventing and tracking football data项目地址:https://gitcode.com/gh_mirrors/pa/passing-networks-in-python

1. 项目的目录结构及介绍

passing-networks-in-python/
├── README.md
├── requirements.txt
├── run.py
├── config/
│   └── plot_config.json
├── data/
│   └── sample_data.csv
├── scripts/
│   └── generate_networks.py
└── visualization/
    └── plot_networks.py

• README.md: 项目说明文件，包含项目的基本介绍和使用说明。
• requirements.txt: 项目依赖文件，列出了运行项目所需的Python包。
• run.py: 项目的启动文件，用于执行生成传球网络的脚本。
• config/: 配置文件目录，包含绘图配置文件。
  • plot_config.json: 绘图配置文件，定义了绘图的颜色、大小等参数。
• data/: 数据文件目录，包含示例数据文件。
  • sample_data.csv: 示例数据文件，用于测试和演示。
• scripts/: 脚本文件目录，包含生成传球网络的脚本。
  • generate_networks.py: 生成传球网络的脚本，处理数据并生成网络图。
• visualization/: 可视化文件目录，包含绘图脚本。
  • plot_networks.py: 绘图脚本，用于绘制传球网络图。

2. 项目的启动文件介绍

run.py 是项目的启动文件，用于执行生成传球网络的脚本。以下是 run.py 的基本介绍：

# run.py
import argparse
from scripts.generate_networks import generate_networks

def main():
    parser = argparse.ArgumentParser(description="Generate football passing networks.")
    parser.add_argument("-m", "--match_id", type=int, required=True, help="Match ID to analyze.")
    parser.add_argument("-t", "--team", type=str, required=True, help="Team name to analyze.")
    parser.add_argument("-s", "--source", type=str, required=True, help="Data source (eventing or tracking).")
    parser.add_argument("-k", "--key", type=str, required=True, help="Key for data analysis.")
    args = parser.parse_args()

    generate_networks(args.match_id, args.team, args.source, args.key)

if __name__ == "__main__":
    main()

• argparse: 用于解析命令行参数。
• generate_networks: 调用 scripts/generate_networks.py 中的函数，生成传球网络。

3. 项目的配置文件介绍

config/plot_config.json 是项目的配置文件，定义了绘图的颜色、大小等参数。以下是 plot_config.json 的基本介绍：

{
    "node_color": "#1f77b4",
    "node_size": 200,
    "edge_color": "#999999",
    "edge_width": 1.5,
    "font_color": "#000000",
    "font_size": 12
}

• node_color: 节点颜色。
• node_size: 节点大小。
• edge_color: 边颜色。
• edge_width: 边宽度。
• font_color: 字体颜色。
• font_size: 字体大小。

通过修改 plot_config.json 文件中的参数，可以自定义传球网络图的外观。

passing-networks-in-pythonSergio Llana's passing network plots with eventing and tracking football data项目地址:https://gitcode.com/gh_mirrors/pa/passing-networks-in-python