开源项目JSON2YOLO安装与使用指南
JSON2YOLOConvert JSON annotations into YOLO format.项目地址:https://gitcode.com/gh_mirrors/js/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文件的转换。
如何运行脚本:
-
确保你的环境已经满足
requirements.txt
中的依赖条件。 -
在命令行中定位至
JSON2YOLO
项目根目录。 -
对于通用的转换,你可以使用以下命令来启动转换过程:
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包而导致失败。
JSON2YOLOConvert JSON annotations into YOLO format.项目地址:https://gitcode.com/gh_mirrors/js/JSON2YOLO