从壹开始解读Yolov11【源码研读系列】—

一、模型配置操作：cfg.__init__.py

1.cfg.cfg2dict：yaml转字典

2.cfg.get_cfg：读取覆盖配置

3.cfg全局配置参数查询表

①*基础参数配置：

②*训练参数配置：

③验证测试参数配置：

④*预测参数配置：

⑤可视化参数配置：

⑥导出部署模型参数配置：

⑦*训练超参数配置

⑧*数据增强参数配置

在之前的从零开始使用YOLO系列文章中，简单记录了训练部署YOLO模型到自己的应用场景的一般方法。ultralytics平台的代码设计，让用户可以非常便捷轻易的使用命令行或者python接口脚本使用模型。

从零开始使用YOLO系列——基础使用博文快速链接：https://blog.csdn.net/qq_58718853/article/details/140501645

在此基础上，尝试使用Pycharm自带的debug模块，通过动态运行代码查看使用其便捷接口时具体调用模块的逻辑和结构。这样检视的好处是可以了解模型运作的流程，如加载模型要么调用model类中的self._load，要么调用self._new。

从零开始使用YOLO系列——debug源码博文快速链接：https://blog.csdn.net/qq_58718853/article/details/141122605

但是debug的方法是跳跃式的，在不同文件下python文件跳转，对于一些模块只能了解其部分，而对类的整体理解审视缺失。因此，新开本系列——按源码子文件顺序，研读官方参考文档，结合源码和实验解读YOLO源码。此系列可以作为YOLO内置功能函数的查询文档，也可以搭配debug系列深度理解YOLO运行逻辑。下见所有源码子文件夹。

一、模型配置操作：cfg.init.py

cfg 内文件夹结构如下图。其中datasets存放了相关数据集的 yaml 配置文件，models存放从Yolov3到11的模型 yaml 配置文件。__init__.py 文件中编写了处理cfg的相关函数。

1.cfg.cfg2dict：yaml转字典

官方文档参考地址：https://docs.ultralytics.com/reference/cfg/__init__/

这是一个读取yaml配置文件并转为字典的功能函数。下例分别读取了yolo11的模型yaml配置文件和整体环境yaml配置。

输入：yaml配置环境地址

输出：具体配置参数的字典dict格式

yaml配置环境可以在克隆下载的源码内找到。详见下图。

# 测试代码
from ultralytics.cfg import cfg2dict

model_yaml = cfg2dict('yolo11.yaml')
print(model_yaml)
config = cfg2dict('default.yaml')
print(config)

cfg2dict解析了yaml文件中的设置，并将其转为模型方便取用的dict字典格式。

2.cfg.get_cfg：读取覆盖配置

读取并修改覆盖配置参数函数。

输入：空（默认配置）或配置文件地址， override=输入修改参数的字典

输出：ultralytics.utils.IterableSimpleNamespace是ultralytics自定义的类

自定义配置文件my_cfg只修改mode为val验证模式，下述测试代码可以验证使用override覆盖后，将my_cfg改回了默认配置。

from ultralytics.cfg import get_cfg

config1 = get_cfg('default.yaml')
config2 = get_cfg('my_cfg.yaml')
print(type(config1))
print(config1==config2)

config3 = get_cfg('default.yaml', overrides={'mode':'val'})
print(config3==config2)