【亲测免费】 开源项目JSON2YOLO安装与使用指南

1、项目目录结构及介绍

1.1 文件夹概览

• ./: 主目录包含了所有项目相关文件。
• /docs: 存储项目文档和技术指导的目录。
• /examples: 示例代码和测试案例所在的位置。
• /scripts: 包含用于自动化流程的Shell和Python脚本。

重要文件列表：

• general_json2yolo.py: 通用的JSON转YOLO格式转换脚本。
• labelbox_json2yolo.py: LabelBox特定的JSON转YOLO格式转换脚本。
• utils.py: 提供工具函数支持的实用程序文件。
• requirements.txt: 必需的第三方库和软件包清单。

1.2 文件功能说明

• general_json2yolo.py: 这个脚本用于将任何遵循COCO标准格式的JSON文件转化为YOLO格式的数据文件。它可以灵活地适应不同的标注类别，并且能够处理各种输入大小。

• labelbox_json2yolo.py: 专门针对LabelBox输出的JSON文件设计，转换规则可能略有不同以满足LabelBox特有的数据结构需求。

• utils.py: 包含一组用于数据解析、坐标转换和其他预处理步骤的功能函数。

2、项目的启动文件介绍

2.1 启动脚本

JSON2YOLO的主要执行文件为general_json2yolo.py 和 labelbox_json2yolo.py。其中:

• general_json2yolo.py 是默认使用的入口脚本，用于普通JSON文件的转换。

如何运行脚本：

1. 确保你的环境已经满足requirements.txt中的依赖条件。

2. 在命令行中定位至JSON2YOLO项目根目录。

3. 对于通用的转换，你可以使用以下命令来启动转换过程：

   python general_json2yolo.py --input /path/to/json/file.json --output /desired/output/directory/
   

   或者，如果你正在处理来自LabelBox的数据，应当调用：

   python labelbox_json2yolo.py --input /path/to/labelbox/json/file.json --output /desired/output/directory/
   

3、项目的配置文件介绍

3.1 配置选项

虽然JSON2YOLO没有显式定义的配置文件，但它接受一系列命令行参数来进行定制化操作。主要参数包括但不限于:

• -i/--input: 输入的JSON文件路径。
• -o/--output: 输出目录，用于存储转化后的YOLO格式的标注文件。
• --debug: 开启调试模式，在开发过程中输出更多日志和错误信息。

3.2 参数调整示例

例如，如果你想从/your/path/annotations.json这个文件开始，并将转化结果保存到/your/output/folder中，可以通过下面的命令行来实现：

python general_json2yolo.py -i /your/path/annotations.json -o /your/output/folder

或者对于LabelBox输出的JSON文件：

python labelbox_json2yolo.py -i /your/path/labelbox_annotations.json -o /your/output/folder

确保在运行上述任一命令之前，已正确安装所需的所有外部依赖项，避免因缺少必要的Python包而导致失败。