mmdetection源码笔记（一）：train.py解读

引言：

刚接触mmdetection，建议不着急看代码，可以先去把config文件夹下的py配置文件先去好好了解一下，因为，要改动或者微调、以及复现论文中的精度，基本上都在config文件夹下进行修改数据。

【干货】用mmdetection，在COCO数据集上跑通faster R-CNN（测试、训练）
【干货】mmdetection使用coco格式的CrowdHuman数据集进行训练及测试（附调参过程）

上面文章是博主刚开始接触mmdetection时，跑通mmdetection的过程和复现论文CrowdHuman里fpn精度的过程，里面有 configs/faster_rcnn_r50_fpn_1x.py文件里的各个字段详细的解释。可以根据配置文件，修改参数，进行复现结果。
其他的py配置文件，就大同小异了，基本上差不多。
mmdetection源码解读，本文就直接先train.py文件下手。

train.py文件

里面主要就两个函数，parse_args()和main()。
作用：
parse_args()：其实就是获取命令行参数的一个过程，从创建解析对象，到对其解析（有点拗口，但不是重点，只要知道，这个函数用来获得命令行的各个参数就行了。）

main()：函数主入口，先做了一些config文件，work_dir以及log的操作（这些操作都是从命令行获得的，或者从命令行带有的文件里得到的参数等。）。
然后最主要的三个步骤就是调用build_detector()来创建模型，调用build_dataset()对数据集进行注册，然后在训练检测器train_detector()。

这里的三个函数build_detector()、build_dataset()、train_detector()我们先不讨论具体的实现。
根据我们之前看的py配置文件，以及跑通mmdetection，大致可以知道。执行train.py时，最主要的参数就是py配置文件。
博主当时跑通mmdetection时，执行训练的命令：

python tools/train.py configs/faster_rcnn_r50_fpn_1x.py

所以呢，我们就可以知道，build_detection()就是将py配置文件里的数据，加载到建立的模型中，然后根据py配置文件中的数据集路径，执行build_dataset()加载数据集模型，最后进行训练train_detector()。

ok，现在详细的来看下面代码。

# -*- coding: utf-8 -*-
from __future__ import division
import argparse
import os
from mmcv import Config
from mmdet import __version__
from mmdet.datasets import build_dataset
from mmdet.apis import (train_detector, init_dist, get_root_logger,set_random_seed)
from mmdet.models import build_detector
import torchdef parse_args():#argparse是python标准库里面用来处理****命令行参数****的库#ArgumentParser（）方法参数须知：一般我们只选择用description#description=None,    - help时显示的开始文字parser = argparse.ArgumentParser(description='Train a detector')#创建一个解析对象# add_argument向该对象中添加你要关注的命令行参数和选项# help     可以写帮助信息 parser.add_argument('--config', help='train config file path')parser.add_argument('--work_dir', help='the dir to save logs and models')parser.add_argument('--resume_from', help='the checkpoint file to resume from')#action    表示值赋予键的方式，这里用到的是bool类型 parser.add_argument('--validate',action='store_true',help='whether to evaluate the checkpoint during training')# type   - 指定参数类型parser.add_argument('--gpus',type=int,default=1,help='number of gpus to use ''(only applicable to non-distributed training)')parser.add_argument('--seed', type=int, default=None, help='random seed')parser.add_argument('--launcher',choices=['none', 'pytorch', 'slurm', 'mpi'],default='none',help='job launcher')parser.add_argument('--local_rank', type=int, default=0)args = parser.parse_args() #进行解析if 'LOCAL_RANK' not in os.environ:#os.environ[''] : 获取系统环境变量os.environ['LOCAL_RANK'] = str(args.local_rank)return argsdef main():args = parse_args()#获得命令行参数，实际上就是获取config配置文件cfg = Config.fromfile(args.config)#读取配置文件# set cudnn_benchmark#在图片输入尺度固定时开启，可以加速，一般都是关的，只有在固定尺度的网络如SSD512中才开启if cfg.get('cudnn_benchmark', False):torch.backends.cudnn.benchmark = True# update configs according to CLI argsif args.work_dir is not None:# 创建工作目录存放训练文件，如果不键入，会自动从py配置文件中生成对应的目录，key为work_dircfg.work_dir = args.work_dirif args.resume_from is not None:# 断点继续训练的权值文件，为None就没有这一步的设置cfg.resume_from = args.resume_fromcfg.gpus = args.gpus# init distributed env first, since logger depends on the dist info.if args.launcher == 'none':distributed = Falseelse:distributed = Trueinit_dist(args.launcher, **cfg.dist_params)# init logger before other stepslogger = get_root_logger(cfg.log_level)#log_level在配置文件里有这个key，value=“INFO”训练一次batch就可以看到输出这个strlogger.info('Distributed training: {}'.format(distributed))# set random seeds 关于设置随机种子的原因，请看文末推荐文章第一篇。if args.seed is not None:logger.info('Set random seed to {}'.format(args.seed))set_random_seed(args.seed)# #  1.  build_detector()在models/builder.py里，其实就是间接调用了build()。搭建模型#model = build_detector(cfg.model, train_cfg=cfg.train_cfg, test_cfg=cfg.test_cfg)#  #  2.  将训练配置传入，其中 build_dataset()在mmdet/datasets/builder.py里实现#train_dataset = build_dataset(cfg.data.train)#配置文件中的data字典，里的字段#train_dataset就是一个字典了，包含了训练时的所有参数字段。if cfg.checkpoint_config is not None:
#save mmdet version, config file content and class names in checkpoints as meta data
#将mmdet版本，配置文件内容和检查点中的类名称保存为元数据# 要注意的是，以前发布的模型是不存这个类别等信息的，# 用的默认COCO或者VOC参数，所以如果用以前训练好的模型检测时会提醒warning一下，问题不大。cfg.checkpoint_config.meta = dict(mmdet_version=__version__,config=cfg.text,CLASSES=train_dataset.CLASSES)#得到数据集的类，比如coco类啊，voc类的等，都是一个类#都要在registry里进行注册。可在datasets文件夹下的py文件看建立模型过程。# add an attribute for visualization convenience 添加属性以方便可视化model.CLASSES = train_dataset.CLASSES# model的CLASSES属性本来没有的，但是python不用提前声明，再赋值的时候自动定义变量##  3.  开始训练#train_detector(model,train_dataset,cfg,                     #配置文件distributed=distributed, #分布式训练 true or flasevalidate=args.validate,logger=logger)if __name__ == '__main__':main()

