OIDv4_ToolKit 使用指南

1. 项目目录结构及介绍

.
├── classes.txt      # 包含所有类别的文本文件
├── gitignore        # Git忽略文件列表
├── images           # 下载的数据集图片存放目录（用户在使用过程中自动生成）
├── LICENSE          # 许可证文件，遵循GPL-3.0协议
├── main.py          # 主程序文件，用于下载和处理数据集
├── modules          # 子模块目录，包含项目的辅助脚本或功能实现
├── requirements.txt # Python依赖库清单，用于安装所需的第三方库
└── README.md        # 项目说明文档，包含项目简介和快速入门指南

介绍:

• classes.txt: 列出了Open Images V4数据集中所有类别名称。
• gitignore: 指示Git哪些文件或目录不应被纳入版本控制。
• images: 用户在执行下载任务时，图片会被保存在此目录下。
• LICENSE: 该项目使用的许可证是GNU General Public License v3.0。
• main.py: 核心运行文件，支持数据集下载与预处理操作。
• modules: 存放了用于支持主程序的各种模块或函数库。
• requirements.txt: 列出开发和运行此项目所需的所有Python包。
• README.md: 提供关于项目的概述、安装步骤和基本使用方法。

2. 项目的启动文件介绍

• 文件名: main.py
• 作用: 这是项目的主入口脚本，提供了命令行界面来管理对Open Images V4数据集的操作。主要功能包括下载特定类别的图像、进行数据格式转换等。
• 使用示例:

  python main.py downloader --classes Helmet Glove --type_csv train --limit 100
  

  上述命令将下载训练类别中的Helmet和Glove两类图像各不超过100张。

3. 项目的配置文件介绍

此项目并未明确提供一个独立的配置文件，但其配置信息主要通过命令行参数传递。关键的“配置”设置通常在调用main.py时直接以参数形式指定，如上例所示的类名(--classes)、数据类型(--type_csv)和限制数目(--limit)等。此外，开发者可以根据需要调整requirements.txt以满足环境需求，间接影响项目运行配置。

注意: 在实际应用中，虽然没有传统意义上的配置文件（如.ini, .yaml等），但通过修改main.py内的默认变量或者使用命令行参数，可以灵活地对项目进行配置。