Useful tools for computer vision/deep learning.
Usage
yolo2coco.py
将yolo格式数据集修改成coco格式。$ROOT_PATH是根目录，需要按下面的形式组织数据：
└── $ROOT_PATH
├── classes.txt
├── images
└──labels-
classes.txt是类的声明，一行一类。 -
images目录包含所有图片 (目前支持png和jpg格式数据) -
labels目录包含所有标签(与图片同名的txt格式数据)
配置好文件夹后，执行：python yolo2coco.py --root_dir $ROOT_PATH ，然后就能看见生成的 annotations 文件夹。
参数说明
--root_path输入根目录$ROOT_PATH的位置。--save_path如果不进行数据集划分，可利用此参数指定输出文件的名字，默认保存为train.json--random_split随机划分参数，若指定--random_split参数，则输出在annotations文件夹下包含train.jsonval.jsontest.json（默认随机划分成8:1:1）--split_by_file自定义数据集划分，若指定--split_by_file参数，则输出在annotations文件夹train.jsonval.jsontest.json。需要在$ROOT_PATH文件下有./train.txt ./val.txt ./test.txt，可以这3个文件来定义训练集、验证集、测试集。注意， 这里里面填写的应是图片文件名字，而不是图片的绝对地址。（在line 43也自行可以修改一下读取方式，为了方便起见，不推荐把图片放在不同位置）
coco2yolo.py
读入coco数据集json格式的标注，输出可供yolo训练的标签。
需要注意的是，COCO2017官方的数据集中categories id 是不连续的，这在yolo读取的时候会出问题，所以需要重新映射一下，这个代码会按id从小到大映射到0~79之间。（如果是自己的数据集，也会重新映射）
执行：python coco2yolo.py --json_path $JSON_FILE_PATH --save_path $LABEL_SAVE_PATH
$JSON_FILE_PATH是json文件的地址。$JSON_FILE_PATH是输出目录（默认为工作目录下的./labels目录。
dataset_mean_var.py
执行：python yolo2coco.py --file_path $IMAGE_PATH --step $INTERVAL
- --file_path 输入图片地址。
- --step 可选，默认为1，选择图片的间隔，如间隔为10，则只计算1/10。
split_yolo_dataset.py
随机划分数据集（yolo数据格式的划分），按train:val:test = 8:1:1保存。
执行：python split_dataset_yolo.py --root_path $ROOT_PATH
vis_yolo_gt_dt.py
同时把GT和预测结果可视化在同一张图中。$DT_DIR是预测结果标签地址，必须是和GT同名的标签。$ROOT_PATH文件目录：
└── $ROOT_PATH
├── classes.txt
├── images
└── labels执行：python vis_yolo_gt_dt.py --root $ROOT_PATH --dt $DT_DIR后生成在outputs文件夹中。
classes.txt和images必须有。labels可以没有，那样就只展示$DT_DIR预测结果。$DT_DIR若没有输入，则只展示标签结果。
coco_eval.py
评估生成的结果，针对yolov5生成的检测结果（test中的--save-json参数，会生成best_predictions.json)，但是这个不适应cocoapi，需要用脚本来修改适应。执行：
python coco_eval.py --gt $GT_PATH --dt $DT_PATH --yolov5
--gtjson格式，用于指定测试集的结果，如果没有，可以利用前面的yolo2coco.py进行转换。--dt同样检测网络生成的预测，使用cocoapi中loadRes来加载，所以需要有相应格式的检测结果。--yolov5将官方代码中生成的结果转换成适配cocoapi的结果。
cat_img.py
左右拼接2个文件夹下同名的图片，方便可视化对比模型的效果。
grid_extract.py
- 网格化输出各个位置目标的分布情况。
- 依据条件提取特定区域的样本。
voc2coco_rotate.py
将旋转框的VOC标注转为COCO格式的。（范围为0~pi）