本页提供有关MMDetection用法的基本教程。有关安装说明,请参阅【目标检测】MMDetection专栏之MMDetection安装https://mp.weixin.qq.com/s/J8LGyYa9hQcLbjeh531vsw
预训练模型的推论
我们提供测试脚本来评估整个数据集(COCO,PASCAL VOC等)以及一些高级api,以便更轻松地集成到其他项目。
测试数据集
[x]单个GPU测试
[x]多个GPU测试
[x]可视化检测结果
你可以使用以下命令测试数据集。
#单GPU测试python tools / test.py $ {CONFIG_FILE} $ {CHECKPOINT_FILE} [--out $ {RESULT_FILE}] [--eval $ {EVAL_METRICS}] [--show]
#多GPU测试./tools/dist_test.sh $ {CONFIG_FILE} $ {CHECKPOINT_FILE} $ {GPU_NUM} [--out $ {RESULT_FILE}] [--eval $ {EVAL_METRICS}]
可选参数: RESULT_FILE
:输出结果的文件名是pickle格式。如果未指定,结果将不会保存到文件中。 EVAL_METRICS
:要根据结果评估的项目。允许的值取决于数据集,例如proposal_fast
,proposal
,bbox
,segm
可用于COCO和mAP
,recall
为PASCAL VOC。
--show
:如果指定,检测结果将绘制在图像上并显示在新窗口中。它仅适用于单个GPU测试,并用于调试和可视化。请确保GUI在你的环境中可用,否则你可能会遇到类似cannot connect to X server
的错误。
如果要评估数据集,请不要同时指定--show
。
例子:
假设你已经将检查点下载到目录checkpoints/
。
1.测试更快的R-CNN并可视化结果。按任意键获取下一张图像。
python tools/test.py configs/faster_rcnn_r50_fpn_1x.py \ checkpoints/faster_rcnn_r50_fpn_1x_20181010-3d1b3351.pth \ --show
2.在PASCAL VOC上测试更快的R-CNN(不保存测试结果)并评估mAP。
python tools/test.py configs/pascal_voc/faster_rcnn_r50_fpn_1x_voc.py \ checkpoints/SOME_CHECKPOINT.pth \ --eval mAP
3.使用8个GPU测试Mask R-CNN,并评估bbox和mask AP。
./tools/dist_test.sh configs/mask_rcnn_r50_fpn_1x.py \ checkpoints/mask_rcnn_r50_fpn_1x_20181010-069fa190.pth \ 8 --out results.pkl --eval bbox segm
4.在具有8个GPU的COCO test-dev上测试Mask R-CNN,并生成json文件提交给官方评估服务器。
./tools/dist_test.sh configs/mask_rcnn_r50_fpn_1x.py \ checkpoints/mask_rcnn_r50_fpn_1x_20181010-069fa190.pth \ 8 --format-only --options "jsonfile_prefix=./mask_rcnn_test-dev_results"
你将获得两个json文件mask_rcnn_test-dev_results.bbox.json
和mask_rcnn_test-dev_results.segm.json
。
网络摄像头演示
我们提供了一个网络摄像头演示来说明结果。
python demo / webcam_demo.py $ {CONFIG_FILE} $ {CHECKPOINT_FILE} [-设备$ {GPU_ID}] [--camera-id $ {CAMERA-ID}] [--score-thr $ {SCORE_THR}]
例子:
python demo/webcam_demo.py configs/faster_rcnn_r50_fpn_1x.py \ checkpoints/faster_rcnn_r50_fpn_1x_20181010-3d1b3351.pth
用于测试图像的高级API
同步接口
这是构建模型并测试给定图像的示例。
from mmdet.apis import init_detector, inference_detector, show_resultimpo