在第86行处，cfg.model, train_cfg=cfg.train_cfg, test_cfg=cfg.test_cfg，cfg为py配置文件里的内容，配置文件是一个字典，每个字段的value值还可能又是个字典，本处就是将key为model、train_cfg、test_cfg的value传入函数build_detector中。下面分别是key为model、train_cfg、test_cfg的截图（该配置文件为faster_rcnn_r50_fpn_1x.py）

通过上面的大量注释，相信已经大致可以知道，train.py主要的流程。接下来就是对建立模型、搭建网络、包括loss处理等部分、创建数据集模型、训练模型等的源码解读了。

mmdetection源码解读系列文章：

mmdetection源码笔记（二）：搭建模型之registry.py和builder.py解读（上）
mmdetection源码笔记（二）：创建网络模型之cascade_rcnn.py的解读（中）
mmdetection源码笔记（二）：cascade_rcnn.py搭建模型过程中各个module的forward()的代码解读（下）（待完成）
mmdetection源码笔记（三）：创建数据集模型之datasets/coco.py的解读（上）
mmdetection源码笔记（三）：创建数据集模型之datasets/custom.py的解读（下）
mmdetection源码笔记（四）：训练模型之train_detector()的解读
mmdetection源码笔记（五）：测试之test()部分的解读

参考

mmdetection源码注释

mmdetection源码笔记（一）：train.py解读相关推荐

Py区块链源码笔记（1）挖矿
昨晚听大佬小课堂,给我普及一晚上区块链相关各种知识,深深感觉到自己宛如一个智障,我不配说自己是学计算机的啊-- 膜拜之余,转载大佬的文章,像大佬学习! 文章出处:Py区块链源码笔记 (1)挖矿也欢迎 ...
【MMDetection 源码解读之yolov3】Neck - FPN
目录前言一.FPN 总结前言这部分接着前一篇文章 [MMDetection 源码解读 yolov3]Backbone - Darknet53 继续往后讲.搭建完了主干特征提取模块,接着就是搭建 ...
Ardupilot -- APM源码笔记（重制）~序言
首先,本篇不会涉及到源码方面的解读跟指导,只是为了后续章节做一些说明,并讲讲写下这些博文的原因说起无人机的话,应该很多人会想到大疆.亿航这些商业巨头,这样的产业能发展起来也跟无人机代码开源有关.从微 ...
angularjs源码笔记(3)--injector
2019独角兽企业重金招聘Python工程师标准>>> 简介 injector是用来做参数自动注入的,例如 function fn ($http, $scope, aService) ...
spring aop原理_Spring知识点总结！已整理成142页离线文档（源码笔记+思维导图）...
写在前面由于Spring家族的东西很多,一次性写完也不太现实.所以这一次先更新Spring[最核心]的知识点:AOP和IOC 无论是入门还是面试,理解AOP和IOC都是非常重要的.在面试的时候,我没 ...
数据结构源码笔记（C语言描述）汇总
数据结构源码笔记(C语言):英文单词按字典序排序的基数排序数据结构源码笔记(C语言):直接插入排序数据结构源码笔记(C语言):直接选择排序数据结构源码笔记(C语言):置换-选择算法数据结构源码 ...
数据结构源码笔记（C语言）：英文单词按字典序排序的基数排序
//实现英文单词按字典序排序的基数排序算法#include<stdio.h> #include<malloc.h> #include<string.h>#defin ...
数据结构源码笔记（C语言）：索引文件建立和查找
//实现索引文件建立和查找算法#include<stdio.h> #include<malloc.h> #include<string.h> #include< ...
数据结构源码笔记（C语言）：快速排序
//实现快速排序算法 #include<stdio.h> #include<malloc.h> #define MAXE 20typedef int KeyType; type ...
数据结构源码笔记（C语言）：冒泡排序
//冒泡排序算法实现 #include<stdio.h> #include<malloc.h> #define MAXE 20typedef int KeyType; type ...

mmdetection源码笔记（一）：train.py解读

引言：

train.py文件

推荐文章

参考

mmdetection源码笔记（一）：train.py解读相关推荐

最新文章

热门文章